Skip to main content

Salesforce Preflight

Abstract

Learn how to use Paligo's "Salesforce Preflight" to control what content gets published to Salesforce Knowledge. You can also use it to preview the content mapping and to remotely delete articles and navigational topics.

If you use a Salesforce Nested Layout for publishing and you have a nested structure in your publication, you can use Salesforce Preflight. This is an extra feature that is available on the Publish document dialog and it provides a visual representation of what will happen when you publish from Paligo to Salesforce Knowledge.

Salesforce Preflight. It has a Current Publication tab that shows a navigational topic and article hierarchy. It also has a Salesforce tab, resource panels at the top, and a side panel for article settings.

Use Salesforce Preflight to:

  • Preview the publishing and see what content Paligo is going to add, update, or delete from Salesforce Knowledge

  • Control which Paligo topics are published to Salesforce Knowledge

  • Set the status of articles to draft or published

  • Remotely delete articles and navigational topics in Salesforce Knowledge.

The following steps guide you through each part of Salesforce Preflight.

  1. Display Salesforce Preflight.

    1. Locate your publication in the Content Manager and select its dotted menu (...).

      Note

      Salesforce Preflight is only available if your publication has multiple levels of topics (nested content).

    2. Select Publish to display the Publish document dialog.

    3. Select HTML and then select the Salesforce Nested Layout that you want to use for publishing.

      Note

      Salesforce Preflight is only available if you use a Salesforce Nested Layout.

  2. Look at the hierarchy in the Current publication tab. This shows how the publication's topics will be mapped to Community, Navigational Topic, and Article components in Salesforce Knowledge.

    Salesforce preflight shows a hierarchical list of the topics and navigation topics. Each topic and navigtation topic has a checkbox, a status icon, and a cog icon.
    • Entries with a green and white plus icon are going to be added by Paligo.

      An article in the Salesforce preflight hierarchical structure. It has its checkbox checked and a green and white plus icon.

      Note that Paligo can only create Navigational Topics if you include the source language used by your Salesforce Knowledge in the publishing settings (see Publish to Salesforce Knowledge).

    • Entries with a blue recycling icon already exist in Salesforce Knowledge and are going to be updated by Paligo.

      An article in the Salesforce preflight hierarchical structure. It has its checkbox checked and a blue recycle icon to show the content is going to be updated.
    • Entries with a warning icon need your attention.

      Salesforce preflight. Close up of a Navigation Topic in the current publication hierarchy. There is a red warning icon next to the navigation topic's title.

      To learn how to solve the problems, see Warnings in Salesforce Preflight.

    Note

    To change how the content maps, use the mapping settings in your Salesforce Nested Layout (see Change the Mapping for a Salesforce Nested Layout).

  3. Use the blue checkboxes to control which topics Paligo will publish to Salesforce Knowledge:

    Salesforce preflight. A close up of a row on the current publication tab. A callout arrow points to the blue checkbox at the start of a row.
    • Check the box to include the topic in the publication

    • Clear the box to exclude it from the publication.

  4. To view the details of any navigation topic or article, select its cog icon. The details are shown in the Active component tab. They include the type of component and the date of its creation.

    You can also set the status for the component. Choose:

    • Use default to set the article to use the Global setting (see step 5). Use default is the default setting for articles.

    • Draft to create or update the article as a draft in your Salesforce Knowledge instance. It cannot be seen by your end-users until you publish it locally, in Salesforce.

      If a published version of the article already exists, that remains in place. Your end-users will still be able to see it (until you publish the new draft version).

    • Published to send the article as a "live" published article. It will appear in your Salesforce Knowledge instance and will be available to your end-users.

      If your Salesforce Knowledge instance contains a draft version of the article that you publish, Paligo will delete the draft.

    Active component tab. It has a link to a Paligo article and a status dropdown for choosing draft, published, or use default.
  5. If you have some articles set to the Use default status, use the Global tab to set their status value.

    1. Select the Global tab.

    2. Set the Status to:

      • Published to set all the "Use default" articles to be published as "live" articles that can be seen by your end-users.

      • Draft to set all the "Use default" articles to be published as a "draft". They will exist in your Salesforce Knowledge instance, but cannot be seen by your end-users until you publish them. You can publish them in Salesforce Knowledge.

      sf-preflight-global.png

    When you publish, Paligo will apply the status to any article that has its own status set to Use default (see previous step). Articles that have their own status set to Draft or Published do not inherit the status from the Global setting.

  6. Look at the top of the Preflight tab for information about what Paligo will do when you publish.

    • The Create panel shows you how many new resources Paligo will create in Salesforce Knowledge. These are resources that Paligo has not published to Salesforce Knowledge before (or if it has, it no longer has the mapping in place).

    • The Update panel shows how many navigation topics and mapped articles Paligo will update. These resources are already mapped as Paligo has published them to Salesforce Knowledge before and remembers them.

    • The Delete panel shows how many Salesforce Knowledge resources Paligo will remove when you publish.

    Top of preflight tab. There are panels showing how many resources Paligo will create, update, and delete.
  7. Use the Salesforce tab to view the content that currently exists in your Salesforce Knowledge instance.

    Salesforce preflight. The Salesforce tab is selected. It shows a hierarchy of the other content that already exists in Salesforce. Anything in the currently selected publication is not included in this list.

    This can be useful if you want to:

    • Find out the names of articles that are already in Salesforce Knowledge. Select the cog icon for the article and look at the Active Component tab in the side panel.

    • Find out when a navigational topic was created. Select the cog icon for the navigational topic and look at the Active Component tab in the side panel.

    • Use Paligo to remotely delete articles that already exist in Salesforce Knowledge. Select the article or navigational topic and then select its delete icon. For details, see Delete Salesforce Articles and Navigational Topics .

    Note

    The Salesforce tab does not include any navigational topics or articles from your current publication, even if they have been published to Salesforce Knowledge before. It only shows the other content that exists in your Salesforce Knowledge instance.

  8. If you are happy with the mapping, you can either:

    • Select Publish to start the publishing process.

    • Select Close to return to the Publish document dialog. You can publish from there as well as change any publishing settings, such as languages, variables, and filters (see Publish to Salesforce Knowledge).

    To change the mapping, see Change the Mapping for a Salesforce Nested Layout.

    If you cancel any changes you have made, such as name changes to articles, select Reset Preflight. This resets the content to how it was at the time you opened the Preflight tab.