From 56cbe6c8edc4fb7e13307f79747353a01668e0d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Henrik=20tom=20W=C3=B6rden?= <h.tomwoerden@indiscale.com>
Date: Tue, 10 Oct 2023 11:41:49 +0200
Subject: [PATCH] DOC: add hint about the manual ID insertion
---
src/doc/tutorials/edit_mode.rst | 15 +++++++++++----
1 file changed, 11 insertions(+), 4 deletions(-)
diff --git a/src/doc/tutorials/edit_mode.rst b/src/doc/tutorials/edit_mode.rst
index a2a0310f..bc271166 100644
--- a/src/doc/tutorials/edit_mode.rst
+++ b/src/doc/tutorials/edit_mode.rst
@@ -73,13 +73,20 @@ the corresponding area at the top of the Record. Similarly, Properties
can be added by dragging Properties (or RecordTypes) from the list in the edit mode toolbox
to the corresponding area at the bottom of the Record. Properties and
parents can be removed from the entity by clicking on the trash-can
-symbol. Not that a Record must always have at least one parent.
+symbol. Note that a Record must always have at least one parent.
+
+When many Entities are valid candidates for a reference property not all
+might be available in the drop down element. In those cases, the drop down
+warns, that only a subset is shown and a new button with a pencil symbol is
+shown. This allows to enter an ID manually (Click the pencil button, enter the
+ID and press Enter). If you wonder how you find the ID of an entity: You can
+for example submit a SELECT query like this "SELCT ID FROM ..."
Changes will be applied after clicking on ``Save`` or can be discarded
entirely by clicking ``Cancel``. Existing Properties and RecordTypes
can be edited in the same way. Note that when changing a RecordType,
the properties don't have values.
-
+
Creating a new Record
---------------------
@@ -136,10 +143,10 @@ entity panel, similar to the "New Record" explained above:
dialog
.. note::
-
+
Adding parents currently (May 2023) does not automatically add the parents’ properties
yet. You will have to do this manually.
-
+
3. Add Properties as described above by selecting them from the lists in the edit mode toolbox and
dragging them to the Property area in the new RecordType. Note that in contrast to Records, the
Properties of RecordTypes do not have values.
--
GitLab