Workflow Loader Utility for SAS 9.3

Loads existing workflow templates (a single file or a directory of templates) directly into the content repository. The utility can also activate the uploaded templates.

Syntax

java
-Dmulticast.address=nnn.nnn.nnn.nnn
-Dmulticast.port=nnnn
com.sas.workflow.util.checkin.WorkflowLoader
user-ID
password
path
-outputDir directory-name
<-replace>
<-activate>

Required Arguments

-Dmulticast.address=nnn.nnn.nnn.nnn

is the multicast address for the environment where the SAS middle tier is deployed.

-Dmulticast.port=nnnn

is the multicast port number of the SAS middle tier.

-outputDir directory-name

specifies the directory where the modified XML is written if any data types are fixed. The utility automatically fixes any invalid data types by mapping them to appropriate supported types (for example, Short Text). A new file with the corrected data type is created in the directory specified, and the new file is automatically loaded into the content repository.

password

is the password for the specified user.

path

is the fully qualified location of the workflows to load. If a single filename is specified, then the content from that single workflow template file is loaded. If the path resolves to a directory, then the contents of all the files in that directory are loaded.

user-ID

is the ID of a user who is authorized to load content. See Managing Workflow Template Authorization for more information.

Optional Arguments

-activate

activates the template after it is loaded into the repository. If you specify this option, the workflow loader utility uploads the workflow definition to the run-time platform.

-replace

replaces the activated workflow definitions if they already exist in the platform. In the SAS Content Server, this option updates the template version.

Example: BAT File for SAS 9.3 on Windows

Before running this utility, set the path to the local environment file, the user ID, and the password to the correct values for you site.
@echo off
 
: /*--------------------------------------------------------------------\
: !!| Script for executing the WorkflowLoader Utility                     |
: !!|                                                                     |
: \--------------------------------------------------------------------*/
 
setlocal

REM Edit this path to point to the local environment file
call "%~dp0..\..\level_env.bat"
 
REM Define needed environment variables

set SASINSTALLHOME=C:\Program Files\SASHome
set USERID=user
set PASSWORD=password
set MULTICAST=239.21.16.242
set MPORT=31001
set MTTL=32
 
if NOT "%1"=="" set WFTEMPLATE=%1
 
if "%1"=="" set WFTEMPLATE="Basic Approval Process.xml"
 
set LAUNCHERJAR=%SASVJR_HOME%\eclipse\plugins\sas.launcher.jar
 
set UTILITIESDIR=%LEVEL_ROOT%\Web\Utilities
set PICKLISTS=%SASINSTALLHOME%\SASWebInfrastructurePlatform\9.3\Picklists\wars\sas.workflow\**\picklist
set CLASSPATH=%UTILITIESDIR%;%LAUNCHERJAR%
 
REM Run the query test
 "%JAVA_JRE_COMMAND%" ^
  -classpath "%CLASSPATH%"  ^
  -Djava.system.class.loader=com.sas.app.AppClassLoader -Dsas.app.launch.config="%PICKLISTS%" ^
  -Dsas.app.repository.path="%SASVJR_REPOSITORYPATH%" ^
  -Dsas.app.class.path="%UTILITIESDIR%" ^
  -Djava.security.auth.login.config=..\Common\login.config^
  -Djava.net.preferIPv4Stack=true -Djava.net.preferIPv6Addresses=false ^
  -Xms64m -Xmx64m -Dmulticast.address=%MULTICAST% -Dmulticast.port=%MPORT% -Dmulticast_udp_ip_ttl=%MTTL% ^
  com.sas.workflow.util.checkin.WorkflowLoader %USERID% %PASSWORD% -verify
 %*
 
REM Run the upload test
 "%JAVA_JRE_COMMAND%" ^
  -classpath "%CLASSPATH%"  ^
  -Djava.system.class.loader=com.sas.app.AppClassLoader -Dsas.app.launch.config="%PICKLISTS%" ^
  -Dsas.app.repository.path="%SASVJR_REPOSITORYPATH%" ^
  -Dsas.app.class.path="%UTILITIESDIR%" ^
  -Djava.security.auth.login.config=..\Common\login.config^
  -Djava.net.preferIPv4Stack=true -Djava.net.preferIPv6Addresses=false ^
  -Xms64m -Xmx64m -Dmulticast.address=%MULTICAST% -Dmulticast.port=%MPORT% -Dmulticast_udp_ip_ttl=%MTTL% ^
  com.sas.workflow.util.checkin.WorkflowLoader %USERID% %PASSWORD% %WFTEMPLATE% -outputDir "%UTILITIESDIR%" -replace -activate
 %*
 
endlocal
if [%2] EQU [exit] exit %ERRORLEVEL%
Last updated: March 5, 2020