|
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>
Description
Creates an Automate 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 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 |
|
The
type of authentication required (if any). Different parameters
may become available depending on the option selected. The available
options are:
|
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:
|
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. |
Example
NOTE:
- The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
- Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.
Description
This sample task creates an object.
Copy
<AMTYPE ACTIVITY="create_object" TYPENAME="CompanyAddress" RESULTSTRUCTURE="theObject"><PROPERTY NAME="addr.Street" VALUE="Here" /></AMTYPE>