Utiliser une feuille de calcul pour ajouter des données

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 20 minutes de lecture
  • Ajoutez des tables de données et des enregistrements à votre application en téléchargeant une feuille de Microsoft calcul Excel.

    Avant de commencer

    Rôle requis : admin, sn_app_eng_studio.user

    Procédure

    Utilisez les procédures suivantes pour charger une feuille de calcul et l’utiliser pour créer des tables de données et importer des enregistrements de données.
    Utilisez d’abord la Importer une feuille de calcul procédure pour charger votre feuille de calcul, puis créez des tables de données à partir de votre importation de feuille de calcul si nécessaire.

    Importer une feuille de calcul

    Chargez une Microsoft feuille de calcul Excel et utilisez-la pour créer votre modèle de données d’application.

    Avant de commencer

    Vérifiez que la feuille de calcul répond aux exigences suivantes :
    • Formaté avec des colonnes horizontales et une étiquette d’en-tête pour chaque
    • Enregistré sous forme de fichier XLSX
    Remarque :
    La feuille de calcul Excel que vous chargez peut avoir plusieurs onglets de feuille de calcul, chacun d’entre eux étant utilisé pour créer une table de données. Si plusieurs feuilles de calcul sont présentes, vous serez invité à sélectionner l’onglet de feuille de calcul à partir duquel créer la table après avoir téléchargé le fichier.

    Rôle requis : admin, sn_app_eng_studio.user ou développeur délégué. Pour plus d'informations, consultez Déléguer les développeurs à l’aide de AES.

    Procédure

    1. Accédez à la Tous > Moteur de développement d'application > Studio du moteur de développement d'application.
    2. Sur la page Mes applications, ouvrez votre application.
    3. À côté de l’en-tête Données, sélectionnez l’icône Ajouter ( Ajouter une icône).
    4. Sélectionnez Importer une feuille de calcul, puis Continuer.
    5. Chargez votre feuille de calcul, puis sélectionnez Continuer.

      Vous pouvez faire glisser le fichier de feuille de calcul sur Studio du moteur de développement d'application votre ordinateur ou le parcourir.

    6. L’un des parcours suivants vous sera présenté :
      • Si votre feuille de calcul ne comporte qu’un seul onglet de feuille de calcul, passez à l’étape suivante.
      • Si la feuille de calcul comporte plusieurs onglets de feuille de calcul, vous aurez une liste de feuilles parmi lesquelles choisir. Dans cette liste de feuilles, vous pouvez sélectionner l’onglet de feuille de calcul à ajouter en premier comme table à votre application.
      1. Dans le champ Entrez un numéro de ligne pour l’en-tête de table , saisissez le numéro de ligne dans lequel se trouvent les en-têtes de colonne de la feuille.
        Par exemple, si les en-têtes sont dans la deuxième ligne, entrez 2.
      2. Facultatif : Pour charger les informations sous les en-têtes de colonne dans la feuille (par exemple, les données de votre feuille de calcul), sélectionnez l’option Importer les données de la feuille de calcul.
        Pour charger uniquement les en-têtes de colonne, décochez la case. Vous pouvez charger uniquement les en-têtes si vous avez l’intention d’utiliser cette table comme modèle et que vous ne souhaitez pas que d’autres données soient ajoutées à votre AES table.
    7. Sélectionnez l’une des options suivantes.
      • Si vous avez téléchargé un fichier Excel avec plusieurs onglets de feuille de calcul, sélectionnez Convertir en table pour procéder à la conversion de l’onglet de feuille de calcul sélectionné en table, puis passez à l’étape suivante.
      • Si vous avez chargé un fichier Excel avec un seul onglet de feuille de calcul, sélectionnez Continuer.
      Des options s’affichent pour savoir où importer votre fichier.
    8. En fonction de ce que vous souhaitez faire avec les données de votre feuille de calcul, accédez à l’une des procédures suivantes pour continuer.
      OptionDescription
      Créer une table directement à partir de l’importation de la feuille de calcul Reportez-vous à la section Créer une table à partir de l’importation de la feuille de calcul pour connaître les étapes suivantes.
      Créer une table en étendant une table existante, puis en utilisant l’importation de la feuille de calcul pour la mettre à jour Reportez-vous à la section Créer une table à partir de l’importation d’une table extensible et d’une feuille de calcul pour connaître les étapes suivantes.
      Utiliser l’importation de feuille de calcul pour mettre à jour une table d’application existante Reportez-vous à la section Modifier une table existante à l’aide de l’importation dans une feuille de calcul pour connaître les étapes suivantes.

    Créer une table à partir de l’importation de la feuille de calcul

    Créez de nouvelles tables directement à partir d’une Microsoft importation de feuille de calcul Excel.

    Avant de commencer

    Rôle requis : admin, sn_app_eng_studio.user ou développeur délégué. Pour plus d'informations, consultez Déléguer les développeurs à l’aide de AES.

    Procédure

    1. Une fois que vous avez téléchargé votre feuille de calcul comme décrit dans Importer une feuille de calcul, choisissez ce que vous souhaitez faire avec les données importées dans l’assistant qui s’affiche.
      Figure 1. Créer une table à partir d’une feuille de calcul
      Créer une table à partir d’une feuille de calcul.
      1. Sélectionnez une nouvelle table.
      2. Choisissez Créer une table.
    2. Sélectionnez Continuer.
    3. Examinez les propriétés de chaque en-tête de colonne à l’aide de la liste déroulante Développer les options pour afficher plus de propriétés.
      Propriété de l’en-tête de colonne Description
      Étiquette de champ Étiquette unique pour la colonne.
      Nom de champ Nom de base de données pour la colonne.
      Type

      Type d’informations que contient la colonne. Par exemple, pour contenir du texte brut dans la colonne, sélectionnez Chaîne.

      Selon le type que vous sélectionnez, renseignez les champs supplémentaires pour affiner la définition de la colonne de table. Par exemple, si vous sélectionnez Chaîne, définissez la limite de caractères de l’entrée de chaîne. Ou, si vous sélectionnez Choix, définissez les choix que les utilisateurs peuvent choisir.

      Consultez Field types.

      Limite de caractère

      Longueur maximale des chaînes qui peuvent être stockées.

      Affichage

      Option permettant de définir la colonne comme valeur d’affichage de la table. Un champ de référence affiche la valeur d’affichage de la table à laquelle il se réfère. Par exemple, la colonne Ouvert par de la table Tâche fait référence à la table utilisateur. Étant donné que la valeur d’affichage de la table utilisateur est le nom d’utilisateur, le champ Ouvert par affiche quelque chose comme Beth Anglin ou Joe Employee. Lorsque vous sélectionnez une valeur d’affichage, choisissez la colonne de table qui servirait de titre approprié pour les enregistrements individuels.

      Une seule colonne peut servir de valeur d’affichage pour une table.

      Obligatoire Option pour exiger que la colonne contienne une valeur avant qu’un nouvel enregistrement puisse être enregistré.

      Pour ajouter une autre colonne à votre table, sélectionnez Ajouter un nouveau champ.

      Pour supprimer une colonne, sélectionnez l’icône de corbeille ( icône Corbeille).

    4. Sélectionnez Continuer pour définir les propriétés de la table.
    5. Renseignez les champs du formulaire.
      Champ Description
      Étiquette de la table Étiquette unique pour identifier la table.
      Nom de la table Nom de base de données pour la table. Un nom de table est créé automatiquement une fois que vous avez entré une étiquette de table. Vous pouvez modifier le nom si nécessaire.
      Autoriser l'extension Option permettant à d’autres tables de partager des données à partir de cette table. Pour plus d’informations sur l’extension de table, reportez-vous à la section Extension de table.
      Numérotation automatique Option permettant de suivre les enregistrements de table avec un numéro unique. Si vous sélectionnez cette option, définissez le préfixe, le numéro de départ et le nombre de chiffres.
      Préfixe

      Nom abrégé de la table à ajouter au début du numéro d’enregistrement. Par exemple, si vous créez une table « Ordinateur portable », votre préfixe peut être « LPTP » ou « LT ».

      Numéro de départ

      Numéro permettant d’identifier le premier enregistrement créé pour votre table.

      Nombre de chiffres

      Nombre maximal de chiffres autorisés dans le numéro d’enregistrement. Cette valeur détermine le numéro d’enregistrement le plus élevé possible. Par exemple, si vous entrez 7, le nombre le plus élevé possible est 9999999.

    6. Sélectionnez Continuer.
    7. Contrôlez qui a accès à la création, à la lecture, à l’écriture et à la suppression de contenu de cette table en ajoutant de nouveaux rôles et/ou en définissant les autorisations de création, lecture, écriture et suppression souhaitées pour les rôles existants.

      Les rôles que vous créez dans la table sont conservés dans l’ensemble de l’application et peuvent être définis davantage dans les autres tables que vous ajoutez. Consultez Ajouter une sécurité d’application pour en savoir plus sur le fonctionnement des autorisations de sécurité.

      Remarque :
      Au moins un rôle doit avoir un accès en lecture pour que vous puissiez prévisualiser la table.
    8. Sélectionnez Continuer pour ajouter la nouvelle table créée à partir de votre feuille de calcul à votre application.
    9. Facultatif : Convertissez les feuilles de calcul restantes si votre fichier contenait plusieurs onglets de feuille de calcul.
    10. Sélectionnez Terminé sur l’écran de résumé.
      Pour afficher votre table dans , vous pouvez également sélectionner Modifier la ou les tables sur Créateur de tablesl’écran de résumé.

    Que faire ensuite

    Pour plus d’informations sur la mise à jour de vos tables de données dans , reportez-vous à Créateur de tablesla section Créateur de tables.

    Créer une table à partir de l’importation d’une table extensible et d’une feuille de calcul

    Créez une table en étendant une table existante, puis en utilisant une Microsoft importation de feuille de calcul Excel pour la mettre à jour ou la personnaliser.

    Avant de commencer

    Rôle requis : admin, sn_app_eng_studio.user, développeur délégué Les autorisations pour « Intégration » doivent être présentes afin d’afficher les options d’importation et de mappage des données. Pour plus d'informations, consultez Déléguer les développeurs à l’aide de AES.

    Procédure

    1. Une fois que vous avez téléchargé votre feuille de calcul comme décrit dans Importer une feuille de calcul, choisissez l’emplacement d’importation de votre fichier dans l’assistant qui s’affiche.
      Figure 2. Importer dans une nouvelle table de données
      Importer dans une nouvelle table de données.
      1. Sélectionnez une nouvelle table.
      2. Choisissez Créer à partir d’une table extensible.
    2. Sélectionnez Continuer.
    3. Recherchez et sélectionnez une table existante pour ajouter les données de cette table à votre application et créer une extension avec une logique de branche.
      Remarque :
      Les tables déjà présentes dans l’application s’affichent en premier dans la liste et les tables recommandées Now Platform s’affichent ensuite, ainsi qu’une brève description du type d’informations que la table stocke.
    4. Sélectionnez Continuer.
    5. Renseignez les champs du formulaire.
      Champ Description
      Étiquette de la table Étiquette unique pour identifier la table.
      Nom de la table Nom de base de données pour la table. Un nom de table est créé automatiquement une fois que vous avez entré une étiquette de table. Vous pouvez modifier le nom si nécessaire.
      Autoriser l'extension Option permettant à d’autres tables de partager des données à partir de cette table. Pour plus d’informations sur l’extension de table, reportez-vous à la section Extension de table.
      Numérotation automatique Option permettant de suivre les enregistrements de table avec un numéro unique. Si vous sélectionnez cette option, définissez le préfixe, le numéro de départ et le nombre de chiffres.
      Préfixe

      Nom abrégé de la table à ajouter au début du numéro d’enregistrement. Par exemple, si vous créez une table « Ordinateur portable », votre préfixe peut être « LPTP » ou « LT ».

      Numéro de départ

      Numéro permettant d’identifier le premier enregistrement créé pour votre table.

      Nombre de chiffres

      Nombre maximal de chiffres autorisés dans le numéro d’enregistrement. Cette valeur détermine le numéro d’enregistrement le plus élevé possible. Par exemple, si vous entrez 7, le nombre le plus élevé possible est 9999999.

    6. Sélectionnez Continuer.
    7. Contrôlez qui a accès à la création, à la lecture, à l’écriture et à la suppression de contenu de cette table en ajoutant de nouveaux rôles et/ou en définissant les autorisations de création, lecture, écriture et suppression souhaitées pour les rôles existants.

      Les rôles que vous créez dans la table sont conservés dans l’ensemble de l’application et peuvent être définis davantage dans les autres tables que vous ajoutez. Consultez Ajouter une sécurité d’application pour en savoir plus sur le fonctionnement des autorisations de sécurité.

      Remarque :
      Au moins un rôle doit avoir un accès en lecture pour que vous puissiez prévisualiser la table.
    8. Sélectionnez Continuer.
      Remarque :
      Votre table est maintenant prête à recevoir des données. À l’étape suivante, les champs de votre importation sont mis en correspondance avec les champs de votre nouvelle table étendue. Vous aurez la possibilité d’ajuster le mappage ou de créer de nouveaux champs à partir de votre importation.
    9. Sélectionnez Continuer pour procéder au mappage des champs.
      Un écran s’affiche où vous pouvez mapper les colonnes de champ de votre feuille de calcul source sur la gauche aux colonnes de champ de votre nouvelle table cible étendue que vous venez de créer sur la droite.
      Figure 3. Mapper les champs importés
      Mappez les champs importés.
    10. Les choix suivants s’offrent à vous au cours de cette étape.
      OptionDescription
      Mapper les champs par lots à l’aide du mappage automatique Sélectionnez Mappage automatique pour mapper automatiquement les champs de votre feuille de calcul aux champs affichés dans la table cible sélectionnée. Le mappage automatique mappe automatiquement les entités sources à des entités cibles portant le même nom. Pour une entité cible qui a déjà été mappée, sélectionner Mappage automatique ne modifie pas sa valeur. Un champ mappé automatiquement comporte une icône de baguette sur sa pastille de données.
      Mapper les champs par glisser-déplacer

      Mappez les champs de votre importation à votre table cible en faisant glisser les pastilles de données représentant les colonnes de la feuille de calcul importée vers la colonne Valeur de la table cible. Vous pouvez également mapper les champs à l’aide du sélecteur de pastilles à droite de chaque champ de table cible.

      Mapper les champs à l’aide du sélecteur de données

      Mappez les données à l’aide du sélecteur de pastilles ( Sélecteur de pastilles.) sur le côté droit de la table cible. Vous pouvez entrer plus d’une valeur dans la colonne Valeur , vous pouvez également entrer du texte.

      Ajouter des options de transformation
      Ajoutez des options de transformation pour chacun des champs de feuille de calcul mappés individuels en cliquant sur l’icône FX ( icône FX.) dans le volet latéral droit. Par exemple, vous pouvez utiliser la fonction de transformation Majuscule pour remplacer une chaîne d’entrée par des caractères tout en majuscule. Consultez Transform functions pour en savoir plus sur l’utilisation de ces éléments pour découper les données de vos champs de feuille de calcul importés.
      Remarque :
      Toutes les fonctions de transformation disponibles dans Flow Designer ne sont pas disponibles.
      Activer la correspondance d’enregistrement de données
      Spécifiez les champs dans lesquels le système doit vérifier les données correspondantes et, le cas échéant, mettre à jour les enregistrements existants au lieu d’en créer de nouveaux en activant le bouton bascule Correspondance dans votre table cible. Par exemple, si une table cible dispose d’un champ de numéro de commande et d’un enregistrement avec un numéro de commande 743, il existe deux options pour gérer les correspondances potentielles.
      • Si l’option Correspondance du champ Numéro de commande est activée, le système vérifie les données correspondantes. Si les données sources possèdent un enregistrement avec le même numéro d’ordre, le système met à jour l’enregistrement existant dans la table cible.
      • Si l’option Correspondance du champ Numéro de commande est désactivée, le système ne recherche pas les données correspondantes. Si les données sources ont un enregistrement avec le même numéro d’ordre, le système crée un nouvel enregistrement dans la table cible. Dans ce cas, la table cible aura deux enregistrements, tous deux avec un numéro d’ordre de 743.
      Configurer le comportement du champ de référence et de choix Configurez le comportement des types de champs Choix et Référence .
      1. Cliquez sur l’icône d’engrenage ( icône d’engrenage.).
      2. Dans Champ, sélectionnez la colonne de champ à laquelle faire correspondre la valeur de l’enregistrement entrant dans la table cible.
      3. Dans Si aucun enregistrement correspondant n’existe, procédez comme suit, spécifiez ce qu’il faut faire si cet enregistrement n’est pas trouvé dans la table cible.
        • Créer un nouveau choix/enregistrement : Crée le choix ou l’enregistrement dans la colonne de champ correspondant de la table cible à partir des données importées pour le champ.
        • Ignorer ce champ : Ignore le champ dans la table cible et le laisse null.
        • Ignorer cet enregistrement : Ignore l’ajout de l’enregistrement entier (ligne) dans la table cible.
      4. Cliquez sur Terminé.
      Ajouter de nouvelles colonnes de champ à la table cible Ajoutez des colonnes de champ non mappées de votre importation vers votre table cible ou créez de nouveaux champs dans votre table cible.
      1. Sélectionnez Ajouter des champs au-dessus de la table cible sur la droite.
      2. Choisissez les champs à ajouter à votre table cible en cochant la case à gauche ou sélectionnez Tous pour tous les choisir.
      3. Vous pouvez également exécuter les fonctions suivantes :
        • Modifiez l’étiquette du champ importé.
        • Modifiez les propriétés de champ pour le champ importé en sélectionnant l’icône Modifier ( Modifier les propriétés de champ de la table cible.).
        • Créez un nouveau champ en cliquant sur Créer un nouveau champ dans le coin supérieur droit de la fenêtre.
      4. Sélectionnez Ajouter des champs pour ajouter les champs sélectionnés à votre table cible.
    11. Sélectionnez Continuer pour créer le mappage d’importation de données et mettre à jour votre table cible.
    12. Facultatif : Convertissez les feuilles de calcul restantes si votre fichier contenait plusieurs onglets de feuille de calcul.
    13. Sélectionnez Terminé sur l’écran de résumé.
      Pour afficher votre table dans , vous pouvez également sélectionner Modifier la ou les tables sur Créateur de tablesl’écran de résumé.

    Que faire ensuite

    Pour plus d’informations sur la mise à jour de vos tables de données dans , reportez-vous à Créateur de tablesla section Créateur de tables.

    Modifier une table existante à l’aide de l’importation dans une feuille de calcul

    Utilisez une importation de Microsoft feuille de calcul Excel pour mettre à jour une table d’application existante.

    Avant de commencer

    Rôle requis : admin, sn_app_eng_studio.user ou développeur délégué. Pour plus d'informations, consultez Déléguer les développeurs à l’aide de AES.

    Procédure

    1. Une fois que vous avez téléchargé votre feuille de calcul comme décrit dans Importer une feuille de calcul, choisissez l’emplacement d’importation de votre fichier dans l’assistant qui s’affiche.
      Figure 4. Importer dans une table d’application existante
      Importez dans une table d’application existante.
      1. Sélectionnez une table existante.
      2. Sélectionnez une table d’application existante dans la liste qui s’affiche.
    2. Sélectionnez Continuer.
      Un écran s’affiche où vous pouvez mapper les colonnes de champ de votre feuille de calcul source sur la gauche aux colonnes de champ de votre table d’application cible existante sur la droite.
      Remarque :
      Vous aurez la possibilité d’ajuster le mappage ou de créer de nouveaux champs à partir de votre importation.
      Figure 5. Mapper les champs importés
      Mappez les champs importés.
    3. Les actions suivantes sont à votre disposition au cours de cette étape.
      OptionDescription
      Mapper les champs par lots à l’aide du mappage automatique Sélectionnez Mappage automatique pour mapper automatiquement les champs de votre feuille de calcul aux champs affichés dans la table cible sélectionnée. Le mappage automatique mappe automatiquement les entités sources à des entités cibles portant le même nom. Pour une entité cible qui a déjà été mappée, sélectionner Mappage automatique ne modifie pas sa valeur. Un champ mappé automatiquement comporte une icône de baguette sur sa pastille de données.
      Mapper les champs par glisser-déplacer

      Mappez les champs de votre importation à votre table cible en faisant glisser les pastilles de données représentant les colonnes de la feuille de calcul importée vers la colonne Valeur de la table cible. Vous pouvez également mapper les champs à l’aide du sélecteur de pastilles à droite de chaque champ de table cible.

      Mapper les champs à l’aide du sélecteur de données

      Mappez les données à l’aide du sélecteur de pastilles ( Sélecteur de pastilles.) sur le côté droit de la table cible. Vous pouvez entrer plus d’une valeur dans la colonne Valeur , vous pouvez également entrer du texte.

      Ajouter des options de transformation
      Ajoutez des options de transformation pour chacun des champs de feuille de calcul mappés individuels en cliquant sur l’icône FX ( icône FX.) dans le volet latéral droit. Par exemple, vous pouvez utiliser la fonction de transformation Majuscule pour remplacer une chaîne d’entrée par des caractères tout en majuscule. Consultez Transform functions pour en savoir plus sur l’utilisation de ces éléments pour découper les données de vos champs de feuille de calcul importés.
      Remarque :
      Toutes les fonctions de transformation disponibles dans Flow Designer ne sont pas disponibles.
      Activer la correspondance d’enregistrement de données
      Spécifiez les champs dans lesquels le système doit vérifier les données correspondantes et, le cas échéant, mettre à jour les enregistrements existants au lieu d’en créer de nouveaux en activant le bouton bascule Correspondance dans votre table cible. Par exemple, si une table cible dispose d’un champ de numéro de commande et d’un enregistrement avec un numéro de commande 743, il existe deux options pour gérer les correspondances potentielles.
      • Si l’option Correspondance du champ Numéro de commande est activée, le système vérifie les données correspondantes. Si les données sources possèdent un enregistrement avec le même numéro d’ordre, le système met à jour l’enregistrement existant dans la table cible.
      • Si l’option Correspondance du champ Numéro de commande est désactivée, le système ne recherche pas les données correspondantes. Si les données sources ont un enregistrement avec le même numéro d’ordre, le système crée un nouvel enregistrement dans la table cible. Dans ce cas, la table cible aura deux enregistrements, tous deux avec un numéro d’ordre de 743.
      Configurer le comportement du champ de référence et de choix Configurez le comportement des types de champs Choix et Référence .
      1. Cliquez sur l’icône d’engrenage ( icône d’engrenage.).
      2. Dans Champ, sélectionnez la colonne de champ à laquelle faire correspondre la valeur de l’enregistrement entrant dans la table cible.
      3. Dans Si aucun enregistrement correspondant n’existe, procédez comme suit, spécifiez ce qu’il faut faire si cet enregistrement n’est pas trouvé dans la table cible.
        • Créer un nouveau choix/enregistrement : Crée le choix ou l’enregistrement dans la colonne de champ correspondant de la table cible à partir des données importées pour le champ.
        • Ignorer ce champ : Ignore le champ dans la table cible et le laisse null.
        • Ignorer cet enregistrement : Ignore l’ajout de l’enregistrement entier (ligne) dans la table cible.
      4. Cliquez sur Terminé.
      Ajouter de nouvelles colonnes de champ à la table cible Ajoutez des colonnes de champ non mappées de votre importation vers votre table cible ou créez de nouveaux champs dans votre table cible.
      1. Sélectionnez Ajouter des champs au-dessus de la table cible sur la droite.
      2. Choisissez les champs à ajouter à votre table cible en cochant la case à gauche ou sélectionnez Tous pour tous les choisir.
      3. Vous pouvez également exécuter les fonctions suivantes :
        • Modifiez l’étiquette du champ importé.
        • Modifiez les propriétés de champ pour le champ importé en sélectionnant l’icône Modifier ( Modifier les propriétés de champ de la table cible.).
        • Créez un nouveau champ en cliquant sur Créer un nouveau champ dans le coin supérieur droit de la fenêtre.
      4. Sélectionnez Ajouter des champs pour ajouter les champs sélectionnés à votre table cible.
    4. Sélectionnez Continuer pour créer le mappage d’importation de données et mettre à jour votre table cible.
      Remarque :
      Vous serez invité s’il reste des champs non mappés dans votre feuille de calcul. Vous pouvez mapper ces champs ou continuer sans les mapper.
    5. Facultatif : Convertissez les feuilles de calcul restantes si votre fichier contenait plusieurs onglets de feuille de calcul.
    6. Sélectionnez Terminé sur l’écran de résumé.
      Pour afficher votre table dans , vous pouvez également sélectionner Modifier la ou les tables sur Créateur de tablesl’écran de résumé.

    Que faire ensuite

    Pour plus d’informations sur la mise à jour de vos tables de données dans , reportez-vous à Créateur de tablesla section Créateur de tables.