Importer des questions dans Askbase

Askbase (Q&R pour Confluence Cloud) importe questions et réponses depuis un fichier CSV ou JSON. Un administrateur Confluence ouvre Confluence administration → Apps → Askbase → Import, choisit le fichier, vérifie l'aperçu et clique sur Import now. Les exports d'Askbase utilisent le même format : vous pouvez donc aussi déplacer vos Q&R d'un site à l'autre.

Format du fichier

Une ligne par question ou réponse, avec une ligne d'en-tête. La casse des noms de colonnes n'a pas d'importance ; les noms courants d'autres outils (Question, Content, Labels, Space, Created, Score) sont aussi reconnus.

ColonneSignification
typequestion ou answer
idIdentifiant de l'élément dans l'ancien outil (obligatoire pour les questions qui ont des réponses)
question_idPour les réponses : l'identifiant de leur question
titleTitre de la question (obligatoire pour les questions)
bodyDétails de la question, ou texte de la réponse (obligatoire pour les réponses)
tagsTags séparés par des virgules (5 maximum)
space_keyClé de l'espace Confluence, ou vide pour tout le site
page_idIdentifiant de page Confluence facultatif pour lier la question à une page
author_account_idIdentifiant de compte Atlassian (conserve l'auteur lors d'un import sur le même site)
author_nameAffiché comme auteur en l'absence d'identifiant de compte
created_atDate d'origine, par ex. 2024-03-18T09:30:00Z
votesTotal des votes
acceptedyes sur la réponse acceptée

Exemple :

type,id,question_id,title,body,tags,accepted,author_name
question,101,,How do I request VPN access?,New starter next week,"it,onboarding",,Dana Lee
answer,,101,,File a ticket in the IT portal under Access.,,yes,Sam Ortiz
answer,,101,,Your manager can also request it for you.,,,Priya N

Depuis Questions for Confluence (Data Center ou Server)

  1. Sur votre site Data Center, exportez questions et réponses avec l'API REST documentée par Atlassian (/rest/questions/1.0/question et /rest/questions/1.0/answer/{id}) ou les requêtes de base de données de l'article de la base de connaissances Atlassian.
  2. Créez un CSV avec les colonnes ci-dessus : une ligne question par question (son identifiant de contenu en id, titre, texte, sujets en tags, clé d'espace) et une ligne answer par réponse (identifiant de contenu de la question en question_id, accepted = yes pour la réponse acceptée).
  3. Installez Askbase sur votre site Cloud et importez le CSV depuis les paramètres d'Askbase.

Questions for Confluence Cloud n'a pas d'export (FAQ Atlassian) : cette méthode ne fonctionne donc que tant que votre site Data Center ou Server tourne encore. Faites-le avant de l'arrêter.

Depuis d'autres applis de Q&R, tableurs ou forums

  • Exportez en CSV depuis l'ancien outil (ou copiez dans un tableur et enregistrez en CSV).
  • Renommez les en-têtes selon les colonnes ci-dessus, ou gardez des noms courants comme Question / Answer / Labels.
  • Les applis encore basées sur Connect perdent le support le 31 janvier 2027. Exportez tant que l'ancienne appli fonctionne : ce que cela signifie.

Questions

Askbase peut-il importer depuis Questions for Confluence Cloud ?

Pas directement. La FAQ d'Atlassian indique qu'il est impossible d'exporter le contenu de Questions for Confluence Cloud, et son API REST Cloud a été supprimée. Si vous utilisez encore Questions sur Data Center ou Server, exportez depuis là (étapes ci-dessus) et importez le fichier dans Askbase sur Cloud.

Les auteurs et les dates sont-ils conservés ?

Les dates et les votes, oui. Les auteurs sont conservés si le fichier contient des identifiants de compte Atlassian et que vous importez sur le même site (par exemple un export Askbase d'un autre espace ou d'un site de test). Sinon, Askbase affiche le author_name du fichier.

Puis-je importer en plusieurs fichiers ?

Oui. Chaque question doit figurer dans un fichier avant (ou avec) ses réponses. Askbase retient les anciens identifiants : les réponses d'un fichier ultérieur retrouvent leur question.

Mes données sont-elles envoyées quelque part pendant l'import ?

Non. Le fichier est lu dans votre navigateur et stocké dans le stockage Forge d'Atlassian pour votre site. Askbase tourne sur Atlassian et n'a aucun serveur externe.

Bloqué sur un format ? Écrivez à support@norynta.com avec quelques lignes d'exemple (sans données confidentielles) et nous vous aiderons à faire la correspondance.