Knowledge Base Article Workflow

On this page

Default Workflow: This page describes the article statuses, types, and actions of a new Alloy Navigator 2026.1 database created with the Default Workflow. A database upgraded from an earlier version need not have this content, and an administrator may have changed it. See Default Workflow Configuration.

A new 2026.1 database created with the Default Workflow contains no articles and no categories. For the Knowledge Base page, the category tree, and the rule that makes an article visible in the Self Service Portal, see Knowledge Base.

The actions on this page are workflow actions of the article; for where the Web App lists them, see Actions in the Web App.

Create an article

The actions How-to Article, Known Issue Article, Reference Article, and Troubleshooting Article create an article, and in the Web App the New menu of the article grid lists them. All four use the same form, with the owner, the service, the title, the public flag, and the content. All four start the new article at Draft with the public flag cleared, so the article is private unless you set the flag on the form. In the supplied configuration, the article form captions the public flag Visible in the Self Service Portal.

The Self Service Portal shows an article only at Live with its public flag set; see Make an article visible in the Self Service Portal. An article gets there through approval or without it.

Publish an article through approval

  1. Run Create Approval, offered at Draft or Live. It creates an approval stage with its approvers; see Request an approval.
  2. Run Request Approval, offered at Draft once the article has an approval stage with a pending request. It sets the article to Pending Approval and sends the requests to the approvers.
  3. Each approver runs Approve Request or Reject Request. Both are offered at Pending Approval, and only to the approvers the request is waiting for; see Vote on an approval request.

When the last approval stage created for the article is approved, the article is set to Approved and at once to Live, and its public flag is set. The article does not stay at Approved: it is published. When that stage is rejected, the article is set to Rejected.

Cancel Approvals, offered at Draft or Pending Approval while the article has approval stages that are still pending, sets the article back to Draft.

Publish an article without approval

Make Live, offered at Draft or Approved, sets the article to Live.

To make the article public, use Make Public, which is offered on an article at Approved or Live. It sets the article to Live when the article is not Live already, sets the public flag, records Marked as 'Public', and notifies the article's collaborators (see Add or remove collaborators). An article at Draft therefore takes Make Live and then Make Public.

Withdraw, review, or retire an article

Make Private is offered only on an article at Live. It clears the public flag, so the Self Service Portal no longer shows the article, and records Marked as 'Private'.

Article Reviewed, offered at Live, completes the article's periodic review. The status does not change.

Retire Article, offered at Draft, Approved, Live, or Rejected, opens the Provide a Reason form, sets the article to Retired, and clears its public flag. Unretire Article, offered at Retired, sets the article back to Draft.

Change the owner of an article

To change the owner of an article, run Assign Ownership. It is offered at Draft, Pending Approval, Approved, Rejected, and Live, not at Retired. It is granted to the Administrator (Full), Administrator (Workflow), and Knowledge Base Manager roles, and not to the Knowledge Base Contributor role. In the Web App, Assign Ownership is in the General section of the Action Bar.

The "Assign Ownership" form holds the article's owner, which is required, with Comment and Time Spent. Choose the new owner and submit the form. The action:

  • Changes the article's owner and records the activity "Ownership assigned to <owner>", with the text of Comment as its details.
  • Notifies the article's collaborators with "<your name> assigned ownership to <owner>." while the workflow parameter Notify Collaborators on Events is on; see Add or remove collaborators.
  • E-mails the new owner at their primary e-mail address, with the subject "Assignment (Knowledge Base Article): <title>".

The status does not change.

When you run Assign Ownership, it checks the new owner's primary e-mail address. If the address is blank, the action stops with the message "<owner>'s Primary E-mail does not exist. Please review as this process will result in an E-mail notification." If the address is not in a valid format, the action stops with a message that names the owner and says that the owner's primary e-mail address is not valid. A stopped action saves nothing: the owner is not changed, no activity is recorded, and no e-mail is sent.

Copy an article

To copy an article, run Copy Article. It is offered in every status except Retired, and it is granted to the Administrator (Full), Administrator (Workflow), Knowledge Base Contributor, and Knowledge Base Manager roles. In the Web App, Copy Article is on the toolbar of the article form, not on the Action Bar, and it works on one article at a time.

The "Copy Article" form holds:

  • The title and the content, both optional and pre-filled with the article's.
  • Visible in Self Service Portal, the public flag, pre-filled with the article's.
  • The type, which is pre-filled.
  • Copy Categories, a check box that starts selected.
  • Number of Copies, which is required and starts at 1.

When you submit the form, the action creates the number of copies set in Number of Copies and records the activity "Copied <ID> <n> time(s)" on the article. Each copy:

  • Starts at Draft, with version 1.0.
  • Takes the title, the content, the type, and the public flag from the form, and the notes and the workspace from the article.
  • Is filed in every category of the article when Copy Categories is selected.
  • Gets none of the article's attachments.
  • Is related to the article it was copied from, and records the activity "Knowledge Base Article created by Knowledge Base Article (<ID>)".

The action ends with the message "<n> Knowledge Base Article(s) created under Related Object tab." It opens none of the copies.

Add or remove collaborators

Collaborators are persons who receive updates on important events of the article; Make Public and Assign Ownership notify them. The notifications are sent while the workflow parameter Notify Collaborators on Events is on, as it is in the supplied configuration.

In the Web App:

  1. On the article form, select Collaborators on the toolbar, next to Follow. The Add or Remove Collaborators form opens.
  2. In the Collaborators field, which lists the active persons by name and email, add or remove persons.
  3. Select Submit.

The same form changes the list later: the persons you add become collaborators, and the persons you remove stop being collaborators.

Statuses and types

For Live and the inactive status, the two article statuses that Alloy Navigator itself defines, see Make an article visible in the Self Service Portal.

  • Statuses: besides Live, the statuses Draft, Pending Approval, Approved, and Rejected. The inactive status is named Retired.
  • Types: How-to, Troubleshooting, Known Issue, and Reference.

Actions in the Web App

In the Web App, the article form shows the following actions in these places. For how the Action Bar and the toolbar work, see Actions in the Web App.

  • The General section of the Action Bar holds, in this order, Assign Ownership, Article Reviewed, Make Live, Make Public, Make Private, Retire Article, and Unretire Article.
  • Collaborators, Copy Article, Follow, and Unfollow, listed here in alphabetical order, are on the toolbar of the form, not on the Action Bar. The article's Action Bar has no Relationships section.