app-get

The app-get task downloads an application package from a Transact Manager server.

Task Attributes

All attributes are optional unless otherwise indicated.

Attribute	Description
clientCode	String Required. The client code of the organization in TM.
name	String Required. The name of the application package. The application package must belong to the client specified in the clientCode attribute.
url	String Required. The TM server URL.
username	String Required. The TM server login username.
password	String Required. The TM server login password.
proxyFile	String HTTP proxy configuration properties file location.
dir	String The directory to download the application package file into. Note: Either dir or file must be specified.
file	String The file path to download the application package file to. Note: Either file or dir must be specified.

TM Security

To use this task, the user specified by username needs an active user account on the TM server with access to the Management Console module.

To be authorized to call the service, the user account also needs the Management Console permission "REST Service Definitions API".

If the user is not a global administrator, only application packages belonging to the organizations assigned to the user will be accessible.

Example

The example Ant task below deletes an application package belonging to a client with client code "mycorp".

<app-get clientCode="mycorp"
    name="myapp"
    url="https://form.mycorp.com/manager/"
    username="[email protected]"
    password="password"
    dir="./../downloads/"
    proxyFile="./proxy.properties" />

Example Ant log output:

app-get:
    [app-get] Request: GET https://form.mycorp.com/manager/secure/rest/application-package/v1/mycorp/myapp HTTP/1.1
    [app-get] Application Package Downloaded: mycorp/myapp