Exchange - Move Single Object

Declaration

<AMEXCHANGE ACTIVITY="move_single" EXCHANGEOBJECTADDRESS="text.EML" FOLDER="text" EMAILADDRESS="text" SERVER="text" DOMAINNAME="text" USERNAME="text" PASSWORD="text (encrypted)" />

See Also

Exchange - Create Object | Exchange - Delete Object(s) | Exchange - Delete Single Object | Exchange - Get Object(s) | Exchange - Modify Object | Exchange - Move Object(s) | Exchange - Move Single Object

Description

Moves a single Exchange object. This activity uses the Exchange object ID of a specific object in order to move it. To retrieve an object's ID, use the Get Exchange Object(s) activity. To move all Exchange objects of the same type or use filters to move more than one Exchange object of the same type, use the Move Exchange Object(s) activity.

Practical Usage

See Description.

Parameters

Property

Type

Required

Default

Markup

Description

Exchange object type

Text (options)

Yes

Appointment

EXCHANGEOBJECTTYPE="Task"

The type of Exchange object to move. Specific properties may become available depending on the object type selected. The available options are:

  • Appointment

  • Contact

  • Email

  • Task

General Properties

You must first select the type of Exchange object to create as specified in the Exchange object type parameter. Specific properties detailed below may become available depending on the object type selected. This activity supports creation of individual appointments, contacts or tasks.

Property

Type

Required

Default

Markup

Description

Exchange object ID

Text

Yes

(Empty)

EXCHANGEOBJECTADDRESS="https://domain.com/

exchange/mail@netauto.com/Inbox/No%20Subject-38.EML"

The object ID (Exchange object address or .EML file) of the Exchange object to move. For example, the object ID of a particular e-mail message would look similar to:

https://domain.com/exchange/mail@netauto.com/Inbox/No%20Subject-38.EML

Destination folder

Text

Yes

(Empty)

FOLDER="folderName"

The destination folder in which to move the desired object. Click the provided down arrow to query available Exchange server folders.

Server Properties

Property

Type

Required

Default

Markup

Description

Protocol

Text (options)

Yes

WEBDAV

PROTOCOLTYPE="ews2007"

The Exchange server protocol to communicate with. The available options are:

  • Exchange 2003 (WEBDAV)

  • Exchange 2007 (EWS)

  • Exhange 2010 (EWS)

Email address

Text

Yes

(Empty)

EMAILADDRESS="test@netauto.com"

The e-mail address to perform the selected activity on.

Exchange server

Text

Yes

(Empty)

SERVER="server.domain.com"

The name of the Exchange server to perform the selected activity on.

HTTPS/HTTP

Yes/No

No

HTTPS

USEHTTP="yes"

Indicates whether to use HTTP or HTTPS as the Exchange server protocol type.

Autodiscover service URL

Yes/No

No

No

AUTODISCOVERURL="yes"

If set to YES, turns on Autodiscover service. The Autodiscover service makes it easier to configure Outlook 2007 or Outlook 2010 and some mobile phones by using a user's e-mail address and password to automatically configure a user's profile. This parameter is set to NO by default and only available if the Protocol parameter is set to EWS2007 or EWS2010.

Allow redirection

Yes/No

No

No

ALLOWREDIRECTION="yes"

If set to YES, allows redirection of incoming requests to another file or URL. This parameter is set to NO by default and only available if the Autodiscover service URL parameter is set to YES.

Ignore invalid server certificates

Yes/No

No

No

IGNOREINVALIDCERTIFICATE="yes"

If set to YES, invalid server certificates are ignored. In some cases the SSL certificate may be expired or become invalid and an exception is thrown due to invalid SSL certificate. You may avoid such SSL certificate errors by choosing to ignore invalid server certificates. This parameter is set to NO by default and only available if the Protocol parameter is set to EWS2007 or EWS2010.

Current folder

Text

Yes

(Empty)

CURRENTFOLDER="Contact"

The Exchange folder in which to perform the selected activity on.

Timeout

Number

No

100

TIMEOUT="120"

The total amount of time in seconds that this activity should be allowed to execute before a time out error occurs.

Authentication type

Text (options)

No

Basic

AUTHTYPE="Default"

The Exchange server authentication type. The available options are:

  • Basic

  • Default

  • Form (Exchange 2003 (WEBDAV) only)

Domain name

Text

Yes

(Empty)

DOMAINNAME="domain"

The domain name corresponding to the e-mail address to perform the selected action on.

Username

Text

Yes

(Empty)

USERNAME="username"

The username corresponding to the e-mail address to perform the selected action on.

Password

Text

Yes

(Empty)

PASSWORD="password"

The password corresponding to the e-mail address to perform the selected action on.

Proxy Properties

Property

Type

Required

Default

Markup

Description

Proxy type

Text (options)

No

System default

PROXYTYPE="http"

The proxy protocol that should be used. If you are unsure of the value to use in this parameter, contact your network administrator. The available options are:

  • System default

  • None

  • HTTP

Proxy host

Text

No

(Empty)

PROXYSERVER="proxy.host.com"

The hostname (server.domain.com) or IP address (xxx.xxx.xxx.xxx) of the proxy server.

Proxy username

Text

No

(Empty)

PROXYUSERNAME="username"

The username that should be used to authenticate when connecting through the proxy server. This option is only valid if the Use authentication parameter is enabled.

Proxy password

Text

No

(Empty)

PROXYPASSWORD="encrypted"

The password that should be used to authenticate when connecting through the proxy server. This option is only valid if the Use authentication parameter is enabled.

Proxy port

Number

No

1028

PROXYPORT="3000"

The port that should be used to connect to the proxy server. Most proxy servers operate on port 1028 (the default) however the proxy server can be customized to operate on other ports

Description Properties

The Description tab allows you to customize the text description of any step as it appears in the Task Builder's Steps Pane.

More on setting custom step description

Error Causes Properties

The Error Causes tab properties allows you to instruct a task step to react only to specific errors or ignore certain errors that should cause it to fail.

More on Error Causes properties

On Error Properties

The On Error tab properties lets you determine what the task should do if a particular step encounters an error as defined in the Error Causes properties.

More about On Error properties

Expressions, Variables and Functions

All text fields allow the use of expressions such as variables, functions or AutoMate extended functions, which can be entered by surrounding the expression in percentage signs (example: %FileDateTime(myVar)% or %myVar%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by clicking the Insert Expression (%) button or by pressing F2.

More on expressions

More on variables

More on function

More on extended functions
More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

 

Description: This sample step moves a single Exchange e-mail object. The Exchange object id is "https://domain.com/exchange/mail@netauto.com/Inbox/No%20Subject-38.EML".

<AMEXCHANGE ACTIVITY="move_single" EXCHANGEOBJECTADDRESS="https://domain.com/exchange/mail@netauto.com/Inbox/No%20Subject-38.EML" FOLDER="FolderName" EMAILADDRESS="test@netauto.com" SERVER="domain.netauto.com" DOMAINNAME="netauto.com" USERNAME="test" PASSWORD="AM1+D+CW7k/sepW0nRCPDzNcZBWjE8XXD4XaME" />

↑ Top of Page