Adding File Node

You can use the File node to specify the name of the output EIWM file for the objects. If an object is not added to a File node, the name generated EIWM file for the object is in the following format: <Name of the exported grid>_<File Suffix>.xml

If an object is added to a File node, the generated EIWM file for the object is in the following format: <File Name>_<File Suffix>.xml. If you have added a folder name, a folder by the given name is created in the staging area.

You can modify the default mapping or specify another mapping for the file.

To define the file mapping:

1. Click the Grids, DB Views, Drawings, Datasheets or Reports tab depending on for what you want to define the mapping.

2. Select the required class from the Current Mapping list. The default mappings for the class, if any, are displayed in the EIWM Object Mapping area on the EIWM tab.

3. If you want to add the File node to an Object ID node, select the required Object ID node, right-click and select File. Else, right-click anywhere on the empty space in the EIWM Object Mapping area, and select Add File. The File node with or without a default mapping is displayed.

   

4. Select the root of the file tree File. The Name, Template ID and Folder name areas appear.

   

5. For the Name area, do one of the following:

   • If you want to specify the mapping value for the file name directly, select the Constant option and enter a value in the Text box. The specified value is added to the EIWM Object Mapping area.

   • If you want to derive the mapping value from the value of an attribute, select the From Attribute option and select an attribute from the Attribute name list. The attribute is added to the EIWM Object Mapping area.

   • If you want to derive the mapping value from a PML expression, select the From PML option and enter a PML expression in the PML Expression box. The PML expression is added to the EIWM Object Mapping area.

6. For the Template ID area, do one of the following:

   Note: The value of Template ID is added to each generated EIWM file as information about the file. For example, the template ID can be used by AVEVA™ Asset Information Management to find out which file is the latest.

   • If you want to specify the mapping value for the template ID directly, select the Constant option and enter a value in the Text box. The specified value is added to the EIWM Object Mapping area.

   • If you want to derive the mapping value from the value of an attribute, select the From Attribute option and select an attribute from the Attribute name list. The attribute is added to the EIWM Object Mapping area.

   • If you want to derive the mapping value from a PML expression, select the From PML option and enter a PML expression in the PML Expression box. The PML expression is added to the EIWM Object Mapping area.

7. (Optional) For the Folder name area, do the following:

   • If you want to specify the mapping value for the folder name directly, select the Constant option and enter a value in the Text box. The specified value is added to the EIWM Object Mapping area.

   • If you want to derive the mapping value from the value of an attribute, select the From Attribute option and select an attribute from the Attribute name list. The attribute is added to the EIWM Object Mapping area.

   • If you want to derive the mapping value from a PML expression, select the From PML option and enter a PML expression in the PML Expression box. The PML expression is added to the EIWM Object Mapping area.

     Note: The nodes without a mapping are displayed in red. Invalid file name characters (* ? " < > |) are replaced with an underscore ("_").

Adding Information to File Node

To add information to the File node, you can either modify the default mappings or specify new mappings. Right-click the File node and select the required option.

You can add metadata, IF condition and object to a File node. For information about how to add metadata, see below. For information about how to add an IF condition, see Adding IF and FOR EACH Statements, and for information about how to add an object, see Mapping Object ID.

Note: Click Remove to remove the File node.

Adding Metadata to File Node

You can add metadata to the file by using the Add Metadata option.

To add metadata to the File node:

8. Right-click the File node, and select Add Metadata. The Metadata node is added.

9. Select the node. The name area is displayed.

   

10. For the Name area, do one of the following:

    • If you want to specify the mapping value for the name directly, select the Constant option and enter a value in the Text box. The specified value is added to the EIWM Object Mapping area.

    • If you want to derive the mapping value from the value of an attribute, select the From Attribute option and select an attribute from the Attribute name list. The attribute is added to the EIWM Object Mapping area.

    • If you want to derive the mapping value from a PML expression, select the From PML option and enter a PML expression in the PML Expression box. The PML expression is added to the EIWM Object Mapping area.

      The metadata is added to the File node.

Add Metadata for AVEVA Ingestion Service

You can use the Add Metadata option to add metadata for AVEVA Ingestion Service. The options you specify here override the default options for AVEVA Ingestion Service and those specified through the General tab. For information on how to specify the AVEVA Ingestion Service options through the General tab, see Additional Settings for AVEVA Ingestion Service in Providing General Information.

The following Name values are reserved for AVEVA Ingestion Service:

• FILE_NAME - STRING

• CONTEXT - STRING

• SOURCE - STRING

• TARGET - STRING

• PUBLISH_ORIGINAL - true/false

• PUBLISH_REFERENCE - true/false

• PUBLISH_RENDITION - true/false

• DOCUMENT_IDENTIFIER - STRING

• REGISTER_IDENTIFIER - STRING

• FILE_REVISION_KEY - STRING

The following image shows three options for AVEVA Ingestion Service.