Discover how you can use Paligo to author content and then publish it directly to Salesforce Knowledge.
You can use the powerful authoring features of Paligo to create your content and then publish it directly to Salesforce Knowledge. Depending on which Salesforce Layout you use for publishing, Paligo can publish to articles only or a mix of "Navigational Topics" and articles.
To publish from Paligo to Salesforce Knowledge:
-
Preparation for Salesforce Integration and check that you have the correct plans, features, and licenses.
-
Make sure you understand the differences between the two types of Salesforce Layout:
-
Salesforce Knowledge Layout, see Mapping with a Salesforce Knowledge Layout
-
Salesforce Nested Layout, see Mapping with a Salesforce Nested Layout
-
-
Decide whether you are going to create your own Salesforce Layout or use a built-in one.
For details, see Create a Salesforce Layout.
If you create a custom Salesforce Nested Layout, you can Edit a Salesforce Layout to control the mapping and change other publishing settings.
-
Use a Salesforce Layout to Publish to Salesforce Knowledge.
Paligo will then publish your content directly to Salesforce Knowledge. It will also download the HTML as a package in your browser.
Learn how to prepare your Salesforce Knowledge integration for receiving content from Paligo.
Before you can publish from Paligo to Salesforce Knowledge, you need to set up your Salesforce instance. We have summarised the steps you need to take below, but for details, you will need to refer to the official Salesforce documentation, see https://help.salesforce.com/s/articleView?id=sf.networks_enable.htm&type=5
-
Make sure you are on the appropriate plans for Paligo and Salesforce:
-
Paligo
You need to be on the Enterprise plan.
-
Salesforce
You need to be on a plan that supports:
-
Salesforce Knowledge in the Lightning Experience.
-
API access.
-
-
-
Make sure you have the appropriate Salesforce Experience Cloud licenses.
-
Enable Salesforce Knowledge in the Lightning Experience. This allows the Lightning Knowledge interface to use your Knowledge articles. For instructions, see the official Salesforce documentation.
-
Enable Experience Cloud.
For details, see Enable Digital Experiences.
-
Create an Experience Cloud site.
For details, see Create an Experience Cloud Site.
-
Set up Data Categories. This is an optional step, but we recommend that you set up Data Categories as they allow you to organize your articles.
For instructions on how to set up Data Categories, refer to the official Salesforce documentation:
You can only set up Data Categories in Salesforce. But once they are in place, you can publish content in Paligo and choose which Data Categories to use, see Publish to Salesforce Knowledge.
-
Set up the Salesforce Digital Experience and theme. The Digital Experience is the presentation part of Salesforce Knowledge, where your audience is presented with your articles.
-
Create an Experience Cloud site.
For details, see Create an Experience Cloud Site.
Note
We recommend that you create a separate site for the content that you will publish from Paligo.
If you have content from Paligo and content created locally in Salesforce on the same site, it can result in mapping errors.
-
Choose a theme.
Typically, Paligo users choose the Help Center theme in Salesforce Knowledge.
For details, see Prebuilt Builder Themes.
Example of Salesforce Digital Experience using Help Center theme.
-
-
If you are going to publish to multiple languages, make sure you have enabled those languages in Salesforce Knowledge.
-
From Setup, enter "Translate" in the Quick Find box.
-
Select Translation Language Settings.
-
Select Add.
-
Add the language(s) and translators.
-
Select Save.
For details, see Add Translated Languages and Translators in the official Salesforce documentation.
-
-
This is an optional step. We recommend that you set up a generic user in Salesforce Knowledge for the Paligo integration. This user will then still be available even if people leave your organization.
When you have made the necessary preparation in Salesforce, you can Connect Paligo to Salesforce Knowledge.
Learn how to set up Paligo's integration settings for Salesforce Knowledge.
Before you can connect Paligo to Salesforce Knowledge, make sure you have made the necessary preparation. Also make sure that you have the appropriate plans, features, and licenses. This is all explained in Preparation for Salesforce Integration.
When you have made the preparation, you can connect Paligo to Salesforce Knowledge. There are quite a number of tasks to complete, so we have divided them into 4 stages.
To connect to Salesforce, Paligo needs various details, including the user credentials and a security token. To get the credentials and security token, it can be easier to switch from Salesforce's Lightning Experience interface to the Classic interface.
Using the Classic interface:
-
Make sure the "Permission API" is enabled in your Salesforce account. This is normally enabled by default, but if not, you can set it under Setup at Users > Profiles.
-
Get the user credentials for Salesforce that you want to use to connect the integration.
-
Get the security token. You may have received this when you created your Salesforce account. But if you don't have it, you can generate a new one:
-
In Salesforce, select your profile in the top-right corner.
-
Choose Settings.
-
In the Quick find field, search for "token" and then select Reset Security Token. A new security token is sent to you by email.
-
You will need the user credentials and security token in stage 4, when you add the integration settings in Paligo.
Next, you need to set up the API field.
You need to get an API field name as this is another setting that is needed for the Paligo-to-Salesforce integration.
-
Go to Setup in Salesforce.
-
Search for Object Manager in the quick find, and select it.
-
In the Object Manager, select Knowledge.
-
Create a Rich Text Field.
-
Select Fields and Relationships.
-
Select New.
-
Select Text Area (Rich).
-
Select Next.
-
Fill out the fields:
(You can choose a different name if you want to)
-
Select Next.
-
Leave the next screen as is by default. Select Next.
-
On the next screen, uncheck all boxes. We will add this field to a new Article type/Page layout later.
-
Select Save.
-
-
If you do not have an existing Page Layout you want to publish to, you can create a new one.
-
Select Save.
-
Drag your Rich Text field to the Knowledge Detail area:
-
Create a new record type:
-
Select Record Types in the left menu of the Object Manager.
-
Select New.
-
Fill in the fields something like below, but again you can choose your name:
-
If you want to enable it for everyone, check all the boxes. You also need to make it the default record type for Paligo to be able to publish to it.
-
-
Select Next.
-
Select the Page Layout you want to use.
-
Select Save.
-
Get the API field content for the Paligo settings:
-
Select Fields & Relationships.
-
Find your Rich Text field and make a note of the field name. You will need the field name when you add the integration settings in Paligo.
-
In Salesforce, the article was removed and then restored
-
The API indicates that the article has been deleted when, in fact, it is still there.
-
-
Next, you need to create a connected app in Salesforce.
To connect Paligo to Salesforce, you need to have a connected app in Salesforce.
-
Go to Setup.
-
Enter "app" in the Quick Find box and select App Manager. (In Salesforce Classic, select Apps under Build & Create).
-
Create a New Connected App
-
Enter a name for the app, for example,
Paligo
. The API name is filled in automatically. -
Enter a contact email address.
-
Select Enable OAuth Settings.
-
In the Callback URL field, enter
https://login.salesforce.com/services/oauth2/callback
. -
In the list of Available OAuth Scopes, add Full Access (full) to the Selected OAuth Scopes
-
Select Save.
It takes up to 10 minutes before the app is ready to be used in Salesforce.
-
Make a note of the Consumer Key and Consumer Secret as you will need to add these to the integration settings in Paligo.
Next, you can add the salesforce integration details to Paligo.
When you have completed stages 1-3 inclusive in Salesforce, you can add the integration details to Paligo.
The draft articles in Salesforce will appear to be very basic. To make them more visually appealing, you can set up Salesforce to publish the articles to a Salesforce Community that uses a help center theme.
Note
The " Lightning experience" view in Salesforce may be a bit inconsistent in how draft articles show or not. If you do not see them in that view, switch to "Classic mode" and choose to view draft articles.
-
Log in to Paligo via a user account that has administrator permissions.
-
Select the avatar in the top-right corner.
-
Select Settings from the menu.
-
Select the Integrations tab.
-
Select Add or Change for the Salesforce integration.
-
Add the Username and Password that you got from Salesforce.
-
Add the security Token from Salesforce.
-
Add the Consumer Key and Consumer Secret.
-
Add the rich text field name in the Content field API name field.
-
Choose whether you want Paligo to publish content as Draft or Published articles in Salesforce.
-
Use the Custom link prefix field to customize any cross-references.
-
Only use this field if your articles in Salesforce are not located directly in the root of your instance.
For example, leave the Custom link prefix field empty if the URL for your articles is
my-instance.force.com/<name of article>
. Paligo will publish your cross-references correctly by default. -
Enter the syntax in the Custom link prefix field if the URL if your articles has one or more extra directories between the instance and the article.
For example, if the URL for your articles is 'my-instance.force.com/sa/<name of article>, enter
my-instance.force.com/sa/
in the Custom link prefix field.
Note
Paligo will use the custom link prefix automatically each time you publish from Paligo to Salesforce. But it can be overridden by another custom link prefix that you can enter in the publishing settings, see Publish to Salesforce Knowledge.
-
-
Check the SEO links box to update the URL name field in Salesforce to match the topic titles and make them SEO friendly.
This setting controls the global default, but it is also possible to override this in the publish dialog and in saved publish settings.
-
Check the Smart restore box to make Paligo automatically remap the content to the article in Salesforce.
Important
Only check the box if the Salesforce publish log contains the error:
The URL Name cannot match the draft or published version of any other article
This error can occur if mapping between Paligo content and Salesforce articles is broken if:
-
In Salesforce, the article was removed and then restored
-
The API indicates that the article has been deleted when, in fact, it is still there.
Clear the checkbox once the link issues are solved.
-
-
Choose whether Paligo will update the URL fields of your articles when you publish to Salesforce:
-
If you want Paligo to publish to Salesforce and update or add URLs for your articles, check the Always Update URL Name Fields box. Paligo will set the URLs based on either the title of the topics being published or the UUID. This depends on the SEO Friendly Links option in the publishing settings, see Publish to Salesforce Knowledge.
-
If you are going to edit the URLs of your articles in Salesforce, after Paligo has published, clear the Always Update URL Name Fields box. This prevents Paligo from updating the URLs.
-
-
Select Save.
-
Select Test settings.
Paligo will test the connection to your Salesforce Knowledge instance. It displays the result in a notification. If the connection failed, it is likely due to a mistake when entering the connection details. Please go through the steps again and check carefully for mistakes. If the connection continues to fail, contact support for help.
You should now be able to publish from Paligo to Salesforce Knowledge. You can use the built-in Salesforce Knowledge or Salesforce Nested Layout or you can create your own.
The two different Layouts map your Paligo content to Salesforce Knowledge differently, so we recommend that you read:
Typically, we recommend that you use a Salesforce Nested Layout as it give you more control over the organization of the articles.
Paligo has built-in Salesforce Layouts that you can use for publishing or you can create your own custom Layout. If you create your own Layout, it has to be based on one of the built-in Salesforce Layouts.
Before you create a Salesforce Layout, make sure you understand the difference between a Salesforce Knowledge Layout and a Salesforce Nested Layout. They map the content from Paligo to Salesforce Knowledge differently, and your custom Layout will use the same type of mapping as the Layout it is based on. To learn about the mapping, see Mapping with a Salesforce Knowledge Layout and Mapping with a Salesforce Nested Layout.
-
Select the Layout tab in the top menu.
Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
-
Select Create New Layout in the lower left corner.
-
Give your layout a name in the Layout title field.
-
Set the Output Format to:
-
Salesforce Knowledge
Use Salesforce Knowledge if you do not use the "Navigational Topics" feature in Salesforce Knowledge.
-
Salesforce Nested
Use Salesforce Nested as the base layout if you need Paligo to map topics to "Navigational Topics" in Salesforce Knowledge.
-
-
Select OK.
Paligo creates your new Layout and adds it to the list on the Layouts tab. It will inherit the settings from the base Salesforce Knowledge or Salesforce Nested Layout that you chose as the Output Format.
If you select your Layout on the Layout tab, Paligo will open it in the Layout Editor. You can use that to change its settings.
Discover how to change the settings of a Salesforce Nested Layout. You can control the mapping, set the image size, and more.
If you have created a custom Salesforce Layout, you can edit it and change its settings. There are several changes you can make, including changing the Chunk section depth which affects how Paligo maps content to Salesforce Knowledge.
For publishing to Salesforce, you only need to consider changing the settings described in this article.
Note
We recommend that you do not change the settings in a Salesforce Layout until you understand how the mapping works (see Mapping with a Salesforce Knowledge Layout and Mapping with a Salesforce Nested Layout. If you change the settings without understanding how they affect the mapping, you may get unexpected results.
-
Select the Layout tab in the top menu.
Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
-
Select your custom Layout in the list.
Paligo opens your custom Layout in the Layout Editor.
-
Use the Layout Editor to apply your changes. The settings are:
-
TOC and chunking
-
Chunk section depth, see Control the Mapping to Salesforce Navigational Topics.
-
-
Images
-
Image size, see Set the Image Size for Salesforce Knowledge.
-
-
Languages
-
Hide missing translations, see Hide Missing Translations for Salesforce Knowledge.
-
-
Salesforce
-
Create article for the section topic, see Generate Articles for Navigational Topics.
-
Use Separate styling for label, number, and title in formal elements, see Add a Class to Labels, Numbers, and Titles in Salesforce.
-
-
-
Select Save.
-
Select the Layout tab in the top menu.
Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
-
Select the Salesforce Nested Layout that you want to edit.
Paligo opens the Layout in the Layout Editor.
-
Use the Chunking section depth setting to control how many levels of content Paligo can try to map to Navigational Topics.
-
Increase the Chunking section depth number to set Paligo to try and map more levels of your content to Navigational Topics.
-
Decrease the Chunking section depth number to map fewer levels of your content to Navigational Topics.
Paligo can only map to a Navigational Topic if the fork is inside the Chunk section depth and it has a lower-level "child" fork. For more details, see Rules for Mapping with Salesforce Nested Layout.
-
-
Select Save.
-
Select the Layout tab in the top menu.
Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
-
Select Images.
-
Set the Image Size.
The higher the number of pixels and dots-per-inch (dpi), the greater the file size and quality of the image.
-
Do not include images
-
Use original images
-
Full size (2500 × 2500px, 120dpi)
-
Large (800 × 800px, 72dpi)
-
Medium (400 × 400, 72dpi)
-
Small (250 × 250px, 72dpi)
-
-
Select Save.
-
Hide the language
-
Use the source language in place of the missing translation.
-
Select the Layout tab in the top menu.
Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
-
Select the Salesforce Nested Layout that you want to change.
-
Select Language.
-
Set Hide Missing Translations to:
-
Enable -
To set Paligo to hide the missing translations in the output.
When you publish, if you choose a language that has no translation, Paligo will hide that language in the output.
-
Disable - To set Paligo to show missing translations in the output. The translations are shown in the source language along with the language code.
-
Default - To inherit the value for this setting from the base layout. The base layout is either a built-in layout provided by Paligo or another custom layout. To find out more, see Layout Relationships - Base, New, Duplicate.
-
-
Select Save.
-
Select the Layout tab in the top menu.
Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
-
Select the Salesforce Nested Layout that you want to edit.
Paligo opens the Layout in the Layout Editor.
-
Set Create Article for the Section Topic to:
-
Enable
To set Paligo to create an extra article for a Navigational Topic. The extra article will have the same name as the Navigational Topic. Paligo will add the content from the topic (that is mapped to the Navigational Topic) into the extra article.
-
Disable
To prevent Paligo from creating an extra article for the topics that map to Navigational Topics. If there is any content in these topics, it will be unavailable to Salesforce users.
- <listitem>
Default - To inherit the value for this setting from the base layout. The base layout is either a built-in layout provided by Paligo or another custom layout. To find out more, see Layout Relationships - Base, New, Duplicate.
</listitem>
For more details, see Rules for Mapping with Salesforce Nested Layout.
-
-
Select Save.
-
Select Layout.
-
Select the Salesforce Nested Layout that you want to change.
-
Set the Use separate styling for label, number, and title in formal elements to:
-
Enabled: To set Paligo to create a span element (in the HTML output) for each part of a label, number, or title. It will also create a class name for each span element.
-
Disabled: To set Paligo to output HTML that does not have span elements for each part of labels, numbers, or title elements.
-
Default - To inherit the value for this setting from the base layout. The base layout is either a built-in layout provided by Paligo or another custom layout. To find out more, see Layout Relationships - Base, New, Duplicate.
-
-
Select Save.
You can now use your custom Salesforce Layout to Publish to Salesforce Knowledge.
Salesforce Layouts have a Chunking section depth setting that affects the mapping of content. It tells Paligo how many levels of the publication structure can be mapped to "Navigational Topics" in Salesforce. By default, it has a value of 3, but you can change it if needed.
Note
By default, Paligo will create extra articles to contain any content from the topics that are mapped to Navigational Topics. You can stop Paligo from creating the extra articles, if you prefer. For details, see Generate Articles for Navigational Topics.
To learn how to use your edited Salesforce Layout for publishing, see Publish to Salesforce Knowledge.
When you use a Salesforce Nested Layout to publish to Salesforce Knowledge, Paligo leaves images in their original size and resolution, by default. If you prefer, you can set the images to be at a different size.
To change the image size for Salesforce Nested Layout outputs:
When you use this Salesforce Nested Layout for publishing, Paligo will apply your chosen settings. If you set the images to be included at a specific size, the images will be that size in the HTML output that Paligo sends to Salesforce Knowledge.
When you publish to Salesforce Knowledge, you can choose which languages to include in the output. If you choose a language that has no translation, Paligo will either:
To control how Paligo handles missing translations, use the Hide Missing Translation setting in the Salesforce Nested Layout:
When you publish with this Salesforce Nested Layout, Paligo will apply the choice you made.
In Paligo, topics at all levels of your publication can contain content. But in Salesforce Knowledge, only articles can contain content. This means that if a Paligo topic contains content and it is mapped to a Navigational Topic, its content is unavailable in Salesforce. To solve this problem, you can enable Create article for the section topic. It is available in the Salesforce category of the Salesforce Nested Layout (see Edit a Salesforce Layout).
To learn how to use your edited Salesforce Layout for publishing, see Publish to Salesforce Knowledge.
Paligo automatically adds elements such as labels, numbers and titles to some types of content. For instance, when you add an example
element, Paligo automatically gives it a title
element too. For HTML-based outputs, you can set Paligo to create span elements for each part of the label/number/title and also to add a class name. You can then use CSS to style these span elements.
When you publish content using this Salesforce Nested Layout, Paligo will apply the settings you have chosen. If you enabled the span elements and class names, those will be applied to the labels, numbers, and titles in the HTML. You can use the browser's Inspection Tool to view the HTML, find the class names, and test changes to the CSS. Then you can write a new CSS file.
To learn about writing CSS to style Salesforce Knowledge content, please refer to the official Salesforce documentation.
Learn how Paligo matches your content to Salesforce Knowledge articles when you publish with the Salesforce Knowledge Layout.
The Salesforce Knowledge Layout provides a simpler form of mapping. It allows Paligo to map the top-level topics in a publication to articles. Any lower-level topics in the publication structure are mapped to sub-sections of the articles.
Example 88. Mapping with Salesforce Knowledge Layout
Let's say you have a 3 level publication in Paligo. You decide to use a Salesforce Knowledge Layout to publish your content, and it is mapped like this:
-
The publication is level 1.
-
"Air Filtering" is at level 2 (the highest level of fork inside the publication). It is mapped to an article in Salesforce Knowledge.
-
"Manual Air Flow Management" is at level 3. This is mapped as a sub-section of the "Air Filtering" article.
-
"Air Flow Overrides" is a level 4 fork. It is mapped to a sub-section of its parent ("Manual Air Flow Management" sub-section inside the "Air Filtering" article.
-
"Stop Air Flow" and "Start Air Flow" are level 5 forks. They are both mapped to sub-sections. These are sub-sections of their parent.
-
"Safety Precautions" is a level 3 fork and is mapped to a sub-section of the "Air Filtering" article.
-
"Customer Support" is a level 2 fork and is mapped to an article.
If this mapping does not suit your publication structure, you could consider using a Salesforce Nested Layout instead (see Mapping with a Salesforce Nested Layout). That supports more complex publication structures.
Alternatively, you could change the structure of your publication. A common approach is to move topics up at least one level, so that you have more articles and fewer sub-sections.
When you understand the mapping, you can publish your content to Salesforce Knowledge, see Publish to Salesforce Knowledge.
Learn how Paligo matches your content to Salesforce Knowledge Navigational Topics and articles when you publish with the Salesforce Nested Layout.
Paligo has a Salesforce Nested Layout that you can use to publish to Salesforce Knowledge. It allows you to publish content directly to both:
-
Articles
The articles contain the information that users read.
-
Navigational Topics
The Navigational Topics do not contain content. Instead, they are used to guide users to collections of related articles. In some themes, they are used as menu options.
We use the term "mapping" to describe the process of matching the Paligo content to the required structure in Salesforce Knowledge.
To understand how the mapping works, you need to be aware of:
-
Layout settings that affect the mapping
-
Mapping rules
When you understand how these work, you will be able to use the Layout settings to change the mapping to suit your requirements.
The Salesforce Nested Layout has two settings that you can use to control the mapping. These are:
-
Chunk section depth
This is the most important setting for the mapping and you can find it in the TOC and chunking category. It tells Paligo how many levels of your publication structure can be mapped to Navigational Topics.
By default, it is set to 3, which means the top 2 levels of forks (references to topics) in your publication may be mapped to Navigational Topics. (The first level is the publication itself). Lower-level forks are mapped to articles or sub-sections of the articles.
"Air Filtering" and "Manual Air Flow Management" are level 2 and level 3 topics and would be mapped to Navigational Topics.
Note that being inside the Chunk section depth level does not guarantee that a fork will be mapped to a Navigational Topic. There are other criteria that also have to be met, as explained in Rules for Mapping with Salesforce Nested Layout.
-
Create article for the section topic
You can find this setting in the Salesforce category. When enabled, it tells Paligo to create an extra article for each Navigational Topic. This can be useful if you do not want to lose content from topics that are mapped to Navigational Topics. For details, see Generate Articles for Navigational Topics.
To understand the mapping, you only need to be aware that Paligo can create extra articles and that they have the same name as their "parent" Navigational Topic.
Paligo has rules for mapping content to Salesforce Knowledge. It uses these rules as well as the Layout settings to determine whether content is mapped to a Navigational Topic, article, or sub-section of an article in Salesforce. Also, some content may not be mapped at all, due to not meeting the required criteria.
To explain the rules for mapping with a Salesforce Nested Layout, we are going to use an example publication structure (shown below). The publication structure has 6 levels of content, where the publication itself is level 1 and then there are forks (references to topics) at levels 2, 3, 4, 5 and 6.
Note
We assume that the Salesforce Nested Layout has its Chunk section depth set to 3 (default) and Create article for section topic is enabled (default).
The rules for mapping to Navigational Topics, articles, or sub-sections are:
-
Navigational Topic
To be mapped to a Navigational Topic, a fork has to meet both of these criteria:
-
Inside the Chunk section depth.
-
Has a lower-level "child" fork.
In the example structure, "Air Filtering" is mapped to a Navigational Topic as it is inside the Chunk section depth and has a child fork ("Automatic Air Flow Management"). The "Automatic Air Flow Management" fork also meets the criteria for a Navigational Topic.
-
-
Article
To be mapped to an article, a fork has to meet any of these criteria:
-
Outside the Chunk section depth and has a parent fork that is mapped to a Navigational Topic.
In the example, "Program the Airflow" meets this criteria.
-
Inside the Chunk section depth but has no child fork.
In the example, "Safety Precautions" meets this criteria.
-
Mapped to a Navigational Topic and Create article for the section topic is enabled in the Layout.
In the example, "Air Filtering" and "Automatic Air Flow Management" meet this criteria.
-
-
Sub-section
To be mapped to an article, a fork has to meet any of these criteria:
-
Outside the Chunk section depth and has a parent fork that is mapped to an article.
In the example, "Auto Flow Start Time" meets this criteria.
-
Outside the Chunk section depth and has a parent fork that is mapped to a sub-section.
In the example, "Auto Flow Start (Regular Schedule)" and "Auto Flow Start (Custom Schedule)" both meet this criteria.
-
-
Not Mapped
Paligo will not map any fork that meets all of these criteria:
-
Inside the Chunk section depth.
-
Has no parent fork (the publication does not count as a parent).
-
Has no child fork.
In the example, "Customer Support" meets this criteria.
-
You will need to be aware of these rules if you make changes to the mapping.
The following examples show how changing the Chunk section depth in a Salesforce Nested Layout can affect the mapping:
Each example shows the mapping and also explains how Paligo applies the rules to determine whether a fork is mapped to a Navigational Topic, article, or sub-section of an article.
Example 89. Mapping with Salesforce Nested Layout, Chunk section depth set to 3
Let's look at how Paligo will map a 5-level topic structure to Salesforce Knowledge when the default settings are in place (Chunk section depth is 3, Create article for the section topic is set to Enable).
Paligo uses the Layout settings and the rules for mapping to decide how each topic is mapped.
-
The publication is level 1
-
"Air Filtering" is at level 2.
-
Inside Chunk section depth: Yes.
-
Has child forks: Yes ("Automatic Air Flow Management" and "Safety Precautions").
-
Mapped to: Navigational Topic and article.
-
-
"Automatic Air Flow Management" is at level 3.
-
Inside Chunk section depth: Yes.
-
Has child forks: Yes ("Program the Auto-Flow").
-
Mapped to: Navigational Topic and article.
-
-
"Program the Auto-Flow" is at level 4.
-
Inside Chunk section depth: No
-
Parent fork is mapped to: Navigational Topic ("Automatic Flow Management")
-
Mapped to: Article.
-
-
"Auto-Flow Start Time" is at level 5.
-
Inside Chunk section depth: No.
-
Parent fork is mapped to: Article ("Program the Auto-Flow").
-
Mapped to: Sub-section of parent article.
-
-
"Auto-Flow Start (Regular Schedule)" and "Auto-Flow Start (Custom Schedule)"
-
Inside Chunk section depth: No.
-
Parent fork is mapped to: Sub-section ("Auto-Flow Start Time").
-
Mapped to: Sub-section of parent sub-section.
-
-
"Safety Precautions" is at level 3.
-
Inside Chunk section depth: Yes
-
Parent fork is mapped to: Navigational Topic ("Air Filtering")
-
Mapped to: Article.
-
-
"Customer Support" is at level 2.
-
Inside Chunk section depth: Yes.
-
Parent fork is mapped to: No parent (publication is not counted as a parent fork).
-
Has child fork: No.
-
Mapped to: Cannot be mapped as no parent fork and no child fork.
-
Example 90. Mapping with Salesforce Nested Layout, Chunk section depth set to 2
Let's look at how changing the Chunk section depth to 2 affects the mapping of a publication with 5 levels of content. For this example, we assume the Create article for section topic is set to Enable.
Paligo uses the Layout settings and the rules for mapping to decide how each topic is mapped.
-
The publication is level 1.
-
"Air Filtering" is at level 2.
-
Inside Chunk section depth: Yes.
-
Has child forks: Yes ("Automatic Air Flow Management" and "Safety Precautions").
-
Mapped to: Navigational Topic and article.
-
-
"Automatic Air Flow Management" is at level 3.
-
Inside Chunk section depth: No.
-
Parent fork is mapped to: Navigational Topic ("Air Filtering").
-
Mapped to: Article.
-
-
"Program the Auto-Flow" is at level 4.
-
Inside Chunk section depth: No.
-
Parent fork is mapped to: Article ("Automatic Flow Management").
-
Mapped to: Sub-section of article.
-
-
"Auto-Flow Start Time" is at level 5.
-
Inside Chunk section depth: No.
-
Parent fork is mapped to: Sub-section ("Program the Auto-Flow").
-
Mapped to: Sub-section of parent sub-section.
-
-
"Auto-Flow Start (Regular Schedule)" and "Auto-Flow Start (Custom Schedule)"
-
Inside Chunk section depth: No.
-
Parent fork is mapped to: Sub-section ("Auto-Flow Start Time").
-
Mapped to: Sub-section of parent sub-section.
-
-
"Safety Precautions" is at level 3.
-
Inside Chunk section depth: Yes
-
Parent fork is mapped to: Navigational Topic ("Air Filtering")
-
Mapped to: Article.
-
-
"Customer Support" is at level 2.
-
Inside Chunk section depth: Yes.
-
Parent fork is mapped to: No parent (publication is not counted as a parent fork).
-
Has child fork: No.
-
Mapped to: Cannot be mapped as no parent fork and no child fork.
-
Example 91. Mapping with Salesforce Nested Layout, Chunk section depth set to 4
Let's look at how changing the Chunk section depth to 4 affects the mapping of a publication with 5 levels of content. For this example, we assume the Create article for section topic is set to Enable.
Paligo uses the Layout settings and the rules for mapping to decide how each topic is mapped.
-
The publication is level 1
-
"Air Filtering" is at level 2.
-
Inside Chunk section depth: Yes.
-
Has child forks: Yes ("Automatic Air Flow Management" and "Safety Precautions".
-
Mapped to: Navigational Topic and article.
-
-
"Automatic Air Flow Management" is at level 3.
-
Inside Chunk section depth: Yes.
-
Has child forks: Yes ("Program the Auto-Flow").
-
Mapped to: Navigational Topic and article.
-
-
"Program the Auto-Flow" is at level 4.
-
Inside Chunk section depth: Yes.
-
Has child forks: Yes ("Auto-Flow Start Time").
-
Mapped to: Navigational Topic and article.
-
-
"Auto-Flow Start Time" is at level 5.
-
Inside Chunk section depth: No.
-
Parent fork is mapped to: Navigational Topic ("Program the Auto-Flow").
-
Mapped to: Article.
-
-
"Auto-Flow Start (Regular Schedule)" and "Auto-Flow Start (Custom Schedule)"
-
Inside Chunk section depth: No.
-
Parent fork is mapped to: Article ("Auto-Flow Start Time").
-
Mapped to: Sub-section of parent article.
-
-
"Safety Precautions" is at level 3.
-
Inside Chunk section depth: Yes
-
Parent fork is mapped to: Navigational Topic ("Air Filtering")
-
Mapped to: Article.
-
-
"Customer Support" is at level 2.
-
Inside Chunk section depth: Yes.
-
Parent fork is mapped to: No parent (publication is not counted as a parent fork).
-
Has child fork: No.
-
Mapped to: Cannot be mapped as no parent fork and no child fork.
-
If you publish with a Salesforce Nested Layout, you can change how Paligo maps content to Salesforce Knowledge. For example, you may want to have fewer levels of a publication mapped to Navigational Topics, or perhaps you have articles that are too long and need fewer sub-sections.
Before you make any changes, make sure you understand the rules for mapping. When you understand how they work, you can alter the mapping by:
-
Changing the Chunk section depth setting in the Layout
For details, see Control the Mapping to Salesforce Navigational Topics.
-
Change the value of the Create article for the section topic setting in the Layout
For details, see Generate Articles for Navigational Topics.
-
Change the structure of your publication in Paligo.
If overlong articles are an issue, consider reorganizing your publication so it has a "flatter" structure. Aim to have more topics at the article level, with fewer sub-sections. You should also consider Salesforce's size limits.
Tip
If you are going to change your publication's structure, we recommend that you first make a copy of the publication or make a branch of it. This means you can keep the original version for use with other outputs, such as PDF or HTML5. Then you can rearrange the copy or branch to create a version for publishing to Salesforce.
Discover how to publish your Paligo content to Salesforce Navigational Topics and/or articles.
You can publish a Paligo publication to "push" content from Paligo to Salesforce Knowledge. You cannot publish individual topics.
Note
Before you publish, you must have already:
-
Completed the Preparation for Salesforce Integration
-
Decided on which type of Salesforce Layout you are going to use for publishing (see Mapping with a Salesforce Knowledge Layout, Mapping with a Salesforce Nested Layout, and Create a Salesforce Layout).
-
Select the dotted menu (...) for the topic or publication in Content Manager.
-
Select Publish.
Paligo displays the Publish document dialog.
-
Select the HTML output and choose Salesforce Knowledge.
-
Use the Salesforce link prefix field to customize any cross-references. You should only use this field if your articles in Salesforce are not located directly in the root of your instance.
For example, if the URL for your articles is 'my-instance.force.com/<name of article>', leave the Salesforce link prefix field empty. Paligo will publish your cross-references correctly by default.
If the URL for your articles has one or more extra directories between the instance and the article, enter the syntax in the Salesforce link prefix field. For example, if the URL for your articles is 'my-instance.force.com/sa/<name of article>, enter /sa/ in the Salesforce link prefix field.
Note
The Salesforce integration settings also have a link prefix setting, but the Salesforce link prefix in the publishing settings takes priority.
The possible combinations and results are:
-
Integration settings has no link entry, publishing settings has no link entry. Result: Cross-references use the syntax <salesforce instance>/<article>
-
Integration settings has link entry, publishing settings has no link entry. Result: Cross-references use the syntax defined in the integration settings.
-
Integration settings has link entry, publishing settings has link entry. Result: Cross-references use the syntax defined in the publishing settings.
-
Integration settings has no link entry, publishing settings has link entry. Result: Cross-references use the syntax defined in the publishing settings.
-
-
Use the SEO friendly switch to control how Paligo generates URLs for the articles.
-
Set the switch to on (blue) if you want Paligo to generate URLs that are based on the title of the topic. This creates a more meaningful URL that is better for search engines and your readers. For example, if you have a topic with the title "Research Articles", Paligo will generate its URL as "/articles/research-grants-12345". Spaces in the title are replaced by hyphens and the ID of the topic is added to the end to make sure the URL is unique.
-
Set the switch to off (white) if you want Paligo to generate URLs that are based on the UUID of the topic. This create a URL that contains the UUID, such as /articles/UUID-123-1230654.
-
-
Click in the Salesforce Data Categories field and then choose a data category from the list. The data categories in the list have to be set up in Salesforce (Paligo pulls them from Salesforce). They can be set up for different purposes, including targeting different audiences.
-
Select Publish document to publish your content.
When the publishing is done, go to your Salesforce Knowledge account and check the results.
Note
If Salesforce displays an error relating to the article size, and your article is 130 KB or less, it is likely due to size limits that are set in Salesforce. Please refer to Salesforce's documentation for details on how to change the limits.
Paligo can publish topics of up to 130 KB and content is "pushed" into a single field in Salesforce.
Note
You can set the look and feel of the articles in Salesforce. Typically, this is done by setting up a Create a Salesforce Layout and using Cascading Style Sheets (CSS) to style the content there.
Importing content from Salesforce Knowledge is possible, but varies depending on how your content is set up. Contact your account manager for information.
It is possible to import content from Salesforce Knowledge into Paligo. There are several different ways to do this and the best approach for you will depend on your requirements and the structure of your content.
For more information, please contact your account manager.
Salesforce Knowledge has a 1MB limit for images and a 130KB limit for articles.
Salesforce enforces some size limitations that it's important to be aware of.
-
Images can not be larger than 1 MB. In general, it is of course good to reduce the size of images, but in Salesforce, the publishing will not go through at all if there is an image larger than this limit.
-
Each article can not be larger than 130 KB (in terms of plain text, excluding images).
It can of course be difficult to know exactly how large your output articles will be, but as an indication, 130 KB is quite a lot of text and would make for a very long article.
Note
If Salesforce displays an error relating to the article size, and your article is 130 KB or less, it is likely due to size limits that are set in Salesforce. Please refer to Salesforce's documentation for details on how to change the limits.
Paligo content is "pushed" into a single field in Salesforce.
Comments
0 comments
Article is closed for comments.