Skip to content

Assigning a Tag to a Case in CRM Channel

Scenario

Use this example when a process should add case tags automatically from data entered by the user. The scenario uses a CRM-style channel so the case can collect tags derived from the process form.

Prerequisites

  • permission to create folders, processes, and channels
  • access to postwork scripting
  • case handling enabled in the target channel

Steps

Create the Folder and Process

  1. Create an application folder, for example Order Information.
  2. Create a new process in that folder and open it in edit mode.

Build the Tasks

  1. Rename the opening task to Order Information Request.
  2. Add the Submit action.
  3. Create the second task Order Information Check.
  4. Mark the task that should interact with the case as Is Case Handler.

Process diagram with the order information tasks and actions.

Add the Tagging Logic

Open the postwork of the case-handling task and add code similar to the following:

1
2
3
4
var tag = $Xml.Evaluate('ComplaintForm/ProductType/Text');
var tags = $Xml.Evaluate('ComplaintForm/NameSurname');

$Case.Tags = [tags, tag];

This postwork takes values from the form data and writes them into the case tag collection.

Design the Form

  1. Open the form for the process.
  2. Create the row-content layout for the order information fields.
  3. Add a text field for the customer name.
  4. Add a dropdown for the product type and populate the static list items.

Form designer with the customer name and product type controls.

Save and Commit the Process

  1. Close the designer tab.
  2. Commit the process changes.
  3. Close the process editor.

Create the Channel

  1. Create a new group channel for customer complaints or CRM follow-up.
  2. Enable cases for the channel.

Channel creation dialog with cases enabled.

  1. Open channel edit.
  2. Go to Related Process.
  3. Add the process you created and save the channel.

Related process configuration in the channel editor.

Create a Case and Start the Process

  1. Create a new case in the channel.
  2. Open the process from the case page.
  3. Fill in the customer name and select the product type.
  4. Submit the first task and then complete the follow-up task.

Started process form with values that will become case tags.

Verify the Tags

Return to the case or the channel case list and confirm that the tag values were added from the submitted process data.

Open case list showing the tags created from process data.

Result

The case now receives tags automatically from the process form, allowing the channel team to filter and categorise cases without adding tags manually.