  

 

Tracelink University

 ## Breadcrumb

1. [Home](/)
2. [Resources](/resources/resource-center)
3. [TraceLink University](/resources/tracelink-university)
 
  

 

 

# Configure TraceLink for Process Orchestration for Empowered Teams

 

 

 

 

 

 

 

 

- [Download PDF](/node/628241/pdf)
- [Share](#)
    - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/configure-tracelink-process-orchestration-empowered-teams&title=Configure TraceLink for Process Orchestration for Empowered Teams&summary=See the Administer Help CenterAdminister Help Center for information about how to configure Process Orchestration for Empowered Teams, link Partners, and add users. &source=TraceLink "LinkedIn")
    - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/configure-tracelink-process-orchestration-empowered-teams&t=Configure TraceLink for Process Orchestration for Empowered Teams "Facebook")
    - [ Mail ](mailto:?subject=Configure TraceLink for Process Orchestration for Empowered Teams+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/configure-tracelink-process-orchestration-empowered-teams "Mail")
    - [ Twitter ](https://twitter.com/intent/tweet?text=Configure TraceLink for Process Orchestration for Empowered Teams https://www.tracelink.com/resources/tracelink-university/configure-tracelink-process-orchestration-empowered-teams&via=TraceLink "Twitter")
 
 

 

 

 

 

#### Table of contents

 

 

 

## Configure Process Orchestration for Empowered Teams

See the [Administer Help Center](https://opus.tracelink.com/documentation/prod/en-US/administer/Content/global_topics/landing_page.htm)Administer Help Center for information about how to configure Process Orchestration for Empowered Teams, link Partners, and add users.

[![Closed](/sites/default/files/tech_comms/poet/Skins/Default/Stylesheets/Images/transparent.gif)](#)<a name="processnetworkconfigoverview"></a>[Process network configuration overview](#)The Process Network configuration in POET defines how business objects such as Work Items, Items, and Compliance Exceptions behave within a process network. This configuration allows you to:

- Customize behavior for each object type
- Define prefixes for each object type
- Configure due dates and notifications
- Control outbound integrations
 
The configuration uses a modular structure where:

- Global settings apply at the process network level
- Object-specific settings are defined per object type using objectTypeConfigurations
 
 

 

[![Closed](/sites/default/files/tech_comms/poet/Skins/Default/Stylesheets/Images/transparent.gif)](#)<a name="processNetworkLevel"></a>[How to configure settings at the process network level](#)Settings at the process network level are applied globally to all objects used in the solution. However, object-specific settings are applied at individual object level and will override the process network settings.

To configure settings for the process network in POET, follow the steps listed below:

1. Send a POST request to:  
    `POST https://{{host}}/api/events`  
    with the following event name:  
    `agile-process-teams:edit-process-network-config:v8`
2. To define the header, include the required metadata in the following format:
    
    ```plaintext
    "header": {
      "headerVersion": 1,
      "eventName": "agile-process-teams:edit-process-network-config:v8",
      "ownerId": "<owner-id>",
      "processNetworkId": "<process-network-id>",
      "appName": "agile-process-teams",
      "dataspace": "default"
    }
    ```
3. Add general settings that apply to the entire process network in the following format:
    
    ```plaintext
    "payload": {
      "processNetworkId": "<process-network-id>",
      "enableNotificationForActionInitiator": true,
      "generalConfigurations": [
        {
          "configurationType": "maxNumberOfRecentCommentsToInclude",
          "configurationValue": "3"
        }
      ]
    }
    ```
4. Define behavior for each object type using `objectTypeConfigurations`. Each entry must include the `objectType` and `generalConfigurations`:
    
    ```plaintext
    "objectTypeConfigurations": [
      {
        "objectType": "workItem",
        "generalConfigurations": [
          {
            "configurationType": "prefix",
            "configurationValue": "WI"
          },
          {
            "configurationType": "defaultDueDateInDays",
            "configurationValue": "5"
          }
        ]
      }
    ]
    ```
5. Send the full payload to apply the configuration. Note that only the fields included in the request are updated.
 
 

 

[![Closed](/sites/default/files/tech_comms/poet/Skins/Default/Stylesheets/Images/transparent.gif)](#)<a name="objectConfig"></a>[How to configure settings at the object level](#)Object-specific settings are defined per object type using objectTypeConfigurations. These settings are particularly useful when a solution includes multiple object types that need custom settings as per business use. For example, the default due date for a compliance exception can be different from that of a change request. You can set the following configurations for every object type:

      Configuration Description     prefix Display ID prefix (e.g., WI, DSCSA).   defaultDueDateInDays Default due date from creation.   maxNumberOfRecentCommentsToInclude Comments included in notifications.   outbound Transform name and version.   outboundTransactionFlag Enable or disable outbound transactions.   outboundB2BTransactionTypeName Required for outbound transactions.   assignToUserB2BTransactionTypeName Used for assignment-related transactions.   These settings allow you to control notifications, ID prefix, and outbound integration.

#### Sample Object Configurations

If your solution includes a single business object such as work item, then see the following sample configuration:

```plaintext
{
  "objectTypeConfigurations": [
    {
      "objectType": "workItem",
      "generalConfigurations": [
        {
          "configurationType": "maxNumberOfRecentCommentsToInclude",
          "configurationValue": "2"
        },
        {
          "configurationType": "defaultDueDateInDays",
          "configurationValue": "5"
        },
        {
          "configurationType": "prefix",
          "configurationValue": "WI"
        },
        {
          "configurationType": "outbound",
          "configurationValue": "POET_WorkItemBOToCanonical:v3"
        },
        {
          "configurationType": "outboundTransactionFlag",
          "configurationValue": "false"
        },
        {
          "configurationType": "outboundB2BTransactionTypeName",
          "configurationValue": "APT_WORK_ITEM_ADVISEMENT"
        },
        {
          "configurationType": "assignToUserB2BTransactionTypeName",
          "configurationValue": "POET_WORK_ITEM_ASSIGN_TO_USER"
        }
      ]
    }
  ]
}
```

 

 

If your solution includes multiple business objects, then see the following sample configuration:

```plaintext
{
  "objectTypeConfigurations": [
    {
      "objectType": "workItem", 
      "generalConfigurations": [
        {
          "configurationType": "maxNumberOfRecentCommentsToInclude",
          "configurationValue": "2"
        },
        {
          "configurationType": "defaultDueDateInDays",
          "configurationValue": "5"
        },
        {
          "configurationType": "prefix",
          "configurationValue": "WI"
        },
        {
          "configurationType": "outbound",
          "configurationValue": "POET_WorkItemBOToCanonical:v3"
        },
        {
          "configurationType": "outboundTransactionFlag",
          "configurationValue": "false"
        },
        {
          "configurationType": "outboundB2BTransactionTypeName",
          "configurationValue": "APT_WORK_ITEM_ADVISEMENT"
        },
        {
          "configurationType": "assignToUserB2BTransactionTypeName",
          "configurationValue": "POET_WORK_ITEM_ASSIGN_TO_USER"
        }
      ]
    },
    {
      "objectType": "ext_TRACELINK_poetComplianceException",
      "generalConfigurations": [
        {
          "configurationType": "defaultDueDateInDays",
          "configurationValue": "5"
        },
        {
          "configurationType": "prefix",
          "configurationValue": "DSCSA"
        },
        {
          "configurationType": "outbound",
          "configurationValue": "POET_ComplianceExceptionBOToCanonical:v2"
        },
        {
          "configurationType": "outboundTransactionFlag",
          "configurationValue": "false"
        },
        {
          "configurationType": "outboundB2BTransactionTypeName",
          "configurationValue": "POET_COMPLIANCE_EXCEPTION_ADVISEMENT"
        },
        {
          "configurationType": "assignToUserB2BTransactionTypeName",
          "configurationValue": "POET_COMPLIANCE_EXCEPTION_ASSIGN_TO_USER"
        }
      ]
    },
    {
      "objectType": "item",
      "generalConfigurations": [
        {
          "configurationType": "prefix",
          "configurationValue": "ITEM"
        }
      ]
    }
  ]
}
```

 

 

 ![](/sites/default/files/tech_comms/poet/Content/Resources/Images/global_images/note_tip_24x24.png) If your solution includes custom or marketplace object types, use the `ext_TRACELINK_` prefix. For example: `ext_TRACELINK_poetComplianceException`.

 

 

[![Closed](/sites/default/files/tech_comms/poet/Skins/Default/Stylesheets/Images/transparent.gif)](#)<a name="processnetworkconfigoverview"></a>[Sample API Configuration for Process Network and Object Configurations](#)The following is sample API configuration that includes settings at the process network level and the object level.

```plaintext
{
    "header": {
        "headerVersion": 1,
        "eventName": "agile-process-teams:edit-process-network-config:v8",
        "ownerId": "{{ownerID}}",
        "processNetworkId": "{{processNetworkID}}",
        "appName": "agile-process-teams",
        "dataspace": "default"
    },
    "payload": {
        "processNetworkId": "{{processNetworkID}}",
        "enableNotificationForActionInitiator": true,
        "generalConfigurations": [
            {
                "configurationType": "maxNumberOfRecentCommentsToInclude",
                "configurationValue": "3"
            }
        ],
        "objectTypeConfigurations": [
            {
                "objectType": "workItem",// example for a base type
                "generalConfigurations": [
                    {
                        "configurationType": "maxNumberOfRecentCommentsToInclude",
                        "configurationValue": "2"
                    }
                    {
                        "configurationType": "defaultDueDateInDays",
                        "configurationValue": "5"
                    },
                    {
                        "configurationType": "prefix",
                        "configurationValue": "WI"
                    },
                    {
                        "configurationType": "outbound",
                        "configurationValue": "POET_WorkItemBOToCanonical:v3"
                    },
                    {
                        "configurationType": "outboundTransactionFlag",
                        "configurationValue": "false"
                    },
                    {
                        "configurationType": "outboundB2BTransactionTypeName",
                        "configurationValue": "APT_WORK_ITEM_ADVISEMENT"
                    },
                    {
                        "configurationType": "assignToUserB2BTransactionTypeName",
                        "configurationValue": "POET_WORK_ITEM_ASSIGN_TO_USER"
                    }
                ]
            },
            {
                "objectType": "ext_TRACELINK_poetComplianceException",// example for a subtype
                "generalConfigurations": [
                    {
                        "configurationType": "defaultDueDateInDays",
                        "configurationValue": "5"
                    },
                    {
                        "configurationType": "prefix",
                        "configurationValue": "DSCSA"
                    },
                    {
                        "configurationType": "outbound",
                        "configurationValue": "POET_ComplianceExceptionBOToCanonical:v2"
                    },
                    {
                        "configurationType": "outboundTransactionFlag",
                        "configurationValue": "false"
                    },
                    {
                        "configurationType": "outboundB2BTransactionTypeName",
                        "configurationValue": "POET_COMPLIANCE_EXCEPTION_ADVISEMENT"
                    },
                    {
                        "configurationType": "assignToUserB2BTransactionTypeName",
                        "configurationValue": "POET_COMPLIANCE_EXCEPTION_ASSIGN_TO_USER"
                    }
                ]
            },
            {
                "objectType": "item",
                "generalConfigurations": [
                    {
                        "configurationType": "prefix",
                        "configurationValue": "ITEM"
                    }
                ]
            }
        ]
    }
}
```

 

 

 

 

## Assign Agile Process Teams roles 

See the [Administer Help Center](https://opus.tracelink.com/documentation/prod/en-US/administer/Content/global_topics/landing_page.htm) for information about how to assign Agile Process Teams roles to users.

[![Closed](/sites/default/files/tech_comms/poet/Skins/Default/Stylesheets/Images/transparent.gif)](#)<a name="Roles"></a>[Roles](#)- Member - Expanded Access – Allows users from the Owner to view, add, edit, copy, close, reopen, and export processes (e.g. incidents, compliance exceptions, change requests). Also allows users to submit processes to Partners and submit initial and final responses to processes, if supported. These users see the Expanded Access dashboard on the Monitor screens.
- Partner Member – Allows users from external Partners to view, add, edit, copy, and download processes. Also allows users to submit initial and final responses to processes, if supported. These users see the Standard Access dashboard on the Monitor screens, with information limited further for Partners.
 
 

 

## <a name="Set"></a>Set up notifications

All Process Orchestration for Empowered Teams users can sign up to receive email notifications based on certain events. See the Opus Platform Help Center for more information.

[![Closed](/sites/default/files/tech_comms/poet/Skins/Default/Stylesheets/Images/transparent.gif)Notification types](#)- Item created – The users receive a notification when an item is created.
- Item assigned – The users receive a notification when an item is assigned to a user.
- Item modified – The users receive a notification when an item is modified.
- Item closed – The users receive a notification when an item is closed.
- Work item created – The users receive a notification when a work item is created.
- Work item assigned – The users receive a notification when a work item is assigned to a user.
- Work item modified – The users receive a notification when a work item is modified.
- Work item closed – The users receive a notification when a work item is closed.
 
 

 

## <a name="Change"></a>Specify prefixes for display identifiers

When you create an instance using a business object such as item or work item, the instance shows a prefix in the display identifier. For example, the prefix for a work item instance named WI-123 is WI. An application administrator must specify this prefix for each business item when setting up Process Orchestration for Empowered Teams.

 ![](/sites/default/files/tech_comms/poet/Content/Resources/Images/global_images/note_tip_24x24.png) Contact your TraceLink Services representative for more information about how to set up a prefix for business object.

## <a name="NumberOfComments"></a>Configure Number of Comments in Outbound Emails

When a business object is updated, Tracelink sends email notification with the comments and attachments for that business object. To configure the number of comments displayed in the outbound email, use the following API to specify the number of comments in the `maxNumberOfRecentCommentsToInclude` configuration type.

```plaintext
{
    "payload": {
        "prefix": "daac",
        "processNetworkId": "{{POET_processNetworkId}}",
        "generalConfigurations": [
          {
              "configurationType": "maxNumberOfRecentCommentsToInclude",
              "configurationValue": "5"
          }
        ]
        "objectTypeConfigurations": [
            {
                "objectType": "ext_TRACELINK_reviewBatchRecord",
                "generalConfigurations": [
                    {
                        "configurationType": "defaultDueDateInDays",
                        "configurationValue": "5"
                    },
                    {
                        "configurationType": "prefix",
                        "configurationValue": "BRRM"
                    },
                    {
                         "configurationType": "maxNumberOfRecentCommentsToInclude",
                         "configurationValue": "5"
                   }
                ]
            }
        ]
    }
}
```

 

 



 

 

 

 

#### Table of contents

 

 

 

 

 

 



 

##### Related Content

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/chat-bubble-question.svg) ](/resources/tracelink-university/modify-your-account) 

#####  Modify your account 

 Modify your profile, define app settings, and enable inbox messages and notifications. 

 

 [View More](/resources/tracelink-university/modify-your-account) 

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/chat-bubble-question.svg) ](/resources/tracelink-university/switch-companies-or-environments) 

#####  Switch companies or environments 

 The OPUS Ensemble user experience allows you to switch between companies or environments that you have access to with the same user account (identified by an email) without logging into a separate URL. 

 

 [View More](/resources/tracelink-university/switch-companies-or-environments) 

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/chat-bubble-question.svg) ](/resources/tracelink-university/navigate-help-documentation-and-support) 

#####  Navigate to help documentation and support 

Select the Help Center icon in the header to access the one-stop-shop help center for everything related to the network you are currently within (e.g.

 

 

 [View More](/resources/tracelink-university/navigate-help-documentation-and-support)