- Introduction to Mail & Deploy
- Architecture
- Installation
- Administration
- Content Management
- Tools
- Self-Service
- API
- Reference
- Actions
- Introduction to Actions
- Activate Culture
- Activate Datasource Bookmark
- Activate Datasource Theme
- Add Content To File Collection
- Click Datasource Button
- Convert Content
- Create File Collection
- Create Report Document
- Cycle
- Distribute Report Document To Library
- Execute Code
- Execute Task
- Filter Datasource Field
- Group
- Initialize Datasource Object
- Merge File Collection Content
- Merge Report Document
- Print Content
- Rebuild Datasource Cache
- Reload Datasource
- Reload Value Table
- Remove All Content From File Collection
- Remove All Datasource Field Filters
- Remove Datasource Field Filter
- Remove Datasource Field Filter Restrictions
- Run Application
- Save Content To File System
- Save Datasource
- Save Datasource To File System
- Save Reduced Datasource To File System
- Save Splitted Report Document To File System
- Send E-Mail
- Set Datasource Variable
- Set Local Variable
- Synchronize User Directory
- Upload Content To Amazon AWS S3
- Upload Content To Box
- Upload Content To Dropbox
- Upload Content To Files.com
- Upload Content To FTP
- Upload Content To Google Drive
- Upload Content To SharePoint
- Write Text File
- Expressions
- Introduction to Mail & Deploy Expressions
- Data Types
- Placeholders
- Functions
- Capitalize
- Concat
- ConvertToBoolean
- ConvertToDate
- ConvertToDateTime
- ConvertToNumber
- ConvertToText
- CreateList
- CreatePassword
- EncodeUri
- EvaluateDatasourceExpression
- Format
- GetAllDatasourceFieldValues
- GetApplicableDatasourceFieldValues
- GetDatasourceVariableValue
- GetFileCollectionSize
- GetFilteredDatasourceFieldValues
- GetFirstDayOfIso8601WeekOfYear
- GetIso8601WeekOfYear
- GetLocalVariable
- GetQlikSenseColor
- GetQlikSenseTextImageContent
- Left
- NewLine
- PasswordProtectReportDocument
- QueryValueTable
- Right
- Replace
- RGB
- SetLocalVariable
- Split
- Substring
- Table.RemoveRow
- Table.RemoveRows
- ToLower
- ToUpper
- Execution Plans
- File Collections
- File Type Settings
- Format Strings
- Hub Input Field Specifications
- MSO Chart Settings
- Styles
- Table Cell Types
- Themes
- Actions
- Release Notes
- 11 Oct 2024
- 2 Minutes to read
- DarkLight
XML File User Directories
- Updated on 11 Oct 2024
- 2 Minutes to read
- DarkLight
General
This type of user directory synchronizes Users and User Groups with an XML file.
This type of user directory is not available in the SaaS version of Mail & Deploy.
File Structure
The XML file contains two types of entries. The basic structure of the XML looks like this:
User Group Entry
This type of entry describes a user group and has the following syntax:
<UserGroup
Id="
Name="
The entry has the following values:
Name | Description |
---|---|
id | The ID of the user group which is used by to identify a user group throughout multiple synchronizations with the XML file. This is an alphanumeric string that needs to be unique. |
name | The name of the user group. |
User Entry
This type of entry describes a user and has the following syntax:
<User
Id="
Name="
MatchCode="<match_code>"
Type="
LanguageCode="
EMailAddress="
TimeZone="<time_zone>"
Culture="
HasWindowsAccount="<has_windows_account>"
WindowsAccountName="<windows_account_name>"
HasCustomCredentials="<has_custom_credentials>"
CustomUserName="<custom_username>"
InitialCustomPassword="<initial_custom_password>" />
<UserGroupMembership UserGroupId="<usergroup_id>" />
</User>
The entry has the following values:
Name | Description |
---|---|
id | The ID of the user which is used by to identify a user throughout multiple synchronizations with the XML file. This is an alphanumeric string that needs to be unique. |
name | The name of the user. |
match_code | The match-code of the user. This property is optional and can be an empty string. |
type | 0. Standard User 1. API User 2. Administrator |
language | en. English de. German |
The e-mail address of the user. This property is optional and can be an empty string. | |
time_zone | The timezone of the user; this needs to be one of the values of the Timezone column of the Windows Default Time Zones. |
culture | The culture of the user; this needs to be one of the values of the CultureInfo Code column of the Culture Code List. |
has_windows_account | False. The user does not have a windows account. True. The user does have a windows account. |
windows_account_name | The name of the windows account of the user in DOMAIN\accountname format. This property can be an empty string if haswindowsaccount is set to False. |
has_custom_credentials | False. The user does not have custom credentials. True. The user does have custom credentials. |
custom_username | The custom username of the user. This property can be an empty string if hascustomcredentials is set to False. |
custom_password | The custom password of the user. This property can be an empty string if hascustomcredentials is set to False. The custom password of a user will only be set if the user is first added during a synchronization; when an existing user is updated, the password will not be overwritten. |
For a full description of the individual properties see the Users article.
Every user entry can have zero or more user group membership entries which define the membership of a user in a user group. The values are:
Name | Description |
---|---|
usergroup_id | The ID of the user group of which the user is a member. This must be the ID of one of the user groups defined in a user group entry of the XML file. |