Export Security

Exports the security records or access control list (ACL) records for specified users or groups to a Comma Separated Values (CSV) file.

Request

Supported Media Types: application/json

Parameters

The following table summarizes the client request specific to this job. For parameters that are generic to all jobs, see Execute a Job.

Table 5-25 Parameters

Name Description Required Default
jobType Export Security Yes None
jobName The name of this job. Example: ExportSecurity No Export Security
fileName The name of the file to which records should be exported. The file containing the exported data is stored in the Planning repository. If fileName is not specified, a file is auto-generated with a name containing the user name, current date, and time stamp. For example, test_admin_SecurityRecords_2019-02-26-04-34-45-420.csv. No The file name is auto-generated
exportUsers Comma separated user names. Only ACL records related to the specified users are exported. No None
exportGroups Comma separated user names. Only ACL records related to the specified groups are exported. No None

Notes:

  • This job can take only exportGroups or exportUsers at one time. If you need to export groups and users, you must run the job twice, once with each parameter.
  • If a user name or group name contains a comma, escape the comma in the request. For example, if a user name is test,User, the request should contain test\\,User.
  • For the file format, see the definition in Import Security Records.

Sample Payload

Example 1: Exports all security records to the ExportSecurityRecordsFile.csv file.

{
    "jobType": "Export Security",
    "jobName": "ExportSecurity",
    "parameters": {
        "fileName": "ExportSecurityRecordsFile.csv”
    }
}

Example 2: Exports security records of two groups, group1 and group2, to the ExportSecurityRecordsFile.cv file.

{
    "jobType": "Export Security",
    "jobName": "ExportSecurity",
    "parameters": {
        "exportGroups": "group1,group2”
        "fileName": "ExportSecurityRecordsFile.csv”
    }
}

Example 3: Exports security records of two users, test1 and test,User2 to the ExportSecurityRecordsFile.csv file. Note that one user name contains a comma in it.

{
    "jobType": "Export Security",
    "jobName": "ExportSecurity",
    "parameters": {
        "exportUsers": "test1,test\\,User2”
        "fileName": "ExportSecurityRecordsFile.csv”
    }
}