Ricerche recenti
Nessuna ricerca recente
Back up your Help Center articles at the click of a button!
Data ultimo post: 10 mag 2016
Welcome
Let me introduce you to kBackup! This little app will allow you to back up your help centre content to your local hard drive at the click of a button.
Using this app makes backing up your help centre content a breeze.
Features
The app currently has several features and may be expanded to include additional features if demand arises.
- The app will back up your help centre content to a specified folder as HTML pages in the format of [ArticleId].html. The app will first verify that the user exists in the given Zendesk domain. This is included for security reasons, so only users who exist in the domain can back up the content.
- The app will also back up any images that are embedded in your article and save these in the same backup folder.
- The app will work for any Zendesk help centre, even if a custom domain is used.
- Using the app to back up your help centre content is completely safe and will not affect any existing data. It will simply take a copy of it, so there is no possibility of data loss during the process.
Requirements
There are some requirements for using this app that need to be met in order for it to function correctly. I've included these requirements below:
- Windows 7 or higher.
- Microsoft.Net Framework 4.6 or higher. This version of the .NET Framework can be downloaded here.
- SSO sign-in and 2FA are not supported. If these are used in your instance, please use the username and API token option instead of the username and password combination. For more info on generating an API token, see Zendesk's help article Generating a new API token.
- If you use a username and password combination, your user must have ‘Password Access’ to the API enabled in Zendesk. You can do this by going to Settings > Channels (Subsection) > API and enabling ‘Password Access’.
Getting Started
To get started with backing up your help centre content, ensure that you have met the requirements above, then go ahead and follow the steps below:
- Download the app here
- Extract the downloaded kBackup.zip file to your Desktop
- Right-click the app and select Run as administrator
- Enter your full Zendesk or custom domain into the Domain field (e.g. my-company.com, my-company.zendesk.com)
- Enter your Zendesk user email into the Email field
- Enter your Zendesk user password into the Password field. Alternatively, select the Use API Token checkbox to use an API token
- Select Connect
- Select the language you would like to back up from the Languages dropdown
- Select the Backup button
- Browse for a folder where you would like to back up your content and select Ok
After selecting a folder and clicking Ok, the backup process will begin, and you will receive a notification when the backup is complete.
If you want to back up multiple languages, select another language from the Languages dropdown and click Backup again.
Download kBackup here!
Release Notes
Release notes have been moved into ReleaseNotes.txt, which is now included in the download.
Giving Feedback & Reporting Bugs
For any feedback, feature and functionality requests or bugs you may have encountered, please leave a reply on this post or email me at felix.stubner(at)gmail(dot)com, and I will get back to you as soon as possible.
Leave a Review
If kBackup has helped you, please consider leaving a review on its Zendesk Marketplace Integration page. Additionally, feel free to click on the little up arrow on this post to upvote it. Thanks for your support!
Disclaimer
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
If kBackup has helped you, please consider up-voting this post by clicking the up arrow below. This will help other users to find the post more easily. Thank you!
10
255 commenti
Andrew Rowan
Hey Felix
Really great tool, and one that we are hoping to utilize over the coming weeks.
I am curious if there is a file size or article number limit as we appear to be missing a handful of articles from one of our exports?
Kind regards
Andrew
0
Felix Stubner
Hi 404614539074,
What you are seeing is actually expected behavior.
I purposely shortened it to a reasonable length and replaced any remaining characters with ... to indicate that the title exceeded this limit.
This is to ensure that when a file is saved, there's a much lower chance that the file path exceeds the Windows imposed 259 character limit for file paths. Exceeding the character limit will prevent interactions with the file. You can find more info on this here https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file.
I think the only real solution to this behavior is for the app to handle backup and also restoring the content and managing the data itself. It's something I've considered in the past but haven't had the time to implement this functionality.
That being said, the full title should still be included in the HTML header within the file, so this is something you could potentially also script if you'd like to work around this, by extracting the title from the file content and then updating the file name.
Hope that helps to answer your query. If there's anything else don't hesitate to let me know.
0
小林正左子
Hi Felix, glad to hear back.
I have one more question.
I have a lot of files that have been converted with broken file names.
In fact, when I install it in the sandbox, it is reflected as a choppy file.
Has this ever happened before?
I would like to ask for a fix if possible.
0
Felix Stubner
Hi 404614539074,
thanks for getting back to me and clarifying.
As the format of the way titles are saved is hard-coded there isn't a way to customize this.
That being said, if you are familiar with Python or another scripting language, it wouldn't be too difficult to write a script that will simply rename the files to not include the numerical value and brackets.
As for the files, you could similarly use a script to change the file contents and remove any of the HTML formatting and change the file extension to convert it to a plain-text file.
Hope these suggestions are helpful.
0
小林正左子
Hi Felix, glad to hear back.
I'm using kBackup to keep the production and sandbox environments the same, but I see the ID in the title.
This ID is not necessary for me.
I don't want to confuse our users by showing extra numerical information in the title.
As for modifying the files, I think it would be difficult to remove them if there are too many files.
If you have any useful suggestions, I'd be happy to hear them.
0
Felix Stubner
Hi 404614539074,
Thanks for giving kBackup a try.
I understand that being able to export the files into different formats would be beneficial and it's an idea I have noted as an enhancement in the past. Whether I will get to it anytime soon, I cannot say.
Regarding the second point you had about the article ID being displayed in the title. I'd like to better understand the use-case here. Why is this causing an issue for your use-case?
0
小林正左子
HI Felix, it's Great tool!
I want to let the sandbox do the uploading.
If you use Google Drive.
It takes time and effort to convert from HTML files to Google documents.
The URL number of the article is displayed in the title.
These two points are very troublesome.
I wonder if there is a better way.
0
Nicole Saunders
Thanks for the positive feedback on the mentions functionality, 512155956!
0
Felix Stubner
379574987874 kBackup has been going for a while now and I try to respond usually within 24-48 hours to make sure users get answers relatively quickly.
Really liking the new Mention feature, when I @someone it now actually tags them which is cool. Thanks for stopping by!
0
Devan La Spisa
Hello 512155956,
Way to be a "Titan" with your response there!
0
Accedi per aggiungere un commento.