Aplica-se a
Utilitários do Bridge: Array Management (Gerenciamento de matrizes)
Gerenciamento de matrizes para manipulação de dados sob medida.
Muitas vezes, ao acessar uma API externa, os dados não são filtrados ou estruturados da maneira que você deseja usá-los. Pode ser necessário adicionar, remover, classificar ou manipular os dados. Com as funções do Array Management (Gerenciamento de matrizes), você pode personalizar os dados para atender às suas necessidades, sem precisar escrever seu próprio código ou modificar o serviço de back-end.
Add Object To Array (Adicionar objeto à matriz)
Possibilita que você adicione mais um registro a uma matriz. O utilitário Add Object To Array (Adicionar objeto à matriz) exige o preenchimento dos seguintes campos:
- Array (Matriz): referência à matriz existente.
- Object (Objeto): o objeto que você deseja adicionar à matriz:
- Key #1 (1ª chave): o rótulo do objeto a ser adicionado.
- Value #1 (1º valor): o valor do objeto a ser adicionado.
Esse utilitário não pode ser usado para simplesmente adicionar entradas a uma lista em uma matriz.
Delete From Array (Excluir da matriz)
Permite que você exclua um registro específico de uma matriz. O utilitário Delete From Array (Excluir da matriz) exige o preenchimento dos seguintes campos:
- Array (Matriz): referência à matriz existente.
- Entry (Entrada): qual objeto ou entrada deve ser removida, sendo que a primeira entrada é 1.
Para os outros utilitários da matriz, a primeira entrada é 0.
Extract Field From Array (Extrair campo da matriz)
Extraia um campo específico da matriz como Array ou CSV. O utilitário Extract Field From Array (Extrair campo da matriz) exige o preenchimento dos seguintes campos:
- Array (Matriz): referência à matriz existente.
- Key (Chave): o nome do campo a ser extraído.
- Output (Saída): formato do resultado da saída.
A imagem abaixo mostra a matriz sendo extraída da esquerda e o resultado da extração do campo Type (Tipo), retornado como uma matriz.
![Array Management utilities examples](https://cdn.bfldr.com/NB5M6M91/at/xjff9nftq38r2g5hppcb4/Add_object_to_array_example.jpg)
Offset Array (Compensar matriz)
Permite recuperar um conjunto de dados da matriz, deliberadamente compensados por uma dada quantidade. É muito útil quando a API da qual você está acessando os dados não oferece suporte à paginação de dados. O utilitário Offset Array (Compensar matriz) exige o preenchimento dos seguintes campos:
- Array (Matriz): referência à matriz existente.
- Trim Size (Tamanho reduzido): o tamanho da matriz resultante.
- Offset (Compensação): a entrada na matriz referenciada a partir da qual começar.
Por exemplo, se a matriz original tiver 10 entradas e se Trim Size (Tamanho reduzido) estiver definido como 4 e Offset (Compensação) como 3, a matriz resultante consistirá nas entradas 3 a 6 da matriz original.
Pick From Array (Escolher da matriz)
Permite que você recupere uma entrada aleatória da matriz para usar em outro lugar. O utilitário Pick From Array (Escolher da matriz) exige o preenchimento dos seguintes campos:
- Array (Matriz): referência à matriz da qual se deve escolher uma entrada.
Size/Length (Tamanho/comprimento)
Retorna o tamanho (número de entradas) de uma matriz. O utilitário Pick From Array (Escolher da matriz) exige o preenchimento dos seguintes campos:
- Data (Dados): referência à matriz da qual se deve obter o comprimento.
Sort Object Array (Classificar matriz por objeto)
Permite classificar a matriz pelo valor de qualquer campo na estrutura do objeto de uma matriz. O utilitário Sort Object Array (Classificar matriz por objeto) exige o preenchimento dos seguintes campos:
- Array (Matriz): referência à matriz para classificação.
- Sort Field (Campo de classificação): objeto que deve ser usado para a classificação.
- Sort Order (Ordem de classificação): opção de classificar em ordem crescente ou decrescente.
A imagem abaixo mostra a matriz a ser classificada à esquerda e a matriz retornada com ordem de classificação crescente selecionada à direita.
![Array Management utilities examples](https://cdn.bfldr.com/NB5M6M91/at/7xfsgpkvcsct33x9kcgn5wq/sort_object_array_example.jpg)
Trim Array (Reduzir matriz)
Permite reduzir a matriz a um número específico de itens. O utilitário Trim Array (Reduzir matriz) exige o preenchimento dos seguintes campos:
- Array (Matriz): referência à matriz que será reduzida.
- Trim Size (Tamanho reduzido): tamanho/comprimento (número de entradas) da matriz resultante.