Información sobre acciones del diccionario en SharePoint Designer 2013
Dictionary es un nuevo tipo de variable de la plataforma de flujos de trabajo de SharePoint que puede usar con SharePoint Designer 2013.
Nota:
Los flujos de trabajo de SharePoint 2010 se han retirado desde el 1 de agosto de 2020 para los nuevos espacios empresariales y se han quitado de los espacios empresariales existentes el 1 de noviembre de 2020. Si está usando los flujos de trabajo de SharePoint 2010, le recomendamos que migre a Power Automate u otras soluciones compatibles. Para obtener más información, consulte Retirada del flujo de trabajo de SharePoint 2010.
Introducción al tipo de variable Dictionary
Un flujo de trabajo es una serie de acciones que conducen a un resultado deseado. Durante la creación de un flujo de trabajo suele ser necesario guardar valores en una variable (contenedor de almacenamiento) para usarlos en otras partes del flujo de trabajo.
Cuando se crea una variable, debe indicar al motor de flujos de trabajo qué tipo de datos contendrá la variable. Por ejemplo, quizás quiera guardar el nombre de un empleado en una variable. El nombre de un empleado es una cadena de caracteres por lo que crearía una variable del tipo String. Después, el flujo de trabajo puede guardar en la variable el nombre del empleado, por ejemplo, "Arturo López".
Figura: Una variable String
SharePoint Designer 2013 tiene un nuevo tipo de variable denominado Dictionary. El tipo de variable Dictionary es un contenedor diseñado para guardar una colección de otras variables. Por ejemplo, es posible que el flujo de trabajo necesite almacenar algo más que el nombre del empleado. Quizás también necesite almacenar su dirección y la fecha de nacimiento. Si no usa la variable Dictionary, tendrá que crear varias variables independientes. En la lógica del flujo de trabajo, puede resultar difícil organizar y trabajar con esto. Una variable Dictionary permite almacenar varios puntos de datos en una única variable.
La figura ilustra el concepto.
Figura: Una variable Dictionary
Acciones de flujo de trabajo que usan el tipo de variable Dictionary
Un flujo de trabajo consiste en varias acciones que se ejecutan a medida que se procesa. SharePoint Designer 2013 contiene muchas acciones diferentes. Por ejemplo, hay una acción para enviar un mensaje de correo electrónico, crear un elemento de lista y registrar mensajes en el historial del flujo de trabajo.
Las siguientes son las tres acciones diseñadas específicamente para el tipo de variable Dictionary.
Crear una variable Dictionary
Contar elementos en un diccionario
Obtener un elemento de una variable Dictionary
Las acciones de flujo de trabajo para el tipo de variableDictionaryse encuentran en la lista desplegable Acción, tal y como muestra la figura.
Figura: Acciones de Dictionary
Crear variables con la acción "Crear una variable Dictionary"
La acción Crear una variable Dictionary se usa para crear una variable del tipo Dictionary. Inserte el contenido del diccionario y, después, especifique el nombre del diccionario en la lista de variables.
La figura muestra el cuadro de diálogo Crear una variable Dictionary. Observe que se han agregado tres variables al diccionario: String, Integer y Date/Time.
Figura: Cuadro de diálogo "Crear una variable Dictionary"
Una variable Dictionary puede contener cualquier tipo de variable disponible en la plataforma SharePoint Workflow. La lista siguiente define los tipos de variables disponibles:
Boolean: valor Sí o No
Date/Time: fecha y hora
Dictionary: colección de variables
Guid: identificador único global (GUID)
Integer: número entero sin decimales
Number: número que puede contener decimales
String: cadena de caracteres
Importante: el tipo de variable Dictionary resulta esencial cuando se usa la acción Llamar al servicio web HTTP.
Precaución: el uso del campo Nombre como consulta solo se admite cuando se establece un valor en un diccionario. El uso del campo Nombre como consulta no se admite cuando se compila un diccionario.
Nota:
[!NOTA] Una variable Dictionary puede contener una variable del tipo Dictionary. La capacidad de almacenar variables Dictionary dentro de una variable Dictionary aporta numerosas ventajas. Por ejemplo, podría crear una variable Dictionary para almacenar información sobre los empleados. Dentro de esa variable Dictionary podría crear otra entrada Dictionary para cada empleado. Durante la creación del flujo de trabajo, puede usar la variable Dictionary en lugar de tener que crear constantemente nuevas variables independientes para cada pieza de información sobre cada empleado. Como se muestra en este ejemplo, se puede usar una variable Dictionary para organizar información compleja dentro del flujo de trabajo.
Contar y almacenar variables con la acción "Contar elementos en una variable Dictionary"
La acción Contar elementos en una variable Dictionary se usa para contar las variables que contiene una variable Dictionary y, después, almacenar ese número en una variable Integer. El recuento de elementos se puede usar para recorrer la variable Dictionary cíclicamente.
La figura muestra la acción del flujo de trabajo Contar elementos en una variable Dictionary.
Figura: Contar elementos en una variable Dictionary
Recuperar variables con la acción "Obtener un elemento de una variable Dictionary"
La acción Obtener un elemento de una variable Dictionary se usa para recuperar una variable almacenada en la variable Dictionary y colocarla en una variable. Esto resulta útil cuando se necesita almacenar un valor del diccionario en una variable independiente. Para recuperar el valor, especifique el nombre de la variable.
La figura muestra la acción de flujo de trabajo Obtener un elemento de una variable Dictionary. Observe que Age es el nombre de la variable en Dictionary y que se está enviando a una nueva variable Integer.
Figura: Obtener un elemento de una variable Dictionary
