scm-pull

The scm-pull task pulls all the files of a Maestro design from a remote Maestro instance, while the scm-project-pull task pulls the files for a Maestro project.

Support

scm-pull is supported in Transact Maestro 17.10 and later releases.

scm-project-pull is supported in Transact Maestro 18.05 and later releases.

Task Attributes

All attributes are optional unless otherwise indicated.

Attribute	Description
url	String Required. The Maestro server URL.
username	String Required. The Maestro server username.
password	String Required. The Maestro server user's password.
clone	String Required. The SCM clone of the project or design.

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 "SCM Project View" or "SCM Design View".

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

Example

The example Ant task below pulls all the files of the Maestro form design with normalized name "form-1".

<scm-pull url="https://form.mycorp.com/maestro/"
            username="[email protected]"
            password="password"
            clone="scm design clone maguire/jsmith/forms/form-1/1.0.0"
            dir="src/form-1" />

Example Ant log output:

scm-pull:
    [scm-pull]   pulled: https://form.mycorp.com/maestro/secure/rest/design-resource/v1/orgs/maguire/jsmith/forms/form-1/1.0.0/form.json