Tipos de dados de item

Ao construir cenários, você trabalha com diferentes tipos de dados, de texto e números simples a elementos mais complexos, como coleções e arrays. Entender esses tipos é essencial porque cada campo nas configurações do módulo aceita um formato específico de informação que você pode inserir ou mapear no campo.

Definir o tipo de dados correto é importante para realizar operações com seus dados. Por exemplo, funções matemáticas exigem o tipo de dados número, enquanto operações de texto precisam do tipo de dados texto.

Validação de dados

O Make valida os dados que você fornece para garantir que eles atendam ao formato esperado do campo e a quaisquer restrições adicionais. Se você inserir ou mapear um tipo de dados inválido, o módulo interromperá o processamento e retornará um DataError.

Erros de validação comuns ocorrem quando:

Um campo espera um número, mas recebe texto como “100 units”.
Você tenta mapear uma coleção como {“name”: “John”, “age”: “30”, “city”: “London”} em um campo que espera texto simples.
Um campo de data recebe uma string formatada incorretamente.

Conversão de dados

O Make automaticamente força (ou seja, converte) certos tipos de dados quando possível. Isso ajuda seu cenário a continuar em execução mesmo quando os tipos de dados não correspondem perfeitamente (quando há pequenas incompatibilidades de tipo). Por exemplo:

Um tipo de dados booleano mapeado para o campo de texto será convertido para o texto "true" ou "false".
Um tipo de dados número mapeado para o campo de texto será convertido para texto.

Saiba mais sobre a coerção de tipos suportada aqui.

No entanto, em alguns casos, essa coerção pode produzir saídas inesperadas, o que pode causar erros mais adiante no cenário. Se a coerção não for possível, o Make também retornará um erro de validação. Assim, para evitar tais erros e garantir a execução correta do cenário, use o tipo de dados correto desde o início.

Tipos de dados

Você pode identificar o tipo de dados de um campo passando o mouse sobre o nome do campo ou sobre o valor mapeado. O Make suporta os seguintes tipos de dados:

Text
Number
Boolean
Date and time
Buffer (binary) data
Collection
Array

Texto

O tipo de dados text (também chamado de string) contém letras, números e caracteres especiais (@ ? !). Ele pode representar nomes, e-mails, endereços, descrições de produtos, prompts e outros textos mais longos. O Make valida o texto para garantir que ele atenda a quaisquer requisitos de comprimento.

Você pode inserir texto manualmente ou mapeá-lo.

Número

O tipo de dados number contém caracteres numéricos. Números podem representar quantidades, preços, números de telefone, idades, medidas e cálculos. Se você não definir seus números como números em alguns módulos, eles podem ser considerados um tipo de dados texto.

O Make valida alguns campos numéricos para intervalos específicos (valores mínimo ou máximo permitidos).

Você pode inserir os dados numéricos nos campos correspondentes manualmente ou mapeá-los.

Boolean (Yes/No)

O tipo de dados Boolean é usado para itens com apenas dois valores possíveis: true ou false. No Make, normalmente é uma opção sim ou não.

Você também pode mapear o tipo de dados Boolean.

Data e hora

Um tipo de dados date é usado para datas ou data+hora. Quando você clica em um campo de data, um calendário pop-up aparece nas configurações do módulo. O formato da data e hora depende do fuso horário especificado em suas Profile settings (Web section > Time zone options).

Você pode inserir a data manualmente, defini-la a partir do calendário ou mapeá-la.

Como os valores de data são exibidos no Make

Em pacotes de saída, os valores de data e hora são exibidos com base no locale e no fuso horário especificado em suas Profile settings (Web section > Time zone options).

Você também pode visualizar o valor de um item de data no formato ISO 8601 passando o mouse sobre o item. Este é o formato usado ao passar os valores de data pela API para outros serviços.

Se o valor ISO não aparecer, o item não é uma data, mas provavelmente texto.

Buffer (binary data)

O conteúdo de arquivo geralmente é enviado como um tipo Buffer (conteúdo de imagem, arquivo de vídeo, etc.). Em alguns casos, há dados de texto incluídos neste tipo (por exemplo, um arquivo de texto). O Make é capaz de converter automaticamente dados de texto em código binário para texto (e vice-versa).

Por exemplo, quando você deseja incluir um arquivo como anexo em seu e-mail, o campo Data esperará um tipo de dados buffer. Você pode mapeá-lo de outros módulos.

Para obter mais informações sobre arquivos, consulte o artigo Trabalhando com arquivos.

Collection

Uma collection é um item que consiste em vários subitens, representados como pares chave-valor (por exemplo, "Product": "Dress", "Quantity": "5"). Por exemplo, você pode definir esses pares chave-valor ao criar uma string JSON no módulo Create JSON.

Isso criará uma collection.

Array

Um array é uma lista de itens. Esses itens podem ser valores simples como números, booleanos e strings (texto), ou datas, ou coleções. Por exemplo, você pode adicionar uma string JSON e então mapear o array para o campo Array do módulo Iterator.

Você verá esse array de coleções na entrada.

Para obter mais informações sobre arrays, consulte: