Découvrez comment publier votre contenu directement dans le Centre d’aide Zendesk.
Les gabarits de page utilisés dans le modèle de sortie PDF ou Word ont été renommés Mise en page.
Les gabarits de page utilisés pour les modèles de rubrique ou pour les sorties en ligne ont été renommés Dispositions de rubrique.
Pour plus d’informations, consultez Modèles dans Adobe RoboHelp.
Adobe RoboHelp étend ses fonctionnalités de publication en vous donnant la possibilité de publier la sortie de la base de connaissances directement dans le Centre d’aide Zendesk.
Pour créer une connexion avec le Centre d’aide Zendesk, vous devez configurer votre compte pour démarrer. Pour plus de détails, voir Prise en main avec Zendesk.
Vérifiez également que l’option permettantd’activer l’authentification API à l’aide de l’adresse e-mail et du mot de passe d’un agent est activée dans l’onglet Paramètres de l’API Zendesk côté Zendesk.
Voici les étapes de configuration du Centre d’aide Zendesk avant de publier votre sortie.
Pour créer un paramètre prédéfini de sortie dans RoboHelp, suivez les étapes suivantes :
Dans un projet actif, procédez de l’une des manières suivantes :
en haut à droite de la barre d’outils Standard et cliquez sur l’icône Modifier les paramètres
.La vue Sortie s’ouvre.
Dans la barre d’outils Sortie, cliquez sur Paramètres prédéfinis de sortie. Le panneau Paramètres prédéfinis de sortie s’ouvre.
Dans le panneau Paramètres prédéfinis de sortie, cliquez sur 
.
Dans la boîte de dialogue Nouveau paramètre prédéfini, spécifiez les options suivantes :
Type : Utilisez la liste déroulante pour sélectionner le type de paramètre prédéfini Base de connaissances.
Nom Spécifiez un nom pour le paramètre prédéfini de sortie.
Cible À partir de la liste déroulante cible, choisissez Centre d'aide Zendesk.
Cliquez sur Terminé.
Vous pouvez accéder au paramètre prédéfini de sortie dans le panneau Paramètres prédéfinis de sortie de la barre d’outils Sortie. Sinon, vous pouvez accéder au paramètre prédéfini de sortie dans la boîte de dialogue Génération rapide de la fenêtre de création.
Vous pouvez utiliser les paramètres suivants pour configurer le paramètre prédéfini de sortie Base de connaissances :
Titre : indiquez le titre de la sortie générée.
Chemin de sortie : indiquez un emplacement pour la sortie.
Assurez-vous que le chemin d’accès de sortie ne se trouve PAS dans le dossier du projet. Si le chemin d’accès de sortie se trouve dans le dossier du projet, la génération de sortie échouera. De plus, le contenu nécessaire ne doit PAS se trouver dans le dossier sélectionné. RoboHelp supprime le contenu du dossier avant de générer la sortie.
Enregistrer le chemin de sortie comme relatif au projet : si cette option est activée et que vous naviguez vers le chemin de sortie, le chemin vers la sortie sera désormais relatif et non plus absolu.
Langue : Utilisez la liste déroulante afin de sélectionner la langue pour la sortie.
Remarque : La langue dans Zendesk doit correspondre à la langue que vous sélectionnerez dans RoboHelp. Par exemple, si vous avez sélectionné Français (France) dans RoboHelp, vous devez sélectionner Français (France) dans Zendesk, non pas Français ni Français (Canada), mais strictement Français (France). La langue dans les deux endroits doit correspondre, sinon il y aura des erreurs dans la publication.
Encodage : dans la liste déroulante, sélectionnez l’encodage à utiliser pour la sortie. Spécifiez le type de format de codage de caractères à utiliser pour votre contenu.
Publication d’un script généré : Pour exécuter votre script personnalisé une fois la génération de la sortie terminée, sélectionnez le fichier de script dans la liste déroulante.
Utilisez les options suivantes pour spécifier les paramètres de sortie de base comme le titre, la cible, le chemin de sortie, le codage, etc. :
Titre Indiquez le titre de la sortie générée.
Vous pouvez utiliser des variables dans le titre. Pour ce faire, saisissez Ctrl + 1 et sélectionnez une variable dans la liste déroulante, puis appuyez sur Entrée. Notez que si vous avez fourni un jeu de variables dans l’onglet Contenu > champ Jeu de variables, lors de la génération de sortie, la valeur de la variable sélectionnée est choisie dans le jeu des variables.
Cible Utilisez la liste déroulante pour spécifier la cible afin de générer la sortie sélectionnée dans le paramètre prédéfini Base de connaissances.
Chemin de sortie Indiquez un emplacement pour la sortie. Pour sélectionner un emplacement, cliquez sur 
.
Assurez-vous que le chemin d’accès de sortie ne se trouve PAS dans le dossier du projet. Si le chemin d’accès de sortie se trouve dans le dossier du projet, la génération de sortie échouera. De plus, le contenu nécessaire ne doit PAS se trouver dans le dossier sélectionné. RoboHelp supprime le contenu du dossier avant de générer la sortie.
Enregistrer le chemin de sortie comme relatif au projet : si cette option est activée et que vous naviguez vers le chemin de sortie, le chemin vers la sortie sera désormais relatif et non plus absolu.
Codage Utilisez la liste déroulante pour spécifier le type de format de codage de caractères à utiliser pour votre contenu.
Exécution d’un script généré Pour exécuter votre script personnalisé une fois la génération de la sortie terminée, sélectionnez le fichier script.js dans la liste déroulante.
Utilisez les options suivantes pour spécifier les paramètres de sortie liés au contenu, tels que les paramètres pour la Table des matières, l’expression de condition, le jeu de variables, le texte déroulant et le texte en expansion.
Table des matières Utilisez la liste déroulante pour sélectionner une Table des matières à inclure dans la sortie. Cette liste déroulante affiche les tables des matières disponibles dans votre projet. La première table des matières de cette liste déroulante est sélectionnée par défaut.
L’ensemble de fichiers et leurs références présents dans la table des matières sélectionnée apparaissent dans la sortie générée.
Il est important de comprendre comment mapper votre publication aux catégories et sections de Zendesk. Pour en savoir plus sur le mappage, voir Configurer le TOC pour Zendesk.
Expression de condition Utilisez la liste déroulante pour indiquer l’expression de condition de votre sortie. Ce paramètre vous permet d’inclure ou d’exclure facilement du contenu en fonction du type de sortie ou de base d’utilisateurs souhaité. Cliquez sur 
pour modifier l’expression de condition sélectionnée. Vous pouvez également choisir Aucun dans la liste déroulante pour ne pas spécifier une expression de condition.
Jeu de variables Utilisez la liste déroulante pour spécifier le jeu de variables à utiliser dans cette sortie. Dans la liste déroulante, vous pouvez sélectionner <Jeu de variables par défaut> pour utiliser le jeu de variables par défaut du projet. Les jeux de variables vous permettent de mettre en œuvre une utilisation spécifique à la sortie des variables. Par exemple, vous pouvez avoir plusieurs jeux de variables pour générer une sortie pour des clients et des utilisateurs internes.
Inclure le texte à développer Sélectionnez cette option pour inclure le texte à développer dans votre sortie Base de connaissances. Sinon, seul le titre à développer est inclus dans la sortie. Cependant, le texte à développer s’affichera sous la forme développée dans la sortie.
Inclure le contenu du texte déroulant Sélectionnez cette option pour inclure le texte déroulant dans votre sortie Base de connaissances. Sinon, seul le titre déroulant est inclus dans la sortie. Toutefois, le texte déroulant s’affichera dans la sortie.
Utilisez l’option pour configurer l’aspect de votre sortie.
Utilisez les options suivantes pour spécifier les paramètres de publication Zendesk, tels que Profil de publication, Visible pour, Géré par, et plus encore :
Profil de publication Utilisez la liste déroulante pour effectuer une sélection dans votre profil de connexion Zendesk. Pour savoir comment créer un profil de publication, voir Configurer un profil de publication .
Visible pour Cliquez sur la liste déroulante pour sélectionner un groupe d’utilisateurs afin de contrôler les paramètres de visibilité de votre contenu publié. Les autorisations d’affichage sont définies sur le serveur Zendesk en fonction de votre compte Zendesk.
Géré par Cliquez sur la flèche déroulante, puis sélectionnez autorisations de gestion pour déterminer qui peut avoir des droits d’édition et de publication. Ces autorisations de gestion sont prégénérées sur le serveur Zendesk en fonction de votre compte Zendesk.
Publier tous les articles de la même catégorie Sélectionnez cette option pour publier toutes les rubriques du TOC dans une seule catégorie et section sur le site Zendesk. Pour plus de détails sur les catégories et les sections, visitez Organiser le contenu de la base de connaissances par catégories et par sections.
Convertir tous les styles en styles inline Sélectionnez cette option pour vous assurer que votre style utilisé dans RoboHelp est conservé lorsque vous publiez votre sortie sur Zendesk.
Charger les images Sélectionnez cette option si vous souhaitez que des images dans les rubriques soient incluses dans la sortie publiée.
Charger les documents liés Sélectionnez cette option si vous souhaitez que les documents (par exemple, PPT, PPTX, DOC, DOCX et PDF) liés dans les rubriques soient inclus dans la sortie publiée.
Inclure Javascript Sélectionnez cette option pour inclure JavaScript dans votre sortie et afficher le texte à développer, le texte déroulant, les fenêtres contextuelles et les miniatures. S’il n’est pas sélectionné, le contenu s’affiche sous forme de texte brut s’il est publié sur le site.
Par défaut, Zendesk n’autorise aucun contenu JavaScript dans les articles. Toutefois, vous pouvez activer JavaScript dans Zendesk en sélectionnant Guide Settings (Paramètres du guide) -> Security (Sécurité) -> « Display unsafe content » (Afficher le contenu dangereux).
Vous devez créer et configurer un profil de publication avant de publier votre sortie sur Zendesk. Pour créer et configurer un profil :
Choisissez Modifier > Publier les profils.
La boîte de dialogue Publier les paramètres s’ouvre.
Cliquez sur 
pour créer un profil.
Dans le champ Type de serveur, sélectionnez Centre d’aide Zendesk.
Pour le type de serveur Centre d'aide Zendesk, procédez comme suit :
Cliquez sur Enregistrer.
RoboHelp enregistre le profil et affiche le nom du profil sous la colonne Profils. Pour modifier un profil, cliquez sur son nom et modifiez ses champs. Pour supprimer un profil, cliquez sur 
en regard de celui-ci.
La dernière étape avant la publication consiste à vérifier que votre table des matières est organisée pour publier votre contenu en catégories et sections, en gardant à l’esprit les lignes directrices suivantes :
Vous pouvez configurer le paramètre de sortie prédéfini Base de connaissances pour le lier à Zendesk, puis publier votre contenu dans le Centre d’aide Zendesk.
Cliquez sur l’onglet Sortie dans la barre d’outils standard. Paramètres prédéfinis de sortie est la sélection par défaut Dans la barre d’outils Sortie.
Sur le panneau Paramètres prédéfinis de sortie, double-cliquez sur un paramètre prédéfini de sortie pour le modifier.
Dans l’éditeur du paramètre prédéfini de sortie, cliquez sur l’onglet Publier pour afficher le profil sélectionné dans la configuration de l’onglet Zendesk.
Vous pouvez également modifier les informations du serveur dans la boîte de dialogue Publier les profils, que vous pouvez lancer en cliquant sur 
.
Sélectionnez les profils (serveurs) sur lesquels vous souhaitez publier du contenu.
Cliquez sur l’icône Générer un paramètre prédéfini 
dans le panneau Paramètres prédéfinis de sortie.
Vous pouvez ensuite afficher une barre de progression à côté du paramètre prédéfini de sortie sélectionné dans le panneau Paramètres prédéfinis de sortie. Une fois la génération de sortie terminée, une boîte de dialogue Succès est visible dans le coin inférieur droit de l’écran.
À la fin de la génération de la sortie, cliquez sur 
dans le panneau Paramètres prédéfinis de sortie pour l’afficher.
Pour publier dans les profils sélectionnés (serveurs), cliquez sur le paramètre prédéfini de sortie, puis cliquez sur 
dans la barre d’outils standard. Ou cliquez avec le bouton droit de la souris sur le paramètre prédéfini de sortie et cliquez sur Publier.
RoboHelp envoie le contenu à Zendesk. Une fois la publication terminée, Robohelp affiche un rapport du contenu publié.
Pour afficher la sortie publiée, cliquez sur l'icône pour vous amener à la page d’accueil du Centre d’aide Zendesk, où vous pouvez accéder à votre article.
Adobe
Nouvel utilisateur ?
