{:fr}

Principe

Une action de type « Lancement de restitution » permet, lors de son exécution, de publier des tableaux de bord dérivés d’un modèle. L’outil ne fait pas de distinction entre les modèles dédiés à la collecte et ceux dédiés à la restitution. L’action de lancement de restitution est similaire à celle dédiée au lancement de collecte, mais elle ne propose pas les paramètres liés à la réception de réponse. De plus, dans la page des publications, les restitutions sont affichées différemment.

Si la restitution (identifiée par un modèle et une date d’arrêté) n’existe pas, elle sera créée. Sinon, de  nouveaux documents seront publiés pour cette publication.

Notez que dans le cadre d’une restitution, les documents ne comportent pas de bouton de transmission de réponse. En revanche, le bouton permettant de vérifier les contraintes est présent, car il est permet de faciliter la détection de problèmes de qualité de données qui seraient éventuellement présents dans les données transmises.

Diffusion

Le paramétrage de la diffusion détermine en particulier les entités de destination et les correspondants affectés.

• Carnet d’adresses : Table / vue fournissant la liste des destinataires potentiels des questionnaires. Techniquement, un seul champ contenant l’adresse mail des destinataires est requis. D’autres champs identifiant peuvent être utiles pour enrichir le noyau.
  • Axe email : le champ du carnet d’adresses portant les adresses mail des correspondants.

• Relation d’affectation : Table / vue définissant la relation d’affectation.
  • Axe de liaison : champ de la relation d’affectation permettant de réaliser la jointure avec le carnet d’adresses.

• Axes de diffusion : Sélectionnez, parmi les champs présents dans la relation d’affectation, ceux définissant les axes de diffusion. Chaque combinaison unique des items d’axes de diffusion constituera une entité (voir aussi la liste des Types d’axes).

• Nom de fichier : Nom de fichier publié. Par défaut, le nom est celui du modèle mais il vous est possible de le personnaliser avec les variables système, les champs du noyau et ceux du compartiment racine du document.

• Table de date d’arrêté : Table / vue contenant la date d’arrêté à utiliser pour cette campagne.
  • Colonne source  : champ de la table/vue contenant la valeur à utiliser comme date d’arrêté. Ce champ doit être un champ date. Si la table/vue contient plusieurs enregistrements, seul le premier est pris en compte.

• Erreurs de personnalisation bloquantes. Si cette case est cochée, toute erreur dans l’alimentation en données de la campagne bloquera le lancement de cette dernière.

Données

Cet onglet vous permet de spécifier l’alimentation en données du document. Au moins un compartiment et au moins un champ du formulaire doivent être alimentés en données.
Pour chaque compartiment vous pouvez spécifier une table/vue d’alimentation et un tri.

Dans cet exemple, le compartiment racine est alimenté par la vue « HR_DEMOS_Sites_Flags ». Seuls 2 des 3 champs de la vue sont utilisés. En revanche, pour le compartiment « Newcomers », la totalité (15/15) des champs de la table « HR_DEMO_Newcomers » est utilisée. L’icône sur fond jaune indique un tri des données.

Messages du modèle

Cet onglet liste les messages du modèle dont est issu la restitution. Vous pouvez les modifier et il est généralement préférable d’éditer les messages depuis cette fenêtre plutôt que lors de l’édition du modèle. En effet, vous pouvez ici disposer des variables issues du noyau ainsi que du compartiment racine.

Les variables système sont également utilisables

Publication

• Vérification HTTP : Si cette case est cochée, le document se connectera au serveur web de GTServer pour vérifier :
  • Que la campagne est toujours active (ni fermée, ni supprimée)
  • Que le questionnaire n’a pas été fermé pour l’entité à laquelle il est rattaché
  • Qu’une nouvelle version du questionnaire n’a pas été envoyée.

Si la vérification HTTP n’a pu être effectuée (par exemple s’il n’est pas possible d’accéder à l’url de GTWeb), le questionnaire ne peut pas être ouvert.

• Diffusion HTTP : Si cette case est cochée, la variable PUBLISH_URL est résolue et aucune pièce jointe n’est ajoutée au mail. Dans le cas contraire, la variable n’est pas résolue et le formulaire est fourni en pièce jointe.

Le lien substitué à la variable PUBLISH_URL pointe toujours sur la dernière version du questionnaire envoyé pour l’adresse mail et les items des axes de diffusion : si un questionnaire a de nouveau été envoyé pour cette entité, le correspondant exploitant l’url du premier message chargera la dernière version du questionnaire si le questionnaire a été envoyé pour la même adresse mail.

• Synchronisation descendante des motifs inertes : Permet d’effectuer une Synchronisation à partir de GTAnswer. Le concepteur peut choisir si la liste des motifs à synchroniser est définie par l’action de lancement courante ou par une autre action de lancement (qui ne pourra être utilisée que pour la synchronisation au besoin).

Le concepteur peut demander à ce qu’une synchronisation soit effectuée à l’ouverture du questionnaire dans GTAnswer et imposer qu’une synchronisation soit effectuée avant la transmission de la réponse (dans ce dernier cas, la transmission de la réponse ne pourra avoir lieu si la synchronisation préalable a échoué).

En cas d’erreur à l’exécution

Ce paragraphe récapitule certains tests à effectuer pour s’assurer du bon fonctionnement de l’action de lancement.
Il ne concerne que les problèmes de données alimentant le document.

Dans tous les cas, comme pour tous les types d’actions (lancement, intégration, restitution), l’action peut être copiée (clic droit puis « Dupliquer l’action ») afin de pouvoir effectuer des modifications sur la copie (en général pour simplifier l’action) de façon à repérer plus facilement les causes de dysfonctionnement.

Consultez les détails des messages d’erreur affichés.

L’action de lancement ne s’exécute pas

• Si des modifications de champ, etc.. ont eu lieu depuis la dernière modification de l’action de lancement. Editez une copie de l’action de lancement et vérifiez que vous pouvez valider une modification minime de cette action.

• En cas d’erreur lors de la transposition, la consultation des fichiers temporaires peut aider au diagnostic de cette erreur. Consultez le point correspondant dans le paragraphe suivant.

• Si les mails ne partent pas pour des soucis de connexion de GTServer au SGBD ou de GTServer au serveur de messagerie, consulter le paragraphe des connexions de l’article Erreurs.

• Vérifiez que chacune des tables/vues pointée par l’action de lancement est opérationnelle dans le SGBD (l’exécution d’un SELECT sur chaque table ne doit pas remonter d’erreur mais peut cependant ne renvoyer aucune donnée).

• Si un multi-onglet est utilisé, le compartiment du multi-onglet (ou l’un de ses fils) doit être associé à une table contenant l’axe de multi-onglet. Cet axe de multi-onglet ne doit pas contenir de données NULL.

• Vérifiez le typage des champs qui sont utilisés dans les jointures : axe de liaison avec le carnet d’adresse, axes de diffusion. Ces champs doivent avoir des types compatibles (pour des critères d’égalité) entre les deux tables.

• Vérifiez que les clés des motifs sont respectées dans les données approvisionnant ces motifs.

• Si un timeout apparaît lors de l’exécution des phrases SQL par GTServer, vous pouvez modifier la valeur du timeout pour l’attente d’exécution en client-serveur des commandes SQL. Inscrivez une valeur en secondes dans la base de registre sur le serveur GT Server dans la clé HKLM\SOFTWARE\Calame\GTServer\CommandTimeout (par défaut, cette valeur est à 600 secondes soit 10 minutes). Il est néanmoins toujours préférable de procéder au préalable à des optimisations en ajoutant des index sur les tables , en construisant des vues indexées, des précalculs dans des tables etc, ou en limitant la volumétrie des données.

L’action de lancement s’exécute mais le document ne contient pas les données attendues

• Exécutez l’action en mode diagnostic

• Exécutez l’action en prévisualisant les données, puis sans fermer la boîte de prévisualisation, allez consulter les fichiers de données produits (.csv) dans le sous-répertoire le plus récent du répertoire temporaire de GT (ce répertoire peut être partagé en lecture seule sur le serveur). Tous les fichiers temporaires ouverts à des fins de diagnostics doivent être fermés après examen et ne doivent pas être modifiés.

• Enlevez toutes les associations de tables/vues à des compartiments sauf le compartiment dont les données sont incorrectes. Exécutez l’action modifiée. Parmi les tables/vues précédemment enlevées, ajoutez seulement les tables/vues associées aux compartiments parents du compartiment aux données incorrectes puis ré exécutez l’action modifiée.

• Si vous avez un souci d’approvisionnement d’une transposition, vérifiez les fichiers temporaires produits en prévisualisation (voir plus haut). Supprimez tous les champs de la table/vue qui ne sont ni des champs des compartiments parents de la transposition ni des champs déclarés dans la définition de la transposition. Cette dernière préconisation exclue le cas où une transposition dans un motif absorbe tous les champs d’un motif : dans ce cas, la table/vue doit doubler tous les champs clés du motif, utiliser éventuellement des champs des compartiments parents et exclure les autres champs (cf Motif et transposition).

• Des interactions entre compartiments peuvent avoir lieu. Les lignes d’un motif ou les onglets d’un multi-onglet sont déterminés par une seule des tables/vues dans le motif ou le multi-onglet : c’est en règle générale la table à la racine du compartiment ou, si celle-ci est absente, la première table associée à un compartiment-fis dans l’ordre alphabétique des compartiments (cf Assemblage des données).

• Les champs du noyau ont priorité sur les autres champ : si un champ est présent dans le carnet d’adresse ou la relation d’affectation, seules les valeurs de ce champ seront prises en compte, tout champ portant le même nom et appartenant à une table/vue associée à un compartiment du qst sera simplement ignoré (cf Assemblage des données).

• Dans le cas d’un motif avec une transposition, vérifiez que vous n’êtes pas dans les cas d’utilisations incorrectes décrits par l’article Motif et transposition

• Si des problèmes de performance se posent, essayez d’exécuter un SELECT dans le SGBD sur chacune des tables/vues. Si le SELECT dans le SGBD pose des problèmes de performance, l’accès à ces mêmes données par GTServer risque d’en poser également. Si le SELECT ne pose pas de problèmes de performance, configurez l’instance pour visualiser les phrases SQL envoyées et testez les phrases SQL envoyées et adaptées pour l’entité concernée.

{:}{:en}

Principle

A  » Rendering launch  » action allows the publication of dashboards derived from a template when it is executed. The tool does not distinguish between templates dedicated to collection and those dedicated to rendering. The action for launching a rendition is similar to the one dedicated to launching a collection, but it does not propose the parameters related to the reception of responses. Moreover, on the publications page, the reports are displayed differently.

If the output (identified by a template and a Statement date) does not exist, it will be created. Otherwise, new documents will be published for this publication.

Diffusion

The diffusion settings particularly determine the destination entities and the correspondents affected.

• Address Book: Table/view providing the list of potential recipients of questionnaires. Technically, only one field containing the email address of the recipients is required. Other identifying fields may be useful to enrich the kernel.
  • Email axis: the address book field containing the email addresses of the correspondents.
• Assignment relationship: Table/view defining the assignment relationship.
  • Linking axis: field of the assignment relationship that allows the joining with the address book.
• Diffusion axis: Select, among the fields present in the assignment relationship, those defining the diffusion axis. Each unique combination of items of the diffusion axes will constitute an entity (see also the list of Axis Types).
• File name: Name of the published file. By default, the name is that of the template, but you can customise it with system variables, kernel fields and document root compartment fields.
• Statement date table : Table/view containing the Statement date to be used for this campaign.
  • Source column: Table/view field containing the value to be used as the Statement date. This field must be a date field. If the table/view contains several records, only the first one is taken into account.
• Blocking customisation errors. If this box is checked, any error in the data feed to the campaign will block the launch of the campaign.

Data

This sheet allows you to specify the data feed of the document. At least one compartment and one field of the form must be fed with data.

For each compartment you can specify a feed table/view and a sort.

In this example, the root compartment is fed by the « HR_DEMOS_Sites_Flags » view. Only 2 of the 3 fields in the view are used. On the other hand, for the « Newcomers » compartment, all (15/15) fields of the « HR_DEMO_Newcomers » table are used. The icon on a yellow background indicates a sorting of the data.

Template messages

This sheet lists the template messages from which the return is derived. You can modify them and it is generally preferable to edit the messages from this window rather than when editing the template. This is because you can have the variables from the kernel as well as the root compartment available here.

System variables can also be used

Publication

• HTTP check: If this box is checked, the document will connect to the GTServer web server to verify :
  • That the campaign is still active (not closed or deleted)
  • That the questionnaire has not been closed for the entity to which it is attached
  • That a new version of the questionnaire has not been sent.

If the HTTP check could not be performed (e.g. if it is not possible to access the GTWeb url), the questionnaire cannot be opened.

• HTTP diffusion: If this box is checked, the PUBLISH_URL variable is resolved and no attachment is added to the mail. Otherwise, the variable is not resolved and the form is delivered as an attachment.

The link substituted by the variable PUBLISH_URL always points to the last version of the questionnaire sent for the email address and the items of the diffusion axis: if a questionnaire has been sent again for this entity, the correspondent will load the last version of the questionnaire if the questionnaire has been sent for the same email address.

• Descending synchronization of inert patterns : Allows Synchronisation from GTAnswer. The developer can choose whether the list of patterns to be synchronised is defined by the current launch action or by another launch action (which can only be used for synchronisation if required).

The developer can ask for a synchronisation to be performed when the questionnaire is opened in GTAnswer and impose that a synchronisation is performed before the transmission of the response (in the latter case, the transmission of the response cannot take place if the prior synchronisation has failed).

In case of runtime errors

This paragraph summarises certain tests to be carried out to ensure that the launch action is working properly.

It only concerns problems with the data feeding the document.

In all cases, as for all types of actions (launch, integration, rendering), the action can be copied (right click then « Duplicate action ») to be able to carry out modifications on the copy (in general to simplify the action) so as to locate the causes of dysfunction more easily .

See the details of the error messages displayed.

Launch action does not execute

• If there have been any changes to the field, etc. since the last time the launch action was modified. Edit a copy of the launch action and check that you can commit a small change to the action.
• If there is an error during transposition, consulting the temporary files may help to diagnose this error. See the corresponding point in the next paragraph.
• If the mails are not sent because of problems with the connection between GTServer and the DBMS or between GTServer and the mail server, see the connections paragraph in the Errors article.
• Check that each of the tables/views pointed to by the launch action is operational in the DBMS (running a SELECT on each table should not return an error but may not return any data).
• If a multi-tab is used, the multi-tab compartment (or one of its sub-tabs) must be associated with a table containing the multi-tab axis. This multi-tab axis must not have NULL data.
• Check the typing of the fields that are used in the joins: axis for linking with the address book, diffusion axis. These fields must have compatible types (for equality criteria) between the two tables.
• Check that the pattern keys are respected in the data supplying these patterns.
• If a timeout occurs when GTServer is processing SQL sentences, you can change the timeout value for waiting for client-server execution of SQL commands. Enter a value in seconds in the registry on the GT Server in the HKLMSOFTWARECalameGTServerCommandTimeout key (by default, this value is 600 seconds or 10 minutes). However, it is always preferable to optimise beforehand by adding indexes to tables, building indexed views, pre-calculations in tables, etc., or by limiting the data volume.

The launch action is executed, but the document does not contain the expected data

• Run the action in diagnostic mode
• Run the action while previewing the data, then without closing the preview box, go to the most recent subdirectory of the GT temporary directory (this directory can be shared in read-only mode on the server) to view the data files produced (.csv). All temporary files opened for diagnostic purposes should be closed after review and should not be modified.
• Remove all table/view associations to compartments except the compartment with incorrect data. Perform the modified action. Of the previously removed tables/views, add only those tables/views associated with the parent compartments of the compartment with incorrect data and then re-perform the modified action.
• If you have a concern about provisioning a transposition, check the temporary files produced in preview (see above). Delete any fields in the table/view that are neither fields in the transposition’s parent compartments nor fields declared in the transposition definition. This last recommendation excludes the case where a transposition in a pattern absorbs all the fields of a pattern: in this case, the table/view must double all the key fields of the pattern, use fields from the parent compartments if necessary, and exclude the other fields (see Pattern and transposition).
• Interactions between compartments can occur. The rows of a pattern or the sheets of a multi-tab are determined by only one of the tables/views in the pattern or multi-tab: this is generally the table at the root of the compartment or, if this is absent, the first table associated with a compartment in the alphabetical order of the compartments (see Data assembly).
• The kernel fields have priority over the other fields: if a field is present in the address book or the assignment relationship, only the values of this field will be taken into account, any field with the same name and belonging to a table/view associated with a compartment of the qst will simply be ignored (see Data assembly).
• In case you have a pattern with a transposition, check that the incorrect use cases described in the Pattern and Transposition article are not present
• If you have performance problems, try running a DBMS SELECT on each of the tables/views. If the DBMS SELECT is causing performance problems, accessing the same data through GTServer may also cause performance problems. If the SELECT is not causing performance problems, configure the instance to view the SQL sentences sent and test the SQL sentences sent and adapted for the entity in question.

{:}