Versions Compared

Old Version 9

changes.mady.by.user Stonebranch

Saved on

compared with

New Version Current

changes.mady.by.user Stonebranch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel
Table of Contents
maxlevel2

...

XML

JSON


Expand
titleXML


Code Block
languagetext
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<user retainSysIds="true">
    <active>true</active>
    <browserAccess>-- System Default --</browserAccess>
    <businessPhone />
    <commandLineAccess>-- System Default --</commandLineAccess>
    <department />
    <email <email>test@test.com</email>>
    <firstName>Joe<<firstName>stone b</firstName>
    <impersonate/>
   <lastName>Doe< <lastName>branch</lastName>
    <lockedOut>false</lockedOut>
   <loginMethod>Standard, Single Sign-On< <loginMethod>Standard</loginMethod>
    <manager <manager>Administrator</manager>>
    <middleName <middleName>M</middleName>>
    <mobilePhone />
    <passwordNeedsReset>false</passwordNeedsReset>
    <permissions>
	<permission> 	   <allGroups>false</allGroups> 	   <commands>ALL</commands><permission>
	   <defaultGroup>true</defaultGroup> 	     <nameWildcard>*</nameWildcard>   <allGroups>true</allGroups>
         <notGroups>false</notGroups> 	  <commands <opCreate>false</opCreate>>
 	   <opDelete>true</opDelete> 	   <opExecute>true</opExecute> 	   <opRead>true<<defaultGroup>true</opRead>defaultGroup>
	   <opUpdate>true</opUpdate> 	   <opswiseGroups /> 	   <permissionType>Agent</permissionType>
	<nameWildcard>*</nameWildcard>
    <sysId>c489750500d444eca9325559d0ef9673</sysId>        <<notGroups>false</permission>notGroups>
   </permissions>    <sysId>3de4c72e27c94d4aa840bffcbd7509ca</sysId>    <timeZone <opCreate>false</>opCreate>
   <title>Vice President</title>    <userName>test.user</userName>    <userPassword>abc123</userPassword><opDelete>true</opDelete>
      <userRoles> 	<userRole> 	   <role description="The universal template admin role.">ops_universal_template_admin</role>
	   <sysId>187ecb3a27544b7fb702caee6dc8d5e3</sysId>
	</userRole>
	<userRole>
	   <role description="The report publishing role.">ops_report_publish</role>
	   <sysId>2e1dc86f47c6431884373f0e06b841da</sysId>
	</userRole>
   </userRoles>
   <webServiceAccess>-- System Default --</webServiceAccess>
</user>
Expand
titleJSON
Code Block
languagetext
{
  "active": true,
  "browserAccess": "-- System Default --",
  "businessPhone": null,
  "commandLineAccess": "-- System Default --",
  "department": null,
  "email": "test@test.com",
  "firstName": "Joe",
  "impersonate":[],
  "lastName": "Doe",
  "lockedOut": false,
  "loginMethod": Standard, Single Sign-On",
  "manager": "Administrator",
  "middleName": "M",
  "mobilePhone": null,
  "passwordNeedsReset": false,
  "permissions": [ {
    "allGroups": false,
    "commands": "ALL",
    "defaultGroup": true,
    "nameWildcard": "*",
    "notGroups": false,
    "opCreate": false,
    "opDelete": false,
    "opExecute": true,
    "opRead": true,
    "opUpdate": true,
    "opswiseGroups": [],
    "permissionType": "Agent",
    "sysId": "c489750500d444eca9325559d0ef9673"
  } ],
  "retainSysIds": true,
  "sysId": "3de4c72e27c94d4aa840bffcbd7509ca",
  "timeZone": null,
  "title": "Vice President",
  "userName": "test.user",
  "userPassword": "abc123",
  "userRoles": [ {
    "role": {
      "description": "The universal template admin role.",
      "value": "ops_universal_template_admin"
    },
    "sysId": "b8c25922d370438aada276cff669136d"
  }, {
    "role": {
      "description": "The report publishing role.",
      "value": "ops_report_publish"
    },
    "sysId": "fda36f00cc4544bc8f7fbd203290539a"
  } ],
  "webServiceAccess <opExecute>true</opExecute>
            <opRead>true</opRead>
            <opUpdate>true</opUpdate>
            <opswiseGroups/>
            <permissionType>Agent</permissionType>
            <sysId>83c2d3b15d0c417f8a8890be17f1f4cd</sysId>
        </permission>
    </permissions>
    <sysId>4e820e27b548497bb8005bb884f2816a</sysId>
    <timeZone>System</timeZone>
    <title>IT Technician</title>
    <tokens/>
    <userName>stonebranch-user-02</userName>
    <userRoles>
        <userRole>
            <role description="Can create reports that belong to a group to which I am a member.">ops_report_group</role>
            <sysId>018b60fc6bb54ca68571f789e5ee1ad5</sysId>
        </userRole>
        <userRole>
            <role description="Can create global reports.">ops_report_global</role>
            <sysId>b21ecafbcd3f4424bfeca3d9846f2c34</sysId>
        </userRole>
        <userRole>
            <role description="The report publishing role.">ops_report_publish</role>
            <sysId>cb84572b5bf44ddfb1e9e0e9b9d1b65a</sysId>
        </userRole>
    </userRoles>
    <webServiceAccess>-- System Default --</webServiceAccess>
</user>




Expand
titleJSON


Code Block
languagetext
{
    "active": true,
    "browserAccess": "-- System Default --",
    "businessPhone": null,
    "commandLineAccess": "-- System Default --"
}

...

Delete a User

...

Description

...

URI

...

HTTP Method

...

DELETE

...

Description

...

Deletes a User.

...

URI Parameters

...

See Delete a User URI Parameters, below.

...

Example URI

...

...

Example Response

...

  • Status 200 /OK
    User {username} deleted successfully.
  • Status 400 /Bad Request
    Mutual exclusion violation. Cannot specify userid and username at the same time.
  • Status 404 /Not Found
    User with {username/userid} does not exist.

...

Delete a User: URI Parameters

...

Parameter

...

Description

...

Specifications

...

Required

...

Mutually Exclusive With

...

userid

...

ID used within the Controller to identify this user.

...

String; URI parameter.

...

Y (unless userename is specified)

...

username

...

username

...

Name used within the Controller to identify this user.

...

String; URI parameter.

...

Y (unless userid is specified)

...

userid

...

List Users

...

Description

...

URI

...

HTTP Method

...

GET

...

Description

...

Retrieves information on all Users.

...

Example URI

...

http://localhost:8080/uc/resources/user/list

http://localhost:9090/uc/resources/user/list?showTokens=true

...

Authentication

...

HTTP Basic

...

Produces Content-Type

...

application/xml, application/json

...

Example

...

See List Users: XML and JSON Examples.

...

User Properties

...

See User Properties.

...

User Permission Properties

...

See User Permission Properties.

...

User Role Properties

...

See User Role Properties.

List Users: URI Parameters 

...

Name

...

Description

...

Specifications

...

Required

...

showTokens

...

Show personal access tokens.

...

Boolean

  • True - Includes the Token details

  • False (Default) - Empty Token List

...

List Users: XML and JSON Examples

XML

JSON

Expand
titleXML
Code Block
languagetext
<users>
  <user>
   <active>true</active>
   <browserAccess>-- System Default --</browserAccess>
   <businessPhone />
   <commandLineAccess>-- System Default --</commandLineAccess>
   <department />
   <email>test@test.com</email>
   <firstName>Joe</firstName>
   <impersonate/>
   <lastName>Doe</lastName>
   <lockedOut>false</lockedOut>
   <loginMethod>Standard, Single Sign-On</loginMethod>
   <manager>Administrator</manager>
   <middleName>M</middleName>
   <mobilePhone />
   <passwordNeedsReset>false</passwordNeedsReset>
   <permissions />
   <sysId>3de4c72e27c94d4aa840bffcbd7509ca</sysId>
   <timeZone />
   <title>Vice President</title>
   <userName>test.user</userName>
   <userPassword>abc123</userPassword>
   <userRoles />
   <webServiceAccess>-- System Default --</webServiceAccess>
  </user>
  <user> 
   <active>true</active> 
   <browserAccess>-- System Default --</browserAccess> 
   <businessPhone /> 
   <commandLineAccess>-- System Default --</commandLineAccess> 
   <department /> 
   <email>test@test.com</email> 
   <firstName>Joe</firstName> 
   <lastName>Doe</lastName> 
   <impersonate/>
   <lockedOut>false</lockedOut> 
   <loginMethod>Standard, Single Sign-On</loginMethod> 
   <manager>Administrator</manager> 
   <middleName>M</middleName> 
   <mobilePhone /> 
   <passwordNeedsReset>false</passwordNeedsReset> 
   <permissions> 
    <permission> 
     <allGroups>false</allGroups> 
     <commands>ALL</commands> 
     <defaultGroup>true</defaultGroup> 
     <nameWildcard>*</nameWildcard> 
     <notGroups>false</notGroups>
     <opCreate>false</opCreate> 
     <opDelete>true</opDelete> 
     <opExecute>true</opExecute> 
     <opRead>true</opRead> 
     <opUpdate>true</opUpdate> 
     <opswiseGroups /> 
     <permissionType>Agent</permissionType> 
     <sysId>c489750500d444eca9325559d0ef9673</sysId> 
    </permission>
  <permissions>
   <sysId>3de4c72e27c94d4aa840bffcbd7509ca</sysId> 
   <timeZone /> 
   <title>Vice President</title> 
   <userName>test.user</userName> 
   <userPassword>abc123</userPassword> 
   <userRoles /> 
   <webServiceAccess>-- System Default --</webServiceAccess> 
  </user>
</users>
Expand
titleJSON
Code Block
languagetext
[ {
  "active": true, 
  "browserAccess": "-- System Default --", 
  "businessPhone": null, 
  "commandLineAccess": "-- System Default --", 
  "department": null, 
  "email": "test@test.com", 
  "firstName": "Joe", 
  "impersonate":[],
  "lastName": "Doe", 
  "lockedOut": false, 
  "loginMethod": Standard, Single Sign-On", 
  "manager": "Administrator", 
  "middleName": "M", 
  "mobilePhone": null, 
  "passwordNeedsReset": false, 
  "permissions": [],
  "sysId": "3de4c72e27c94d4aa840bffcbd7509ca", 
  "timeZone": null, 
  "title": "Vice President", 
  "userName": "test.user", 
  "userPassword": "abc123", 
  "userRoles": [],
  "webServiceAccess": "-- System Default --"
  },
  {
  "active": true,
  "browserAccess": "-- System Default --",
  "businessPhone": null,
  "commandLineAccess": "-- System Default --",
  "department": null,
  "email": "test@test.com",
  "firstName": "Joe",
  "impersonate":[],
  "lastName": "Doe",
  "lockedOut": false,
  "loginMethod": Standard, Single Sign-On",
  "manager": "Administrator",
  "middleName": "M",
  "mobilePhone": null,
  "passwordNeedsReset": false,
  "permissions": [ {
    "allGroups": false,
    "commands": "ALL",
    "defaultGroup": true,
    "nameWildcard": "*",
    "notGroups": false,
    "opCreate": false,
    "opDelete": false,
    "opExecute": true,
    "opRead": true,
    "opUpdate": true,
    "opswiseGroups,
    "department": null,
    "email": null,
    "firstName": "stone b",
    "impersonate": [],
    "lastName": "branch",
    "lockedOut": false,
    "loginMethod": "Standard",
    "manager": null,
    "middleName": null,
    "mobilePhone": null,
    "passwordNeedsReset": false,
    "permissions": [
        {
            "allGroups": true,
            "commands": null,
            "defaultGroup": true,
            "nameWildcard": "*",
            "notGroups": false,
            "opCreate": false,
            "opDelete": true,
            "opExecute": true,
            "opRead": true,
            "opUpdate": true,
            "opswiseGroups": [],
            "permissionType": "Agent",
            "sysId": "83c2d3b15d0c417f8a8890be17f1f4cd"
        }
    ],
    "retainSysIds": true,
    "sysId": "4e820e27b548497bb8005bb884f2816a",
    "timeZone": "System",
    "title": "IT Technician",
    "tokens": [],
    "userName": "stonebranch-user-02",
    "userRoles": [
        {
            "role": {
                "description": "Can create reports that belong to a group to which I am a member.",
                "value": "ops_report_group"
            },
            "sysId": "018b60fc6bb54ca68571f789e5ee1ad5"
        },
        {
            "role": {
                "description": "Can create global reports.",
                "value": "ops_report_global"
            },
            "sysId": "b21ecafbcd3f4424bfeca3d9846f2c34"
        },
        {
            "role": {
                "description": "The report publishing role.",
                "value": "ops_report_publish"
            },
            "sysId": "cb84572b5bf44ddfb1e9e0e9b9d1b65a"
        }
    ],
    "webServiceAccess": "-- System Default --"
}




Anchor
Delete a User
Delete a User

Delete a User


Description

URI

http://host_name/uc/resources/user

HTTP Method

DELETE

Description

Deletes a User.

URI Parameters

See Delete a User URI Parameters, below.

Example URI

Example Response

  • Status 200 /OK
    User {username} deleted successfully.
  • Status 400 /Bad Request
    Mutual exclusion violation. Cannot specify userid and username at the same time.
  • Status 404 /Not Found
    User with {username/userid} does not exist.

Anchor
Delete a User URI Parameters
Delete a User URI Parameters

Delete a User: URI Parameters

Parameter

Description

Specifications

Required

Mutually Exclusive With

userid

ID used within the Controller to identify this user.

String; URI parameter.

Y (unless userename is specified)

username

username

Name used within the Controller to identify this user.

String; URI parameter.

Y (unless userid is specified)

userid


Anchor
List Users
List Users

List Users


Description

URI

http://host_name/uc/resources/user/list

HTTP Method

GET

Description

Retrieves information on all Users.

Example URI

http://localhost:8080/uc/resources/user/list

http://localhost:9090/uc/resources/user/list?showTokens=true

Authentication

HTTP Basic

Produces Content-Type

application/xml, application/json

Example

See List Users: XML and JSON Examples.

User Properties

See User Properties.

User Permission Properties

See User Permission Properties.

User Role Properties

See User Role Properties.

List Users: URI Parameters 

Name

Description

Specifications

Required

showTokens

Show personal access tokens.

Boolean

  • True - Includes the Token details

  • False (Default) - Empty Token List

N

Anchor
List Users XML and JSON Examples
List Users XML and JSON Examples

List Users: XML and JSON Examples

XML

JSON


Expand
titleXML


Code Block
languagetext
<users>
    <user>
        <active>true</active>
        <browserAccess>-- System Default --</browserAccess>
        <businessPhone />
        <commandLineAccess>-- System Default --</commandLineAccess>
        <department />
        <email />
        <firstName>stone b</firstName>
        <impersonate/>
        <lastName>branch</lastName>
        <lockedOut>false</lockedOut>
        <loginMethod>Standard</loginMethod>
        <manager />
        <middleName />
        <mobilePhone />
        <passwordNeedsReset>false</passwordNeedsReset>
        <permissions/>
        <sysId>4e820e27b548497bb8005bb884f2816a</sysId>
        <timeZone>System</timeZone>
        <title>IT Technician</title>
        <tokens/>
        <userName>stonebranch-user-02</userName>
        <userRoles>
            <userRole>
                <role description="Can create reports that belong to a group to which I am a member.">ops_report_group</role>
                <sysId>018b60fc6bb54ca68571f789e5ee1ad5</sysId>
            </userRole>
            <userRole>
                <role description="Can create global reports.">ops_report_global</role>
                <sysId>b21ecafbcd3f4424bfeca3d9846f2c34</sysId>
            </userRole>
            <userRole>
                <role description="The report publishing role.">ops_report_publish</role>
                <sysId>cb84572b5bf44ddfb1e9e0e9b9d1b65a</sysId>
            </userRole>
        </userRoles>
        <webServiceAccess>-- System Default --</webServiceAccess>
    </user>
    <user>
        <active>true</active>
        <browserAccess>-- System Default --</browserAccess>
        <businessPhone />
        <commandLineAccess>-- System Default --</commandLineAccess>
        <department />
        <email />
        <firstName>stone c</firstName>
        <impersonate/>
        <lastName>branch</lastName>
        <lockedOut>false</lockedOut>
        <loginMethod>Standard</loginMethod>
        <manager />
        <middleName />
        <mobilePhone />
        <passwordNeedsReset>false</passwordNeedsReset>
        <permissions/>
        <sysId>c212afe3dd6b4cb98cc3cb432cf7be46</sysId>
        <timeZone>System</timeZone>
        <title>IT Technician</title>
        <tokens/>
        <userName>stonebranch-user-03</userName>
        <userRoles/>
        <webServiceAccess>-- System Default --</webServiceAccess>
    </user>
</users>




Expand
titleJSON


Code Block
languagetext
[
    {
        "active": true,
        "browserAccess": "-- System Default --",
        "businessPhone": null,
        "commandLineAccess": "-- System Default --",
        "department": null,
        "email": null,
        "firstName": "stone b",
        "impersonate": [],
        "lastName": "branch",
        "lockedOut": false,
        "loginMethod": "Standard",
        "manager": null,
        "middleName": null,
        "mobilePhone": null,
        "passwordNeedsReset": false,
        "permissions": [],
        "sysId": "4e820e27b548497bb8005bb884f2816a",
        "timeZone": "System",
        "title": "IT Technician",
        "tokens": [],
        "userName": "stonebranch-user-02",
        "userRoles": [
            {
                "role": {
                    "description": "Can create reports that belong to a group to which I am a member.",
                    "value": "ops_report_group"
                },
                "sysId": "018b60fc6bb54ca68571f789e5ee1ad5"
            },
            {
                "role": {
                    "description": "Can create global reports.",
                    "value": "ops_report_global"
                },
                "sysId": "b21ecafbcd3f4424bfeca3d9846f2c34"
            },
            {
                "role": {
                    "description": "The report publishing role.",
                    "value": "ops_report_publish"
                },
                "sysId": "cb84572b5bf44ddfb1e9e0e9b9d1b65a"
            }
        ],
        "webServiceAccess": "-- System Default --"
    },
    {
        "active": true,
        "browserAccess": "-- System Default --",
        "businessPhone": null,
        "commandLineAccess": "-- System Default --",
        "department": null,
        "email": null,
        "firstName": "stone c",
        "impersonate": [],
        "permissionTypelastName": "Agentbranch",
        "sysIdlockedOut": "c489750500d444eca9325559d0ef9673"false,
    } ],   "retainSysIdsloginMethod": true"Standard",
    "sysId": "3de4c72e27c94d4aa840bffcbd7509ca",   "timeZonemanager": null,
  "title": "Vice President",      "userNamemiddleName": "test.user",null,
        "userPasswordmobilePhone": "abc123"null,
  "userRoles": [ {     "role": {passwordNeedsReset": false,
        "descriptionpermissions": "The universal template admin role.",[],
        "valuesysId": "ops_universal_template_admin"c212afe3dd6b4cb98cc3cb432cf7be46",
    },     "sysIdtimeZone": "b8c25922d370438aada276cff669136dSystem",
  }, {     "roletitle": { "IT Technician",
        "descriptiontokens": "The[],
report publishing role.",       "valueuserName": "ops_report_publish"stonebranch-user-03",
    },     "sysIduserRoles": "fda36f00cc4544bc8f7fbd203290539a" [],
    } ],   "webServiceAccess": "-- System Default --"
    },
  
]



Anchor
Modify a User
Modify a User

...

List Personal Access Tokens: Query Parameters

The following request parameters can be used to filter the results of this service.

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

userid

N/A

UUID of the user

UUID of the user

N

username

username

N/A

User Name

String value of User name

N

userid

...