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)" />

Description: Moves a single Exchange object. This activity uses the Exchange object ID of a specific object 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

Used to move an individual Exchange object specified by its unique ID.

Connection Parameters

Property

Type

Required

Default

Markup

Description

Connection

---

---

---

---

Indicates where user credentials, server settings and other preferences required to establish a connection to the Exchange server should originate from. This is a design mode parameter used only during task construction and configuration, thus, comprises no markup. The available options are:

  • Host (default) - Specifies that user credentials, server settings and advanced preferences are configured individually for this activity. This option is normally chosen if only a single activity is required to complete an operation.

  • Session - Specifies that user credentials, server settings and advanced preferences are obtained from a pre-configured session created in an earlier step with the use of the Create session activity. This option is normally chosen if a combination of related activities are required to complete an operation. Linking several activities to a single session eliminates redundancy. Additionally, a single task supports construction and simultaneous execution of multiple sessions, improving efficiency.

Session

Text

Yes if Connection set to Session

ExchangeSession1

 SESSION="ExchangeSess21"  

Protocol

Text (options)

Yes if Connection set to Host

WEBDAV
  1. PROTOCOLTYPE="ews2007"
  2. PROTOCOLTYPE="webdav"

The Exchange server protocol to communicate with. This parameter is active only if the Connection parameter is set to Host. Different parameters become available depending on the protocol selected. The available options are:

  • WEBDAV (Exchange 2003, 2007) - Use older WEBDAV protocol

  • EWS (Exchange 2007 & newer, Online) - Use newer EWS protocol or Exchange online.

Email address

Text

Yes if Connection set to Host

(Empty)

 EMAILADDRESS="me@myjob.com"

A valid email address to authenticate Exchange connection. This parameter is active only if the Connection parameter is set to Host.

Username

Text

Yes if Connection set to Host

(Empty)

 USERNAME="theMan"

A valid username used to authenticate Exchange connection. This value may or may not be identical to the value set in the Email address field. This parameter is active only if the Connection parameter is set to Host.

Password

Text

Yes if Connection set to Host

(Empty)

 PASSWORD="encrypted text"

A valid password used to authenticate Exchange connection. This parameter is active only if the Connection parameter is set to Host.

Domain name (optional)

Text

No

(Empty)
  1. DOMAINNAME="srvr.domain.com"
  2. DOMAINNAME="232.145.351.124"

The domain name (e.g., domain.exchangeServer.com) or IP address (e.g., xxx.xxx.xxx.xxx) used to connect to the Exchange server. This parameter is active only if the Connection parameter is set to Host.

Authentication type

Text (options)

No

Basic
  1. AUTHTYPE="Basic"
  2. AUTHTYPE="Default"
  3. AUTHTYPE="Form"

The Exchange server authentication type. This parameter is available only if Protocol parameter is set to WEBDAV (Exchange 2003, 2007). The available options are:

  • Basic - Processes basic authentication credentials presented in HTTP headers.

  • Default - The default authentication type set via Options -> Default Settings -> Email will be used.

  • Form - Forms-based authentication lets you use an HTML form to obtain credentials from users who are attempting to access the Exchange server.

NOTE: If you are unsure of the value to use in this parameter, contact your network administrator.

HTTPS/HTTP

Yes/No

No

HTTPS

 USEHTTP="yes"

Indicates whether to use HTTP (normal HTTP) or HTTPS (secure HTTP) as the Exchange server protocol type.

Exchange server

Text

Yes if Protocol set to EWS

(Empty)

 SERVER="server.domain.com"

The Exchange server to perform this activity. Click Discover to auto-discover the server based on the email address and password entered. This parameter is available only if the Protocol parameter is set to EWS (Exchange 2007 & newer, Online).

Authenticate as current windows user

---

---

---

---

If enabled, authentication will be performed via the credentials of the current Windows user, thus, disabling the Username, Password and Domain name parameters (disabled by default). This parameter is available only if the Protocol parameter is set to EWS (Exchange 2007 & newer, Online). This is a visual parameter only used interactively during design-time, therefore, contains no parameters or markups.

Rediscover server at runtime

Yes/No

No

No

 AUTODISCOVERURL="YES"

If set to YES, Autodiscover service will be automatically performed at runtime (set to NO by default). The Autodiscover service makes it easier to configure email clients by using a user's email address and password to automatically set a user's profile. Setting this parameter to YES automatically disables the Exchange server parameter. This parameter is available only if the Protocol parameter is set to EWS (Exchange 2007 & newer, Online).

Current folder

Text

Yes

Calendar

 CURRENTFOLDER="Contact"

The Exchange folder in which to perform this activity.

Timeout (seconds)

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. The default value is 100 seconds.

Impersonate

Yes/No

No

No

 IMPERSONATE="YES"

If set to YES, Impersonation is enabled. Impersonation allows an account on an Exchange server to perform actions by using the permissions that are associated with another account, instead of the permissions that are associated with the caller's account. This parameter is set to NO by default and only available if the Protocol parameter is set to EWS (Exchange 2007 & newer, Online).

NOTE: With Exchange Impersonation, one account is acting as another account. When an account is impersonated, the system logs the access as if the account that is specified in the header were acting on the system. The calling account must have the appropriate permissions to perform impersonation.

Ignore invalid server certificate

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 invalid and an exception is thrown due to its validity status. 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 EWS (Exchange 2007 & newer, Online).

Proxy type

Text (options)

No

System default
  1. PROXYTYPE="none"
  2. PROXYTYPE="http"

Specifies the proxy type this activity should use when attempting network communications through a proxy server. The available options are:

  • System default - The default proxy configuration set via Options -> Default Settings -> Proxy will be used.

  • None - No proxy is required.

  • HTTP - The proxy type to use is HTTP.

NOTE: If you are unsure of the value to use in this parameter, contact your network administrator.

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.

Object Parameters

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.

Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.

Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)

On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)

Example

The sample AML code below can be copied and pasted directly into the Steps panel 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" />