Type - Create object

Declaration

<AMTYPE ACTIVITY="create_object" PROTOCOL="text (options)" PASSPHRASE="text (encrypted)" CERTIFICATE="text" PASSWORD="text (encrypted)" USERNAME="text" DOMAINNAME="text" IGNOREWARNINGS="YES/NO" AUTHENTICATIONTYPE="text (options)" TYPENAME="text" RESULTSTRUCTURE="text" ROWS="text" COLUMNS="text" DEPTH="text"><PROPERTY NAME="text" VALUE="text" /></AMTYPE>

Related Topics   

Description

Creates an Automate Desktop object from the defined custom type or web service.

Practical usage

Usually used in conjunction with the Type - Define activity in order to create an Automate Desktop object from the defined custom type or web service.

Parameters

General

Property Type Required Default Markup Description
Type name Text Yes (Empty) TYPENAME="CustomType" The type name in which to create an object from. Click the Load properties button to populate this field with existing defined custom types.
Create and populate object of complex type Text Yes (Empty) RESULTSTRUCTURE="ObjectName" The name of the object to create.

Properti(es)

Property Type Required Default Markup Description
Name Text No (Empty) NAME="String" The property names of the object to create. Click Add to add a property type. To delete an existing property type/name, select the entry and click Delete. Additionally, items can be moved up / down the list by selecting the entry you wish to move and clicking the Move Up or Move Down button.
Value Text No (Empty) VALUE="ValueName" The property values of the object to be created.

Credentials

Property Type Required Default Markup Description
Authentication Type Text (options) No None
  • AUTHENTICATIONTYPE="default"
  • AUTHENTICATIONTYPE="basic"
  • AUTHENTICATIONTYPE="digest"
 The type of authentication required (if any). Different parameters may become available depending on the option selected. The available options are:
  • None (default) - No authentication.
  • Default - Default authentication.
  • Basic - Uses a username and password to authenticate a service client to a secure endpoint.
  • Digest - Authentication scheme based on cryptographic hashes.
  • Windows (Ntlm or Kerberos) - Windows standard authentication types.
Domain Text No (Empty) DOMAINNAME="mydomain.com" The domain name used for authentication.  This parameter is available only if the Authentication Type parameter is set to Basic, Digest or Windows (NTLM or Kerberos).
Username Text No

(Empty)

 		 USERNAME="theUser" The user name used for authentication. This parameter is available only if the Authentication Type parameter is set to Basic, Digest or Windows (NTLM or Kerberos).
Password Text No (Empty) PASSWORD="encrypted" The password used for authentication.  This parameter is available only if the Authentication Type parameter is set to Basic, Digest or Windows (NTLM or Kerberos).
Client Certificate Text No (Empty) CERTIFICATE="C:\Temp\Cert" The path to a valid client certificate used for authentication.  This parameter is available only if the Authentication Type parameter is set to Basic, Digest or Windows (NTLM or Kerberos).
Passphrase Text No (Empty)  PASSPHRASE="encrypted" The passphrase used for authentication.
Protocol Text (options) No SOAP PROTOCOL="Soap12" The protocol version. The available options are:
  • SOAP (default)
  • SOAP 1.2
Ignore warnings Yes/No No Yes IGNOREWARNINGS="NO" If selected, SOAP-related warnings are ignored.

Array

Property Type Required Default Markup Description
One dimension Number No (Empty) ROWS="value" If enabled (default), specifies creation of a one-dimensional array (or single dimension array). Accessing its elements involves a single subscript which represent a row index. If this parameter is enabled, the Two dimension and Three dimension parameters are ignored.
Two dimension Number No Disabled ROWS="value1" COLUMNS="value2" If enabled, specifies creation of a two-dimensional array (or double-dimension array). Its elements represent a row and column index. If this parameter is enabled, the One dimension and Three dimension parameters are ignored. Disabled by default.
Three dimension Number No Disabled ROWS="value1" COLUMNS="value2" DEPTH="value3" If enabled, specifies creation of a three-dimensional array (or triple-dimension array). Its elements represent a row, column and depth index. If this parameter is enabled, the One dimension and Two dimension parameters are ignored. Disabled by default.

Description

Error Causes

On Error

Example

NOTE:
  • Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
  • To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.

Description

This sample task creates an object.

Copy 
<AMTYPE ACTIVITY="create_object" TYPENAME="CompanyAddress" RESULTSTRUCTURE="theObject"><PROPERTY NAME="addr.Street" VALUE="Here" /></AMTYPE>