Creates, deletes, modifies, and gets Microsoft Exchange contact records, and gets contact record attachments.

  <cfexchangecontact action="create" contact="" name="" uid="">

 cfexchangecontact(action="create", contact="", name="", uid="");

This tag requires Adobe ColdFusion 8 and up.  Not supported on Lucee, etc.

Attribute Reference

action string

The action to take. Must be one of the following: create, delete, get, getAttachments, modify (required)
  • create
  • delete
  • deleteAttachments
  • get
  • getAttachments
  • modify

attachmentPath string

The absolute file path of the directory in which to put the attachments.
If the directory does not exist, ColdFusion creates it.
If you omit this attribute, ColdFusion does not save any attachments. (optional)

connection variableName

The name of the connection to the Exchange server, as specified in the cfexchangeconnection tag.
If you omit this attribute, you must create a temporary connection by specifying
cfexchangeconnection tag connection attributes in the cfexchangecontact tag. (optional)

contact any

A reference to the structure that contains the contact properties to be set or changed and their values.
You must specify this attribute in number signs (#).
For more information on the event structure, see the Usage section. (required)

generateUniqueFilenames boolean

A Boolean value specifying whether to generate unique file names if multiple attachments have the same file names.
Case "yes": 3x myfile.txt -> myfile.txt, myfile1.txt, and myfile2.txt. (optional, default=no)
  • true
  • false

name string

The name of the ColdFusion query variable that will contain the retrieved events or
information about the attachments that were retrieved. (required)

result string

The name of a variable that will contain the UID of the contact that is created.
You use this value in the uid attribute other actions to identify the contact to be acted on. (optional)

uid string

A case-sensitive Exchange UID value that uniquely identifies the contacts on which to perform the action.
For the delete action, this attribute can be a comma delimited list of UID values.
The getAttachments and modify action allow only a single UID value. (required)

Sample code using the cfexchangecontact tag

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub