Differences

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

--- transformations:sharedmemory [2021/10/17 16:37] – craigt
+++ transformations:sharedmemory [2023/10/13 23:08] (current) – craigt
@@ Line 8: / Line 8: @@
   * Remember a value by a key
   * Forget a value and its associated key
+  * Recall a list of keys
   * Recall a value by key
   * List keys and values
@@ Line 35: / Line 36: @@
 =====Action settings=====
 ^Setting^Description^
-|Command|Select the operation to perform on the shared memory repository.  Options:  //Remember//, //Recall//, //Forget//, and //List//.|
+|Command|Select the operation to perform on the shared memory repository.  Options:  //Remember//, //Recall//, //Recall a list of keys//, //Forget//, and //List//.|
 \\
@@ Line 56: / Line 57: @@
 |Append column|When //unchecked//, the output dataset will be a single cell containing the recalled value in a column named as selected\\ above.  When //checked//, a new column will be appended to the incoming dataset with the recalled value appearing in each row. |
 <sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\
+\\
+====Recall a list of keys settings====
+Description:  Retrieve the values of the shared memory keys listed within a column.
+^Setting^Description^
+|Column name|Select the column that contains a list of fully qualified shared memory keys.|
+|If a key doesn't exist|Select how EasyMorph will handle cases where the listed key does not exist in shared memory.\\  Options: //Fail// (the workflow stops with an error message) or //Return error// (the workflow continues, but an error message is returned in the "Value" column). |
 \\
@@ Line 110: / Line 118: @@
 Below is a sample process for manipulating the shared memory.
-**Store values:**\\
+===STORE VALUES:===
 > Command:  REMEMBER
 > Key:  mykeys\key1
@@ Line 119: / Line 127: @@
 > Value:  200
-\\
+\\ \\
-**List keys-values:**\\
+===LIST KEYS-VALUES:===
 > Command:  LIST
 > Keys start with:  mykeys
@@ Line 129: / Line 137: @@
 |mykeys\key2|200|17-Oct-2021|UserName  |
-\\
+\\ \\
-**Retrieve a value:**\\
+===RETRIEVE A VALUE:===
 > Command:  RECALL
 > Key:  mykeys\key1
@@ Line 138: / Line 146: @@
 |100|
-\\
+\\ \\
-**Clear a key-value pair:**\\
+===CLEAR A KEY-VALUE PAIR:===
 > Command:  FORGET
 > Key:  mykeys\key1
+\\
+^Key^Value^Last changed^Changed by^
+|mykeys\key1|100|17-Oct-2021|UserName  |
+|mykeys\key2|200|17-Oct-2021|UserName  |
+\\ \\
+===RECALL A LIST OF KEYS:===
+Current dataset:
+^Key_List ^
+|mykeys\key1  |
+|mykeys\key2  |
+|mykeys\key3  |
+|otherkeys\keyAA  |
+|otherkeys\keyBB  |
+\\
+> Command:  RECALL A LIST OF KEYS
+> Column name:  Key_List
+\\
+^Key_List ^Value ^
+|mykeys\key1  | 100|
+|mykeys\key2  | 250|
+|mykeys\key3  | 700|
+|otherkeys\keyAA  |Mark  |
+|otherkeys\keyBB  |Mary  |
+\\