Differences

This shows you the differences between two versions of the page.

--- pergamonmystic:linkedhelp:edit_multi_value [2021/09/27 10:37]
admin
+++ pergamonmystic:linkedhelp:edit_multi_value [2021/09/27 11:27] (current)
admin
@@ Line 19: / Line 19: @@
 The text box is a search-trigger, so immediately on pressing the 1st key, the normal popup-search dialog will be displayed - simply keep typing in order to gradually narrow-down the possible words. If the required word appears as the only selection in the list, just press **[ENTER]** to accept it and add it to the multi-value control.
-Full use of the pop-up dialog can be viewed below, and is identical to its use in the
+If the word is new and is not found by the pop-up dialog, just keep typing until the entire word or phrase required has been entered - when finished, press **[ENTER]** to create the word or phrase as a new entry and attach it to the multi-value control.
-==== Adding a New Keyword Immediately ====
-It is possible to immediatel
+Full use of the pop-up dialog can be viewed at the bottom of this article in **Using the Pop-Up Dialog**, and is identical to its use in the [[PergamonMystic:linkedhelp:manage_lookup_popup|dynamic drop-down]].
 ----
-==== Using the popup-dialog ====
-==== Selecting From A Large Range ====
+==== Editing Qualifiers ====
-{{:pergamonmystic:linkedhelp:mystichelp_dynamicdrop_0003.jpg?direct&200 |}}
+{{:pergamonmystic:linkedhelp:mystichelp_multivalue_0002.jpg?direct&200 |}}
-If the range of possible options is excessive (such as Series Title or Keywords), clicking the **[?]** part of the drop-down will display a dialog to allow a full search of the possible values. The dialog is also displayed if you select the **[Search Dialog]** option from the context sensitive menu (see above).
+Some values that can be attached to multi-value controls require qualification - in other words, for what purpose are they being attached?
-Depending upon the nature of the options requested, the list may remain empty on initial display of the dialog or may load all of the values possible. In order to perform a search for possible values or to otherwise filter the list of values being displayed, enter text into the search pattern field.
+Keywords naturally have only one purpose and therefore do not have qualifiers, but contributors are often authors, editors, illustrators etc. depending upon the item.
-In order to select an option, double-click the value in the list.
+{{:pergamonmystic:linkedhelp:mystichelp_multivalue_0003.jpg?direct&200 |}}
+When selecting a value from one of these types of lists, the default qualifier is initially used (e.g. Author, in the case of contributors) with that qualifier indicated on the attachment. If you need to modify the qualifier, click the indicator (e.g. **[Au]** in the case of **Au**thor and select a different qualifier from the list.
-A number of additional operations can be triggered from with thin the search field using the keyboard:
+----
-=== [ESC] ===
+==== Displaying the Content Editor ====
-Pressing the escape key will close the dialog without performing any action. The currently selected value in the drop-down will be unchanged.
-=== [SHIFT]-[ESC] ===
+{{:pergamonmystic:linkedhelp:mystichelp_multivalue_0004.jpg?direct&200 |}}
-Pressing the escape key with the **[SHIFT]** key at the same time selected the 'none' value. The current value in the drop-down is removed and replaced with no value selected.
-=== [ENTER] ===
+If you wish to edit the entire contents of the multi-value control at one time, it is possible to display the [[PergamonMystic:linkedhelp:manage_lookup_content|Manage Lookup Content]] editor which provides the ability to add and remove values, search for and create new values all in one dialog.
-Pressing the enter (return) key can have one of two possible actions:
+To do so, click the **[+]** symbol to display the content editor. Use the editor to edit the right hand side of the list then click **[Save]** to update the multi-value control all in one go.
-    * If there is a single value in the list, that value is selected and returned to the drop-down.
+----
-    * If there are no matching results in the list, pressing enter (return) signifies that you want the current text entered to represent a new value in the list - the value is created and passed back to the drop-down as the new selection.
-=== [SHIFT]-[ENTER] ===
-Usually, text entered in the search is shorter than the possible options - entering '//america//' for example would find '//american//', '//south america//', '//america dance//' etc. and display these in the results list. Unfortunately, this effectively prevents the new text (//america//) from being selected or created as a new entry as pressing **[ENTER]** by itself will select the first entry in the list.
-By pressing **[SHIFT]-[ENTER]**, you tell the dialog that you want to select and create the current value, as it currently exists in the search text field.
+==== Removing Values ====
-=== Using the ~ (tilde) Prefix ===
+If you wish to remove a value from the multi-value control, simply click the **[X]** symbol next to the value that you wish to remove.
-Usually, the search field will only perform actions with a minimum number of characters entered (usually more than 3). This reduces the number of searched and the amount of data passed back to the list when the range of possible options is exceptionally high. By entering the tilde (~) character at the beginning of the text, a search is forced regardless of the the text length, even if it less than the minimum - this enabled searches of words such as 'US', 'UK', 'SAS', 'FBI' etc.
+Note that the value is removed from this control, but is not removed from the database - other locations where this value is in use are therefore not affected.

Pergamon Wiki

User Tools

Site Tools

Differences

Page Tools