--- title: "Business Rule Designer - Knowledge Management" slug: "business-rules-for-km" status: "update" updated: 2026-11-16T18:46:54Z published: 2026-11-16T18:46:54Z canonical: "help.symphonysummitai.com/business-rules-for-km" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.symphonysummitai.com/llms.txt > Use this file to discover all available pages before exploring further. # Business Rule Designer - Knowledge Management Business Rules for Knowledge Management extend the existing Business Rule Designer to the Knowledge module. A Knowledge Management (KM) administrator can create rules that respond to Knowledge Article (KA) events and automatically send an email notification or invoke an API. This enhancement keeps the same Business Rule experience as other modules, but only shows the fields, operators, recipients, keywords, and actions that apply to Knowledge Management. ### Key benefits - Automates Knowledge Article events without requiring manual monitoring. - Provides a consistent rule-building experience across Knowledge Management and other supported modules. - Supports event-based and scheduled automation. - Enables targeted email notifications using Knowledge-specific recipients and attributes. - Supports integrations with external or internal systems through API actions. - Prevents irrelevant module fields and actions from appearing in Knowledge rules. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/business-rules-for-km-image-iekmo84m.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=8QwEBtgrwuQNd3TA%2BUmomMM681ZygnhXLnb3oi5ETXQ%3D) | Use Case User Persona: Admin | Solution | | --- | --- | | NovaTech Technologies manages Knowledge Articles for employees across many departments. Authors submit articles for review, but administrators need a consistent way to alert the right reviewers so articles are not delayed in the review process. | NovaTech configures a Knowledge business rule to notify the appropriate reviewer when an author submits an article. **How NovaTech uses the Knowledge business rule?** 1. **Select the event:** Configure the rule for the **Knowledge** module and the **Update** trigger. 2. **Define the condition:** Set the **Status** condition to **is Submitted** so the rule runs for articles that authors submit for review. 3. **Notify the reviewer:** Add an email **Notification** action and select **KR Approver** as the recipient. Include the article title and other relevant Knowledge keywords in the message. 4. **Support timely review:** When an author updates an article to Submitted and it meets the condition, the reviewer receives an email to review it. | ### Configure a Knowledge business rule Knowledge business rules help automate article actions without manual follow-up. They can run on create, update, or scheduled events. To configure a business rule for Knowledge Management, perform the following steps: 1. Login as an Administrator and select the **Admin** Workspace. ![A screenshot of a computer Description automatically generated](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/br-pm-apex-aspen-spring-26-documentation-v1-image-qd44ifgr.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=BzxtR9c%2BpYZ680CaIlGfFATmo0W2EXDNEmCdNbN0ciU%3D) Figure: Workspace - Admin 2. Select Infrastructure from the left panel and then select **Business Rule**. ![A screenshot of a computer Description automatically generated](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/br-pm-apex-aspen-spring-26-documentation-v1-image-qhnpf6rf.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=q6YpvnKBZmQZat%2FH7ugBzQHkr4UeLjCPHtIC6GMjA2s%3D) Figure: Infrastructure - Business Rule 3. The Business Rule page is displayed. Select the **Department** from the left panel. ![A close-up of a computer screen Description automatically generated](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/br-pm-apex-aspen-spring-26-documentation-v1-image-x2d05v5s.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=%2FWGXZPeDoymGjhLV8h6hyHliE37Q9pqtkE0vKxYZLCE%3D) Figure: Department 4. Select **Add New** from the right panel to create a new business rule. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/BR_CM_Addnew.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=z6YddPOxu%2BPgvwcJeENEDDLuFN6HwwogTbNkUYDYpHY%3D) Figure: Business rule – Add New 5. In **Rule Definition**, enter the business rule name, description, execution order, and active state as required. For more information, refer to Field Description. ![Figure: Business Rule for KM](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/business-rules-for-km-image-0x7v7aul.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=k1ZWmKlpEtfwEazCBDgOa%2Fm%2FNvL3K8g9kHBDYzqd0gc%3D) Figure: Business Rule for KM | **Field** | **Description** | | --- | --- | | Department | Select one or more Tenants from the drop-down list. | | Business Rule Name | Enter the name to be given to the Business Rule. | | Business Rule Description | Enter a description about what the business rule will accomplish. | | Execution Order | Enter a numeric value representing the order in which the rule should be executed. Business Rules are executed based on their configured **Execution Order**. A higher execution order takes higher priority. For example, a rule with an execution order of **1000** runs before a rule with an execution order of **500**. If multiple Business Rules have the same execution order, the **most recently created rule** takes priority. The system allows multiple Business Rules to have the same execution order. | | Active | Enable the Active check box to make the Business Rule active. | 6. Select the **Knowledge Management** from the **Module** dropdown. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/km(2).png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=zdgsAs7FBYESBb187MiqeqJ7Mt3%2FXP8Wwj4P4twa%2BY4%3D) Figure**:** Module Selection 7. Choose when to execute the Business Rule. ![A screenshot of a computer Description automatically generated](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/br-pm-apex-aspen-spring-26-documentation-v1-image-sv8cuz5b.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=Dxl2xbmxdkGD2VlNKoHpTbvY%2FQ73ubPsAVbAPhTkwJE%3D) Figure**:** Execution Mode Selection ****After and Async Business Rules**** **After Business Rule** Use an **After Business Rule** in Knowledge Management when a field or related record must be updated **immediately after the knowledge record is submitted**, and the results must be visible to the user right away. When a knowledge record is created or updated, the After rule executes after the data is saved to the database. During this time, the **knowledge record is temporarily frozen**, and no additional updates are allowed until the rule finishes processing. **Async Business Rule** The **Async Business Rule** runs **asynchronously in the background** and does *not* freeze the knowledge record. Users can continue working while the background processing continues independently. This mode is ideal for **non‑urgent or backend operations**. Async rules minimize user wait time because the work happens behind the scenes. 1. Select the trigger type from the dropdown. ![A close-up of a computer screen Description automatically generated](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/br-pm-apex-aspen-spring-26-documentation-v1-image-ua3dkv22.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=ijSBiXRsHBgqbU%2FAZY6K8wiDY2%2F4%2FzkHlUkF9Zh1ZkU%3D) Figure**:** Trigger Selection ****Trigger Types**** The following trigger types are supported for Knowledge Management: - **Create:** Select this check box to execute the business rule when a record is created. - **Update:** Select this check box to execute the business rule when a record is updated. - **Schedule:** Select this check box to execute the business rule when a record is scheduled. > [!NOTE] > Note: > > If **Schedule** check box is selected, then **When** must be selected as **Async**. > > Calendar icon is displayed if the schedule job is configured for this business rule. **Scheduled Business Rules** Business Rules configured with the **Schedule trigger** execute automatically at defined intervals. This can be used for scenarios such as: - Sending notifications - Auto-updating Change Records - Monitoring records based on SLA or timelines Administrators can also define whether the rule should execute: - Anytime - Only during business hours - Only outside business hours > [!NOTE] > Note: > > Scheduled Business Rules are useful for automating **periodic Knowledge Article activities**, such as identifying articles approaching expiry and notifying Knowledge Owners and Workgroup Owners for timely review. 1. Choose the conditions based on which the rule executes. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/br-pm-apex-aspen-spring-26-documentation-v1-image-b5k7g8x7.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=m4lIzNzQudSrjay0KNQwDLabAulQSHfgJ6JFF%2BrUL3k%3D) Figure**:** Condition 2. Configure the condition, or select **No Condition**. For more information, refer to [Conditions](/apex/docs/business-rules-for-km#conditions). 3. Configure at least one **Notification** or **API** action. For more information, refer [Notification and API](/apex/docs/business-rule). 4. Review the configuration and submit the rule. ### ### Conditions A condition determines which Knowledge Articles cause the configured actions to run. Each condition consists of: - **Field** - **Operator** - **Value** After you select **Knowledge** as the module, the Condition Builder displays only Knowledge Article attributes. Criteria can use existing Business Rule condition logic, including AND and OR where supported. Administrators can select one of the following options: - **Conditions based on criteria**: Run the action only when the configured criteria are true. - **No Condition**: Run the action whenever the selected trigger occurs, regardless of Knowledge Article attributes. #### Condition behavior | Selection | System behavior | | --- | --- | | Field | Displays the supported Knowledge Article attributes. | | Operator | Displays only operators supported by the selected field’s data type. | | Value | Displays an appropriate input, selection, or lookup based on the field and operator. | | No Condition | The rule does not check attribute criteria. | For example, selecting a checkbox field provides Boolean-compatible operators and values, while selecting a date field provides date-compatible operators and a date value control. Operators that do not require a value must not display or require a value entry. For more information, refer [Business Rule Conditions](/apex/docs/business-rule) #### Supported standard attributes | Field name | Field key | Type | Data type | Source or behavior | | --- | --- | --- | --- | --- | | KR ID | KR_ID | Number | Integer | System-generated Knowledge Record identifier. | | Title | KR_TITLE | Text | String | Knowledge question or title. | | Status | KR_STATUS | Dropdown | String | Supports New, Submitted, Authorized, Not-Authorized, Approved, Rejected, Published, Retired, and Draft. | | Life Cycle Status | KR_LIFECYCLE_STATUS | Dropdown | String | Read-only lifecycle stage. | | Workgroup | KR_WORKGROUP | Dropdown | Integer | Knowledge Article workgroup. | | Classification | KR_CLASSIFICATION | Tree view | Integer | Classification on the General tab. | | Category | KR_CATEGORY | Tree view | Integer | Category on the General tab. Supports **is** and **is under** for child categories. | | Important Record | KR_IMPORTANT | Checkbox | Boolean | Important Record setting on the Access tab. | | Restricted to Analysts | KR_RESTRICTED_ANALYST | Checkbox | Boolean | Restricts the article to analysts. | | Self-Help Article | KR_SELF_HELP | Checkbox | Boolean | Indicates whether the record is a self-help article. | | Public Article | KR_PUBLIC | Checkbox | Boolean | Indicates whether the article is public. | | Has Attachment | KR_HAS_ATTACHMENT | Checkbox | Boolean | Indicates whether the article contains an attachment. | #### Supported date attributes | Field name | Field key | Type | Data type | Notes | | --- | --- | --- | --- | --- | | Expiry Date | KR_EXPIRY_DATE | Date | Date | Supported for the expiry-date model only. Review-cycle behavior is not included. | ### Actions After the trigger occurs and the configured condition evaluates to true, the system performs the action. If you select **No Condition**, the system performs the action whenever the trigger occurs. Knowledge business rules support the following action tabs: - **Notification** - **API** The **Update Fields** action is not available for Knowledge business rules. #### Notification action Use the Notification action to send an email when a Knowledge business rule trigger occurs and its condition evaluates to true. ![Figure: Notification](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/business-rules-for-km-image-1tmu8ise.png?sv=2026-02-06&spr=https&st=2026-11-20T21%3A41%3A54Z&se=2026-11-20T22%3A41%3A54Z&sr=b&sp=r&sig=Th5wIj%2FcChJCpcuFCOrbcphpprhrhk3j%2BzokypE49Gs%3D) Figure: Notification ##### Notification configuration | Field or section | Behavior | | --- | --- | | Notification Name | Enter a name that identifies the notification configuration. | | Medium | **Email** only. SMS is not supported for Knowledge business rules. | | To | Add one or more supported primary recipients. | | Cc | Supports the same recipient types available in the To field. | | Subject | Enter the email subject. The Knowledge Article ID can be pre-populated in line with the existing Business Rule behavior. **Note**: Use Dollar (‘$’) and type a character to trigger suggestions for Knowledge Management attributes in Email Subject and Email Body. | | Email Body | Enter the notification message. You can use HTML content. | ### Supported recipients The **To** and **Cc** fields support the following recipient types: | Recipient type | Supported selections | | --- | --- | | By Workgroup | Select a specific workgroup or the owner workgroup of the Knowledge Article. | | By Customer | Search for and select a customer. | | Custom Email IDs | Enter one or more email addresses manually. | For more information, refer [Business Rule Notification](/apex/docs/business-rule). ## API action Use the API action to invoke an internal or third-party endpoint when a Knowledge business rule triggers and its condition evaluates to true. For example, an organization can call an external service after a user creates or updates a Knowledge article. ### API configuration | Field or section | Description | | --- | --- | | API Configuration Name | Enter a name that identifies the API configuration. | | Method | Select a supported HTTP method. The system supports **PUT**. **GET** remains subject to RBAC validation and final confirmation. | | API URL | Enter the endpoint URL to invoke. | | Params | Configure path or query parameters as key-value pairs. | | Authentication | Configure the authentication required by the endpoint. | | Headers | Add request headers and associated values. | | Body | Configure the request payload where applicable. | | Response | View the response returned by the endpoint. | For more information, refer [Business Rules API](/apex/docs/business-rule) ## Example use-cases #### **Notify the Knowledge owner before article expiry** A KM Administrator creates a scheduled rule to identify published articles that are approaching their expiry date. - **Module:** Knowledge - **Trigger:** Schedule - **Condition:** KR_STATUS equals Published **AND** KR_DAYS_TO_EXPIRY is less than or equal to the configured threshold - **Action:** Send an email to the **KR Owner** and **Workgroup Owner** This rule helps Knowledge teams review articles before they expire and reduces the risk of outdated content remaining available. **Notify an approver when someone submits an article** A KM Administrator creates a rule that runs whenever someone submits a Knowledge Article for approval. - **Module:** Knowledge - **Trigger:** Update - **Condition:** KR_STATUS is Submitted - **Action:** Send an email to the **KR Approver** The notification can include the Knowledge Article ID, title, department, workgroup, and other supported Knowledge keywords. **Invoke an integration for a newly published article** A KM Administrator creates a rule that calls an integration endpoint after someone publishes an article. - **Module:** Knowledge - **Trigger:** Update - **Condition:** KR_STATUS equals Published - **Action:** Invoke a configured API and pass Knowledge Article details in the request Use this rule to synchronize published Knowledge content with another authorized application. **Send an email for every Knowledge Article update** A KM Administrator creates a rule that notifies a configured recipient whenever someone updates a Knowledge Article, without evaluating a condition. - **Module:** Knowledge - **Trigger:** Update - **Condition:** No Condition - **Action:** Send an email notification to the configured recipient. Add the Knowledge Article ID to the subject and include relevant attributes, such as status, lifecycle status, customer, log time, importance, and expiry date, in the email body. Because the rule has no condition, it sends a notification for every Knowledge Article update that triggers it.