Configuring SAS Workflow for Use with SAS Model Manager

Overview

SAS Workflow provides services that work together to model, automate, integrate, and streamline business processes. It provides a platform for more efficient and productive business solutions.
SAS Workflow is used by SAS solutions that benefit from business process management. SAS Workflow Studio is a desktop client application that is used to design and deploy workflow definitions. The SAS middle tier hosts the workflow engine and the workflow services as part of the SAS Web Infrastructure Platform. The SAS Model Manager Workflow Console is used to manage the workflows that are associated with versions in a modeling project. For more information about SAS Workflow, see SAS Workflow in SAS Intelligence Platform: Middle-Tier Administration Guide.
To use SAS Workflow with SAS Model Manager, be sure the following prerequisites are met:
  1. SAS Workflow Engine, SAS Workflow Services, and SAS Workflow Studio must be installed and configured. For more information, see SAS Intelligence Platform: Installation and Configuration Guide
  2. If you want to receive notifications for a workflow, you can configure alert notifications using SAS Management Console. For more information, see Configuring Alert Notifications for SAS Workflow.
  3. Workflow definitions must be created using SAS Workflow Studio. For more information about creating workflow definitions, see the SAS Workflow Studio: User's Guide.

Guidelines for Creating Workflow Definitions

When you create workflow definitions in SAS Workflow Studio to use with SAS Model Manager, follow these guidelines:
  • Participants, and policies must be added to the task level. Statuses added at the task level and the default statuses at the workflow definition level can be used for a task status. Data objects can be added at the workflow definition level or task level.
    Note: The tasks that are defined in SAS Workflow Studio as part of a workflow definition are displayed as activities in the SAS Model Manager Workflow Console.
  • Only the Potential Owner and Business Administrator workflow roles are used by SAS Model Manager and they can be used in either a participant or swimlane definition.
  • In order to assign additional participants to activities using the Workflow Console, the user must have or be in a group that is assigned the workflow role of business administrator. Also, in order to create new workflows and assign participants, the user must be in the Model Manager Administrator Users group or in a group that is associated with the Model Manager Administrator Users group in SAS Management Console.
    The Create a workflow instance capability must be enabled for the usage role that is associated with a user or group in order for them to be able to create workflows. By default this capability is enabled for the Model Manager: Administration Usage role that is associated with the Model Manager Administrator Users group. You can access the capability from the Capabilities tab in the Role Properties window. In the assigned capabilities tree, expand Model Manager JavaSvcs 12.3then selectWorkflow Service.
    The following SAS Model Manager groups are created at installation time:
    • Model Manager Administrator Users Group (mdlmgradminusers)
    • Model Manager Advanced Users Group (mdlmgradvusers)
    For more information, see Configuring Users, Groups, and Roles.
  • Only workflow definitions that are in the Workflow repository, with the mmapi tag attribute specified in the file properties, are available to SAS Model Manager in the Workflow Console.

How to Associate a Model Management Component with a Workflow Activity

You can associate a model management component with an activity (or task) as part of creating a workflow definition. First you must create a workflow definition using SAS Workflow Studio. Add the tasks, statuses, and data objects that you want to include in your workflow. For more information about creating a workflow definition, see the SAS Workflow Studio: User's Guide.
To associate a model management component with an activity:
  1. Start SAS Workflow Studio, and then open a workflow definition.
  2. Expand the Tasks node in the workflow tree.
  3. Expand a task node, right-click the Data Objects folder, and select the New Data Object menu option.
    New Data Object
  4. Enter MM_TaskToDo for the data object label.
  5. Select Short Text from for the type of data object.
  6. Enter the model management component directory path and XML filename in the Text property. The directory path is ConfigTemplates/nodeTemplates/<XML-filename>. See List of Model Management Components to get the appropriate XML filename.
    New Data Object Populated
  7. Click OK.
  8. Repeat steps 3 through 7 for each task that you want to associate a model management component.
List of Model Management Components
Model Management Component Name
Description
XML Filename
Add Documents
This component enables you to attach documents to the Documents folder at the project, or version level.
AddDocument.xml
Import Models
This component enables you to import models from the SAS Metadata Repository, a SAS package file (.spk), or a PMML file (.xml) into the version that is associated with the workflow.
ModelRegistration.xml
Publish Models
This component enables you to publish champion and challenger models from the model repository to the SAS Metadata Repository or to a database.
ModelPublish.xml
Set Champion and Challenger
This component enables you to set a project champion model and challenger models.
SetChampionOrChallenger.xml
View Models
This component enables you to view a list of the models. You can also view model information such as properties, model variables, score code, model files, notes, and history. By default, the Model Viewer component is available from both the Import Models and also the Set Champion and Challenger components.
GenericModelViewer.xml
View Model Performance
This component enables you to view the performance of the project champion model through a series of charts. The performance charts are generated using performance tasks in the SAS Model Manager client application.
PerformanceView.xml
View Reports
This component enables you to view reports that have been created using the Workflow Console or by using the New Report wizard under the associated version in the SAS Model Manager client application.
ReportsView.xml
Create and View Reports
This component enables you to create and view reports. Reports that were created using the New Report wizard under the associated version in the SAS Model Manager client application are displayed as well.
ReportsViewAndCreation.xml
Utility
This component consists of all of the available model management components.
Utility.xml
Note: The list of the model management components that can be configured to be used with the SAS Model Manager Workflow Console can also be found at http://server-name:port/SASContentServer/repository/default/ModelManager/ConfigTemplates/nodeTemplates/

How to Associate a Milestone with a Workflow Activity

You can specify the process type of milestone for a workflow definition and associate a milestone ID with an activity (or task) as part of creating a workflow definition. This enables the workflow and tasks that are associated with a version to appear on the Workflow Milestones tab in the version details view, and in the Workflow Milestones Report in SAS Model Manager.
First you must create a workflow definition using SAS Workflow Studio. Add the tasks, statuses, and data objects that you want to include in your workflow. For more information about creating a workflow definition, see the SAS Workflow Studio: User's Guide.
To specify the process type of milestone for a workflow definition, you must add a data object for the process type at the workflow definition level. To add the Process Type data object at the workflow definition level:
  1. Start SAS Workflow Studio, and then open a workflow definition.
  2. Right-click the Data Objects folder, and select the New Data Object menu option.
    New Data Object
  3. Enter Process Type for the data object label.
  4. Select Short Text from for the type of data object.
  5. Enter Milestone in the Text property.
    New Data Object Populated
  6. Click OK.
To associate a milestone ID with a task:
  1. Start SAS Workflow Studio, and then open a workflow definition.
  2. Expand the Tasks node in the workflow tree.
  3. Expand a task node, right-click the Data Objects folder, and select the New Data Object menu option.
    New Data Object
  4. Enter MM_MilestoneID for the data object label.
  5. Select Short Text from for the type of data object.
  6. Enter a name for the milestone ID in the Text property. The name can be the same as the task name.
    New Data Object Populated
  7. Click OK.
  8. Repeat steps 3 through 7 for each task that you want to associate a milestone ID so that it appears on the Workflow Milestones report.

How to Make Workflow Definitions Available to SAS Model Manager

After you have created a workflow definition in the SAS Workflow Studio, you must make the workflow definition available to SAS Model Manager.
To save the workflow definition to the Workflow repository:
  1. Save the workflow definition to your local drive.
  2. Add the tag attribute of mmapi to the workflow definition file properties.
  3. Verify that the workflow definition appears in the Workflow Definitions category view of SAS Model Manager Workflow Console.
For more information, see Deploying and Maintaining Workflows in SAS Workflow Studio: User's Guide.

Log On to the Server

With SAS Workflow Studio, you are limited to managing locally stored workflow definitions on your system until you have logged on to the SAS Content Server. After you are connected, you can access additional workflow definitions that are stored in the SAS Content Server.
To log on to the server:
  1. From the Server menu, select Log On.
  2. In the Log On window, select the host-name from the SAS environment drop-down list.
    Note: For more information, see Configuring the SAS Environment File in SAS Intelligence Platform: Middle-Tier Administration Guide.
  3. Enter a user ID and password, and click Log On.
  4. Click OK for success message that might appear.

Add Tag Attributes to a Workflow Definition

Only those workflow definitions in the Workflow repository that have the mmapi tag attribute specified in the file properties are available to SAS Model Manager in the Workflow Console.
To add a tag attribute to the file properties of a workflow template in SAS Workflow Studio:
  1. Select Filethen select Properties and click Add.
  2. Enter the tag value of mmapi.
    Note: The file properties are case sensitive. This value must be lowercase.
  3. Click OK twice.

Upload a Workflow Definition

To upload a workflow:
  1. From the Server menu, select the Save to Repository menu option. The Save to Workflow Repository window appears.
  2. (Optional) Enter relevant comments to associate with the workflow definition.
  3. Select the Activate option if you want to activate the current version in the Workflow repository.
  4. Click OK.
  5. Click OK for the success messages that might appear.

Verify That the Workflow Definitions Are Available in the Workflow Console

To verify that the workflow definitions are available in the Workflow Console:
  1. Enter the URL http://hostname:port/SASModelManagerWorkflow in your web browser.
  2. Enter the user ID and password for a SAS Model Manager administrator.
  3. Verify that the uploaded workflow definition appears in the Workflow Definitions category view.

See Also

Using Workflow Console in SAS Model Manager: User's Guide