Skip to main content

Version: 23.10

scm-clone

The scm-clone task clones a Maestro design, while the scm-project-clone task clones a Maestro project.

Support

scm-clone was introduced in Transact Maestro 17.10, and continues to be available in later Transact Maestro and Journey Maestro releases.

scm-project-clone was introduced in Transact Maestro 18.05, and continues to be available in later Journey Maestro releases.

Task Attributes

All attributes are optional unless otherwise indicated.

AttributeDescription
urlString

Required. The Maestro server URL.

usernameString

Required. The Maestro server username.

passwordString

Required. The Maestro server user's password.

cloneString

Required. The SCM clone of the project or design.

dirString

Required. The directory to clone the project into.

proxyFileString

HTTP proxy configuration properties file location.

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 clones a form design with the normalized name "form-1".

<scm-clone 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"
proxy="./proxy.properties" />

Example Ant log output:

scm-clone:
[scm-clone] Request: GET https://form.mycorp.com/maestro/secure/rest/form-design-version/v1/maguire/jsmith/forms/form-1/1.0.0 HTTP/1.1
[scm-clone] Cloned 'maguire/jsmith/forms/form-1/1.0.0' in dir: C:\tmp\sdk\src\form-1