Exchange Contacts field

This is a specialized String List field where the list items (values and text) are obtained from a search of Contacts that is stored in the logged in user’s Personal Address Book in the associated Exchange Server (if there is one) and in the Default Global Address List in Active Directory. The user will select the values from a customized Lookup string list. Note that the lookup box will not be preloaded with the list values, but the user needs to specifically provide search criteria in order to retrieve any matches.

Option Description
Custom Text Property If field type is Custom, then this property must be set. Set this property to a valid exchange store property the contents of which will be used to populate the display text of the list items. For example, if the property is set to “urn:schemas:contacts:fileas” then the display text of the list items will be set to the name of the contact. For a full list of properties refer to the Exchange Store Schema in the Exchange Server SDK documentation.
Custom Value Property If field type is Custom, then this property must be set.Set this property to the valid exchange store property the contents of which will be used to populate the value of the list items. For example, if the property is set to “urn:schemas:contacts:bday” then the value of the list items will be set to the Birthday of the contact. For a full list of properties refer to the Exchange Store Schema in the Exchange Server SDK documentation.
Exchange Service Enter the WebDAV or Exchange Web Service (EWS) URL. Note that for a EWS service, the URL is optional because the EWS API will automatically discover the URL using the user’s email address that is retrieved from Active Directory.
Default This value will automatically populate the field until changed by the user.
Generates OMR This generates OMR on the Smarticket for the user to place a mark in the selection box.
Height The use of the property varies when Display Mode is set to Lookup:
  • If Display Mode is List Box, then this property defines the number of items that are visible at the same time in the list box.
  • If Display Mode is Lookup, then this property defines the number of lines of the text box control that holds the selected values.
  • If Display Mode is Button List this property is ignored.
  • If Display Mode is Ticket Only this property is ignored.
Max Items The maximum number of items found that will be displayed in the lookup list, if the value in the property is 0 then all values will be displayed. It is recommended that a value is entered for this property since an unlimited search can be slow depending on the number of contacts in the Exchange Server and in Active Directory.
Separator Symbol chosen by administrator to separate selected values.
Shown in Ticket Choosing Yes means that the field value name will appear on the Smarticket barcode sheet when printed.
Type
  • Email — If selected, the list will contain the email information for the contacts, the values of the list will be filed with the email address of the contacts, the display value will be the name of the contact.
  • Fax — If selected, the list will contain the fax information for the contacts, the values of the list will be filed with the fax number of the contacts, the display value will be the name of the contact.
  • Custom — This is an advanced option that lets the administrator specify which properties will be used to populate the values and displays for the list by entering a value in the Custom Text Property and Custom Value property, if Custom type is selected then the lookup will only be done to the personal address book, the Default Global Address List will not be searched.
Width This property is only used if the Display Mode is lookup, in which case this property is used to indicate the Width in characters of the text box that holds the values entered or selected by the user.

Custom Properties

Custom properties that are used with the Custom Text Property and Custom Value Property for the Exchange Contact field type are listed below. Note that although both property name standards for both WebDAV and Exchange Web Service (EWS) can be used with Smarticket Process Designer, it is recommended that the property name standards for Exchange Web Service (EWS) be used.

WebDAV Exchange Web Service (EWS)
urn:schemas:contacts:cn DisplayName
urn:schemas:contacts:department Department
urn:schemas:contacts:o CompanyName
urn:schemas:contacts:facsimiletelephonenumber BusinessFax
urn:schemas:contacts:officetelephonenumber BusinessPhone
urn:schemas:contacts:title JobTitle
urn:schemas:contacts:manager Manager
urn:schemas:contacts:secretary AssistantName
urn:schemas:contacts:bday Birthday
urn:schemas:contacts:businesshomepage BusinessHomePage
urn:schemas:contacts:givenName GivenName
urn:schemas:contacts:initials Initials
urn:schemas:contacts:middlename MiddleName
urn:schemas:contacts:nickname NickName
urn:schemas:contacts:location OfficeLocation
urn:schemas:contacts:profession Profession
urn:schemas:contacts:sn Surname
urn:schemas:contacts:secretaryphone AssistantPhone
urn:schemas:contacts:office2telephonenumber BusinessPhone2
urn:schemas:contacts:callbackphone Callback
urn:schemas:contacts:organizationmainphone CompanyMainPhone
urn:schemas:contacts:homePhone HomePhone
urn:schemas:contacts:homePhone2 HomePhone2
urn:schemas:contacts:mobile MobilePhone
urn:schemas:contacts:otherfax OtherFax
urn:schemas:contacts:othertelephone OtherTelephone
urn:schemas:contacts:pager Pager
urn:schemas:contacts:telephoneNumber PrimaryPhone
urn:schemas:contacts:telexnumber Telex
urn:schemas:contacts:ttytddphone TtyTddPhone
urn:schemas:contacts:email1 EmailAddress1
urn:schemas:contacts:email2 EmailAddress2
urn:schemas:contacts:email3 EmailAddress3

Other custom property names that can be used with Custom Text Property and Custom Value Property are:

  • DisplayName
  • Mileage
  • CarPhone
  • HomeFax
  • Isdn
  • RadioPhone
  • ImAddress1
  • ImAddress2
  • ImAddress3