Salesforce

Node Properties (Magic xpi 3.x)

« Go Back

Information

 
Created ByKnowledge Migration User
Approval Process StatusPublished
Objective
Description

Node Properties (Magic xpi 3.x)

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:

Property

Description

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.

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:

  • All Destination types.

  • The Database Source type.

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:

Property

Description

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:

Property

Description

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.

Since version: V3.1

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.

Reference
Attachment 
Attachment