Algumas partes da página podem ter sido traduzidas automaticamente.

Utilitários do Bridge: Array Management (Gerenciamento de matrizes)

Gerenciamento de matrizes para manipulação de dados sob medida.

Quem pode usar isso?

Planos:

  • Bridge by Smartsheet

Ao acessar uma API externa, os dados geralmente precisam ser filtrados ou estruturados conforme desejado. Talvez seja necessário adicionar, remover, classificar ou manipular os dados. Com as funções de gerenciamento de matrizes, você pode personalizar os dados para atender às suas necessidades sem escrever código ou modificar o serviço de back-end.

Módulos de gerenciamento de matriz

Nas descrições abaixo, palavras em negrito indicam campos nos módulos.

Em caso de dúvida sobre um campo em um módulo, passe o mouse sobre o ponto de interrogação ao lado do campo e você terá uma breve descrição da função do campo.

Add Object To Array (Adicionar objeto à matriz)

Ele permite que você acrescente um novo objeto inserido a uma matriz existente. Isso é particularmente útil ao criar ou modificar matrizes dinamicamente durante a execução do fluxo de trabalho.

Certifique-se de que a matriz à qual você está adicionando esteja estruturada como uma matriz de objetos, pois esse módulo se destina a matrizes de objetos, não a listas simples ou matrizes de valores.

Delete From Array (Excluir da matriz)

Remover uma entrada especificada de uma matriz. A entrada define qual objeto ou entrada deve ser removido, com a primeira entrada sendo 1, a segunda sendo 2 e continuando sequencialmente.

Para outros utilitários de matriz, a primeira entrada é 0, a segunda é 2 e assim por diante.

Extract Field From Array (Extrair campo da matriz)

Extraia uma chave específica de uma matriz, com uma matriz ou um CSV como saída. Use esse módulo ao criar uma lista simplificada a partir de estruturas de dados complexas, como gerar opções suspensas ou preparar dados para processamento adicional.

Certifique-se de que a chave inserida corresponda à chave contida na matriz selecionada.

Offset Array (Compensar matriz)

Recupere um subconjunto de dados de uma matriz existente, começando em um deslocamento especificado. Você deve selecionar o Trim Size, que é o tamanho da matriz resultante.

Por exemplo, se a matriz original tiver dez entradas, o Trim Size for definido como 4 e o Offset for definido como 3, a matriz resultante consistirá nas entradas 3 a 6 da matriz original. 

O deslocamento é baseado em zero, o que significa que um deslocamento de 0 se refere ao primeiro elemento na matriz.

Pick From Array (Escolher da matriz)

Permite que você recupere uma entrada aleatória de uma matriz para usar em outro lugar. 

Size/Length (Tamanho/comprimento)

Retorna o número de entradas nos dados definidos. Esse módulo é prático quando você precisa avaliar o tamanho de um conjunto de dados para iterações ou lógica condicional em seus fluxos de trabalho.

Sort Object Array (Classificar matriz por objeto)

Permite que você classifique uma matriz pelo valor de qualquer campo na estrutura do objeto de uma matriz. Você deve especificar o campo de classificação, que define o objeto pelo qual classificar, e a ordem de classificação, que é crescente ou decrescente.

 Esteja ciente de que o módulo pode ter limitações ao lidar com matrizes que contêm objetos aninhados. Nesses casos, a classificação pode não funcionar conforme o esperado.

Trim Array (Reduzir matriz)

Ele permite reduzir uma matriz a um número específico de itens. Você deve especificar o Trim Size, que é o tamanho da matriz resultante.

O módulo retém itens desde o início da matriz. Se você precisar de itens específicos, considere classificar a matriz com antecedência.