| Info |
|---|
As outlined in What are tags?, Tags can contain additional data (attributes), which can be uniquely set for each entity-tag (i.e. Tag applied to a person or a team). This is useful if you seek to have common Tag names, but “data” (i.e. attributes) that is unique to the person/team to which a tag is applied. This pages defines how to load unique entity-tag attributes. |
| Info |
|---|
Note: this is a special case of Tags With Attributes use. For more about importing Tags with Attributes, see: Bulk import Tags with attributes (common attributes). |
| Table of Contents | ||
|---|---|---|
|
About unique attributes for tags
...
attributes for tags
...
Tags
...
Tags with Unique Attributes to an Entity can then be added via tag type settings (manage tags):
...
Configuring tags attributes
...
Users can then associate values to the attributes when editing tags applied to a group or person. Navigate to a group or person page then select Edit tag.
...
Interaction Options for Unique Attributes
...
Optional - The attribute is not required, its value can be edited from the directory
Editable- not currently in useMandatory - The attribute must be provided when tagging a group or person, can be edited from the directory
Readonly - The attribute value cannot be edited from the directory
...
Importing unique attributes along with a tag import can be done using specific pre-processing instruction using the normal integration for tag import.
An example of CSV file and JSON field map is provided below.
JSON Field Map
The following example tags a
Required configuration for the import
...
"entityType": "person", “group” or “both”"preprocessor": "phoenixGenericTags""skipRemoveTagsFromEntity": false"removeExistingEntityTags": truefalse"forceUpdateSameTag": true"importShadowTag":false
...
| Code Block | ||
|---|---|---|
| ||
{
"entityType": "person",
"preprocessor": "phoenixGenericTags",
"skipRemoveTagsFromEntity": false,
"removeExistingEntityTags": truefalse,
"forceUpdateSameTag": true,
"importShadowTag": false,
"headerRowIdentifier": "Person ID",
"idType": "internalId",
"idColumnName": "Person ID",
"tagTypes": [
{
"tagValueColumnNames": [
"Tags"
],
"separator": "_"
"tagType": "FUNDING_SOURCE",
"entityTagAttributes": [
{
"attrValueColumnName": "FTE",
"label": "FTE"
}
],
}
]
} |
...