Skip to main content

Use Metadata Macros

Any metadata captured in Nexsets can also be used in macros. This section provides instructions for capturing metadata in a Nexset as well as using that metadata in macros within Nexla.

Metadata can be added to automatically detected and/or transformed Nexsets.

How to Add Metadata to a Nexset

    • To create a new Nexset that contains metadata information from a detected Nexset, click the Transform icon Transform.png on the Nexset to which metadata should be added. This will open the Nexset in the Nexset Designer.

        Transform_Nexset.png

    • To add metadata information to an existing transformed Nexset, find the Nexset in My Data Flows, and click Open_Menu.png to open the Nexset menu.

    1. If the Nexset is active, click Pause.png to pause the Nexset. Then, click Open_Menu.png on the Nexset again.

        Pause_Nexset.png

    2. Click Edit.png to open the Nexset for editing in the Nexset Designer.

        Edit_Nexset.png

  1. Click the Add_Rule_Group.png button in the Nexset Rules panel in the middle of the screen, and select Transform.png from the menu that appears.

      Rule_Group_Menu.png

  2. In the Function pulldown menu, select "Equal to Attribute".

      Function_Menu.png

  3. Under "Equal to", select "Metadata" from the pulldown menu.

      Equal_To_Menu.png

  4. The Apply on Attribute pulldown menu lists all metadata attributes available for the selected Nexset. Select the metadata type that should be added to the output Nexset from this menu.

      Metadata_Menu.png

  5. Enter a name for the output metadata attribute in the Output Attribute Text field.

      Output_Attribute.png

  6. Click Run_Nexset_Rules.png in the top right corner of the Nexset Rules panel to generate a preview of the output metadata attribute values in the Nexset Output panel on the right.

  7. Optional: To include additional metadata attributes in the output Nexset, click Add_New_Transform.png at the bottom of the rule group, and repeat Steps 3-7 in this section.

      New_Transform.png

  8. Optional: When including metadata to a new output Nexset, ensure that all other needed attributes are also included in the output Nexset. This can be done within the same Transform rule group or by adding one or more new groups for easier viewing.

    For more information about adding output attributes to Nexsets, see the Nexset Designer Overview article in the Help Center.

Metadata Macros in API Calls

  1. To incorporate a metadata macro when sending a Nexset that contains metadata attributes to an API destination, type a left curly bracket, {, at the position where the macro should be added in the URL field. This will open a dropdown menu containing all available macros that can be added.

    Metadata macros available for the selected Nexset will be listed under the "Data Attributes" category.

      Metadata_Macros.png

  2. To add a metadata macro listed in the dropdown menu to the URL field, click on the macro in the list, and it will be added at the current position.

      Add_Macro3.png