Create and manage push data structures

Learn how to create and manage your push data structures in MXO.

Push data structures are used by data adapters to send data to other systems. For example, to create a lead in a CRM based on a customer requesting a quote on an organization's website.

Create a push data structure

To create a push data structure, follow these steps:

  1. In MXO go to Configure > Data structures.

  2. Click + Create.

  3. Select Push as the type of structure you want to create.

  4. Click Let's get started.

  5. Provide the following details for your structure:
    FieldDescription
    NameA unique name for this structure.
    DescriptionOptional. A description for this structure.

  6. Select the purpose for which you want to use this structure from the corresponding drop-down.

  7. Provide values for any required attributes.

  8. Create your data structure. Click the plus button next to your data structure and select one of the following:
    FieldDescription
    Data attributeA single item of data. For example, age, gender, email address.
    NodeOrganizes your structure into nodes to make it easier to view the information it contains.
    List nodeEnables you to push lists of data to external systems. For example, the positive and negative click counts for a list of actions. Select the list to use in your structure.
  9. Add any data attributes you want to make available to the external system. Provide the following details for each data attribute:
    FieldDescription
    Attribute nameA name for the attribute that is easily identifiable by the external system. Attribute and node names must be unique against other attributes in the same parent node. For example, you can have a customer_name attribute inside the root node, and another customer_name attribute inside a sub-node. Names cannot contain any spaces and are subject to XML validation.
    Attribute valueThe value to send as an attribute to the external system. You can use any AEP data items available in the Data Item Picker (MXO filters out any items not considered to be AEP data items, such as functions and action attributes), any data items derived from eligibility rules, or any hardcoded value. Any value entered directly into the attribute value field is passed to the external system as a hardcoded value.
    Value typeThe value type. You can choose between a string, numeric, date, or boolean value. MXO identifies the value type automatically, based on the data type of any attribute you select using the Data Item Picker.
    You can remove a data attribute by hovering over it and clicking the minus icon on the right side.

  10. Click Save to finish the creation process.

Note: You can organize your structure into nodes to make it easier to view the information it contains, as shown in the example scenario.

Edit a data structure

To edit a data structure, follow these steps:

  1. In MXO, go to Configure > Data Structures.

  2. Click the data structure you want to open for editing.

  3. Edit the data structure as required.

  4. Click Save to finish the editing process.

Note: You must republish whenever you make changes to your structure for those changes to be reflected in your other systems. This may require changes to any of the systems requesting this structure.

Copy a data structure

From time to time you may want to clone an existing structure, rather than creating a new one from scratch. To copy a data structure, follow these steps:

  1. In MXO, go to Configure > Data Structures.

  2. Find the desired data structure in the list and click copy iconCopy. The data structure editor opens.

  3. Rename the new data structure and make any other required changes.
  4. Click Save to finish the cloning process.

View data structure dependencies

To see a list of the dependencies associated with a data structure, follow these steps:

  1. In MXO, go to Configure > Data Structures.

  2. Find the desired data structure in the list and click dependencies icon Dependencies.

  3. In the modal window that appears, you can see the list of dependencies for that data structure. You may click any dependency to open it in a new window and edit or remove it. Then, click Refresh to reload the dependencies list.

  4. Click Ok in the modal window to close it.

Delete a data structure

To delete a data structure, follow these steps:

  1. In MXO, go to Configure > Data Structures.

  2. Find the desired data structure in the list and click delete icon Delete.

  3. If the data structure is associated with one or more entities, the modal window that appears will show the dependencies list and block the deletion process. Access each dependency and remove the association before deleting the data structure. Then, click Refresh to reload the dependencies list and ensure you have removed them all.

  4. Click Delete to complete the deletion process.