CSM 10.5 Documentation

Home

Knowledge Article Workflow One-Step Actions

CSM provides numerous OOTB Knowledge Article workflow One-Step™ Actions.

The following One-Step Actions are used to process the Knowledge Article workflow:

  • Submit For Review
  • Technical Review Complete
  • Format Review Complete
  • Publish

"Submit For Review" One-Step Action

The "Submit For Review" One-Step Action runs when the user selects Next: Technical Review on the Knowledge Article form.

  • Scope: Blueprint
  • Description: Knowledge Article submitted for technical review.
  • Conditions: One-Step Action is allowed to run against: Single record or a group of records.

Submit For Review Steps

Step Name Description Action(s) Expression(s)
Show a Popup When the creator of the Knowledge Article selects Next: Technical Review on the Knowledge Article form, a pop-up message appears thanking the creator for the submission.

Automated: Displays pop-up message.

User: Selects OK button.

Step only runs if expression is True:

Knowledge Article.Status is not equal to Retired

Create Audit Record Adds two audit records to the History tab: (1) the name of the User who created the Knowledge Article and (2) the name of the user who submitted the Knowledge Article. Automated: Adds an audit record using template text in the

'Article Creator: [Knowledge Article.Created By] field

Article was submitted for technical review by: [CurrentUserDisplayName]'

Step only runs if expression is True:

Knowledge Article.Status is not equal to Retired

Set Status to Technical Review Changes the status to Technical Review and the Next Status to Technical Review Complete. Automated: Changes the status to Technical Review and the Next Status to Technical Review Complete. Saves the Business Object after action.
Set Assigned Team Sets the Assigned team to the same value as the Technical Review team. Automated: Changes the Assigned Team field to match the Technical Review Team field. Saves the Business Object after action. The value of the Technical Review team is determined by the selection made on the Knowledge Article form in the Category field. See the table in OOTB Knowledge Management Teams for a list of teams and how they correlate with the selected Category.
Email Technical Review Team Sends an email to the Technical Review team informing them that the Knowledge Article is ready for review and attaches the email record to the Knowledge Article's history. Automated: Email sent to the Technical Review team via the default user account.
  • To: [To Email]
  • Subject: Please Review Knowledge Article [Knowledge Article.Knowledge Article ID]
  • Format: HTML format (*.html;*.htm)
  • Priority: Normal

Email record is also:

  • Attached to the current record's history.
  • Attached to recipients in To line.
  • Attached to recipients in CC line.

The Technical Review team is determined by the selection made on the Knowledge Article form in the Category field. See the table in OOTB Knowledge Management Teams for a list of teams and how they correlate with the selected Category.
Refresh Runs the Refresh command to update the display. Automated: Runs the Refresh command.

"Technical Review Complete" One-Step Action

The "Technical Review Complete" One-Step Action runs when the user selects Next: Technical Review Complete on the Knowledge Article form.

  • Scope: Blueprint
  • Description: Technical Review Team has completed its review of the Knowledge Article.
  • Conditions: One-Step Action is allowed to run against: Single record or a group of records.

Technical Review Complete Steps

Step Name Description Action(s) Expression(s)
Must be a Technical Review Team Member

If a user who is not a member of the Technical Review team selects Next: Technical Review Complete, a pop-up message displays stating, "You must be a member of the Technical Review team."

Automated: Displays pop-up message.

User: Selects OK button.

Step only runs if expression is True; otherwise the One-Step Action continues to the next step:

"Is Member of Technical Review Team" expression equals False

Technical Review Team If the user who selected Next: Technical Review Complete is not a member of the Technical Review team, the One-Step Action stops running.

If the user is a member of the Technical Review team, the One-Step Action continues to the next step.

Automated: One-Step Action stops running if user is not a member of the Technical Review team; otherwise it continues to the next step.

Step only runs if expression is True; otherwise the One-Step Action continues to the next step:

"Is Member of Technical Review Team" expression equals False

Decide Between Multiple Cases Determines which of the following paths to take based on specific field values on the form:
  • Set Status to Format Review (if the Visible on Customer Portal check box is selected)
  • Set Status to Pending Publish Date (if the publish date is set to the future)
  • Set Status to Published (default path if none of the above conditions are True)
Automated: Follows the path where the expression is True. One-Step Action follows one of three paths where expression is True with priority from top to bottom as follows:
  • Follow path to Set Status to Format Review step if: Knowledge Article.Visible to Customer Portal equals True
  • Follow path to Set Status to Pending Publish Date step if: Knowledge Article.Publish Date (date) is greater than CurrentDateTime()
  • If none of the above conditions are True, the Default path is to the Set Status to Published step.
Set Status to Format Review If the Visible on Customer Portal check box is selected, changes the KA status to Format Review and the Next Status Text to Format Review Complete. Automated: Changes the status to Format Review and the Next Status Text to Format Review Complete. Saves the Business Object after action.
Set Status to Pending Publish Date If the publish date is set to the future, changes the KA status to Pending Publish Date. Automated: Changes the status to Pending Publish Date.
Set Status to Published If the Visible on Customer Portal check box is not selected and the publish date is not set to the future, changes the KA status to Published and the Next Status Text to Retire this Article.

The Publish One-Step Action runs.

Automated: Changes the status field to Published and the Next Status Text to Retire this Article.

The Publish One-Step Action runs.

Set Assigned Team Sets the Assigned Team field to the same value as the Format Review team. Automated: Changes the Assigned team to match the Format Review team. Saves the Business Object after action. The Format Review team is determined by the selection made on the Knowledge Article form in the Category field. See the table in OOTB Knowledge Management Teams for a list of teams and how they correlate with the selected Category.
Set Assigned To Saves the Knowledge Article. Automated: Saves the Business Object after action.
Email Format Review Team Sends an email to the Format Review team informing them that the Knowledge Article is ready for review and attaches the email record to the Knowledge Article's History. Automated: Email sent to the Format Review team via the default user account.
  • To: [To Email]
  • Subject: Please Review Knowledge Article [Knowledge Article.Knowledge Article ID]
  • Format: HTML format (*.html;*.htm)
  • Priority: Normal

Email record is also:

  • Attached to the current record's history.
  • Attached to recipients in TO line.
  • Attached to recipients in CC line.

The Format Review team is determined by the selection made on the Knowledge Article form in the Category field. See the table in OOTB Knowledge Management Teams for a list of teams and how they correlate with the selected Category.

"Format Review Complete" One-Step Action

The "Format Review Complete" One-Step Action runs when the user clicks Next: Format Review Complete on the Knowledge Article form.

  • Scope: Blueprint
  • Description: Format Review team has completed its review of the Knowledge Article.
  • Conditions: One-Step Action is allowed to run against: Single record or a group of records.

Format Review Complete Steps

Step Name Description Action(s) Expression(s)
Format Review Team (1)

If a user who is not a member of the Format Review team selects Next: Format Review Complete, a pop-up message displays stating, "You must be a member of the Format Review Team."

Automated: Displays pop-up message.

User: Selects OK button.

Step only runs if expression is True; otherwise the One-Step Action continues to the next step:

"Is Member of Format Review Team" expression equals False

Format Review Team (2) If the user who selects Next: Format Review Complete is not a member of the Format Review team, the One-Step Action stops running.

If the user is a member of the Format Review team, the One-Step Action continues to the next step.

Automated: One-Step Action stops running if User is not a member of the Format Review Team; otherwise it continues to the next step.

Step only runs if expression is False; otherwise the One-Step Action continues to the next step:

"Is Member of Format Review Team" expression equals True

Set Assigned Team Sets the Assigned Team field to the same value as the Technical Review Team. Automated: Changes the Assigned team to match the Technical Review team. Saves the Business Object after action. The Technical Review team is determined by the selection made on the Knowledge Article Form in the Category field. See the table in OOTB Knowledge Management Teams for a list of teams and how they correlate with the selected Category.
Decide Between Multiple Cases Determines which of the following paths to take based on specific field values on the form:
  • Set Status to Pending Publish Date (if the Publish Date is set to the future)
  • Set Status to Published (default path if above condition is not True)
Automated: Follows the path where the expression is True. One-Step Action follows one of three paths where expression is True with priority from top to bottom as follows:
  • Follow path to Set Status to Pending Publish Date step if: Knowledge Article.Publish Date (date) is greater than CurrentDateTime()
  • If the above condition is not True, the default path is to the Set Status to Published step.
Set to Pending Publish Date If the Publish Date is set to the future, changes the KA status to Pending Publish Date. Automated: Changes the status to Pending Publish Date.
Set to Published If the Publish Date is not set to the future, changes the KA status to Published and the Next Status text to Retire this Article.

The Publish One-Step Action runs.

Automated: Changes the status to Published and the Next Status text to Retire this Article.

The Publish One-Step Action runs.

Publish One-Step Action

If a Knowledge Manager is also the creator of KA, they can bypass the KA workflow and go straight to publishing the article.

As part of the KA workflow, the Publish One-Step Action runs once the status on the Knowledge Article form changes to Published via the Technical Review Complete or Format Review Complete One-Step Actions.

  • Scope: Blueprint
  • Description: KA is published.
  • Conditions: One-Step Action is allowed to run against: Single record or a group of records.

Publish Steps

Step Name Description Action(s) Expression(s)
Publish This One-Step Action can be manually run by a member of the Knowledge Management team.

User: Can manually run this One-Step Action if a member of the Knowledge Management team.

Step only runs if expression is True:

CurrentUserRecordID() Is member of team [GUID]

The GUID in this expression is the TeamDef ID of the Knowledge Management team.
Publish and Verify Visibility to the Portal Sets the Published Date, Status, and Visible to Customer Portal (if applicable) fields. Automated: Sets the Published Date to the Current Date and Time.

Changes the Status to Published.

Prompts for the CSM Portal, if visible.

Published Date set by custom expression: CurrentDateTime
Reset Review Date Runs the Reset Review Date One-Step Action. Automated: Runs the Reset Review Date One-Step Action, which sets the Review Date to one year from the current date. (This field can also be manually modified on the Knowledge Article form.)

Additional One-Step Actions

A full list of One-Step Actions is beyond the scope of this document. Export a schema document from CSM Administrator (Create a Blueprint > Tools > Export Schema) to view a full list of One-Step Actions associated with a particular type of Business Object (example: Major).

Was this article useful?