Manage data usage labels for a schema

IMPORTANT

Schema-based labeling is part of attribute-based access control, which is currently available in a limited release for US-based healthcare customers. This capability will be available to all Real-time Customer Data Platform customers once it is fully released.

All data that is brought into Adobe Experience Platform is constrained by Experience Data Model (XDM) schemas. This data may be subject to usage restrictions defined by your organization or by legal regulations. To account for this, the Platform allows you to restrict the usage of certain datasets and fields through the use of data usage labels.

A label applied to a schema field indicates the usage policies that apply to the data contained in that specific field.

While labels can be applied to applied to individual datasets (and fields within those datasets), you can also apply labels at the schema level. When labels are applied directly to a schema, those labels are propagated to all existing and future datasets that are based on that schema.

In addition, any field label that you add in one schema propagates to all other schemas that employ the same field from a shared class or field group. This helps to ensure that usage rules for similar fields are consistent across your entire data model.

This tutorial covers the steps for adding labels to a schema using the Schema Editor in the Platform UI.

Getting started

This guide requires a working understanding of the following components of Adobe Experience Platform:

  • Experience Data Model (XDM) System: The standardized framework by which Experience Platform organizes customer experience data.
    • Schema Editor: Learn how to create and manage schemas and other resources in the Platform UI.
  • Adobe Experience Platform Data Governance: Provides the infrastructure for enforcing data usage restrictions on Platform operations, using policies that define which marketing actions can (or cannot) be performed on labeled data.

Select a schema or field to add labels to

To start adding labels, you must first select an existing schema to edit or create a new schema to view its structure in the Schema Editor.

To edit the labels for an individual field, you can select the field in the canvas and then select Manage access in the right rail.

Select a field from the Schema Editor canvas

You can also select the Labels tab, choose the desired field from the list, and select Edit governance labels in the right rail.

Select a field from the Labels tab

To edit the labels for the entire schema, select the pencil icon () next to the schema’s name under the Labels tab.

Select the schema name from the Labels tab

NOTE

A disclaimer message appears when you first attempt to edit the labels for a schema or field, explaining how label usage affects downstream operations depending on your organization’s policies. Select Proceed to continue editing.

Label usage disclaimer

Edit the labels for the schema or field

A dialog appears that allows you to edit the labels for the selected field. If you selected an individual object-type field, the right rail lists the sub-fields that the applied labels will propagate to.

Selected fields displayed

NOTE

If you are editing fields for the whole schema, the right rail does not list the applicable fields and displays the schema name instead.

Use the displayed list to select the labels you want to add to the schema or field. As labels are chosen, the Applied labels section updates to show the labels that have been selected so far.

Applied labels displayed

To filter the displayed labels by type, select the desired category in the left rail. To create a new custom label, select Create label.

Filter displayed labels or create a new label

Once you are satisfied with your chosen labels, select Save to apply them to the field or schema.

Save the selected labels

The Labels tab reappears, showing the applied labels for the schema.

Field labels applied

Next steps

This guide covered how to manage data usage labels for schemas and fields. For information on managing data usage labels, including how to add them to specific datasets rather than at the schema level, see the data usage labels UI guide.

On this page