Creating an application data stream definition

From the Common Data Provider tab in the Z Common Data Provider Configuration Tool, you can create an application data stream definition to use in a policy.

Procedure

To create an application data stream, complete the following steps:

  1. In the Configuration Tool, click the MANAGE CUSTOM DATA STREAM DEFINITIONS button.
  2. In the resulting Manage Custom Data Stream Definitions window, click the Create application data stream definition box.
  3. In the resulting Define Application Data Stream window, provide values for the following fields:
    Name
    Specifies the name of the data stream.

    This name is converted to uppercase characters when it is saved.

    The Name value must contain only alphanumeric characters and underscores. The maximum length is 243 characters.

    Group
    In the Configuration Tool, the data stream is included in the list of categorized data streams under the main category Customer Data Streams. For the hierarchy under Customer Data Streams, you must specify the group and subgroup under which you want to include the data stream. The value of Group specifies the group. The following example illustrates the hierarchy, and indicates that MYGROUP is specified as the Group value:
    • Customer Data Streams
      • MYGROUP

    The Group value is case-insensitive. For example, if you specify MyGroup as the value, and a group that is named MYGROUP exists under the main category Customer Data Streams, the Configuration Tool includes the data stream under MYGROUP, and does not create the category MyGroup.

    The Group value must contain only alphanumeric characters and underscores. The maximum length is 243 characters.

    Subgroup
    In the Configuration Tool, the data stream is included in the list of categorized data streams under the main category Customer Data Streams. For the hierarchy under Customer Data Streams, you must specify the group and subgroup under which you want to include the data stream. The value of Subgroup specifies the subgroup. The following example illustrates the hierarchy, and indicates that MYSUBGROUP is specified as the Subgroup value:
    • Customer Data Streams
      • MYGROUP
        • MYSUBGROUP

    The Subgroup value is case-insensitive. For example, if you specify MySubGroup as the value, and a subgroup that is named MYSUBGROUP exists under the group, the Configuration Tool includes the data stream under MYSUBGROUP, and does not create the category MySubGroup.

    The Subgroup value must contain only alphanumeric characters and underscores. The maximum length is 243 characters.

    Tags
    Specifies the source or format of the data in the data stream. You can use tags to remind you of the source or format.
    If you specify multiple values, you must list one tag per line, as shown in the following example:
    
    CSV
    Split
    

    Any tags that you specify are shown in the Configuration Tool on the data stream and transform nodes.

    If the data is being sent in split format, specify the tag Split.

    If the data is in CSV format, specify the tag CSV.

    The Tags value is case-sensitive and must contain only alphanumeric characters and underscores.

  4. Click OK.
    The data stream is created and available to be included in policies.

What to do next

Add the custom data stream to your policy. For information about creating or updating a policy, see the following information:

Use the Open Streaming API to send your application data to the Data Streamer and stream it to analytics platforms. For more information, see Sending user application data to the Data Streamer.