Node Properties (Magic xpi 4.1)
To access the Node Properties dialog box, double-click a Source or Destination node (or right-click and then select Properties from the context menu).
The Node Properties dialog box displays full details of the selected node. The details are described in the table below.
You can also define the value for a Source or Destination directly in the Node Properties dialog box. If you do this, you do not need to map Source data to the node.
You can click the button next to the Calculated Value field to open the Expression Editor. This lets you use functions, mathematical and logical signs, variables, and connected nodes to create an expression that defines the node's value. You can also directly enter an expression in the Calculated Value field.
|
Note:
|
-
If you add a condition or map a compound element, you have the option to update variables in the Advanced tab. If you do not map any simple element under this compound, the variables are not updated.
-
You cannot select a variable that was already selected in another node.
|
|
The Node Properties dialog box's General tab displays the following information:
|
|
|
|
Attributes
|
|
Node Type
|
This field indicates whether the node is simple or compound. This is an informational display and cannot be edited.
|
|
Name
|
This field displays the name of the node. The name of the node is the name of the element in the Source or Destination data. This is an informational display and cannot be edited.
|
|
Path
|
This field displays the path where the node is located. This is an informational display and cannot be edited.
|
|
Data Type
|
The data type of the selected Source or Destination. This is an informational display and cannot be edited.
|
|
StringDate (for the datetime field in databases only)
|
If you select this check box, the internal attribute (below) becomes an Alpha type. This enables the field to contain both the date and the time. If you select this option, you will need to make some changes to the data_types.xml file, which is located in the Magic xpi root folder. To learn how to do this, click here.
|
|
Internal Attribute
|
This describes the attribute used when you want to convert the Data type into a Magic xpi internal type. This property will override the default set in the Default Data Format dialog box. This is an informational display and cannot be edited.
|
|
Content Encoding
|
This field lets you define the encoding of a node's variables when you map a value to a Data Mapper variable or select Call Flow as a Destination type.
For BLOB variable data types, select one of the following from the drop-down list:
-
ANSI
-
Unicode
-
Binary (default)
For Alpha variable data types, select one of the following from the drop-down list:
Since version: 4.0a
|
|
Picture
|
The length of the data. For example, if the digit 9 is entered the node can have nine or less characters.
-
For Source nodes, this is an informational display and cannot be edited.
-
For Destination nodes only. If the node is mapped to a Source, or a value is entered in the Calculated Value field, you can change the picture value.
|
|
Replication
|
Select this check box to enable the replication of Data Mapper compound nodes. For more information on how to do this, click here.
|
|
Always Use The New Picture
|
Select this check box when you change the picture in the Picture field of this dialog box, and you want to be sure that the value you entered is always used.
This check box is available for a mapped element in:
|
|
Log Error (this is enabled only when working with databases)
|
Click  to select the variables that will accept the input data in the Exception Handling Flow.
|
Note:
|
You should make sure that you have previously defined the variables that will accept the input data in the Exception Handling Flow.
|
|
|
|
Execute Condition
|
|
Condition
|
You can define a condition to decide when this mapping directive will be executed in deployment. If there is no condition, it will always be executed. This is only relevant when the Destination type is XML.
Click  to open the Expression Editor, and to enter a condition.
|
|
Values: This is available for the Node Properties of simple nodes only.
|
|
Calculated Value
|
Often, the result that you want to place in a variable cannot be fetched from a single value, but needs to be fetched from a number of different parameters. This is where calculated values need to be used. These are variables that are updated using an expression to determine the actual value.
Click to open the Expression Editor. Use this to enter an expression or a fixed value.
This is available for Destination data only.
|
The Node Properties dialog box's Advanced tab displays the following information:
|
|
|
|
Description: Enter a description for the node's properties.
|
|
Compound Level Computation: This is relevant for compound nodes only. This section is not displayed when you are working with simple nodes. Compound level functionality lets you update any variable while looping a Destination compound. During deployment, the updates are executed according to their sequence. Click New to open a new line. Compound level computations run before conditions on node properties.
|
|
Variable Name
|
Click to open the Variables List. Select the required variable, and click Select.
|
|
Expression
|
Click to enter an update for your selected variable.
|
|
Condition
|
Click to define when the variable update takes place.
|
The Node Properties dialog box's Additional XML properties tab displays the following read-only information from the schema:
|
|
|
|
Attributes:
|
|
Namespace prefix
|
The node's namespace prefix, which can be used as an alias for the node's namespace. This is an informational display and cannot be edited.
|
|
Namespace
|
The node's namespace. A namespace is a collection of names, identified by a URI reference, that are used in XML documents as element types and attribute names. This helps to differentiate XML documents from different Sources so they can be read by the Data Mapper. This is an informational display and cannot be edited.
|
|
Max length
|
The number of characters for alphanumeric field types.
|
|
Default/Fixed value
|
The default or fixed value for the field.
|
|
Total digits
|
The total number of digits, before and after the decimal point.
|
|
Fraction digits
|
The number of digits after the decimal point.
|
|
Max occurrences
|
This property is retrieved from the schema. It refers to the maximum number of node occurrences that are allowed.
For example, if the schema's Max occurrences=3, the XML that is based on that schema can include up to three occurrences at the most.
|
|
Min occurrences
|
This property is retrieved from the schema. It refers to the minimum number of node occurrences that are allowed.
For example, a valid XML schema can be generated only if Min occurrences=1 (at least).
|
|
Nillable
|
If the value of this attribute is 'true' on an element declaration, then the content of an instance of this element may be flagged as being null in an instance by the xsi:nil attribute on the instance element. This property appears for simple elements only.
|
|
Documentation: This section contains the documentation that is relevant to the field.
|
|
Enumerations: This section displays a predefined list of available values for this node.
|
