Générateur de rapports

Exposer le générateur de rapports transforme l'un de vos modèles de rapport en page publique. D'autres personnes ouvrent un lien, fournissent les documents demandés par le modèle et récupèrent le rapport terminé — sans compte QAnswer et sans pouvoir modifier le modèle lui-même.

Ouvrez l'assistant, allez dans l'onglet Exposer et sélectionnez la carte « Générateur de rapports ». La page qui s'ouvre est un guide en six étapes.

Note
Si l'organisation de l'assistant ne dispose pas de l'option Expose, ce guide s'ouvre en lecture seule : l'avis « Option Expose requise » apparaît en haut et toutes les étapes sont grisées. Voir L'option Expose.
Avertissement
Vous devez disposer d'un modèle enregistré au préalable. Un assistant Générateur de rapports tout neuf n'en a aucun, et les étapes 3 et 4 restent bloquées tant qu'aucun n'est choisi — elles affichent « Vous devez choisir un modèle… ». Créez et enregistrez-en un d'abord sur la page Générateur de rapports de l'assistant.
Le guide du générateur de rapports, avec les étapes Langue et Sélectionner un modèle

Étape 1 — Langue

Choisissez la langue d'affichage de la page publique — ses libellés, boutons et textes indicatifs. Tant qu'aucune langue n'est choisie, le lien de partage de l'étape 6 reste désactivé avec le message « choisissez une langue à l'étape 1 ».

Étape 2 — Sélectionner un modèle

Choisissez lequel de vos modèles enregistrés publier. Le champ est une liste consultable ; saisissez du texte pour la filtrer, ou utilisez les flèches pour parcourir les modèles un par un.

La liste Sélectionner un modèle ouverte, affichant les modèles enregistrés de cet assistant
  • Un seul modèle est exposé par lien. Pour publier un deuxième modèle, revenez ici et générez un autre lien pour celui-ci.
  • Les modèles portent une puce indiquant leur type, ce qui permet de distinguer d'un coup d'œil un modèle ancien d'un plus récent.
Note
Choisir un modèle débloque les étapes 3 et 4, qui lui sont propres.

Étape 3 — Description (facultatif)

Une brève explication destinée à quiconque ouvre le lien — ce que couvre le rapport et ce qu'on attend de lui.

L'étape Description du guide du générateur de rapports
Avertissement
La description appartient à l'assistant, pas à ce seul modèle. La modifier ici change également ce qu'affichent les autres intégrations de l'assistant.

Étape 4 — Données du modèle

C'est l'étape propre au générateur de rapports. Les connecteurs de données de votre assistant sont listés, et pour chacun vous décidez de son comportement dans le modèle publié :

L'étape Données du modèle, listant un connecteur Document réglé sur Inclure
  • Requis — la personne qui exécute le rapport doit téléverser ses propres données pour ce connecteur avant que le rapport ne s'exécute. À utiliser pour l'élément sur lequel porte le rapport — un contrat, un rapport à résumer.
  • Inclure — vos propres données de ce connecteur sont disponibles pour le rapport publié. À utiliser pour la documentation de référence sur laquelle tous les rapports doivent s'appuyer.
  • Exclure — le connecteur n'est pas du tout accessible depuis le modèle publié. À utiliser pour tout élément confidentiel.

Avec plusieurs connecteurs, les actions groupées les règlent tous d'un coup — Tout requérir, Tout inclure ou Tout exclure — et le menu ⋯ de chaque ligne propose les mêmes choix connecteur par connecteur.

Avertissement
Cliquez sur « Enregistrer » sous la liste des connecteurs. Rien de ce que vous modifiez à cette étape ne prend effet avant cela.

Étape 5 — Choisir votre accès

Personne ne peut ouvrir le lien tant que vous n'avez pas décidé qui est autorisé :

L'étape Choisir votre accès du guide du générateur de rapports
  • Public — toute personne disposant du lien peut exécuter le rapport, sans connexion ni clé API.
  • Utilisateurs connectés — le lien fonctionne, mais seulement après connexion du visiteur à QAnswer. Utile pour un partage interne à une entreprise.
  • Uniquement avec une clé API — l'assistant reste privé et le lien contient une clé API qui permet aux visiteurs d'y accéder. Sélectionnez cette option pour remettre hors ligne un générateur de rapports publié : un lien sans clé cesse de fonctionner.

Lorsque Uniquement avec une clé API est sélectionné, les réglages de la clé apparaissent juste sous l'option :

  • Utiliser une clé API existante liste les clés de l'assistant utilisables ici ; les clés expirées et les clés Read and write sont écartées. Ce choix n'apparaît que si vous avez un accès en écriture à l'assistant et qu'une telle clé existe.
  • Pour créer une nouvelle clé, saisissez un nom dans Nom de la clé API et cliquez sur Générer une clé.
  • La clé choisie s'affiche alors masquée, avec un bouton de copie, et Utiliser une autre clé fait réapparaître le sélecteur. QAnswer mémorise la clé dans votre navigateur et la sélectionne à nouveau la prochaine fois que vous ouvrez le guide.
  • Ne pas inclure la clé API dans le code exporté (avancé) retire la clé du lien. Le lien ne fonctionne alors que dans ce navigateur, où la clé est conservée dans le stockage local.

Passer à Public ou à Utilisateurs connectés met la clé de côté, puisqu'aucune n'est alors nécessaire ; elle revient si vous repassez à Uniquement avec une clé API.

Note
Sous les options, un message d'état indique si l'intégration est prête, par exemple « Prêt : tout le monde peut utiliser cette intégration, aucune clé API n'est nécessaire. », ou ce qui manque encore, comme « Pas encore prêt : sélectionnez ou créez une clé API ci-dessus. »
Avertissement
L'accès est un réglage au niveau de l'assistant. Le modifier ici le modifie aussi pour les autres interfaces de l'assistant et pour toutes les intégrations tierces.
Note
Cette étape ne contrôle que l'accès public anonyme. Pour partager avec des utilisateurs, des équipes ou des organisations précis, utilisez la boîte de dialogue Partager dans la barre supérieure de l'assistant.

Étape 6 — Partager

Une fois la langue, le modèle et le type d'accès définis, le lien apparaît. Utilisez l'icône de copie à côté, ou la flèche pour l'ouvrir dans un nouvel onglet.

L'étape Partager affichant le lien public généré du générateur de rapports

Tant que ces trois éléments ne sont pas définis, cette étape affiche un avertissement au lieu d'un lien, en indiquant ce qui manque — « choisissez une langue à l'étape 1 », « choisissez un modèle à l'étape 2 », ou un rappel de choisir un type d'accès.

Note
Le lien contient l'identifiant du modèle et un indicateur de duplication. Chaque visiteur travaille sur sa propre copie du modèle : exécuter le rapport public ne modifie donc jamais l'original que vous avez publié.