Skip to main content

Run Tool Project

This step starts a Run Tool project. You can use the DataSync RunTool Project Step Handler to run any Run Tool Project you have previously designed.

info

By default the Run Tool will use the Connection Library where the Ouvvi Processing Service is running from, not the Ouvvi Connection Library.

To create this step select Data Sync Run Tool Project from the list and enter in a name for the step.

At a minimum you need to enter in the path to the Run Tool project to be scheduled. If you want to make use of Ouvvi App Settings in your Run Tool Project then add each of them as a new line under the App Settings section.

RunTool Project Step Configuration

ParameterValue
Run Tool Project FilenameThe file location of the Run Tool Project.
Connection Library PathOptional, this overrides the connection library to use the one at the path specified here. Useful for if you have multiple connection libraries (e.g. DEV, PROD & UAT).
TimeoutEnter in a time for the timeout
Run TimeIf you need to use the 32 bit version of the Run Tool set the run time to be 32 bit.
App SettingsEnter in the name and value of the Ouvvi App Setting you want to pass to your Run Tool Project.
ConfigurationOptional, use this to override the configuration with another config file.

Adding a Source Control Step

If you are using source control with your Run Tool Project you may want to add an additional step before the Run Tool step to pull the latest version.

You can do this by adding an External Program step that calls GIT to get the latest version. The step configuration for this might look similar to the following.

GIT Pull Step

ParameterValue
Working DirectoryThe path to the directory where your Run Tool project is stored.
Programgit.exe
Argumentspull , to pull in the changes from the origin.
TimeoutThe time it will take for the request to timeout.

Troubleshooting

If the GIT Pull step errors, it is most likely because there are uncommitted changes locally. Please check this and then try running the step again.

The GIT step may also fail due to credentials, if your account has MFA you will need to grant the credential manager access/ permission via OAuth.

The step will also fail if it is not pushed to the origin as there will be nothing to pull.