Présentation des actions de dictionnaire dans SharePoint Designer 2013
Le type de variable de dictionnaire est un nouveau type de variable dans la plateforme de flux de travail SharePoint que vous pouvez utiliser avec SharePoint Designer 2013.
Remarque
Les flux de travail SharePoint 2010 ont été retirés depuis le 1er août 2020 pour les nouveaux locataires et retirés des locataires existants le 1er novembre 2020. Si vous utilisez des flux de travail SharePoint 2010, nous vous recommandons de migrer vers Power Automate ou d'autres solutions prises en charge. Pour plus d'informations, voir la retraite du flux de travail SharePoint 2010.
Présentation du type de variable de dictionnaire
Un flux de travail est une série d'actions qui effectuent un résultat désiré. À mesure que vous créez un flux de travail, vous devez souvent enregistrer des valeurs dans une variable (conteneur de stockage) à utiliser dans d'autres parties du flux de travail.
Lorsque vous créez une variable, vous devez indiquer le moteur de flux de travail à quel type de données se trouvera dans la variable. Par exemple, que vous souhaitez enregistrer le nom d'un employé dans une variable. Le nom d'un employé est une chaîne de caractères, vous créez une variable de type String. Le flux de travail peut ensuite stocker le nom de l'employé, tel que « Jean Dupont », dans la variable.
Figure : Variable de chaîne
SharePoint Designer 2013 a un nouveau type de variable appelé dictionnaire. Le type de variable de dictionnaire est un conteneur destiné à contenir une collection d'autres variables. Par exemple, votre flux de travail devront stocker plus que le nom de l'employé. Il peut également nécessaire stocker sa date de naissance et les adresses. Si vous n'utilisez pas la variable de dictionnaire que vous devrez créer plusieurs variables autonomes. Cela peut rapidement devenir difficile à organiser et difficile à utiliser dans la logique du flux de travail. Une variable de dictionnaire vous permet de stocker plusieurs points de données dans une seule variable.
La figure illustre le concept.
Figure : Variable de dictionnaire
Actions de flux de travail utilisant le type de variable de dictionnaire
Un flux de travail se compose de plusieurs actions qui sont exécutées lors du traitement du flux de travail. SharePoint Designer 2013 contient un large éventail d'actions. Par exemple, il est une action à envoyer un message électronique, créez un élément de liste et enregistrer les messages dans l'historique de flux de travail.
Voici les trois actions spécifiquement conçues pour le type de variable de dictionnaire.
Générer un dictionnaire
Nombre d'éléments dans un dictionnaire
Obtenir un élément à partir d'un dictionnaire
Les actions de flux de travail pour leVolet de tâchestype de variable sont accessibles dans la liste déroulante Action, comme illustré dans la figure.
Figure : Actions de dictionnaire
Créer des variables à l’aide de l’action « Générer un dictionnaire »
L'action de Génération de dictionnaire vous permet de créer une variable du type de dictionnaire. Vous permet d'entrer le contenu de dictionnaire et dans la liste des variables, indiquez le nom du dictionnaire.
La figure illustre la boîte de dialogue créer un dictionnaire. Notez que trois variables ont été ajoutés au dictionnaire : une chaîne, un entier et une date/heure.
Figure: « Créer un dictionnaire » la boîte de dialogue
Un dictionnaire peut contenir n’importe quel type de variable disponible dans la plateforme de flux de travail SharePoint. La liste suivante définit les types de variables disponibles :
Boolean: une valeur Oui ou non
Date/heure: date et heure
Dictionnaire: une collection de variables
GUID: un identificateur global Unique (GUID)
Nombre entier: un nombre entier sans décimales
Nombre: nombre qui peut contenir les décimales
Chaîne: une chaîne de caractères
Important : le type de variable Dictionnaire est critique lorsque vous utilisez l’action Appeler le service web HTTP.
Attention : l’utilisation du champ Nom en tant que liste de choix est prise en charge uniquement lorsque vous définissez une valeur dans un dictionnaire. À l'aide du champ nom comme une recherche n'est pas pris en charge lorsque vous créez un dictionnaire.
Remarque
[!REMARQUE] Une variable de dictionnaire peut contenir une variable du type de dictionnaire. La possibilité de stocker les variables de dictionnaire au sein d'un dictionnaire fournit un certain nombre d'avantages. Par exemple, vous pouvez créer un dictionnaire pour stocker les informations relatives aux employés. Dans le dictionnaire, vous pouvez créer une autre entrée du dictionnaire de chaque employé. À mesure que vous créez le flux de travail, vous pouvez utiliser la variable de dictionnaire au lieu de créer en permanence des nouvelles variables autonomes pour chacune des informations sur chaque employé. Comme le montre cet exemple, un dictionnaire peut être utilisé pour organiser les informations les plus complexes au sein du flux de travail.
Compter et stocker des variables avec l’action « Nombre d’éléments dans un dictionnaire »
L'action de Compter les éléments d'un dictionnaire vous permet de compter les variables qui contient un dictionnaire et d'enregistrer ce nombre dans une variable de type entier. Vous pouvez ensuite utiliser le nombre d'éléments en boucle par le biais du dictionnaire.
La figure illustre l'action de flux de travail de Compter les éléments d'un dictionnaire.
Figure : Nombre d'éléments dans un dictionnaire
Récupérer des variables avec l’action « Obtenir un élément à partir d’un dictionnaire »
Vous utilisez l'action d'obtenir un élément à partir d'un dictionnaire pour récupérer une variable stockée dans le dictionnaire et les placer dans une variable. Cette opération est utile lorsque vous avez besoin d'une valeur dans le dictionnaire stocké dans une variable autonome. Vous pouvez récupérer une valeur en entrant le nom de la variable.
La figure illustre l'action de flux de travail obtenir un élément à partir d'un dictionnaire. Notez que âge est le nom de la variable dans le dictionnaire et elle est en cours de sortie vers une nouvelle variable de type Integer.
Figure : Obtenir un élément à partir d'un dictionnaire
