Mapear uma matriz ou elemento de matriz
Uma matriz é um item do pacote que pode conter o seguinte:
- Um ou mais valores do mesmo tipo (matriz simples)
- Uma ou mais coleções do mesmo tipo (matriz complexa)
Exemplo:
- Matriz complexa: o módulo Watch emails retorna uma matriz de anexos para cada email. Cada anexo representa uma coleção que pode conter um nome, conteúdo, tamanho e assim por diante.
Requisitos de acesso
Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront pacote | Qualquer |
| Adobe Workfront licença |
Novo: Standard Ou Atual: Work ou superior |
| Adobe Workfront Fusion licença** |
Atual: nenhum requisito de licença Workfront Fusion. Ou Herdados: Qualquer um |
| Produto |
Novo:
Ou Atual: sua organização deve comprar o Adobe Workfront Fusion. |
Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.
Para obter informações sobre Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.
Mapear uma matriz inteira
-
Clique na guia Scenarios no painel esquerdo.
-
Selecione o cenário no qual deseja mapear uma matriz.
-
Clique em qualquer lugar no cenário para entrar no editor de cenários.
-
No módulo para o qual deseja mapear a matriz, clique no campo onde deseja mapear a matriz. Este é o campo para o qual a matriz está mapeada.
-
Na caixa exibida, mapeie o item.
O painel permite mapear campos da mesma forma que com qualquer outro tipo de item. Se você não quiser preencher cada item separadamente, mas quiser mapear outra matriz no campo de destino, use o botão Map. Nesse caso, verifique se ambos os storages (o storage de origem e o storage de destino) têm a mesma estrutura.
Você pode adicionar qualquer número de itens a uma matriz.
É possível dividir uma matriz em pacotes individuais usando um iterador. Para obter mais informações, consulte o módulo Iterator em Adobe Workfront Fusion.
Mapear itens em uma nova matriz
Alguns campos no Workfront Fusion permitem mapear elementos em uma matriz. Por exemplo, você pode criar uma matriz de itens de lista de verificação no módulo Workfront Boards > Adicionar item de lista de verificação. Quando o módulo é executado, todos os itens da lista de verificação são adicionados ao cartão.
Qualquer campo do módulo que exibe "Adicionar item" cria uma matriz.
Para adicionar elementos à matriz:
- Clique em Adicionar item
- No painel aberto, insira detalhes sobre o item.
- Clique em Adicionar.
- (Opcional) Repita as etapas 1 a 3 para cada elemento que você deseja adicionar à matriz .
Mapear elementos de matriz
Mapear elementos de matriz por número
Os elementos da matriz são exibidos como um número entre colchetes após o nome da matriz. Você pode mapear um elemento individual de uma matriz em um campo usando esse número de índice.
Para mapear um elemento de matriz:
-
Clique no campo onde deseja mapear o elemento.
O painel de mapeamento é aberto.
-
Localize a matriz que contém o elemento que você deseja mapear.
-
Clique na seta suspensa ao lado da matriz.
-
Clique no elemento que deseja mapear.
O elemento é mapeado, com o índice de 1. Isso mapeia o primeiro elemento na matriz.
-
Para mapear um elemento diferente da matriz, clique em [1] e insira o número de índice do elemento de matriz que você deseja mapear.
Mapear um elemento de matriz com uma determinada chave
Algumas matrizes contêm coleções com itens de valores-chave, como metadados, atributos e assim por diante. Para usar um desses valores, você pode pesquisar um elemento por seu valor de chave fornecido e obter o valor correspondente do item de valor. Recomendamos usar uma fórmula que empregue uma combinação das funções map() e get().
O exemplo a seguir mostra a saída do aplicativo Jira.
Este exemplo obtém um nome de arquivo de uma matriz de anexos, para o anexo específico com uma ID 10108.
Esse exemplo gera a seguinte saída:
A fórmula pode ser explicada da seguinte maneira:
-
map-
O primeiro parâmetro da função
map()é o item de matriz inteiro. -
O segundo parâmetro é o nome bruto do item de valor. Para obter o nome bruto, passe o mouse sobre o item no painel mapping:
note note NOTE Todos os parâmetros diferenciam maiúsculas de minúsculas. Mesmo que neste exemplo em particular o rótulo do item difira de seu nome bruto apenas em maiúsculas, é necessário usar o nome bruto. -
O terceiro parâmetro é o nome bruto do item-chave:
-
O quarto parâmetro é o valor de chave fornecido.
Como a função
map()retorna uma matriz (já que poderia haver mais elementos com o valor de chave fornecido), é necessário aplicar a funçãoget()para obter seu primeiro elemento: -
-
get-
O primeiro parâmetro da função
get()é o resultado da funçãomap(). -
O segundo parâmetro é o índice do elemento. Neste exemplo, o índice é
1.
-
Esse exemplo gera a seguinte saída:
Para obter mais informações sobre a função map(), consulte Funções de matriz.
Para obter mais informações sobre a função get(), consulte Funções gerais.
Converter elementos de matriz em uma série de pacotes
Matrizes podem ser convertidas em uma série de pacotes usando o módulo Iterator. Para obter mais informações, consulte Iterator módulo.
