Create an SAP workflow on a Duet Enterprise site

Step 1 - Create a site for the workflow

It is sometimes useful to create a site to host workflow tasks. Then, you can be certain that the site contains exactly the features that you want.

If you already have a site configured to host workflows, skip to Step 3 - Configure a new SAP workflow task type later in this article.

To create a Duet Enterprise root workflow site:

1. From the Duet Enterprise-enabled site collection, click the Settings icon and then click Site contents. In the Site Contents page click new subsite.

2. In the New SharePoint site dialog, in the Title and Descriptions pane, enter a name for the new site and a description.

3. In the Web Site Address pane, enter a name for the URL path.
   The URL name that you provide will become the final segment in the whole URL. For example, if you enter WorkflowTasks for the URL. The complete URL might then resemble this example:
   http://MySiteName/SiteColl/WorkflowTasks

4. In the Template Selection pane, select the site template (such as a Team Site template) that you want to use.

5. In the Permissions pane, check Use unique permissions.
   

   Important:  It is very important to use unique permissions. Failure to use unique permissions might make it impossible to access the workflow site, or impossible to view a task.

   In the Navigation Inheritance pane, decide whether you want your workflow site to use the same top link bar that the parent site uses.

6. Click Create to open a page where you can specify user access for the workflow.

7. On the Set Up Groups for this Site page, set up visitor, member, and owner groups for the site, and then click OK.

   How do I set up groups?

   To set up groups for the new workflow site:

8. In the Visitors to this Site pane, do one of the following:

9. Select Use an existing group, and then select the name of the group from the drop-down list

   – OR –

10. Select Create a new group, and then enter a name for the group of visitors.
    Enter one or more names for the users who you want to belong to this group, and then click the check names button.

11. On the Set Up Groups for this Site page, in the Members of this Site pane, do one of the following:

12. Select Use an existing group, and then select the name of the group from the drop-down list

    – OR –

13. Select Create a new group, and then enter a name for the group of members.
    Enter one or more names for the users who you want to belong to this group, and then click the check names button.

14. On the Set Up Groups for this Site page, in the Owners of this Site pane, do one of the following:

15. Select Use an existing group, and then select the name of the group from the drop-down list

    – OR –

16. Select Create a new group, and then enter a name for the group of owners.
    Enter one or more names for the users who you want to belong to this group, and then click the check names button.

    SharePoint Server creates the new site, and then opens it.

Step 2 - Activate the workflow feature

When you activate the workflow feature, SharePoint Server adds the SAP Workflow Configuration section to the Site Settings page and registers theSAP Workflow Site site template.

To activate the Duet Enterprise SAP Workflow feature:

1. From the new site page, click the Settings icon, and then click Site Settings to open the Site Settings page.

2. From the Site Actions group, click Manage site features.

3. Locate Duet Enterprise – SAP Workflow, and then click Activate.

After the feature activates, you can go back to the root site for the workflow.

Step 3 - Configure a new SAP workflow task type

When you configure a new SAP workflow task type, you specify the SAP task type and the possible outcomes that the task can have. SharePoint Server creates a new workspace for the task type. The workspace hosts all the tasks for a workflow task type.

Duet Enterprise includes a site template that you can use to configure a new SAP workflow task type. Alternatively, a site designer can use SharePoint Designer 2013 to customize a workflow for individual business requirements. For example, a site designer might specify that each page on the workflow site include a Related Reports Web Part.

To configure a new SAP workflow task type:

1. From the root workflow site, click the Settings icon, and then click Site settings.

2. On the Site Settings page, locate the SAP Workflow Configuration group, and then click Configure new SAP Workflow task type to open the properties page for the workflow site.

3. On the New SAP Workflow Task Type page, enter a description for this new site.

4. In the Template Selection group, in the Select a template panel, click the Duet Enterprise tab. Then, click SAP Workflow Site, or the name of the custom template that you want to use.

5. In the Task Name group, in the Task name text box, enter the name of the SAP task type.
   

   Note:  The Task name must match the name as it appears in the SAP system. To learn more about task type names, contact your SAP Workflow administrator.

6. In the text box next to Task display name, enter the name that you want to appear on the site.

7. In the Task Outcomes group, in the Possible task outcomes pane, do the following:

   1. In the Text box, enter the name of a possible outcome, such as Approve or Reject. The outcomes that you specify here will appear as buttons on the task form.

   2. In the Key box, enter the numeric key of this outcome, such as 001 or 002.

   3. Click Add Outcome.

   4. Repeat steps a-c until you have finished entering possible outcomes.
      

      Note:  The site designer specifies a certain collection of valid outcomes (text and key values) during the initial setup process. The outcome name and key that you enter in this step must be one of these pre-defined outcomes. For more information about valid outcomes that you can use, contact your SAP Workflow Administrator.

      You must also customize the task details page if you want the extended business property to appear in the approval form. For more information, see Customize a task details page.

      1. To remove a listed outcome, highlight the outcome and then click Remove Selected.

      2. In the Extended business properties text box, enter the names of any extended properties.

         Note:  A site designer or administrator can specify additional properties for an SAP workflow. To learn about any extended business properties that might be required for your site, contact your workflow administrator.

      3. In the External Content Type group, in the External content type text box, enter Workflow Task for this task type. To verify the name of the external content type, click the check button . To select Workflow Task from a list of valid external content types, click the browse button to open the External Content Type Picker dialog. Then, select Workflow Task, and then click OK.

      4. In the Task Deletion group, in the days text box, specify how long to keep a completed task in the task list before deleting the task. The default is 500 days.

      5. Click Create to create the new workflow task workspace site.

      6. When the Site Created Successfully message box appears, click OK to go to the new site page.

Once the workflow task workspace is created you can use the SharePoint Server user interface or SharePoint Designer to customize the site to suit your business needs.

Step 4 - Grant users access

After you create an SAP workflow task type and its site, you are ready to add the users who will receive the tasks from the site. You can add users individually, or add a group of users by adding an appropriate SAP role.

When you grant users access to the SAP workflow task type, Duet Enterprise confirms authorization for the requested user to access the SAP workflow elements.

To grant users access to the SAP workflow task type:

1. Navigate to the root workflow site.

2. Click the Settings icon, and then click Site settings.

3. On the Site Settings page, locate the SAP Workflow Configuration group, and then click Grant user access to SAP workflow tasks to open the User Subscription page.

4. On the User Subscription page, click new item.

5. In the Workflow task type drop-down list, select the task that you want to grant access to.

6. In the User/Role text box, enter the user account of the user for whom you want to grant access. If you want to grant access to all users who have a certain SAP role, enter the name of the role. You can verify the entry that you made by clicking the Check Names button. To browse for a name or role, click the browse button.

7. Click OK to return to the User Subscription page.
   

Step 5 - Publish the workflow

Each unique task in an SAP workflow that is configured to run in SharePoint is implemented as a separate SharePoint Server declarative workflow. You must publish the workflow to make it available to users on the workflow task workspace.

To perform the steps in the following procedure, you must be a site administrator for the workflow task workspace. You must also have SharePoint Designer 2013 installed on the computer from which you are accessing the workflow site.

To publish a workflow:

1. From the workflow task workspace site, click Page.

   Note:  You can use the Task Workspace Locater List to see all the workflow tasks for a root workflow site. From the root workflow site, click the Settings icon and then click Site contents. In the Site Contents page, click Task Workspace Locater List.

2. In the Edit group, click the Edit Page arrow to see more options, and then click Edit in SharePoint Designer. SharePoint Designer will connect to the workflow site automatically. In addition, it opens the workflow on a page that enables you to manage the settings for the workflow site.

3. In the Navigation pane, click Workflows.

4. In the Workflows pane, locate the List Workflow section and the name of the workflow that you want to publish.

   For example, the following illustration shows the TestTask workflow.

   

5. Double-click the name of the workflow to open a page where you can manage settings for the workflow.

6. In the Save group of the ribbon, click Publish.