Erros e regras de validação de componentes no Jitterbit Integration Studio

Introdução

Os componentes devem ser válidos para serem implantados. Esta página aborda como identificar componentes inválidos e visualizar os erros de validação associados a eles, bem como como resolver erros de validação.

Erros de validação

Esta seção aborda como identificar componentes de projeto inválidos e visualizar os erros de validação associados a componentes inválidos.

Para novos projetos, os itens inválidos são destacados por padrão na quadro de design, com a seleção padrão de Destacar Itens Inválidos. Para desativar esta opção, limpe esta seleção:

Quando Destacar itens inválidos é selecionado, os componentes inválidos são contornados com uma borda vermelha na quadro de design:

No painel do projeto, os nomes dos componentes inválidos também aparecem em itálico e na cor vermelha. Além disso, os componentes inválidos que têm um erro implícito são mostrados com um ícone de erro. Este ícone não é exibido se o motivo pelo qual o componente é inválido é que ele contém outros componentes com erros implícitos. Por exemplo, um workflow pode ser inválido porque contém operações ou outros componentes que são inválidos, ou uma operação pode ser inválida porque contém outros componentes que são inválidos, conforme mostrado abaixo:

Para exibir erros de validação para componentes identificados como implicitamente inválidos, clique no ícone de erro ao lado do nome do componente. Uma caixa de diálogo exibe os erros de validação do componente. Para obter informações detalhadas sobre o que faz com que os componentes sejam inválidos e como resolver erros de validação, consulte Regras de validação, próximo.

Regras de validação

Certas regras de validação devem ser seguidas para que os componentes do projeto sejam implantados na nuvem Harmony e para que as operações em que são usados sejam executadas em agentes Jitterbit. Essas regras garantem que todas as partes de um projeto sejam suportadas e esperadas pelo agente. As regras de validação para workflows e operações são abordadas nestas páginas:

• Validade do Workflow
• Validade da operação

As regras para outros componentes individuais do projeto são detalhadas a seguir.

Os nomes devem ser únicos

Os nomes de alguns tipos de componentes do projeto devem ser exclusivos para cada tipo de componente.

Dependendo de qual componente é inválido, a variação apropriada desta mensagem de erro é retornada se esta regra não for atendida:

[Operation / Connection / Activity / Transformation / Script / Email / Variable] names must be unique.

Ao criar um novo componente de projeto do zero, a validação de campo incluída na tela de configuração do componente não permitirá que você forneça o mesmo nome para vários componentes do projeto. No entanto, você pode receber esta mensagem de erro se, por exemplo, você tiver importado um projeto que contém componentes com nomes duplicados.

Se você receber um desses erros, verifique se você deu um nome exclusivo para cada componente do projeto e renomeie quaisquer duplicatas quando necessário. Os links de documentação para cada componente do projeto são fornecidos em Componentes do projeto página.

Os componentes do projeto devem ser válidos

As regras de validação dependem do tipo de componente.

Atividades

Para que uma atividade seja válida, ela deve ser configurada corretamente. Se uma atividade não tiver sido configurada ou estiver configurada incorretamente, esta mensagem de erro de validação será retornada:

Activity is not configured properly.

Esta mensagem aparece em alguns cenários comuns:

• Quando novas atividades são adicionadas a uma operação da paleta de componentes de design, elas ainda não estão configuradas, então você pode receber essa mensagem de erro se tiver adicionado uma nova atividade sem configurá-la ainda. Para resolver, abra a tela de configuração da atividade e configure a atividade.
• Se a atividade estiver parcialmente configurada, ou se a validação de campo individual dentro da configuração da atividade não tiver sido atendida, você também poderá receber esta mensagem de erro. Para resolver, abra a configuração da atividade e preencha todos os campos obrigatórios com uma entrada válida.

Alguns conectores estão disponíveis e podem ser usados somente em ambientes associados a um grupo de agentes privados. Embora novas conexões e atividades não possam ser criadas usando esses conectores em agentes de nuvem, é possível migrar ou importar projetos criados com esses conectores para um ambiente de agente de nuvem. Nessa situação, as conexões e atividades criadas usando conectores somente de agentes privados são inválidas, com esta mensagem de erro:

Connector is only available on private agents.

As atividades podem estar sujeitas às suas próprias regras de validação exclusivas, que são abordadas na documentação da atividade. Por exemplo, uma dessas atividades é a Atividade de reconhecimento para o RabbitMQ conector.

Se uma atividade for inválida por algum outro motivo que não possa ser prontamente determinado, esta mensagem de erro será retornada:

Activity is invalid.

Para resolver, consulte a documentação para cada atividade disponível em Conectores.

Scripts

Para que um script seja válido, ele deve ser configurado corretamente. Se um script não tiver sido configurado, esta mensagem de erro de validação será retornada:

Script is not configured properly.

Essa mensagem aparece mais comumente quando você adicionou um novo script a uma operação e ele está vazio. Para resolver, abra a tela de configuração de script e então crie um script no editor.

Além disso, para que um Jitterbit Script para ser válido, ele não deve ter nenhum erro de validação dentro do próprio script. Se um Jitterbit Script contém erros de validação, uma mensagem de erro de validação específica ou esta mensagem de erro de validação é retornada:

Script is invalid.

Para resolver, abra o editor de script e ver os erros do script. Também recomendamos testar o script para garantir que sua saída seja como esperado. Documentação adicional está disponível em Scripts.

Transformações

Para que uma transformação seja válida, ela deve ser configurada corretamente. Se uma transformação não tiver sido configurada ou estiver configurada incorretamente, esta mensagem de erro de validação será retornada:

Transformation is not configured properly.

Essa mensagem aparece mais comumente quando você adicionou uma nova transformação a uma operação e ela ainda não foi configurada. Para resolver, abra a tela de configuração da transformação e configure a transformação adequadamente.

Além disso, para que uma transformação seja válida, ela não deve ter nenhum erro de validação dentro da própria transformação. Para ser considerada válida, uma transformação deve atender a estas regras:

• Um mapeamento não pode conter referências a campos ou variáveis inexistentes.
• Um mapeamento não pode conter conflitos de tipo de dados.
• Um nó de loop de destino não pode ter múltiplas fontes.
• Um esquema deve ser fornecido para uma atividade de origem ou destino adjacente.

Além disso, certos campos de destino podem exigir um mapeamento ou podem não permitir um mapeamento. Mapeamentos inválidos são indicados visualmente na tela de configuração de transformação (consulte Validade do mapeamento de Transformação).

Dependendo do erro, a variação apropriada dessas possíveis mensagens de erro é retornada se esta regra não for atendida:

Mapping refers to a non-existent [source / target / variable] field $[path].

Potential data type conflict in mapping.

Target field $[node.name] [must be mapped / cannot be mapped].

Mappings of a target loop node depend on more than one source loop node.

[Source / Target] schema must be provided.

Para resolver, tente estas dicas de solução de problemas:

• Se você tiver referências a campos inexistentes, conflitos de tipo de dados ou outros mapeamentos inválidos, localize o mapeamento inválido e desmapeie-o ou verifique o esquema para garantir que todos os campos sejam contabilizados e tenham tipos de dados compatíveis. Se você tiver referências a variáveis inexistentes, verifique para garantir que a variável existe.
• Se você tiver um nó de loop de destino que depende de mais de um nó de loop de origem, siga as instruções fornecidas em Mapear de uma origem de múltiplas instâncias para um destino de instância única em Estruturas de dados.
• Se você tiver atividades de origem ou destino adjacentes à transformação, certifique-se de fornecer um esquema para cada uma delas. Esquemas de arquivo podem ser fornecidos de dentro da atividade durante sua configuração (veja a documentação de cada conector), ou por definir um esquema diretamente de dentro da transformação.

Além disso, se uma transformação for inválida por algum outro motivo que não possa ser facilmente determinado, esta mensagem de erro será retornada:

Transformation is invalid.

Para obter informações mais detalhadas, consulte Validade do mapeamento de Transformação, bem como páginas adicionais em Transformações.