User Defined Storage (Magic xpi 3.x)
Magic xpi's User Defined Storage (UDS) lets you define multi-dimensional storage tables (arrays). You can use these definitions in your integration flows to store and retrieve multi-instance data types.
UDS data is stored in the memory, and is therefore available to the current running flow only. However, you can receive the UDS data as a BLOB to enable you to use it at a later stage. First you define the UDS models in the UDS Repository. You can then use them in flows by defining flow variables based on the UDS models.
To use the UDS feature:
-
Select the Project menu, then click UDS. The UDS Repository opens. Alternatively, you can open the UDS Repository dialog box by pressing SHIFT+F10.
-
The UDS Repository is divided into two halves. The left pane contains the following properties:
|
|
|
|
Name
|
The name that you define for a specific UDS model. For example, Customer.
|
|
Description
|
A description of the UDS model, as defined by you. You can include information designed to help you identify a particular UDS model, or you can enter a short description of the UDS model's function.
|
-
The right pane is the Fields table. These fields define the arrays belonging to the UDS model that you just added in the left pane. It contains the following properties:
|
|
|
|
Name
|
The name of the property. For example, CustomerName.
|
|
Type
|
Select one of the following types from the drop-down menu:
-
Alpha
-
Numeric
-
Date
-
Time
-
BLOB
-
Logical
For example, you would select Alpha to correspond with the CustomerName.
|
|
Length
|
The maximum length of the field.
|
|
Index
|
This lets you sort the UDS according to a specific field. For example, you can decide to sort the records based on the CustomerName entered in the Name column.
|
|
Default Value
|
Enter a default value here. For example, you could enter a specific customer name or a specific order date.
|
Note:
|
This field accepts explicit values only. Functions, expressions, variables, and logical names are not allowed. If the entered value is not explicit, the Checker will return an error.
|
|
|
-
Each pane has its own New and Delete buttons. These are used for adding and deleting UDS models, and their fields, from the UDS Repository.
-
When you have finished entering your required UDS models, click OK to save your entries and to close the UDS Repository. Alternatively, you can click Cancel to exit the UDS Repository without saving any new entries.
|
Note:
|
-
Once you define UDS models in the UDS Repository, they will be added to the list of the flow variable types (in the Variable repository's Type column).
-
UDS variables can only be defined as flow variables.
|
|
|
|
Since version:
|
V3
|
Using the UDS in a Flow
UDS and the Data Mapper
UDS and the Flow Data Service
UDS Functions
UDS Properties
UDS Table – Debugger
