As documentation reaches the end of its life cycle, it is possible to decommission it so that it will no longer be included in search results, but still remain accessible via a URL, pretty URL, or deep link.
There are two ways to decommission content:
- Republish each document to be decommissioned separately. This method is best if reprocessing would take a prohibitive amount of time.
- Use the Enrich and Clean feature to decommission any number of documents simultaneously.
While the first method is straightforward, the second involves a specific process. Administrators must define a new taxonomy in the Back Office and create new metadata based on the original metadata in the Enrich and Clean administration interface.
To begin, access the homepage of the Back Office and follow these steps:
- Select a service.
- In the Setup menu, select Vocabularies, then select New Vocabulary.
- In the Type dropdown menu, select Synonyms for a portal configured in a single language, or Thesaurus for a portal configured in multiple languages.
- In the Use section, select Indexing use and Semantic enrichment.
- Define a name, for example, taxoStatus.
- Define a language. Typing the first letter of a language opens a pop-up with a list of options.
- Save the new vocabulary.
- Select New term and define two terms, for example, statusOnline and statusDecommissioned. For a portal configured in multiple languages, set the language of both terms to "*".
- Create synonyms for statusOnline. Use metadata values (version, model number, etc.) shared by documents which should not be decommisioned.
- Create synonyms for statusDecommissioned by similarly referencing the metadata values of documents which should be decommissioned.
- Save the vocabulary.
This completes the process in the Back Office. The next step is to log in to the portal, select Administration > Knowledge Hub > Enrich and Clean, and follow these steps:
- Select New rule.
- Select the metadata key corresponding to the metadata values defined as synonyms for the terms statusonline and statusdecommissioned in the Back Office.
- Select the vocabulary defined in the Back Office, for example, taxoStatus.
- Name the generated metadata publishingStatus.
- Select Create.
Once the new rule is defined, it is necessary to configure the portal so that it does not display content with the metadata publishingStatus=statusDecommissioned. SaaS users should create a Fluid Topics help desk ticket to request assistance. On premise users should follow these steps:
- Select a service.
- In the Setup menu, select Configuration.
- In the Front Configuration section, select Front.
- Use the Filter search box to go to the QEng > SearchFrontEnd > QueryParsing menu, and select the Edit button in the addArg section.
- Select Add.
- In the Key field, enter afs:log=ft:baseUrl:https://urlOfYourCustomerPortal, where urlOfYourCustomerPortal is the customer portal url of the afs:log parameter displayed when hovering a query in the "Analytics > Queries > Last Queries" section of the Back Office.
- In the Value field, enter afs:filter@FluidTopics=not(publishingStatus="statusDecommissioned").
- Select Save, then select I'm done with modifying.
- Select Publish.