External Program
Starts an external program from Ouvvi.
To create this step select External Program from the list and start by entering a name for the step. Then enter in the parameters required to execute the program you want to run. There are a few examples below such as using WinSCP, GIT, or running visual basic scripts to help guide you.
Parameter | Value |
---|---|
Working Directory | The path to the directory where the program is stored. |
Program | The name of the external program file. |
Arguments | The arguments to apply. |
Timeout | The time it will take for the request to timeout. |
Run Scripts
You can run scripts, such as Visual Basic, in the external program step by calling the cscript.exe.
Ouvvi will also capture the script output to the log.
You need to set the Program parameter to cscript.exe
and the Arguments parameter to the path to your script. e.g. C:\Temp\Test.vbs
Git Pull
You can use the external program step to pull the latest changes from a Git repo by calling the git.exe
program.
You need to set the working directory to be the path to your local repository, the program parameter to git
, and the arguments should be pull
.
You can push changes to a repository by changing the argument to push
.
WinSCP to connect to SFTP
For SFTP File Downloads and Uploads in Ouvvi you can either use a Data Sync project with the WinSCP connector or you need to use WinSCP in the external program step.
In the external program step set the program to be the path to the winscp.exe
and then enter your command into the arguments field.
You can save the path to the program as a user setting and call the user setting in the program field e.g. {{WinSCPPath}}
.
An example for uploading a file to a folder in the FTP Server is:
Make sure to enter in the root path to your file into the working directory otherwise you may get an error stating file is not found.
Troubleshooting
If you have issues where your files don't seem to be synchronising you should take a look at your WinSCP logs. These will tell you what is causing the error when you try to run it from Ouvvi.
Alternatively it could be a permissions issue relating to writing the WinSCP log files, where the Ouvvi service account doesn't have permission to write to the log. For this you either need to enable permissions or set an execution context with credentials that have permission to write.