Help Center
Training
Knowledge Base
Community
Developers
Support

Création d'une tâche de chargement des données à l'aide de Workbench 4

Domo University
  • Mise à jour
S’abonner

Affichage du résumé de la page

Introduction

Pour charger des données dans Domo à partir de sources externes, vous devez d'abord spécifier les informations de connexion et de données sous la forme d'une tâche, que vous pouvez ensuite enregistrer, puis réutiliser.

Dans Workbench 4, la procédure de création d'une tâche de DataSet est la suivante :

  1. Définissez les paramètres de base de la tâche dans l'Assistant Workbench de création de tâche de DataSet, notamment le serveur Domo, le nom et le type de tâche de DataSet, la méthode de transport des données (par exemple, le Fournisseur de fichiers local, Fournisseur de connexion ODBC, etc.) et le type de lecteur des données (source des données) (par exemple, JIRA, Excel, etc.). Une entrée est alors ajoutée pour la tâche de DataSet dans votre volet Comptes. À ce stade toutefois, la tâche de DataSet n'est pas encore prête pour l'exécution.

  2. Spécifiez d'abord les informations de connexion de la tâche de DataSet pour la source de données dans les paramètres Méthode de transport.

  3. Pour définir les autres paramètres de la source de données de la tâche de DataSet, utilisez les paramètres Source de données. Ces paramètres dépendent du type de source de données. Certains, par exemple les variables de remplacement destinées aux requêtes, sont facultatifs, mais d'autres sont obligatoires.

  4. Au besoin, configurez les diverses options de la tâche, par exemple les transformations, les notifications, les colonnes exclues, etc.      

Pour obtenir plus d'informations sur les commandes et les paramètres des champs de Workbench, consultez la rubrique Présentation de l'interface utilisateur de Workbench 4.

Vidéos de formation - Chargement de fichiers à l'aide de Workbench 4

Apprenez à charger des fichiers CSV et Excel avec Workbench 4.

Partie 1 sur 4

Partie 2 sur 4

Partie 3 sur 4

 

Partie 4 sur 4

Remarques :

  • Les vidéos de formation sur les produits sont exclusivement réservées aux clients Domo.
  • En cas de problèmes pour accéder ou consulter les vidéos de formation, contactez le support technique Domo. 

Les vidéos de formation requièrent Adobe Flash Player.

Connexion aux données Excel 

Vous pouvez créer une tâche de DataSet Excel dans Workbench 4. Lorsque vous sélectionnez le type de source de données Excel, vous pouvez définir l'emplacement de la feuille Excel à connecter et configurer la plage de cellules de données souhaitée.

Pour créer une tâche de DataSet Excel dans Workbench 4,

  1. Cliquez sur Ajouter une nouvelle dans le regroupement Tâches de DataSet de la barre d'outils Boutons située en haut de la fenêtre Workbench. L'Assistant Workbench de création de tâche de DataSet s'affiche.

  2. (Conditionnel) Si vous y êtes invité, sélectionnez le serveur Domo désiré. (Cet écran s'affiche uniquement lorsque plusieurs serveurs ont été configurés dans Workbench.)

  3. Entrez le nom de la tâche dans le champ Nom de la tâche de DataSet. Il s'agit-là du nom de la tâche tel qu'affiché dans Workbench, pas du nom du DataSet chargé dans Domo.

  4. Entrez le nom DataSet dans le champ Nom du DataSet. Ce nom est celui du DataSet chargé dans Domo.

  5. Dans le champ Type de DataSet, sélectionnez un type de DataSet dans le menu déroulant ou entrez un nom personnalisé.
    Le type de DataSet sélectionné ou saisi ici apparaît ensuite en tant que type de connecteur dans Domo après exécution de la tâche.

    Conseil : il est préférable de sélectionner ou d'entrer un type de DataSet désignant clairement à l'utilisateur les données représentées, pas le lecteur de données utilisé pour présenter les données. Par exemple, si vous connectez une feuille Excel qui contient des données Twitter, il vaut mieux entrer « Twitter » que sélectionner Excel, car les données représentées dans Domo proviennent de Twitter, pas d'Excel.       

  6. Sélectionnez la méthode de mise à jour souhaitée dans le menu Méthode de mise à jour :

    • Pour remplacer le DataSet dans son intégralité lors de la mise à jour en cours, sélectionnez Remplacer le DataSet.

    • Si vous préférez ajouter les nouvelles données aux données existantes lors de la mise à jour, sélectionnez Ajouter au DataSet.

      Remarque : une fois les paramètres configurés dans l'Assistant, vous pouvez modifier les paramètres saisis aux étapes précédentes dans le panneau Source de la tâche de DataSet.

  7. Cliquez sur Suivant.

  8. Dans le menu Méthode de transport, sélectionnez Fournisseur de fichier local ou Fournisseur de fichier de processus externe.

    Ces méthodes de transport sont décrites ci-après :

    Méthode de transport

    Description

    Fournisseur de fichier local

    Permet de sélectionner un fichier sur votre ordinateur ou sur le réseau.

    Fournisseur de fichier de processus externe 

    Permet de sélectionner une application tierce récupérant les données dans Domo à l'aide d'un script. 

    De même, le Fournisseur de fichier SFTP, vous permet de récupérer un fichier via FTP, SFTP (SSH-FTP) ou FTPS (FTP-SSL)

    Vous ne pouvez plus modifier la méthode de transport après avoir terminé la procédure dans l'Assistant.  

  9. Cliquez sur Suivant.

  10. Dans le menu Source de données, sélectionnez Excel.

  11. Cliquez sur Suivant.

  12. Cliquez sur Suivant.
    Une nouvelle tâche de DataSet Excel est ajoutée dans la liste des tâches associées au serveur actuellement authentifié dans le volet Comptes.

  13. Sous la tâche de DataSet Excel qui vient de s'ajouter à la liste, sélectionnez Source. 
    Les options du panneau qui s'affiche vous permettent de configurer le transport de fichier et les paramètres de votre source de données Excel.

  14. (Conditionnel) Choisissez l'une des procédures suivantes :

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier local...

      1. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès.

      2. Sélectionnez le fichier Excel désiré sur votre ordinateur ou sur le réseau.

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier de processus externe...

      1. Cliquez sur les points de suspension (...) dans le champ Programme exécutable.

      2. Sélectionnez le fichier exécutable désiré sur votre ordinateur ou sur le réseau.

      3. (Facultatif) Entrez au besoin des arguments dans le champ Arguments.

      4. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès du résultat.

      5. Sélectionnez le chemin d'accès du résultat désiré sur votre ordinateur ou sur le réseau.
        Le type de fichier du chemin de résultat doit être Excel.

  15.  Cliquez sur Appliquer les modifications.

  16. Sélectionnez le type de plage requis dans le menu Plage de sélection.
    Les différents types de plage sont décrits dans le tableau suivant :

    Type de plage

    Description

    Plage de cellules 

    Permet de spécifier la feuille Excel dans laquelle les données doivent être récupérées, de même que la cellule de départ, la ligne de fin et la colonne de fin.

    Plage nommée 

    Permet de sélectionner une plage nommée dans une liste. Si vous n'avez pas encore créé de plage nommée pour ce fichier dans Excel, ce menu ne contient pas d'option. 

    Plage dynamique 

    Permet d'ignorer le nombre de lignes spécifié à la fin de la feuille Excel.  

  17. Choisissez l'une des procédures suivantes :

    • Si vous avez sélectionné le type Plage de cellules...

      1. Sélectionnez la feuille à connecter dans le menu Nom de feuille.

      2. Dans Cellule de début, spécifiez la première cellule de la plage dans laquelle récupérer les données.

      3. (Conditionnel) Pour que Workbench récupère les données de votre feuille jusqu'à ce qu'il rencontre une ligne et/ou une colonne vide, ne désactivez pas les cases à cocher Continuer jusqu'à ligne vide et/ou Continuer jusqu'à colonne vide. Sinon, désactivez les cases à cocher et définissez la ligne et la colonne de fin dans les champs Ligne de fin et Colonne de fin, respectivement. 

  18. Si la première ligne de votre plage de cellules contient des en-têtes de colonne, ne désactivez pas la case à cocher ; sinon, désactivez cette option.
    Ce point est important lors de la création des cartes dans Domo, car les en-têtes de colonne servent à référencer les données de ces colonnes. Pour obtenir plus d'informations, consultez la rubrique Application de colonnes de DataSet dans votre graphique.

Vous êtes maintenant prêt à exécuter la tâche de DataSet via la création d'un DataSet Excel dans Domo. Vous pouvez toutefois exécuter de nombreuses autres opérations sur la tache de DataSet avant de l'envoyer dans Domo. Ces opérations sont notamment les suivantes :

Connexion aux données CSV

Vous pouvez créer une tâche de DataSet CSV dans Workbench 4. Lorsque vous sélectionnez le type de source de données CSV, vous pouvez définir le chemin d'accès à la source des données CSV et configurer des options comme les séparateurs, le mode de gestion des champs manquants, etc.

Remarque : le fichier CSV doit

  • être un fichier texte ;
  • contenir des données séparées par un seul caractère. Vous pouvez spécifier ce séparateur dans les Paramètres avancés.

Exemple de fichier CSV

Vendeur(euse),ID,Ventes de mars,Quota atteint ?
"MacGregor, Sam",1156724,"$10,909",Y
"Orton, Jason",1156738,"$6,008",N
"Butler, Heidi",1156742,"$4,321",N
"Hope, Frank",1156749,"$13,888",Y
"Perez, Katrina",1156768,"$11,472",Y
"Wood, Howard",1156777,"$7,446",N
"Yager, Dorothy",1156787,"$3,825",N
"Jeepers, Adam",1156796,"$9,942",Y
"Pendlesmythe, Ellen",1156803,"$14,578",Y
"Ferrera, Luigi",1156809,"$11,239",Y
"Coulsey, Mason",1156819,"$5,213",N
"Michelsen, Bruce",1212121,"$20,250",Y

Pour créer une tâche de DataSet CSV dans Workbench 4,

  1. Cliquez sur Ajouter une nouvelle dans le regroupement Tâches de DataSet de la barre d'outils Boutons située en haut de la fenêtre Workbench. L'Assistant Workbench de création de tâche de DataSet s'affiche.

  2. (Conditionnel) Si vous y êtes invité, sélectionnez le serveur Domo désiré. (Cet écran s'affiche uniquement lorsque plusieurs serveurs ont été configurés dans Workbench.)

  3. Entrez le nom de la tâche dans le champ Nom de la tâche de DataSet. Il s'agit-là du nom de la tâche tel qu'affiché dans Workbench, pas du nom du DataSet chargé dans Domo.

  4. Entrez le nom du DataSet dans le champ Nom du DataSet. Ce nom est celui du DataSet chargé dans Domo.

  5. Dans le champ Type de DataSet, sélectionnez un type de DataSet dans le menu déroulant ou entrez un nom personnalisé.
    Le type de DataSet sélectionné ou entré ici apparaît ensuite en tant que type de connecteur dans Domo après exécution de la tâche.

    Conseil : il est préférable de sélectionner ou d'entrer un type de DataSet désignant clairement à l'utilisateur les données représentées, pas le lecteur de données utilisé pour présenter les données. Par exemple, si vous connectez une feuille CSV qui contient des données Twitter, il vaut mieux entrer « Twitter » que sélectionner CSV, car les données représentées dans Domo proviennent de Twitter.

  6. Sélectionnez la méthode de mise à jour souhaitée dans le menu Méthode de mise à jour :

    • Pour remplacer le DataSet dans son intégralité lors de la mise à jour, sélectionnez Remplacer le DataSet.

    • Si vous préférez ajouter les nouvelles données aux données existantes lors de la mise à jour, sélectionnez Ajouter au DataSet.

      Remarque : une fois les paramètres configurés dans l'Assistant, vous pouvez modifier les paramètres saisis aux étapes précédentes dans le panneau Source de la tâche de DataSet.

  7. Cliquez sur Suivant.

  8. Dans le menu Méthode de transport, sélectionnez Fournisseur de fichier local ou Fournisseur de fichier de processus externe. Ces méthodes de transport sont décrites ci-après :

    Méthode de transport

    Description

    Fournisseur de fichier local

    Permet de sélectionner un fichier sur votre ordinateur ou sur le réseau.

    Fournisseur de fichier de processus externe 

    Permet de sélectionner une application tierce récupérant les données dans Domo à l'aide d'un script. 

    Vous ne pouvez plus modifier la méthode de transport après avoir terminé la procédure dans l'Assistant.  

  9. Cliquez sur Suivant.

  10. Dans le menu Source de données, sélectionnez CSV.

  11. Cliquez sur Suivant.

  12. Cliquez sur Suivant.
    Une nouvelle tâche de DataSet CSV est ajoutée dans la liste des tâches associées au serveur actuellement authentifié dans le volet Comptes.

  13. Sous la tâche de DataSet CSV qui vient de s'ajouter à la liste, sélectionnez Source. 
    Les options du panneau qui s'affiche vous permettent de configurer le transport de fichier et les paramètres de votre source de données CSV.

  14. (Conditionnel) Choisissez l'une des procédures suivantes :

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier local...

      1. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès.

      2. Sélectionnez le fichier CSV désiré sur votre ordinateur ou sur le réseau.

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier de processus externe...

      1. Cliquez sur les points de suspension (...) dans le champ Programme exécutable.

      2. Sélectionnez le fichier exécutable désiré sur votre ordinateur ou sur le réseau.

      3. (Facultatif) Entrez, le cas échéant, des arguments dans le champ Arguments.

      4. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès du résultat.

      5. Sélectionnez le chemin d'accès du résultat désiré sur votre ordinateur ou sur le réseau.
        Le type de fichier du chemin de résultat doit être CSV.

  15. Cliquez sur Appliquer les modifications.

  16. Dans le menu Séparateurs de champs, activez le bouton radio du séparateur utilisé dans votre fichier CSV. Pour définir un séparateur personnalisé, cliquez sur le bouton radio Autre, puis entrez le séparateur souhaité dans le champ.

  17. Dans le champ Encapsuler les champs avec, spécifiez le caractère à utiliser pour encapsuler les champs.

  18. Dans le champ Caractère de séquence d'échappement, définissez le caractère à utiliser pour l'échappement.

  19. Dans la section Gestion des champs manquants, activez le bouton radio du comportement souhaité lorsque Workbench rencontre des champs manquants dans votre fichier CSV.

    Option

    Description

    Générer une erreur

    Workbench renvoie une erreur en présence de champs manquants dans le fichier CSV.

    Remplacer par des valeurs vides 

    Les champs manquants dans votre fichier CSV sont remplacés par des valeurs vides dans votre DataSet Domo.  

  20. Si la première ligne de votre plage de cellules contient des en-têtes de colonne, ne désactivez pas la case à cocher ; sinon, désactivez cette option. Ce point est important lors de la création des cartes dans Domo, car les en-têtes de colonne servent à référencer les données de ces colonnes. Pour obtenir plus d'informations, consultez la rubrique Application de colonnes de DataSet dans votre graphique.  

  21. Pour que Workbench ignore les lignes vides du fichier CSV lorsqu'il envoie les données à Domo, cochez la case Expurger les données avant le traitement ; sinon, n'activez pas cette option.

  22. (Facultatif) Dans le champ Ignorer les lignes de début, spécifiez le nombre de lignes à ignorer au début des données de sorte que l'importation ne commence qu'à partir d'une certaine ligne.
    Cela n'inclut pas la ligne d'en-tête qui contient les noms de colonnes.

  23. (Facultatif) Dans le champ Ignorer les lignes de fin, spécifiez le nombre de lignes à ignorer à la fin des données.

  24. Dans le menu Codage de texte, sélectionnez le codage de caractères utilisé dans le fichier CSV. 

Vous êtes maintenant prêt à exécuter la tâche de DataSet via la création d'un DataSet CSV dans Domo. Vous pouvez toutefois exécuter de nombreuses autres opérations sur la tache de DataSet avant de l'envoyer dans Domo. Ces opérations sont notamment les suivantes :

Connexion aux données JIRA

Vous pouvez créer une tâche de DataSet JIRA dans Workbench 4. Lorsque vous sélectionnez le type de DataSet JIRA, vous pouvez entrer vos identifiants de connexion JIRA et une requête JQL pour récupérer les données JIRA dans Workbench.

Pour créer une tâche de DataSet JIRA dans Workbench 4,

  1. Cliquez sur Ajouter une nouvelle dans le regroupement Tâches de DataSet de la barre d'outils Boutons située en haut de la fenêtre Workbench.
    L'Assistant Workbench de création de tâche de DataSet s'affiche.

  2. (Conditionnel) Si vous y êtes invité, sélectionnez le serveur Domo désiré. (Cet écran s'affiche uniquement lorsque plusieurs serveurs ont été configurés dans Workbench.)

  3. Entrez le nom de la tâche dans le champ Nom de la tâche de DataSet.
    Il s'agit-là du nom de la tâche tel qu'affiché dans Workbench, pas du nom du DataSet chargé dans Domo.

  4. Entrez le nom du DataSet dans le champ Nom du DataSet.
    Ce nom est celui du DataSet chargé dans Domo.

  5. Dans le champ Type de DataSet, sélectionnez un type de DataSet dans le menu déroulant ou entrez un nom personnalisé.
    Dans le cas d'une connexion JIRA, il est recommandé (mais pas obligatoire) de sélectionner JIRA dans le menu déroulant.

    Conseil : il est préférable de sélectionner ou d'entrer un type de DataSet désignant clairement à l'utilisateur les données représentées, pas le lecteur de données utilisé pour présenter les données. Par exemple, si vous connectez une base de données ODBC qui contient des données Twitter, il vaut mieux entrer « Twitter » que sélectionner ODBC, car les données représentées dans Domo proviennent de Twitter.

  6. Sélectionnez la méthode de mise à jour souhaitée dans le menu Méthode de mise à jour :

    • Pour remplacer le DataSet dans son intégralité lors de la mise à jour, sélectionnez Remplacer le DataSet.

    • Si vous préférez ajouter les nouvelles données aux données existantes lors de la mise à jour en cours, sélectionnez Ajouter au DataSet.

      Remarque : une fois les paramètres configurés dans l'Assistant, vous pouvez modifier les paramètres entrés aux étapes précédentes dans le panneau Source de la tâche de DataSet.

  7. Cliquez sur Suivant.

  8. Dans le menu Méthode de transport, sélectionnez Connexion JIRA.

  9. Cliquez sur Suivant.

  10. Dans le menu Source de données, sélectionnez JIRA.

  11. Cliquez sur Suivant.

  12. Cliquez sur Suivant.
    Une nouvelle tâche de DataSet JIRA est ajoutée dans la liste des tâches associées au serveur actuellement authentifié dans le volet Comptes.

  13. Sous la tâche de DataSet JIRA qui vient de s'ajouter à la liste, sélectionnez Source.
    Les options du panneau qui s'affiche vous permettent d'établir la connexion à votre source de données JIRA.

  14. Cliquez sur le bouton + situé à droite de « Connexion JIRA ».

  15. Dans les champs appropriés, entrez le nom d'utilisateur et le mot de passe qui vous permettent de vous connecter à l'instance JIRA de votre société.

    Remarque : si vous tentez d'exécuter une tâche JIRA à l'aide d'identifiants de connexion incorrects, le compte JIRA se verrouille. Dans ce cas, la simple entrée des identifiants de connexion appropriés ne permet pas de corriger le problème. Il vous faut alors vous connecter manuellement à JIRA et transmettre une validation CAPTCHA.

  16. Dans le champ URL du serveur, entrez l'adresse URL du serveur JIRA de votre société.

  17. Dans le champ Requête JIRA, entrez la requête permettant de récupérer les données JIRA dans votre DataSet.

    Conseil : vous pouvez créer une requête JQL dans Jira, la copier, puis la coller dans Workbench.

    Exemple de requête JQL

    project not in (ARCHIVE, CPD, DC, DCV, DP, QA, ODD) AND issuetype in (Epic) AND fixVersion in (2015-02-17) ORDER BY status DESC, resolved DESC, issuetype DESC, key ASC

    Cliquez sur Appliquer les modifications.
    Si vos identifiants de connexion et votre requête sont valides, la liste des attributs de votre source de données JIRA s'affiche dans le panneau Propriétés de la source de données.

  18. (Facultatif) Pour ajouter d'autres attributs à la liste, entrez-les dans le champ Ajouter l'attribut inclus.

  19. (Facultatif) Pour retirer certains attributs de la liste, désactivez leur case à cocher, puis cliquez sur Oui pour confirmer l'opération.

Vous êtes maintenant prêt à exécuter la tâche de DataSet via la création d'un DataSet JIRA dans Domo. Vous pouvez toutefois exécuter de nombreuses autres opérations sur la tache de DataSet avant de l'envoyer dans Domo. Ces opérations sont notamment les suivantes :

Connexion aux données ODBC

Vous pouvez créer une tâche de DataSet ODBC dans Workbench 4. Lorsque vous sélectionnez le type de source de données ODBC, vous pouvez définir les divers détails de votre connexion et configurer votre requête.

Remarque : lors de son exécution, Workbench 4 détermine automatiquement si vous utilisez une version 32 ou 64 bits de Windows ; il ne vous est donc pas demandé de spécifier une version. 

Pour créer une tâche de DataSet ODBC dans Workbench 4 :

  1. Cliquez sur Ajouter une nouvelle dans le regroupement Tâches de DataSet de la barre d'outils Boutons située en haut de la fenêtre Workbench.
    L'Assistant Workbench de création de tâche de DataSet s'affiche.

  2. (Conditionnel) Si vous y êtes invité, sélectionnez le serveur Domo désiré. (Cet écran s'affiche uniquement lorsque plusieurs serveurs ont été configurés dans Workbench.)

  3. Entrez le nom de la tâche dans le champ Nom de la tâche de DataSet. Il s'agit-là du nom de la tâche tel qu'affiché dans Workbench, pas du nom du DataSet chargé dans Domo.

  4. Entrez le nom du DataSet dans le champ Nom du DataSet. Ce nom est celui du DataSet chargé dans Domo.

  5. Dans le champ Type de DataSet, sélectionnez un type de DataSet dans le menu déroulant ou entrez un nom personnalisé.
    Le type de DataSet sélectionné ou entré ici apparaît ensuite en tant que type de connecteur dans Domo après exécution de la tâche.

    Conseil : il est préférable de sélectionner ou d'entrer un type de DataSet désignant clairement à l'utilisateur les données représentées, pas le lecteur de données utilisé pour présenter les données. Par exemple, si vous connectez une base de données ODBC qui contient des données Twitter, il vaut mieux entrer « Twitter » que sélectionner ODBC, car les données représentées dans Domo proviennent de Twitter.

  6. Sélectionnez la méthode de mise à jour souhaitée dans le menu Méthode de mise à jour :

    • Pour remplacer le DataSet dans son intégralité lors de la mise à jour en cours, sélectionnez Remplacer le DataSet.

    • Si vous préférez ajouter les nouvelles données aux données existantes lors de la mise à jour en cours, sélectionnez Ajouter au DataSet.

      Remarque : une fois les paramètres configurés dans l'Assistant, vous pouvez modifier les paramètres entrés aux étapes précédentes dans le panneau Source de la tâche de DataSet.

  7. Cliquez sur Suivant.

  8. Dans le menu Méthode de transport, sélectionnez Fournisseur de connexion ODBC, puis cliquez sur Suivant.

  9. Dans le menu Source de données, sélectionnez Lecteur de connexion de base de données, puis cliquez sur Suivant.

  10. Cliquez sur Suivant.
    Une nouvelle tâche de DataSet ODBC est ajoutée dans la liste des tâches associées au serveur actuellement authentifié dans le volet Comptes.

  11. Sous la tâche de DataSet ODBC qui vient de s'ajouter à la liste, sélectionnez Source.
    Les options du panneau qui s'affiche vous permettent de configurer votre connexion ODBC et de définir votre requête.

  12. Dans le champ Type de connexion, sélectionnez une option de connexion.

    Le tableau suivant décrit les options disponibles :

    Option

    Description

    Nom DSN système

    Sélectionnez le DSN (nom de la source de données) à utiliser pour le DataSet souhaité parmi les DSN disponibles dans votre système. Vous pouvez indiquer si les identifiants de connexion sont requis.

    Remarques : 

    • Lorsque vous chargez des données à partir d'un DataSet ODBC, vous devez spécifier un nom de source de données (DSN) existant. Pour créer un DSN, vous pouvez utiliser l'Administrateur de sources de données ODBC de Windows. (Pour accéder à l'Administrateur de sources de données ODBC dans Windows, entrez « ODBC » dans la zone de recherche du menu Démarrer, puis sélectionnez « Sources de données (ODBC) ».) Pour plus d'informations sur la création d'un DSN, reportez-vous à l'aide de Windows sur ODBC (en recherchant « ODBC » dans l'Aide et l'Assistance de Windows) ou regardez la vidéo de formation disponible dans Workbench 4. Pour obtenir plus d'informations sur la configuration d'un pilote MySQL, consultez la rubrique Comment améliorer les performances d'un pilote MySQL ? 

    • Pour plus d'informations sur la définition des noms de DataSet (DSN) et l'utilisation de connexion ODBC (Open Database Connectivity) pour accéder aux données, reportez-vous à la documentation relative à ODBC.

    • Par défaut, la connexion ODBC utilise les paramètres définis dans le DSN. Cela signifie qu'il est possible d'envoyer des requêtes potentiellement nuisibles pour les bases de données via la connexion ODBC lors de l'aperçu et de l'exécution des tâches. Cela inclut les instructions comme modifier, supprimer, créer un tableau, insérer dans, etc. Pour que Workbench ne puisse pas exécuter de telles commandes, vous devez effectuer les modifications nécessaires dans le DSN.

    Connexion Builder

    Entrez les informations relatives à votre connexion ODBC, par exemple, les identifiants de connexion, le pilote, l'URL du serveur, le nom de la base de données, le port, la valeur du délai d'expiration et les paramètres de connexion.  

    Chaîne de connexion

    Entrez une seule chaîne pour votre connexion.

  1. (Conditionnel) Choisissez l'une des procédures suivantes :

    • Si vous avez sélectionné le Type de connexion Nom DSN système...

      1. Dans le menu Nom DSN système, sélectionnez le DSN système souhaité parmi les DSN disponibles dans votre système.

      2. (Conditionnel) Si cette connexion DSN implique obligatoirement des identifiants de connexion, définissez l'option Informations de connexion requises sur « Activé », puis entrez votre nom d'utilisateur et votre mot de passe dans les champs appropriés. Si ce n'est pas le cas, définissez l'option Informations de connexion requises sur « Désactivé ».

    • Si vous avez sélectionné le Type de connexion Connexion Builder...

      1. Entrez les informations appropriées dans les champs.
        Selon votre connexion, certains paramètres sont obligatoires.
        Vous pouvez utiliser le tableau suivant en référence :

        Champ

        Description

        Pilote

        Spécifiez le nom du pilote utilisé pour accéder à la base de données.

        Serveur 

        Spécifiez le nom du serveur ou l'URL de la base de données. 

        Base de données 

        Spécifiez le nom de la base de données à laquelle vous souhaitez accéder. 

        Port 

        Entrez le numéro de port correspondant à la base de données. Le port par défaut est le port MySQL. 

        Délai d'expiration

        Entrez la valeur du délai d'expiration souhaité (en secondes), c'est-à-dire le délai pendant lequel la connexion au DataSet doit être maintenue avant d'être actualisée. 

        Nom d'utilisateur 

        Spécifiez le nom d'utilisateur permettant de se connecter à la base de données. 

        Mot de passe 

        Spécifiez le mot de passe à utiliser pour accéder à la base de données. 

        Paramètres de connexion 

        Spécifiez les paramètres de connexion au DataSet. 

    • Si vous avez sélectionné le Type de connexion Chaîne de connexion...

      1. Entrez la chaîne de connexion permettant de se connecter à la source de données.   

  2. Cliquez sur Appliquer les modifications.

  3. Entrez la requête correspondant aux données à récupérer dans le volet Propriétés de la source de données. Par exemple :

    SELECTIONNER
    order_audit_id,
    user_name,
    customer_name,
    order_source,
    order_total,
    créés
    DE order_audit

  4. (Facultatif) Définissez les variables de remplacement des colonnes du DataSet dans l'onglet Variables de remplacement. Pour chaque variable de remplacement...

    1. Sélectionnez la colonne applicable dans la liste déroulante Colonne.

      Remarque : le menu déroulant Colonne n'est rempli qu'à partir du moment où une connexion ODBC a bien été créée dans le volet Méthode de transport.

    2. Définissez les variables de remplacement de la colonne sélectionnée dans le menu déroulant Valeur.

      Type de variable

      Description

      lastvalue

      Les variables lastvalue gardent la trace des champs pertinents pour la dernière ligne de données transmise avec le dernier chargement de la tâche associée. La syntaxe est la suivante :

      !{lastvalue:_name_}!

      Les valeurs des variables lastvalue sont mises à jour par Workbench une fois le chargement terminé. Les variables lastvalue sont stockées dans le fichier de la tâche (.xml). Cette variable vous permet de construire une requête qui ne récupère que les « nouvelles » lignes à chaque exécution. Par exemple, si vos données comprennent une colonne pour laquelle un « id » de ligne est incrémenté pour chaque nouvelle ligne, vous pouvez construire une requête contenant

      !{lastvalue:id}!

      similaire à celle-ci :

      sélectionner id, nom, type, ventes de nomtable où l'id > !{lastvalue:id}! ordre par id

      Dans cet exemple, la colonne « id » doit être incluse dans les clauses SÉLECTIONNER, OÙ et COMMANDER POUR pour que la variable soit utilisée et mise à jour.

      Lors du chargement de cette tâche, Workbench remplace la variable

      !{lastvalue:id}!

      par la valeur réelle de « id ». À la fin du chargement, Workbench stocke la dernière valeur chargée pour « id » dans le fichier de la tâche (.xml).

      Remarque : vous devez inclure les colonnes référencées avec une variable lastvalue dans vos clauses SÉLECTIONNER, OÙ et COMMANDER POUR pour que la variable puisse être utilisée et mise à jour une fois les données chargées.

      previewonly

      Permet d'indiquer que certaines opérations doivent avoir lieu lorsqu'un aperçu est chargé dans Workbench. Par exemple, vous pouvez demander à votre aperçu d'afficher 100 lignes de données plutôt que les 1 000 000 lignes présentes dans la source de données. La syntaxe est la suivante :

      !{previewonly:Statement}!

Vous êtes maintenant prêt à exécuter la tâche de DataSet via la création d'un DataSet ODBC dans Domo. Vous pouvez toutefois exécuter de nombreuses autres opérations sur la tâche de DataSet avant de l'envoyer dans Domo. Ces opérations sont notamment les suivantes :

Connexion à un cube OLAP

Vous pouvez créer une tâche de DataSet OLAP dans Workbench 4. Lorsque vous sélectionnez le type de source de données OLAP, vous pouvez définir les divers détails de votre connexion et configurer votre requête.

Pour créer une tâche de DataSet OLAP dans Workbench 4 :

  1. Cliquez sur Ajouter une nouvelle dans le regroupement Tâches de DataSet de la barre d'outils Boutons située en haut de la fenêtre Workbench.
    L'Assistant Workbench de création de tâche de DataSet s'affiche.

  2. (Conditionnel) Si vous y êtes invité, sélectionnez le serveur Domo désiré. (Cet écran s'affiche uniquement lorsque plusieurs serveurs ont été configurés dans Workbench.) 

  3. Entrez le nom de la tâche de DataSet dans le champ Nom de la tâche de DataSet. Il s'agit-là du nom de la tâche tel qu'affiché dans Workbench, pas du nom du DataSet chargé dans Domo.

  4. Entrez le nom du DataSet dans le champ Nom du DataSet. Ce nom est celui du DataSet chargé dans Domo.

  5. Dans le champ Type de DataSet, sélectionnez un type de DataSet dans le menu déroulant ou entrez un nom personnalisé.
    Le type de DataSet sélectionné ou entré ici apparaît ensuite en tant que type de connecteur dans Domo après exécution de la tâche.

    Conseil : il est préférable de sélectionner ou d'entrer un type de DataSet désignant clairement à l'utilisateur les données représentées, pas le lecteur de données utilisé pour présenter les données. Par exemple, si vous connectez un cube OLAP qui contient des données Twitter, il vaut mieux entrer « Twitter » que sélectionner OLEDB, car les données représentées dans Domo proviennent de Twitter.

  6. Sélectionnez la méthode de mise à jour souhaitée dans le menu Méthode de mise à jour : 

    • Pour remplacer le DataSet dans son intégralité lors de la mise à jour en cours, sélectionnez Remplacer le DataSet.

    • Si vous préférez ajouter les nouvelles données aux données existantes lors de la mise à jour en cours, sélectionnez Ajouter au DataSet.

      Remarque : une fois les paramètres configurés dans l'Assistant, vous pouvez modifier les paramètres saisis aux étapes précédentes dans le panneau Source de la tâche de DataSet.

  7. Cliquez sur Suivant.

  8. Dans le menu Méthode de transport, sélectionnez Fournisseur de connexion OLEDB, puis cliquez sur Suivant.

  9. Dans le menu Source de données, sélectionnez Lecteur de connexion de base de données, puis cliquez sur Suivant.

  10. Cliquez sur Suivant.
    Une nouvelle tâche de DataSet OLAP est ajoutée dans la liste des tâches associées au serveur actuellement authentifié dans le volet Comptes.

  11. Sous la tâche de DataSet OLAP qui vient de s'ajouter à la liste, sélectionnez Source.
    Les options du panneau qui s'affiche vous permettent de configurer votre connexion OLAP et de définir votre requête.

  12. Dans champ Connexion OLAP, procédez de l'une des manières suivantes :

    • Entrez la chaîne de connexion OLAP contenant votre Fournisseur (MSOLAP ou Essbase), la Source de données, le Catalogue initial, l'ID de l'utilisateur et le Mot de passe.

    • Pour créer votre chaîne de connexion, remplissez les champs dans la Connexion Builder. Pour ouvrir la Connexion Builder, cliquez sur la flèche présente dans le champ Connexion OLAP.
      Le tableau suivant décrit tous les paramètres disponibles dans la Connexion Builder :

      Option

      Description

      Source de données 

      Définit le serveur sur lequel la base de données est stockée. 

      Fournisseur 

      Sélectionnez un fournisseur (MSOLAP ou Essbase). 

      Catalogue 

      Définit le Catalogue initial pour votre connexion OLAP. 

      Nom d'utilisateur 

      Définit le nom d'utilisateur pour cette connexion OLAP. 

      Mot de passe 

      Définit le mot de passe de cette connexion OLAP. 

  13. Cliquez sur Appliquer les modifications.

  14. Entrez la requête correspondant aux données à récupérer dans le volet Propriétés de la source de données. Par exemple :

    avec les membres [Mesures].[Réduction PCT] COMME '[Mesures].[Montant de réduction]/[Mesures].[Montant des ventes]', FORMAT_STRING = 'Pourcentage'
    défini Top10SellingProducts comme 'topcount([Produit].[Nom du modèle].enfants, 10, [Mesures].[Montant des ventes])'
    définis Preferred10Products comme '
    {[Produit].[Nom du modèle].&[Mountain-200],
    [Produit].[Nom du modèle].&[Road-250],
    [Produit].[Nom du modèle].&[Mountain-100],
    [Product].[Model Name].&[Road-650],
    [Produit].[Nom du modèle].&[Touring-1000],
    [Produit].[Nom du modèle].&[Road-550-W],
    [Produit].[Nom du modèle].&[Road-350-W],
    [Produit].[Nom du modèle].&[HL Mountain Frame],
    [Produit].[Nom du modèle].&[Road-150],
    [Produit].[Nom du modèle].&[Touring-3000]
    }'
    selectionné {[Mesures].[Montant des ventes], [Mesures].[Montant de réduction], [Mesures].[Réduction PCT]} sur 0,
    Preferred10Products sur 1
    de [Tutoriel de services d'analyses]

  15. (Facultatif) Définissez les variables de remplacement des colonnes du DataSet dans l'onglet Variables de remplacement. Pour chaque variable de remplacement...

    1. Sélectionnez la colonne applicable dans la liste déroulante Colonne.

      Remarque : le menu déroulant Colonne n'est rempli qu'à partir du moment où une connexion OLAP a bien été créée dans le volet Méthode de transport.

    2. Définissez les variables de remplacement de la colonne sélectionnée dans le menu déroulant Valeur.

      Type de variable

      Description

      lastvalue

      Les variables lastvalue gardent la trace des champs pertinents pour la dernière ligne de données transmise avec le dernier chargement de la tâche associée. La syntaxe est la suivante :

      !{lastvalue:_name_}!

      Les valeurs des variables lastvalue sont mises à jour par Workbench une fois le chargement terminé. Les variables lastvalue sont stockées dans le fichier de la tâche (.xml). Cette variable vous permet de construire une requête qui ne récupère que les « nouvelles » lignes à chaque exécution. Par exemple, si vos données comprennent une colonne pour laquelle un « id » de ligne est incrémenté pour chaque nouvelle ligne, vous pouvez construire une requête contenant

      !{lastvalue:id}!

      similaire à celle-ci :

      selectionner id, nom, type, ventes de nomtable où l'id > !{lastvalue:id}! la commande par id

      Dans cet exemple, la colonne « id » doit être incluse dans les clauses SÉLECTIONNER, OÙ et COMMANDER POUR pour que la variable soit utilisée et mise à jour.

      Lors du chargement de cette tâche, Workbench remplace la variable

      !{lastvalue:id}!

      par la valeur réelle de « id ». À la fin du chargement, Workbench stocke la dernière valeur chargée pour « id » dans le fichier de la tâche (.xml).

      Remarque : vous devez inclure les colonnes référencées avec une variable lastvalue dans vos clauses SÉLECTIONNER, OÙ et COMMANDER POUR pour que la variable puisse être utilisée et mise à jour une fois les données chargées.

      previewonly

      Permet d'indiquer que certaines opérations doivent avoir lieu lorsqu'un aperçu est chargé dans Workbench. Par exemple, vous pouvez demander à votre aperçu d'afficher 100 lignes de données plutôt que les 1 000 000 lignes présentes dans la source de données. La syntaxe est la suivante :

      !{previewonly:Statement}!

Vous êtes maintenant prêt à exécuter la tâche de DataSet via la création d'un DataSet OLAP dans Domo. Vous pouvez toutefois exécuter de nombreuses autres opérations sur la tâche de DataSet avant de l'envoyer dans Domo. Ces opérations sont notamment les suivantes :

Connexion aux données XML

Vous pouvez créer une tâche de DataSet XML dans Workbench 4. Lorsque vous sélectionnez le type de source de données XML, vous pouvez spécifier le nœud de données contenant les données à récupérer, de même que les nœuds à ignorer.

Pour créer une tâche de DataSet XML dans Workbench 4,

  1. Cliquez sur Ajouter une nouvelle dans le regroupement Tâches de DataSet de la barre d'outils Boutons située en haut de la fenêtre Workbench.
    L'Assistant Workbench de création de tâche de DataSet s'affiche.

  2. (Conditionnel) Si vous y êtes invité, sélectionnez le serveur Domo désiré. (Cet écran s'affiche uniquement lorsque plusieurs serveurs ont été configurés dans Workbench.)

  3. Entrez le nom de la tâche dans le champ Nom de la tâche de DataSet. Il s'agit-là du nom de la tâche tel qu'affiché dans Workbench, pas du nom du DataSet chargé dans Domo.

  4. Entrez le nom du DataSet dans le champ Nom du DataSet. Ce nom est celui du DataSet chargé dans Domo.

  5. Dans le champ Type de DataSet, sélectionnez un type de DataSet dans le menu déroulant ou entrez un nom personnalisé.

    Conseil : il est préférable de sélectionner ou d'entrer un type de DataSet désignant clairement à l'utilisateur les données représentées, pas le lecteur de données utilisé pour présenter les données. Par exemple, si vous connectez une feuille XML qui contient des données Twitter, il vaut mieux entrer « Twitter » que sélectionner XML, car les données représentées dans Domo proviennent de Twitter.

  6. Sélectionnez la méthode de mise à jour souhaitée dans le menu Méthode de mise à jour :

    • Pour remplacer le DataSet dans son intégralité lors de la mise à jour en cours, sélectionnez Remplacer le DataSet.

    • Si vous préférez ajouter les nouvelles données aux données existantes lors de la mise à jour en cours, sélectionnez Ajouter au DataSet.

      Remarque : une fois les paramètres configurés dans l'Assistant, vous pouvez modifier les paramètres entrés aux étapes précédentes dans le panneau Source de la tâche de DataSet.

  7. Cliquez sur Suivant.

  8. Dans le menu Méthode de transport, sélectionnez Fournisseur de fichier local ou Fournisseur de fichier de processus externe. Ces méthodes de transport sont décrites ci-après :

    Méthode de transport

    Description

    Fournisseur de fichier local

    Permet de sélectionner un fichier sur votre ordinateur ou sur le réseau.

    Fournisseur de fichier de processus externe 

    Permet de sélectionner une application tierce récupérant les données dans Domo à l'aide d'un script. 

     Vous ne pouvez plus modifier la méthode de transport après avoir terminé la procédure dans l'Assistant.

  9. Cliquez sur Suivant.

  10. Dans le menu Source de données, sélectionnez XML.

  11. Cliquez sur Suivant.

  12. Cliquez sur Suivant.
    Une nouvelle tâche de DataSet XML est ajoutée dans la liste des tâches associées au serveur actuellement authentifié dans le volet Comptes.

  13. Sous la tâche de DataSet XML qui vient de s'ajouter à la liste, sélectionnez Source. 
    Les options du panneau qui s'affiche vous permettent de configurer le transport de fichier et les paramètres de votre source de données XML.

  14. (Conditionnel) Choisissez l'une des procédures suivantes :

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier local...

      1. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès.

      2. Sélectionnez le fichier XML désiré sur votre ordinateur ou sur le réseau.

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier de processus externe...

      1. Cliquez sur les points de suspension (...) dans le champ Programme exécutable.

      2. Sélectionnez le fichier exécutable désiré sur votre ordinateur ou sur le réseau.

      3. (Facultatif) Entrez au besoin des arguments dans le champ Arguments.

      4. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès du résultat.

      5. Sélectionnez le chemin d'accès du résultat désiré sur votre ordinateur ou sur le réseau.
        Le type de fichier du chemin de résultat doit être XML.

  15.  Cliquez sur Appliquer les modifications.

  16. (Facultatif) Dans le champ Nœud de données, entrez le nœud de données contenant les données XML à récupérer.

  17. (Facultatif) Dans le panneau Nœuds ignorés, entrez les nœuds que vous voulez ignorer lors de l'exécution de votre tâche de DataSet.
    Pour entrer un nœud, cliquez sur le champ vide et entrez le nœud à ignorer.
    Pour modifier un nœud existant, cliquez sur la ligne correspondant à ce dernier et entrez le nouveau nœud.  

Vous êtes maintenant prêt à exécuter la tâche de DataSet via la création d'un DataSet XML dans Domo. Vous pouvez toutefois exécuter de nombreuses autres opérations sur la tâche de DataSet avant de l'envoyer dans Domo. Ces opérations sont notamment les suivantes : 

Connexion aux données QuickBooks

Vous pouvez créer une tâche de DataSet QuickBooks dans Workbench 4. Lorsque vous sélectionnez le type de source de données QuickBooks, vous pouvez choisir un type de rapport QuickBooks et définir des options telles que l'exercice fiscal, la granularité de date, etc.

Pour créer une tâche de DataSet QuickBooks dans Workbench 4 :

  1. Cliquez sur Ajouter une nouvelle dans le regroupement Tâches de DataSet de la barre d'outils Boutons située en haut de la fenêtre Workbench.
    L'Assistant Workbench de création de tâche de DataSet s'affiche.

  2. (Conditionnel) Si vous y êtes invité, sélectionnez le serveur Domo désiré. (Cet écran s'affiche uniquement lorsque plusieurs serveurs ont été configurés dans Workbench.)

  3. Entrez le nom de la tâche de DataSet dans le champ Nom de la tâche de DataSet. Il s'agit-là du nom de la tâche tel qu'affiché dans Workbench, pas du nom du DataSet chargé dans Domo.

  4. Entrez le nom du DataSet dans le champ Nom du DataSet. Ce nom est celui du DataSet chargé dans Domo.

  5. Dans le champ Type de DataSet, sélectionnez un type de DataSet dans le menu déroulant ou entrez un nom personnalisé.
    Le type de DataSet sélectionné ou entré ici apparaît ensuite en tant que type de connecteur dans Domo après exécution de la tâche.

    Conseil : il est préférable de sélectionner ou d'entrer un type de DataSet désignant clairement à l'utilisateur les données représentées, pas le lecteur de données utilisé pour présenter les données. Par exemple, si vous connectez une feuille Excel qui contient des données QuickBooks, il vaut mieux sélectionner QuickBooks qu'Excel, car les données représentées dans Domo proviennent de QuickBooks, pas d'Excel.

  6. Sélectionnez la méthode de mise à jour souhaitée dans le menu Méthode de mise à jour :

    • Pour remplacer le DataSet dans son intégralité lors de la mise à jour en cours, sélectionnez Remplacer le DataSet.

    • Si vous préférez ajouter les nouvelles données aux données existantes lors de la mise à jour en cours, sélectionnez Ajouter au DataSet.

      Remarque : une fois les paramètres configurés dans l'Assistant, vous pouvez modifier les paramètres entrés aux étapes précédentes dans le panneau Source de la tâche de DataSet. 

  7. Cliquez sur Suivant.

  8. Dans le menu Méthode de transport, sélectionnez Fournisseur de fichier local ou Fournisseur de fichier de processus externe. Ces méthodes de transport sont décrites ci-après : 

    Méthode de transport

    Description

    Fournisseur de fichier local

    Permet de sélectionner un fichier sur votre ordinateur ou sur le réseau.

    Fournisseur de fichier de processus externe 

    Permet de sélectionner une application tierce récupérant les données dans Domo à l'aide d'un script. 

    Vous ne pouvez plus modifier la méthode de transport après avoir terminé la procédure dans l'Assistant.

  9. Cliquez sur Suivant.

  10. Dans le menu Source de données, sélectionnez QuickBooks.

  11. Cliquez sur Suivant.

  12. Cliquez sur Suivant.
    Une nouvelle tâche de DataSet QuickBooks est ajoutée dans la liste des tâches associées au serveur actuellement authentifié dans le volet Comptes.

  13. Sous la tâche de DataSet QuickBooks qui vient de s'ajouter à la liste, sélectionnez Source. 
    Les options du panneau qui s'affiche vous permettent de configurer le transport de fichier et les paramètres de votre source de données QuickBooks.

  14. Choisissez l'une des procédures suivantes :

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier local...

      1. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès.

      2. Sélectionnez le fichier QuickBooks désiré sur votre ordinateur ou sur le réseau.

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier de processus externe...

      1. Cliquez sur les points de suspension (...) dans le champ Programme exécutable.

      2. Sélectionnez le fichier exécutable désiré sur votre ordinateur ou sur le réseau.

      3. (Facultatif) Entrez, le cas échéant, des arguments dans le champ Arguments.

      4. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès du résultat.

      5. Sélectionnez le chemin d'accès du résultat désiré sur votre ordinateur ou sur le réseau.
        Le type de fichier du chemin de résultat doit être QuickBooks.

  15. Cliquez sur Autoriser le fichier de la société dans la barre d'outils Boutons située en haut de la fenêtre Workbench.
    L'Assistant Autoriser le fichier de la société QuickBooks s'affiche.

  16. Cliquez sur Suivant.
    QuickBooks démarre, et le fichier sélectionné s'affiche.

  17. Assurez-vous d'être connecté à QuickBooks en tant qu'administrateur et vérifiez que le fichier est en mode multi-utilisateurs.

  18. Cliquez sur Suivant dans Workbench.
    Le fichier QuickBooks est autorisé dans Domo.

  19. Cliquez sur Appliquer les modifications.

  20. (Facultatif) Si vous voulez que QuickBooks se ferme lorsque Workbench rencontre des erreurs, cochez la case intitulée Autoriser Workbench à interrompre QuickBooks lors des erreurs de connexion.

  21. Activez le bouton radio du type de rapport désiré.
    Les principaux types de rapport sont les suivants :

    Rapport

    Description

    Rapport détaillé général

    Présente des informations détaillées sur les multiples types de rapports, par exemple « Recettes par client », « Ventes en attente », etc. Pour sélectionner la plage de dates requise pour le rapport, choisissez les dates de début et de fin dans les sélecteurs de dates À partir de et Jusqu'au, respectivement. Au besoin, vous pouvez choisir manuellement les colonnes à afficher dans le rapport en les sélectionnant dans le menu Colonnes.

    Rapport récapitulatif général 

    Présente des informations résumées sur les différents types de rapports, par exemple « CustomerBalanceSummary », « IncomeTaxSummary », « PhysicalInventoryWorksheet », etc. Pour sélectionner la plage de dates requise pour le rapport, choisissez les dates de début et de fin dans les sélecteurs de dates À partir de et Jusqu'au, respectivement. Vous pouvez également sélectionner la granularité de date des données de votre rapport (par exemple, récapituler les données par jour, par mois, etc.).

    Rapport récapitulatif budgétaire 

    Présente les rapports sur le bilan et les profits et pertes. Vous pouvez sélectionner l'exercice fiscal correspondant à votre rapport. 

    Liste 

    Présente les rapports au format liste, par exemple « Employé » (liste des employés de la société), « Fournisseurs » (liste des fournisseurs), etc. Ces informations n'étant pas classées par date, il n'est pas possible de définir une plage de dates ou de choisir un exercice fiscal. 

  22. (Conditionnel) Choisissez l'une des procédures suivantes :

    • Si vous avez sélectionné Rapport détaillé général...

      1. Sélectionnez un sous-rapport dans le menu Rapport détaillé général.

      2. Dans le menu À partir de, sélectionnez la date de début de votre rapport.

      3. (Conditionnel) Pour que votre rapport récupère les données jusqu'à la date du jour à chaque mise à jour, laissez l'option Jour actuel activée dans le menu Jusqu'au. Sinon, sélectionnez la date de fin du rapport dans le menu.

      4. Dans le menu Nombre maximal de jours à renvoyer dans un seul résultat, entrez le nombre maximal de jours requis. La valeur ne peut pas dépasser 30.

      5. Dans le menu Colonnes, sélectionnez les colonnes dont vous souhaitez récupérer les données.

    • Si vous avez sélectionné Rapport récapitulatif général...

      1. Sélectionnez un sous-rapport dans le menu Rapport récapitulatif général.

      2. Dans le menu À partir de, sélectionnez la date de début de votre rapport.

      3. (Conditionnel) Pour que votre rapport récupère les données jusqu'à la date du jour à chaque mise à jour, laissez l'option Jour actuel activée dans le menu Jusqu'au. Sinon, sélectionnez la date de fin du rapport dans le menu.

      4. Dans le menu Résumer les colonnes du rapport par, sélectionnez la granularité de date des données de votre rapport. Cette option détermine le mode de ventilation des données. Par exemple, si vous choisissez Trimestre, les données sont ventilées par trimestre et non pas par mois, par semaine, etc.

    • Si vous avez sélectionné Rapport récapitulatif budgétaire...

      1. Sélectionnez un sous-rapport dans le menu Rapport récapitulatif budgétaire.

      2. Sélectionnez l'exercice fiscal requis dans le menu Exercice fiscal.

    • Si vous avez sélectionné Liste...

      1. Sélectionnez un sous-rapport dans le menu Liste.

Vous êtes maintenant prêt à exécuter la tâche de DataSet via la création d'un DataSet QuickBooks dans Domo. Vous pouvez toutefois exécuter de nombreuses autres opérations sur la tâche de DataSet avant de l'envoyer dans Domo. Ces opérations sont notamment les suivantes :

Connexion aux données JSON

Vous pouvez créer une tâche de DataSet JSON dans Workbench 4. Lorsque vous sélectionnez le type de source de données JSON, vous pouvez spécifier le nœud qui contient les données à récupérer, le séparateur, ainsi que la façon dont les données doivent être mises à plat.

Pour créer une tâche de DataSet JSON dans Workbench 4,

  1. Cliquez sur Ajouter une nouvelle dans le regroupement Tâches de DataSet de la barre d'outils Boutons située en haut de la fenêtre Workbench.
    L'Assistant Workbench de création de tâche de DataSet s'affiche.

  2. (Conditionnel) Si vous y êtes invité, sélectionnez le serveur Domo désiré. (Cet écran s'affiche uniquement lorsque plusieurs serveurs ont été configurés dans Workbench.)

  3. Entrez le nom de la tâche de DataSet dans le champ Nom de la tâche de DataSet. Il s'agit-là du nom de la tâche tel qu'affiché dans Workbench, pas du nom du DataSet chargé dans Domo.

  4. Entrez le nom du DataSet dans le champ Nom du DataSet. Ce nom est celui du DataSet chargé dans Domo.

  5. Dans le champ Type de DataSet, sélectionnez un type de DataSet dans le menu déroulant ou entrez un nom personnalisé.
    Le type de DataSet sélectionné ou entré ici apparaît ensuite en tant que type de connecteur dans Domo après exécution de la tâche.

    Conseil : il est préférable de sélectionner ou d'entrer un type de DataSet désignant clairement à l'utilisateur les données représentées, pas le lecteur de données utilisé pour présenter les données. Par exemple, si vous connectez une feuille JSON qui contient des données Twitter, il vaut mieux entrer « Twitter » que sélectionner JSON, car les données représentées dans Domo proviennent de Twitter.

  6. Sélectionnez la méthode de mise à jour souhaitée dans le menu Méthode de mise à jour :

    • Pour remplacer le DataSet dans son intégralité lors de la mise à jour en cours, sélectionnez Remplacer le DataSet.

    • Si vous préférez ajouter les nouvelles données aux données existantes lors de la mise à jour en cours, sélectionnez Ajouter au DataSet.

      Remarque : une fois les paramètres configurés dans l'Assistant, vous pouvez modifier les paramètres entrés aux étapes précédentes dans le panneau Source de la tâche de DataSet.

  7. Cliquez sur Suivant.

    Dans le menu Méthode de transport, sélectionnez Fournisseur de fichier local ou Fournisseur de fichier de processus externe. Ces méthodes de transport sont décrites ci-après : 

    Méthode de transport

    Description

    Fournisseur de fichier local

    Permet de sélectionner un fichier sur votre ordinateur ou sur le réseau.

    Fournisseur de fichier de processus externe 

    Permet de sélectionner une application tierce récupérant les données dans Domo à l'aide d'un script. 

    Vous ne pouvez plus modifier la méthode de transport après avoir terminé la procédure dans l'Assistant.

  8. Cliquez sur Suivant.

  9. Dans le menu Source de données, sélectionnez JSON.

  10. Cliquez sur Suivant.

  11. Cliquez sur Suivant.
    Une nouvelle tâche de DataSet JSON est ajoutée dans la liste des tâches associées au serveur actuellement authentifié dans le volet Comptes.

  12. Sous la tâche de DataSet JSON qui vient de s'ajouter à la liste, sélectionnez Source. 
    Les options du panneau qui s'affiche vous permettent de configurer le transport de fichier et les paramètres de votre source de données JSON.

  13. (Conditionnel) Choisissez l'une des procédures suivantes :

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier local...

      1. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès.

      2. Sélectionnez le fichier JSON désiré sur votre ordinateur ou sur le réseau.

    • Si vous avez sélectionné la méthode de transport Fournisseur de fichier de processus externe...

      1. Cliquez sur les points de suspension (...) dans le champ Programme exécutable.

      2. Sélectionnez le fichier exécutable désiré sur votre ordinateur ou sur le réseau.

      3. (Facultatif) Entrez au besoin des arguments dans le champ Arguments.

      4. Cliquez sur les points de suspension (...) dans le champ Chemin d'accès du résultat.

      5. Sélectionnez le chemin d'accès du résultat désiré sur votre ordinateur ou sur le réseau.
        Le type de fichier du chemin de résultat doit être JSON.

  14. Cliquez sur Appliquer les modifications.

  15. Dans le champ Source de données, entrez le nœud à partir duquel vous souhaitez récupérer des données JSON. 
    Il doit s'agir d'un tableau d'objets (par exemple, Key5_Key3). 

  16. Dans le champ Séparateur, entrez le séparateur à insérer dans le nom de colonne des résultats mis à plat.

  17. Dans le menu Options d'aplanissement, indiquez comment mettre à plat les données. Les options sont les suivantes : 

    Option

    Description

    Néant 

    Renvoie la chaîne JSON non mise à plat.

    Profond 

    Ajoute de nouvelles lignes pour tous les objets imbriqués. 

    Large 

    Ajoute de nouvelles colonnes pour tous les objets imbriqués. Une seule ligne est renvoyée. 

Vous êtes maintenant prêt à exécuter la tâche de DataSet via la création d'un DataSet JSON dans Domo. Vous pouvez toutefois exécuter de nombreuses autres opérations sur la tâche de DataSet avant de l'envoyer dans Domo. Ces opérations sont notamment les suivantes : 

Articles associés

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.