Skip to main content
Inspiring
February 18, 2021
Question

Zendesk articles not updating

  • February 18, 2021
  • 18 replies
  • 2445 views

I'm using RoboHelp 2020 and publishing to Zendesk. I was successful in getting the projects into Zendesk, but I'm having trouble with revisions not showing. RoboHelp says everything published, but Zendesk articles only show some updates in any given article. If I have an article with two or more revisions, only one or two will show, not all of them. 

I've tried different browsers, refreshing, clearing cache, and waiting overnight. My guess is there is an issue with the way RoboHelp interacts with the Zendesk API, but can't get any help from Zendesk. Any ideas?

    This topic has been closed for replies.

    18 replies

    TechWriter1025
    Known Participant
    May 26, 2021

    Merged projects definitely don't work with Zendesk but unmerging merged Help isn't so bad if you use the .fpj. 

     

    Something that may contribute to my blank topic issue is that I noticed that RoboHelp is generating my topics incorrectly: I greated a "generate Zendesk" folder and after a successful generate (according to RH), I go to that folder and see all my files (screenshot 1). The individual .htm topics open with no issues but one .htm file that lists all my topics (screenshot 2) links incorrectly (screenshot 3). My main project is Project A with self explained topic titles, Project A - Topic 1, Project A - Topic 2, etc. I have one rouge-named topic FYI.

     

    All topics are in my TOC on the same level. Is there something I should be setting up differently? Or is this a bug?

     

     

     

     

    Community Expert
    May 21, 2021

    I wouldn't expect merged projects to work with somethng like Zendesk simply because the construction is far more complex than those systems are designed for - according to the links, they don't even cope with more than 3 levels of 'toc'. And the linking between projects then gets in to relative file paths, not to mention I know there is javascript involved to bring the whole merge together, so that likely wouldn't be supported either.

     

    But to get a definitive answer on merged projects and thirdparty knowledge bases, you'd need to contact support for an official answer.

     

    See the following page for support contact options:
    https://helpx.adobe.com/contact/enterprise-support.other.html#robohelp

    Kevin5FC2Author
    Inspiring
    May 20, 2021

    I'm not sure merged projects would be the issue as generating an output is a separate process from publishing. But then, I've never used merged project outputs from RoboHelp.

    TechWriter1025
    Known Participant
    May 20, 2021

    Thank you all. I'll have to try these suggestions. So far, I'm testing with a much much smaller project as opposed to a copy of my real projects. I'm also working with a merged RH project, which may be an enormous issue because it seems as though cross project linking does not work when published to Zendesk. I'm going off topic, I know.

    Kevin5FC2Author
    Inspiring
    May 18, 2021

    @TechWriter1025 - I'm referring to RoboHelp. The topic properties has a Status dropdown. But I've found that this has no impact on whether the topic publishes or not. While I'm not sure exactly what I did to resolve the issue, here's something to try:

    1. With a blank TOC file open, click the Insert Section icon along the top toolbar and name the section the exact name of your Zendesk page where your publishing to. For example, I'm working on a cloud-based application and have a Cloud Platform page for the Admin Guide, User Guide, and various documents for the support team. It's that simple and you don't have to connect the section to anything.
    2. Add a subsection with the title of your publication, such as Product User Guide.
    3. For the third level, I added the TOC with all my topics that I titled Contents. So it's a TOC within a TOC. This allows me to maintain one TOC for all my various outputs, e.g., Zendesk, Word (for drafts), etc. I can then add front matter for each type of publication as needed, e.g., home page for web, cover sheet for print, etc. I should add that this TOC is all one level with no subtopics as this is how it appears in Zendesk.

    One thing I did find is that my updates were actually going to a generic page in Zendesk titled, "others". If you have permissions, go to Guide admin > Arrange content > Arrange articles. I hope this helps.

    Community Expert
    May 18, 2021

    Make sure you follow the toc structure recommended here:

    https://helpx.adobe.com/robohelp/user-guide.html/robohelp/using/publish-zendesk.ug.html#configure_toc

     

    Or see this article (not for Robohelp) which I think explains the structure required for Zendesk more clearly. Specifically the Create a TOC section.

    https://www.madcapsoftware.com/blog/a-step-by-step-guide-how-to-publish-madcap-flare-content-directly-to-zendesk/

     

    This article also indicates (in the Additional Considerations section) that you can't publish a topic to multiple categories, which might also play in to some of the problems being seen.

     

    Additionally, there might be a rate limit on uploading to Zendesk. Which might explain the fewer errors on subsequent publishing, as each publish results in fewer files needing to be updated each go. You'd have to contact Robohelp support to see if this could be the issue though.

     

    Do note I haven't published to Zendesk, so I'm only theorising about possible issues.

    TechWriter1025
    Known Participant
    May 17, 2021

    I'm having trouble with this too: 1) not all selected articles carried over 2) all articles are blank--there is nothing in the body. I solved my first problem by taking this thread's suggestion of adjusting the TOC, so now all my articles are on Zendesk, but they're all blank. @Kevin5FC2 when you say you adjusted the article status, was that in RH or Zendesk?

    Peter Grainge
    Community Expert
    Community Expert
    February 21, 2021

    This is a new feature so not many forum supporters with experience of this. I can only suggest you try Support. See https://helpx.adobe.com/contact/enterprise-support.other.html#robohelp for your support contact options.

    ________________________________________________________
    See www.grainge.org for free Authoring and RoboHelp Information

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    Kevin5FC2Author
    Inspiring
    February 25, 2021

    While I did successfully resolve the issue, I never really found the silver bullet. I made several versions of my TOC until I found one that gave the best results. I also made changes to each topic status. Still, publishing often resulted in 404 and 503 errors for random topics. I found that if I republish, there were fewer errors each time. After three to four publishings, all topics finally updated successfully for each of my outputs. I think there is still some work to be done on how RoboHelp uses the Zendesk API.