Get Contacts List operation


The Get Contacts List operation retrieves the list of contacts in the specified organization. 

The following table describes the elements for the <items> XML element and adapter request for the Get Contacts List operation. 

Elements for the <items> XML for the Get Contacts List operation

Input element

Description

Required

<target>

Specifies the target for the request 

If this element is not present, the adapter uses the default target specified in its configuration.

No

<host>

Specifies the host name or IP address of the remote computer 

To specify a dynamic target, you must use this element.

No

<user-name>

Specifies the user name for remote host authentication 

To specify a dynamic target, you must use this element.

No

<password>

Specifies the password that corresponds to the user name 

To specify a dynamic target, you must use this element.

No

<commands>

Indicates the beginning of the <commands> element, which contains the individual <command> elements

Yes

<command>

Indicates the beginning of a <command> element, which contains the elements that specify the operation to execute and its parameters

Yes

<active-directory-command>

Specifies the operation to execute 

Default value: Get Contact

Yes

<object-class>

Specifies the type of object on which to perform the operation 

Default value: Contact

Yes

<object-distinguished-name>

Specifies the distinguished name of the contact that you want to retrieve

For example: CN=MyContact,OU=TestOU,DC=punbnadv21,DC=local

Yes

<server>

Specifies the remote server for the connection 

If the object belongs to an Active Directory service hosted on a remote server, you must use this element.

Conditional

<domain>

Specifies the remote domain for the connection 

If the object belongs to an Active Directory service hosted on a remote server, you must use this element.

Conditional

<user-name>

Specifies the logon user name for the remote server

Conditional

<password>

Specifies the password associated with the user name

Conditional

The following figure shows a sample adapter request for the Get Contacts List operation.

Adapter request for the Get Contacts List operation

<request-data>
 <active-directory-request>
   <commands>
     <command>
       <active-directory-command>Get Contacts</active-directory-command>
       <object-class>Contact</object-class>
       <object-distinguished-name>DC=punbnadv21,DC=local</object-distinguished-name>
     </command>
   </commands>
 </active-directory-request>
</request-data>

The following figure shows a sample adapter response for the Get Contacts List operation:

Sample adapter response for the  Get Contacts List operation

<active-directory-response>
 <metadata>
   <status>success</status>
 </metadata>
 <target-output host="vw-pun-bna-dv21.bmc.com">
   <metadata>
     <os-id>Windows Server 2008</os-id>
     <os-version>6.3.9600</os-version>
     <status>success</status>
   </metadata>
   <commands-output>
     <command-output>
       <metadata>
         <command>dsquery contact "DC=punbnadv21,DC=local"</command>
         <line-count>8</line-count>
         <execution-milliseconds>47516</execution-milliseconds>
         <exit-code>0</exit-code>
         <status>success</status>
       </metadata>
       <output>
         <line index="1">Copyright 2010 BMC Software Ltd, Version: 1.5  </line>
         <line index="2">Connecting to remote service...</line>
         <line index="3">Connected to remote host.</line>
         <line index="4">"CN=Puja S. Verma,CN=Users,DC=punbnadv21,DC=local"</line>
         <line index="5">"CN=Pooja Sinha,CN=Users,DC=punbnadv21,DC=local"</line>
         <line index="6">"CN=PujaV Sinha,OU=PujaTest,DC=punbnadv21,DC=local"</line>
         <line index="7">"CN=Avishi Sinha,OU=PujaTest,DC=punbnadv21,DC=local"</line>
         <line index="8">Remote application exited with code: 0 </line>
       </output>
     </command-output>
   </commands-output>
 </target-output>
</active-directory-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*