Skip to main content
Omnitracs Knowledge Base

User

Information about a user is implemented in the User object.  The attributes of the User object are:

 

Attribute

 

 

Description

 

companyId

A string of maximum length 10 containing the unique identifier of the company the user belongs to.

email

A string of maximum length 50 containing the email address of the user.

firstName

A string of maximum length 30 containing the first name of the user.

forcePwdReset

A boolean value indicating if the user must change their password at the next login attempt.

id

A string of maximum length 10 that indicates the unique identifier for the user.

lastName

A string of maximum length 30 containing the last name of the user.

lockedOut

A boolean value indicating if the user is locked out.

obeyDst

A boolean value indicating if the user obeys daylight saving time.

pagerEmail

A string of maximum length 50 containing the pager email address of the user.

qspInstance

A character value representing the instance of the Portal the user belongs to. Valid values are:
"1" - Qualcomm
"2" - Shaw
"3" - CNR

role

Role object containing information about the user's role.

timeZone

TimeZone object containing information about the user's timezone settings.

WSDL Definition

Here is how the User Information object is defined within the WSDL

<complexType name="User">

   <sequence>

      <element name="companyId" nillable="true" type="xsd:string"/>

      <element name="email" nillable="true" type="xsd:string"/>

      <element name="firstName" nillable="true" type="xsd:string"/>

      <element name="forcePwdReset" type="xsd:boolean"/>

      <element name="id" nillable="true" type="xsd:string"/>

      <element name="lastName" nillable="true" type="xsd:string"/>

      <element name="lockedOut" type="xsd:boolean"/>

      <element name="obeyDst" type="xsd:boolean"/>

      <element name="pagerEmail" nillable="true" type="xsd:string"/>

      <element name="qspInstance" nillable="true" type="xsd:string"/>

      <element name="role" nillable="true" type="tns2:Role"/>

      <element name="timeZone" nillable="true" type="tns2:TimeZone"/>

   </sequence>

</complexType>


 

Sample XML

Here is some sample XML that shows what the User Information object will look like in XML

<user>

    <companyId>MYCOMPANY</companyId>

    <email>romanowski@mycompany.com</email>

    <firstName>Nick</firstName>

    <forcePwdReset>0</forcePwdReset>

    <id>ROMANOWSKI</id>

    <lastName>Romanowski</lastName>

    <lockedOut>false</lockedOut>

    <obeyDst>false</obeyDst>

    <pagerEmail>nick@mycompany.com</pagerEmail>

    <qspInstance>1</QSPinstance>

    <role>

        <description>Administrator</description>

        <name>Admin</name>

    </role>

    <timeZone>

        <dstLongName>Pacific Daylight Saving Time</dstLongName>

        <dstShortName>PDT</dstShortName>

        <gmtOffset>GMT-08:00</gmtOffset>

        <name>Pacific Time</name>

        <stdLongName>Pacific Standard Time</stdLongName>

        <stdShortName>PST</stdShortName>

    </timeZone>

  </user>

  • Was this article helpful?