# Advanced Knowledge Parameters CapStorm provides several powerful settings for Knowledge restores, found under the *Additional Knowledge\_\_kav Parameters* section of the *\_\_kav* table. Understanding these options gives maximum safety and control over the restore process. ## *One Version Per Push Setting* This setting helps ensure a safe and successful restore of complex Knowledge articles. When enabled, CapStorm will only restore a single version of any specific Knowledge article each time you run a restore job. This setting is important for Archived or Online Knowledge Article Versions that have related files (or other related objects). ### How it Works If there is an article with three versions, the restore job would need to be run *three* times to restore its full history. This will cause the first version to be pushed by the first job (along with related records), then the second version by the second job (with related records), etc… The process will also handle translations separately, restoring the master version in one run and its translations in another. ### Why This Setting Should Be Used The main reason to use this setting is to keep the newest article version in an editable *Draft* state for as long as possible. Once an article is published as *Online*, it becomes read-only, which can cause two common problems: 1. **Linking Files:** Files cannot be attached to a published article. *One Version Per Push* restores the article as a *Draft*, giving an opportunity to run another restore job to link file attachments (*ContentDocumentLink* records) before the article is published. 2. **Populating Lookups:** If the article has lookup fields to other records, this setting allows those other records to be restored first and correctly linked to the draft. If the article were published immediately, there is no option to go back and update the lookup fields if they were initially blank. By keeping the article in a *Draft* state, this setting ensures all related data can be restored and linked correctly, preserving data integrity. ### How to Enable it This setting is a checkbox located in the **Restore Set Editor** under the **Migration Setup** tab when *\_\_kav* table is selected. ![](https://2924009365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5FyPmqVkPxhj2oT8fbgB%2Fuploads%2Fgit-blob-5fddfc3c3c9bab2bef9223dcf1fe4076a750390f%2F740e8b2b-one_version_per_push-1024x455.png?alt=media) ## Pre-Restore Cleanup Parameters These two settings work together to fix articles that may have been left in a Draft state from a previous, incomplete restore job. ![](https://2924009365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5FyPmqVkPxhj2oT8fbgB%2Fuploads%2Fgit-blob-e694f3be7b96eb8b51bcb320589627501e2fcde4%2Fc7e7cdfd-additional_knowledge_params-1024x455.png?alt=media) ### *Publish Drafts Before Restore Setting* This setting is a cleanup tool. Before the main restore begins, it searches the Salesforce org for any Knowledge articles that are still *Drafts* but should be *Online* or Archived (according to the backup) and attempts to publish them. **Use with Caution:** Before using this option, it’s a good practice to investigate why the previous job failed. If the failure happened before the article’s content was updated, using this option might publish an incomplete draft or a draft that is a duplicate of the previous version. ### *Halt on Pre-Restore Failure Setting* This setting gives stricter control over the cleanup process and is **only available when “Publish Drafts Before Restore” is checked.** * **What it does:** If this box is checked and CapStorm encounters any error while trying to publish the old drafts, the entire restore job will **stop immediately**. * **Why it’s important:** If the cleanup process fails and the job continues, the new restore might overwrite the failed draft with the *next* version’s content. This could cause **a version to be skipped**, leading to an incomplete and incorrect article history. This setting prevents that from happening. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://learn.capstorm.com/copystorm-restore/best-practices/knowledge-recovery/advanced-knowledge-parameters.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.