Creating Enact Part Definition Data Collector

The Enact Part Definition Data Collector acquires part definitions from the data source (for example, DMS) and compiles them into Enact parts.

When adding or modifying a Enact Part Definition Data Collector, the Enact Part Definition dialog box opens.

1. To configure the Enact Part Definition Data Collector, do the following:

   • General Tab

     Under the General tab, you can enable the Enact Part Definition Data Collector, set the unique name, and configure the data destination.

     1. To enable the data collector, click the Enabled checkbox.

     2. To run the data collector as a service, click to check the Run in Background checkbox.

        Do not uncheck the Run in Background checkbox. The prompting functionality does not work in the Enact Part Definition Data Collector.

     3. In the Configuration Name data field, type the identification name. Ensure the name is unique and descriptive.

     4. To configure the data destination, click and configure the desired destination, as follows:

        • Enterprise Integration System

          You can browse to the destination of the IDEF file, which can be subsequently processed by Enterprise Integration System.

          1. Click the ellipsis button (...).

          2. Browse to and click the folder where you want to store IDEF files.

          3. Click the OK button.

        • Enact

          After interfacing DCS to Enact, you can deliver data to Enact using a web-based transport.

          For more information on interfacing DCS to Enact, please see Configuring DCS for Enact.

   • Sampling Tab

     Under the Sampling tab, you can set when and how often DCS imports data from DMS.

     1. To associate the data collection with a specific DMS item, establishing the circumstance that causes a sample to be taken, click the Add button and then do the following:

        1. In the Tag Item data field, do the following:

           1. Click the DMS Item Selection button.
           2. In the DMS Item Selection dialog box, click the desired DMS tag item.
           3. Click the OK button.

        2. In the Evaluation drop-down list, click the desired comparison:

           • IS NEW. TRUE if current data collection is new when compared to the previous data collection.
           • <. TRUE if the value in the Tag Item data field is less than the value in the Value 2 data field.
           • <=. TRUE if the value in the Tag Item data field is less than or equal to the value in the Value 2 data field.
           • =. TRUE if the value in the Tag Item data field equals the value in the Value 2 data field.
           • <>. TRUE if the value in the Tag Item data field is not equal to the value in the Value 2 data field.
           • >=. TRUE if the value in the Tag Item data field is greater than or equal to the value in the Value 2 data field.
           • >. TRUE if the value in the Tag Item data field is greater than the value in the Value 2 data field.
           • Is Valid. TRUE if the value in the Tag Item data field is valid for the data type (for example, date data type contains a date, number data type contains a number).
           • Is Blank or Invalid. TRUE if the value in the Tag Item data field is blank or is invalid for the data type.

        3. In the Value 2 data field, do one of the following:

           • Type the comparison value for this condition.

           • Type the item name and tag name in this format:

             %TAG(Type, ItemName.TagName)

             For assistance locating the item name and tag name, do the following:

             1. Click the DMS Item Selection button.
             2. In the DMS Item Selection dialog box, click the desired DMS tag item.
             3. Click the OK button.
        4. Click the OK button.

        To (Undefined variable: Snippet.Action) DMS item triggers, click the desired DMS item trigger, and then click the (Undefined variable: Snippet.ButtonName) button. To (Undefined variable: Snippet.Action) DMS item triggers, click the desired DMS item trigger, and then click the (Undefined variable: Snippet.ButtonName) button.

     2. To switch the Enact Part Definition Data Collector to an Idle State after an interval of inactivity (which could trigger a feedback action), click the Enabled checkbox, and then do the following:

        1. Using the Interval data field, set the interval value.
        2. Using the Unit data field, set the interval time measurement (Seconds, Minutes, Hours, Days, Weeks, Months, Quarters, or Years).

        For example, if you set the idle interval to 10 Minutes and the Enact Part Definition Data Collector doesn’t collect for 10 minutes, it switches to an Idle State.

        • Sampling Example 1

          Sampling on NEW Part, Idling after 1 Day

          

          • On Thursday, December 14, at 7:33 AM, the Enact Part Definition Data Collector collects a new part, and then idles on Friday, December 15, at 7:33 AM after 1 day of inactivity.
          • On Friday, December 22, at 4:18 PM, the Enact Part Definition Data Collector collects a new part, and then idles on Saturday, December 23, at 4:18 PM after 1 day of inactivity.
        • Sampling Example 2

          Sampling when Part value is Blue Part, Idling after 2 Weeks

          

          • On Thursday, December 14, at 6:29 AM, the Enact Part Definition Data Collector collects a part value of Blue Part, and then idles on Thursday, December 28, at 6:29 AM after 2 weeks of inactivity.
          • On Thursday, December 28, at 3:01 PM, the Enact Part Definition Data Collector collects a part value of Blue Part, and then idles on Thursday, January 11, at 3:01 PM after 2 weeks of inactivity.
   • Descriptors Tab

     Under the Descriptors tab, you can set the descriptors imported by the Enact Part Definition Data Collector.

     1. To add a descriptor, click the Add button, click the desired descriptor, click the OK button, and then do the following:

        If the Descriptor Type dialog box does not display all of the descriptors above, you have already added the descriptor to the data collector.

        • Part

          For Destination: Enterprise Integration System, Enact

          Existing in Enact: If descriptor does not exist, DCS does not add new descriptor, records error

          Required: Yes

          Number Allowed: 1 per configuration

          Group / Item: Item only

          1. In the Language Label drop-down list, click the desired language, which configures DCS to write the incoming value to the selected language label.

             In the upper right corner, DCS displays a highlighted counter of the number of language labels you have set. Also, in the drop-down list, DCS displays a pointer (<) beside the languages with language labels.

             For more information, please see Language Labels (Parts).

          2. In the Short Name data field, do one of the following:

             • Type the part name value for the selected language.

             • Type the item name and tag name in this format:

               %TAG(Type, ItemName.TagName)

               For assistance locating the item name and tag name, do the following:

               1. Click the DMS Item Selection button.
               2. In the DMS Item Selection dialog box, click the desired DMS tag item.
               3. Click the OK button.
        • Description

          For Destination: Enterprise Integration System, Enact

          Required: No

          Number Allowed: 1 per configuration

          Group / Item: Item only

          1. In the Long Name data field, do one of the following:

             • Type the part description for the selected language.

             • Type the item name and tag name in this format:

               %TAG(Type, ItemName.TagName)

               For assistance locating the item name and tag name, do the following:

               1. Click the DMS Item Selection button.
               2. In the DMS Item Selection dialog box, click the desired DMS tag item.
               3. Click the OK button.
        • End Time

          For Destination: Enterprise Integration System, Enact

          Required: No

          Number Allowed: 1 per configuration

          Group / Item: Item only

          1. In the Item data field, do one of the following:

             • Type the end time value.

               Use the following time format: yyyy-mm-ddT00:00:00.

             • Type the item name and tag name in this format:

               %TAG(Type, ItemName.TagName)

               For assistance locating the item name and tag name, do the following:

               1. Click the DMS Item Selection button.
               2. In the DMS Item Selection dialog box, click the desired DMS tag item.
               3. Click the OK button.
          2. In the Source: Time Zone data field, click the radio button for the desired time zone source (Time (Local), Time (UTC), or Other) and then select the time zone.
        • Revision

          For Destination: Enterprise Integration System, Enact

          Existing in Enact: If descriptor does not exist, DCS adds new descriptor

          Required: No

          Number Allowed: 1 per configuration

          Group / Item: Item only

          In the Item data field, do one of the following:

          • Type the revision value.

          • Type the item name and tag name in this format:

            %TAG(Type, ItemName.TagName)

            For assistance locating the item name and tag name, do the following:

            1. Click the DMS Item Selection button.
            2. In the DMS Item Selection dialog box, click the desired DMS tag item.
            3. Click the OK button.
        • Start Time

          For Destination: Enterprise Integration System, Enact

          Required: No

          Number Allowed: 1 per configuration

          Group / Item: Item only

          1. In the Item data field, do one of the following:

             • Type the start time value.

               Use the following time format: yyyy-mm-ddT00:00:00.

             • Type the item name and tag name in this format:

               %TAG(Type, ItemName.TagName)

               For assistance locating the item name and tag name, do the following:

               1. Click the DMS Item Selection button.
               2. In the DMS Item Selection dialog box, click the desired DMS tag item.
               3. Click the OK button.
          2. In the Source: Time Zone data field, click the radio button for the desired time zone source (Time (Local), Time (UTC), or Other) and then select the time zone.
        • Tag

          For Destination: Enterprise Integration System, Enact

          Existing in Enact: If descriptor does not exist, DCS does not add new descriptor, records error

          Required: Yes

          Number Allowed: 1 per configuration

          Group / Item: Item only

          1. In the Language Label drop-down list, click the desired language, which configures DCS to write the incoming value to the selected language label.

             In the upper right corner, DCS displays a highlighted counter of the number of language labels you have set. Also, in the drop-down list, DCS displays a pointer (<) beside the languages with language labels.

             For more information, please see Language Labels (Tag Groups).

          2. In the Group data field, do one of the following:

             • Type the tag group value.

             • Type the group name and tag name in this format:

               %TAG(Type, GroupName.TagName)

               For assistance locating the group name and tag name, do the following:

               1. Click the DMS Item Selection button.
               2. In the DMS Item Selection dialog box, click the desired DMS tag item.
               3. Click the OK button.

          3. In the Value data field, do one of the following:

             • Type the tag value.

             • Type the item name and tag name in this format:

               %TAG(Type, ItemName.TagName)

               For assistance locating the item name and tag name, do the following:

               1. Click the DMS Item Selection button.
               2. In the DMS Item Selection dialog box, click the desired DMS tag item.
               3. Click the OK button.

     2. Click the OK button.

        To (Undefined variable: Snippet.Action) descriptors, click the desired descriptor, and then click the (Undefined variable: Snippet.ButtonName) button. To (Undefined variable: Snippet.Action) descriptors, click the desired descriptor, and then click the (Undefined variable: Snippet.ButtonName) button.

   • Part Families Tab

     Using the Part Families tab, you can link the incoming parts to part families and process models.

     The part family and process model must already exist in Enact, and the part family must be associated with the process model. If the part family and process model do not already exist in Enact, or the part family is not associated with the process model, the Part Definition Data Collector will write the parts to Enact but will not create links to the part family and process model.

     If the part already exists in Enact, the Part Definition Data Collector will not modify the part, but it will link the part to the part family and process model.

     1. To select the desired part family and process model to link to the incoming part, click the Add button and then do the following:

        1. In the Part Family (Name) data field, do one of the following:

           • Type the part family name.

           • Type the item name and tag name in this format:

             %TAG(Type, ItemName.TagName)

             For assistance locating the item name and tag name, do the following:

             1. Click the DMS Item Selection button.
             2. In the DMS Item Selection dialog box, click the desired DMS tag item.
             3. Click the OK button.

        2. In the Process Model (Name) data field, do one of the following:

           • Type the process model name.

           • Type the item name and tag name in this format:

             %TAG(Type, ItemName.TagName)

             For assistance locating the item name and tag name, do the following:

             1. Click the DMS Item Selection button.
             2. In the DMS Item Selection dialog box, click the desired DMS tag item.
             3. Click the OK button.

     2. Click the OK button.

        To (Undefined variable: Snippet.Action) part family links, click the desired part family, and then click the (Undefined variable: Snippet.ButtonName) button. To (Undefined variable: Snippet.Action) part family links, click the desired part family, and then click the (Undefined variable: Snippet.ButtonName) button.

   • Conditions Tab

     Under the Conditions tab, you can establish the circumstances that initiate data collection.

     1. To add a condition, click the Add button and then do the following:

        1. In the Type drop-down list, Global is the only option and is automatically selected, which means conditions are applied to every incoming value. If any of the conditions fail, the Enact Part Definition Data Collector ignores the incoming value.

        2. In the Tag Item data field, do one of the following:

           • Type the item value.

           • Type the item name and tag name in this format:

             %TAG(Type, ItemName.TagName)

             For assistance locating the item name and tag name, do the following:

             1. Click the DMS Item Selection button.
             2. In the DMS Item Selection dialog box, click the desired DMS tag item.
             3. Click the OK button.

        3. In the Evaluation drop-down list, click the desired comparison:

           • IS NEW. TRUE if current data collection is new when compared to the previous data collection.
           • <. TRUE if the value in the Tag Item data field is less than the value in the Value 2 data field.
           • <=. TRUE if the value in the Tag Item data field is less than or equal to the value in the Value 2 data field.
           • =. TRUE if the value in the Tag Item data field equals the value in the Value 2 data field.
           • <>. TRUE if the value in the Tag Item data field is not equal to the value in the Value 2 data field.
           • >=. TRUE if the value in the Tag Item data field is greater than or equal to the value in the Value 2 data field.
           • >. TRUE if the value in the Tag Item data field is greater than the value in the Value 2 data field.
           • Is Valid. TRUE if the value in the Tag Item data field is valid for the data type (for example, date data type contains a date, number data type contains a number).
           • Is Blank or Invalid. TRUE if the value in the Tag Item data field is blank or is invalid for the data type.

        4. In the Value 2 data field, do one of the following:

           • Type the comparison value for this condition.

           • Type the item name and tag name in this format:

             %TAG(Type, ItemName.TagName)

             For assistance locating the item name and tag name, do the following:

             1. Click the DMS Item Selection button.
             2. In the DMS Item Selection dialog box, click the desired DMS tag item.
             3. Click the OK button.

     2. Click the OK button.

        To (Undefined variable: Snippet.Action) conditions, click the desired condition, and then click the (Undefined variable: Snippet.ButtonName) button. To (Undefined variable: Snippet.Action) conditions, click the desired condition, and then click the (Undefined variable: Snippet.ButtonName) button.

   • Feedback Tab

     Under the Feedback tab, you can configure the Enact Part Definition Data Collector to trigger a read request, allowing it to notify DMS when it is ready for published data, OR send information back to the data source after satisfying a specific condition, whether the source is an OPC server, PLC, or some other equipment.

     The Enact Part Definition Data Collector actually writes the value to the selected DMS item, which means the DMS item must be writable.

     Data Source Configuration

     • OPC Server. If the source of the DMS Item is an OPC Server, the Enact Part Definition Data Collector posts the value to the OPC Server, which will subsequently post the value to the originating equipment, such as a shop floor PLC.
     • Grid Data Provider. If the source of the DMS Item is the Grid Data Provider via serial port or TCP/IP, the Enact Part Definition Data Collector posts the value through that port.
     • Counter Provider. If you click the Writable checkbox in the originating Counter Provider, the Enact Part Definition Data Collector posts the current counter value back to the Counter Provider, allowing the Counter Provider to track the most recently transmitted value.
     • [All Other Providers]. If you set the Feedback Type data field to Set Item Value for any other provider (for example, Bridge Provider, Clock Calendar Provider, Clock Events Provider, etc.), the Enact Part Definition Data Collector ignores the setting and will not send any values back to the originating provider.

     1. To add a feedback configuration, click the Add button and then do the following:

        1. In the Send Feedback if drop-down list, click the desired feedback condition:

           • Data Collector is Enabled. Processes feedback when the Enact Part Definition Data Collector state changes to Enabled.
           • Data Collector is Disabled. Processes feedback when the Enact Part Definition Data Collector state changes to Disabled or DCS is stopped.
           • Global Conditions Pass. Processes feedback when the Enact Part Definition Data Collector conditions pass (under the Conditions tab).
           • Subgroup is Saved. Processes feedback when the Enact Part Definition Data Collector saves data.
           • Idle Time Triggers. Processes feedback when the Idle interval elapses (under the Sampling tab).

        2. In the Feedback Type drop-down list, click the desired type of feedback:

           • Read Request. Notify DMS that the Enact Part Definition Data Collector is ready for published data, as follows:

             1. Click the DMS Item Selection button.
             2. In the DMS Item Selection dialog box, click the desired DMS tag item.
             3. Click the OK button.

           • Set Item Value. Send information back to the data source after satisfying a specific condition, as follows:

             1. In the DMS Item Name data field, do the following:

                1. Click the DMS Item Selection button.
                2. In the DMS Item Selection dialog box, click the desired DMS tag item.
                3. Click the OK button.

             2. In the Value data field, type the value posted to DMS.

                • DMS Item Value. Click the DMS Item Selection button to select a value from a pre-existing DMS item.
                • Non-Printable Characters. Click the ASCII button to build the value, including Math Functions if Data Type is set to Numeric.

             3. In the Data Type drop-down list, click the desired data type:

                • Numeric. The Enact Part Definition Data Collector processes the value prior to posting to DMS. If the value is 1+3, the Enact Part Definition Data Collector posts 4.
                • Text. The Enact Part Definition Data Collector posts the value "as is" to DMS. If the value is 1+3, the Enact Part Definition Data Collector posts 1+3.

     2. Click the OK button.

        To (Undefined variable: Snippet.Action) feedback configurations, click the desired feedback configuration, and then click the (Undefined variable: Snippet.ButtonName) button. To (Undefined variable: Snippet.Action) feedback configurations, click the desired feedback configuration, and then click the (Undefined variable: Snippet.ButtonName) button.

2. Click the OK button.