When you have import content from Zendesk, Paligo creates topics to match the sections and articles. To use these topics to update the matching articles in Zendesk, you need to set up the topic-to-article relationships. This is called "mapping" and you set it up by using the Zendesk Preflight feature, which is part of the publishing settings.
-
Select the options menu ( ... ) for the publication that Paligo created when you imported content from Zendesk. Then select Publish.
-
On the Publish Document dialog, select HTML.
-
Choose a Zendesk layout from the dropdown list below the buttons for the output types.
When you select a Zendesk layout, the Publish Document dialog changes to show Zendesk-specific settings, such as Zendesk category and Managed by. Also, the Zendesk Preflight tab appears at the top.
-
Apply any Languages, Profiling attributes, Variables, and Optional Parameters that you want the publication to use.
These are common publishing settings and you can find out about them in Publish Content, Filtering / Profiling, and Variables.
-
Select the Zendesk Preflight tab.
The Zendesk Preflight tab shows you what will happen in Zendesk when you publish. There is a hierarchical list, that shows the categories, sections, and articles that will be created, updated, or deleted. Those that are marked with a plus icon are going to be added to your Zendesk instance.
Note
In Paligo, you create different levels in a publication's structure by adding topics and organizing them in a hierarchy. So where Zendesk has a section and then articles in it, Paligo has a top-level topic, with other topics at a lower level. As the top-level topic can contain content, Paligo automatically creates an extra article for it when publishing to Zendesk. If you prefer, you can use the Zendesk Layouts to stop Paligo from creating extra articles for top-level topics.
As the import topics do not have any relationship with the articles in Zendesk, Paligo sees them as completely new content. So when you publish to Zendesk, Paligo will create new categories, sections, and articles.
Below the new sections and articles, there are sections and articles that are gray and do not have any icons. These represent the sections and articles that already exist in Zendesk.
There is no update icon for these, as Paligo is not going to do anything to them. It knows they exist in Zendesk, but they are not mapped to any topics.
With a new import, you most likely do not want the import topics to create new sections and articles. Instead, you probably want them to update the existing sections and articles instead. So the next step is to set up that mapping.
-
Select the cog icon for a section that Paligo is going to add to Zendesk. The mapping dialog appears.
-
Select the Mapping dropdown list.
You now have the option to create a new section in Zendesk (the option with the plus icon). Or you can map the section topic in Paligo to any existing, unmapped section or article (the options with the update icons).
After an import, you will most likely want to map the section topics to existing sections in Zendesk, and the article topics to existing articles in Zendesk.
-
Set the section to map to an existing, unmapped section in Zendesk and then select Confirm.
When you confirm, the list refreshes to show the new mapping. You should see that the section now has an update icon instead of a plus icon, as you have set the section topic to update an existing section in Zendesk. If you expand the section in the list, you should see that it now contains the existing articles in that section (grayed out) and also the new articles that Paligo will create in that section (plus icons).
You most likely do not want this mapping. Instead, you want Paligo to map the content to the existing articles. So the next step is to map the new articles (plus icons) to the existing articles (grayed out).
-
Select the cog icon for one of the new articles to display the mapping dialog.
-
Select the Mapping dropdown and set the article to update the existing article (update icon), instead of creating a new article (plus icon). Select Confirm when you have set the mapping.
You can set the article to map to any existing, unmapped article in Zendesk, but it's most likely that you want to map to the existing article of the same name.
-
Repeat steps 6-10 inclusive for each new section and new article. As you map the new sections and articles to the existing sections and articles, you will see that the list shows less content. Because the topics that were generated as a result of the import are now mapped to the existing sections and articles, rather than creating new ones in addition to the existing ones.
Typically, after an import, you will set the Paligo content to map to the existing sections and articles, so that there are no new sections or articles being created in Zendesk.
-
Select Publish document to publish your content.
Paligo will then publish your content to Zendesk. From this point on, the topics in Paligo are mapped to the sections and articles in Zendesk. So if you make a change to a topic in Paligo, and publish to Zendesk, the matching article will also have the change.
To find out about using Zendesk Preflight for publishing to Zendesk, see Customize Paligo-to-Zendesk Mapping.
Comments
0 comments
Article is closed for comments.