Site-wide User ID Configuration#
User IDs can be configured through JSON configuration files. This is useful if you wish to deploy a shared set of user IDs that should be present on various item types.
Configuration location for individual users#
To deploy a user ID configuration for a single user, deploy a JSON configuration file (documented below) to:
%appdata%\Algenta\Colectica\UserIds.json
Configuration location for all users#
To deploy a user ID configuration for all users on a machine, deploy a JSON configuration file (documented below) to:
%programdata%\Algenta\Colectica\UserIds.json
Configuration file format#
The user ID configuration file is a simple JSON format that specifies which user ID types should appear by default for which item types. A sample file looks like this:
{
"DefinedUserIds": [
{
"Label": "Study",
"ItemType": "30ea0200-7121-4f01-8d21-a931a182b86d",
"UserIds": [ "Study Number", "DOI" ]
},
{
"Label": "Data Collection",
"ItemType": "c5084916-9936-47a9-a523-93be9fd816d8",
"UserIds": [ "Survey Code" ]
}
]
}
Properties#
- Label
The Label property is optional, but can be useful to provide a human-readable name for the item type.
- ItemType
The ItemType property specifies the item type for which the user IDs should be displayed. For a list of valid item types, see Item Type Identifiers.
- UserIds
The UserIds property is an array of user ID types that should be displayed for the item type.