Import Associations
- Have a list of the usernames, levels, custom dimension values and related attributes that you want to associate. You can export these lists to keep them handy.
- Security:
- Admin Access> Userspermission.
- Organization Structurepermission withAll Levelsselected.
- Model includes: sheets, accounts, dimensions, and formulaspermission.
Associations connect levels, custom dimensions, or related attributes to users. You can then use association codes to create access rules for users and groups. When you use associations for access rules, you can update the associations, instead of the rules, to update user access.
Level ownership is a type of user association that connects users to levels. Unlike regular level associations, level ownership also comes with other privileges.
Associations with a parent level, parent dimension value, or parent attribute automatically associates the users with all descendants of the parent. You don't need to create associations for the child levels, attribute values, or dimensions values. The import ignores any associations that duplicate or are already included in an existing associations.
Example: An association to the HQ level exists for user jdoe@company.com. You add a new level association for jdoe@company.com for the Sales level. Sales rolls up to HQ. Therefore, the import ignores that association because the existing association for HQ already includes Sales.
When creating associations for level-ownership, you must:
- Leave theCodefield blank.
- EnterLevelfor the associated dimension.
The term 'dimension' in the template and exported spreadsheet generically refers to levels, custom dimensions, and attributes.
When you import associations, you can either work from a blank template or you can download the existing associations and update them.
For other ways to create associations see:
- SelectAdministrationfrom the main menu.
- ClickAssociations.
- As you complete the task, consider:
选项 描述 ImportProvides theDownload templatelink, so you can make changes in a blank template. Instructions are in the first tab of the template.ExportDownloads existing associations, so you can make changes and additions. - Open the spreadsheet that you downloaded.For the blank template, open theAssociationssheet.
- As you complete the columns of the spreadsheet, consider:
选项 描述 Code- Leave this column blank for level ownership.
- Enter any unique code for level, attribute, and custom dimension associations. Codes can contain numbers, letters, spaces, and symbols.
Associated DimensionEnter:- Levelsfor level associations and level ownership.
- The name of the custom dimension for custom dimension associations.
- The name of the attribute for attribute associations.
Association NameEnter- Level Ownershipfor level ownership associations.
- Any name for level, attribute, and custom dimension associations.
Don't useLevel Ownershipfor any otherAssociation Namebesides the actual level ownership association, which has no code.Dimension Value CodeEnter 1:- Level code.
- Level attribute value code.
- Custom dimension value code.
- Dimension attribute value code.
Entering the parent code always includes the children in the association.UsernameEnter the first user associated with the value code.Enter all other users, one in each row, leaving the previous columns blank. See the example table below. - In the row after the last username, enter the next value code in theDimension Value Codecolumn.
- List all the users associated with that dimension value code, one in each row.
- To start a new rule, enter aCodeafter the last user listed in the previous rule.
- Save the spreadsheet.
- Return toAdministration>Associations.
- From the toolbar, clickImport.
- Select a radio button. As you complete the task, consider:
选项 描述 ReplaceDeletes all existing associations for each code and replaces them.Update and AppendChanges existing associations and adds new ones. - Drag and drop your saved file into the square or click anywhere in the square and select your saved file.
- ClickDonewhen you get the success message.
- If the import failed:
- Click theDownload Reportlink beneath the error message.
- Open the file and open theErrorssheet. Rows with errors are yellow. The error message displays in the cell with the error in red text.
- Select the cell with the error to read the full message.
- Open theImportsheet and find the corresponding rule. It's on the same row as the error is in theErrorssheet.
- Correct the error and save the file.
- Try importing again.
LManager is the code for a level association called Level Managers. jsmith and janedoe are associated with the Sales level. For janedoe note that the first 4 columns are blank. janedoe is part of the
Sales
associations of LManagers. For the HQ level value, note that the first 3 columns are blank. HQ is still part of the LManager association. PManager is the next association rule. Code | Associated Dimension | Association Name | Dimension Value Code | Username |
|---|---|---|---|---|
PManager | Product | Product Managers |