Noções básicas sobre ações de dicionário do SharePoint Designer 2013
O tipo de variável Dicionário é um novo na plataforma do Fluxo de Trabalho do SharePoint que você pode usar com o SharePoint Designer 2013.
Observação
Os fluxos de trabalho do Microsoft Office SharePoint Online 2010 foram desativados desde 1º de agosto de 2020 para novos locatários e removidos de locatários existentes em 1º de novembro de 2020. Se você estiver usando fluxos de trabalho do Microsoft Office SharePoint Online 2010, recomendamos a migração para o Power Automate ou outras soluções suportadas. Para mais informações, confira a Retirada do fluxo de trabalho do Microsoft Office SharePoint Online 2010.
Entender o tipo de variável Dicionário
Um fluxo de trabalho é uma série de ações que executam um resultado desejado. Criar um fluxo de trabalho que geralmente, você precisa salvar valores em uma variável (contêiner de armazenamento) para usar em outras partes do fluxo de trabalho.
Quando você cria uma variável que você precisa saber o mecanismo de fluxo de trabalho que tipo de dados que vai ser contido na variável. Por exemplo, convém salvar o nome de um funcionário em uma variável. O nome de um funcionário é uma cadeia de caracteres, portanto você criará uma variável do tipo String. O fluxo de trabalho, em seguida, poderia armazenar o nome do funcionário, como "John Doe" na variável.
Figura: Uma variável de cadeia de caracteres
SharePoint Designer 2013 tem um novo tipo de variável chamado dicionário. O tipo de dicionário variável é um contêiner projetado para armazenar uma coleção de outras variáveis. Por exemplo, o fluxo de trabalho pode precisar armazenar mais do que apenas o nome do funcionário. Ele também pode precisar armazenar sua data de nascimento e de endereço. Se você não usar a variável de dicionário que você precisará criar várias variáveis autônomos. Isso rapidamente pode se tornar difícil organizar e difícil manuseio de lógica do fluxo de trabalho. Uma variável de dicionário permite que você armazene vários pontos de dados em uma única variável.
A figura ilustra o conceito.
Figura: Uma variável de dicionário
Ações de fluxo de trabalho que usam o tipo de variável Dicionário
Um fluxo de trabalho consiste em várias ações que serão executadas como o fluxo de trabalho é processado. SharePoint Designer 2013 contém várias ações diferentes. Por exemplo, há uma ação para enviar uma mensagem de email, criar um item de lista e registrar mensagens de histórico de fluxo de trabalho.
Estas são as três ações projetadas especificamente para o tipo de dicionário de variável.
Criar um dicionário
Count items in a Dictionary.
Get an item from a Dictionary.
As ações de fluxo de trabalho para oDictionarytipo de variável pode ser encontrado na lista suspensa ação, conforme mostrado na figura.
Figura: Ações de dicionário
Criar variáveis com a ação "Criar dicionário"
Você pode usar a ação de Compilação de dicionário para criar uma variável de tipo de dicionário. Você pode inserir o conteúdo do dicionário e, em seguida, especifique o nome do dicionário da lista de variáveis.
A figura mostra a caixa de diálogo criar um dicionário. Observe que três variáveis foram adicionadas ao dicionário: uma cadeia de caracteres, um inteiro e uma data/hora.
Figura: "Criar um dicionário" caixa de diálogo
Um Dicionário pode conter qualquer tipo de variável disponível na plataforma de Fluxo de Trabalho do SharePoint. A lista a seguir define os tipos de variável disponíveis:
Boolean: um valor Sim ou não
Data/hora: data e hora
Dicionário: um conjunto de variáveis
GUID: um identificador global exclusivo (GUID)
Integer: um número inteiro sem casas decimais
Número: um número que pode conter decimais
Cadeia de caracteres: uma cadeia de caracteres
Importante: o tipo de variável Dicionário é fundamental quando você está usando a ação Chamar o Serviço Web HTTP.
Cuidado: o uso do campo Nome como uma pesquisa só tem suporte quando você define um valor em um dicionário. Usando o campo nome como uma pesquisa não é suportado quando você estiver criando um dicionário.
Observação
[!OBSERVAçãO] Uma variável de dicionário pode conter uma variável de tipo de dicionário. A capacidade de armazenar variáveis de dicionário dentro de um dicionário oferece vários benefícios. Por exemplo, você pode criar um dicionário para armazenar informações sobre funcionários. Dentro do dicionário, você pode criar outra entrada do dicionário para cada funcionário. Enquanto você cria o fluxo de trabalho, você pode usar a variável de dicionário ao invés de criar constantemente novas variáveis autônomos para cada parte das informações sobre cada funcionário. Conforme mostrado neste exemplo, um dicionário pode ser usado para organizar informações complexas dentro do fluxo de trabalho.
Contar e armazenar variáveis com a ação "Contar Itens em um Dicionário"
Você pode usar a ação de Contagem de itens de um dicionário para contar as variáveis que contém um dicionário e, em seguida, armazene esse número em uma variável de inteiro. Em seguida, você pode usar a contagem de itens para percorrer o dicionário.
A figura mostra a ação de fluxo de trabalho de Contagem de itens em um dicionário.
Figura: Contar os itens em um dicionário
Recuperar variáveis com a ação "Obter um Item de um Dicionário"
Você pode usar a ação de obter um Item de um dicionário para recuperar uma variável armazenada no dicionário e colocá-lo em uma variável. Isso é útil quando você precisa de um valor no dicionário armazenado em uma variável autônoma. Você pode recuperar um valor inserindo o nome da variável.
A figura mostra a ação de obter um Item de um dicionário de fluxo de trabalho. Observe que a idade é o nome da variável no dicionário e ele está sendo a saída para uma nova variável de inteiro.
Figura: Obter um item de um dicionário