getUsers

Gets an array of users as specified by company, group, and user role handles. This operation lets you sort returned users and filter by character.

Authorized User Types

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin
Name Type Required Description
includeInactive xsd:boolean No Include or exclude inactive users. Non-IPS Admin users must be an active member of at least one company to be authorized to make any API calls. An authorization fault is returned if the user has no active company memberships.
includeInvalid xsd:boolean No Lets you include/exclude invalid users.
companyHandleArray types:HandleArray No Filter results by company.
groupHandleArray types:HandleArray No Filter results by group.
userRoleArray types:StringArray No Filter results by user role.
charFilterField xsd:string No Filter results by field’s string prefix (see Trash State).
charFilter xsd:string No Filter results by a specific character.
sortBy xsd:string No Choice of user sort fields.
recordsPerPage xsd:int No Returns specified number of records per page.
resultsPage xsd:int No Results page.

Output (getUsersReturn)

Name Type Required Description
userArray types:UserArray Yes An array of users.

Examples

This code sample returns the array of users for several optional parameters. User roles, user character filter fields, and user sort fields are determined by using specific String Constants.

Request

<ns1:getUsersParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:includeInvalid>false</ns1:includeInvalid>
   <ns1:companyHandleArray>
      <ns1:items>47</ns1:items>
   </ns1:companyHandleArray>
   <ns1:userRoleArray>
      <ns1:items>IpsAdmin</ns1:items>
   </ns1:userRoleArray>
   <ns1:sortBy>LastName</ns1:sortBy>
</ns1:getUsersParam>

Response

<getUsersReturn xmlns="http://www.scene7.com/IpsApi/xsd">
   <userArray>
      <items>
         <userHandle>70|kmagnusson@adobe.com</userHandle>
         <firstName>Kris</firstName>
         <lastName>Magnusson</lastName>
         <email>kmagnusson@adobe.com</email>
         <role>IpsAdmin</role>
         <isValid>true</isValid>
         <passwordExpires>2107-07-27T15:18:15.816-07:00</passwordExpires>
      </items>
      ...
   </userArray>
</getUsersReturn>

On this page