Téléchargement de champs de fichier dans les enregistrements d'entité

Vous pouvez facilement manipuler des fichiers spécifiques d'un enregistrement d'entité à l'aide de Studio. Ces activités vous permettent d'exécuter des opérations telles que le chargement, le téléchargement ou la suppression de fichiers d'un champ d'un enregistrement d'entité.

L'exemple suivant montre comment télécharger automatiquement un fichier spécifié contenant des informations sur les Jeux olympiques extraites des pages Wikipédia à partir de Data Service afin de les utiliser dans le cadre d'autres opérations.

Téléchargez l'exemple

Prérequis : créer des entités dans Data Service

En suivant les étapes détaillées sur la page Créer une entité ( Creating an Entity ), nous avons créé une entité pour stocker des informations sur les Jeux olympiques.

L'entité Jeux olympiques (Olympics) présente les champs suivants : Nom (texte) [Name (Text)] et Logo (fichier) [Logo (file)].

Consultez les pages suivantes :

• l'activité Télécharger un fichier (Upload File activity) car elle contient des détails sur la façon d'utiliser cette activité pour télécharger facilement les logos ;

• la page Fichier (File), car elle fournit des détails sur la façon de télécharger des logos à partir de la plate-forme.

  Remarque: Des champs intégrés au système sont automatiquement ajoutés à votre entité afin de fournir des détails sur sa création.
  
  

  

  
  

Étape 1 : Créer le workflow

Interroger les enregistrements liés

Nous utilisons l'activité Rechercher des enregistrements d’entités (Query Entity Records) pour extraire une liste d'enregistrements de l'entité Jeux olympiques (Olympics) à partir de Data Service en configurant la variable folder. Elle parcourt tous les enregistrements du champ Nom (Name) et les génère dans la variable olympicsRecords à utiliser dans l'activité Boîte de dialogue d'entrée (Input Dialog) suivante.

Créer une boîte de dialogue d'entrée

Ajoutez l'activité Boîte de dialogue d'entrée (Input Dialog) pour afficher une boîte de dialogue contenant le message de libellé Select et un Type d'entrée Multiple choice. Dans le tableau d'entrée, ajoutez la variable olympicsRecords créée précédemment pour l'activité Rechercher des enregistrements d’entités (Query Entity Records), pour laquelle vous appliquerez la fonction suivante : olympicsRecords.Select(Function (o as Olympics) o.Name).ToArray afin de configurer le tableau d'options à partir duquel vous effectuerez votre sélection.

Configurez la variable selectedOlympics pour rassembler les résultats de sortie.

Attribuer une valeur au fichier

Utilisez l'activité Affecter (Assign) pour affecter la variable olympicsRecords.First(Function (o as Olympics) o.Name = selectedOlympics) créée précédemment dans l'activité Dialogue d'entrée (Input Dialog) à la nouvelle variable olympicEdition.

Configurer une boîte de dialogue Sélectionner un dossier (Select a Folder)

Ajoutez la variable Sélectionner un dossier (Select Folder) pour ouvrir une boîte de dialogue et créez la variable folder pour le chemin du dossier de sortie. Vous utiliserez cette variable dans l'activité suivante Télécharger le fichier à partir du champ d'enregistrement (Download File from Record Field).

Télécharger le fichier à partir du champ d'enregistrement

Utilisez l'activité Télécharger le fichier à partir du champ d'enregistrement (Download File from Record Field) pour télécharger le fichier folder à partir du fichier Logo (Logo) de l'enregistrement d'entité olympicEdition.Id.

Exécuter la commande Power Shell (Run Power Shell Command)

Ajoutez l'activité Appeler Power Shell (Invoke Power Shell) pour exécuter la ligne de commande suivante : Path.Combine(folder, olympicEdition.Logo.Name) afin de combiner les paramètres d'entrée suivants : les variables folder et olympicEdition et les champs Logo et Nom (Name) créés dans l'entité Jeux Olympiques (Olympics).

Le but de cette activité est d'appeler le chemin complet du fichier et de l'ouvrir dans la visionneuse ou l'éditeur de photos par défaut.

[Facultatif] : commenter

En tant qu'étape facultative, nous avons ajouté un exemple sur la façon d'effectuer une suppression de fichier ayant été commentée pour ne pas supprimer le fichier au moment de l'exécution. Pour ce faire, nous avons ajouté l'activité Commenter (Comment Out). Ici, nous avons inclus les activités suivantes qui ne seront pas exécutées au moment de l'exécution :

Vous pouvez annuler votre commentaire pour l'essayer.

1. Configurez l'ordre des activités enfants.

   Nous avons ajouté une activité Séquence (Sequence) que nous avons renommée Activités ignorées (Ignored Activities).

2. Incluez ici l'activité Supprimer le fichier à partir du champ d’enregistrement (Delete File from Record Field) pour supprimer le fichier du champ d'enregistrement d'entité spécifié.
   
   

   

   
   
3. Pour que l'activité Supprimer le fichier à partir du champ d'enregistrement fonctionne comme prévu, configurez-la comme suit :
   1. Définissez l'identifiant d'enregistrement (Record ID) sur la variable olympicEdition.Id créée dans l'activité Télécharger le fichier à partir du champ d'enregistrement (Download File from Record Field).
   2. Le champ à partir duquel vous souhaitez supprimer le fichier est le fichier Logo (Logo) créé dans l'enregistrement de Data Service créé au début de cet exemple.
   3. L'enregistrement de sortie est la variable olympicEdition créée dans l'activité Affecter (Assign).
      
      

      

      
      

Une fois terminé, votre projet devrait ressembler à ceci :