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, desmarque 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 possuem um erro implícito são mostrados com um Ícone de erro. Este ícone não será exibido se o motivo da invalidade do componente for a presença de outros componentes com erros implícitos. Por exemplo, um workflow pode ser inválido por conter operações ou outros componentes inválidos, ou uma operação pode ser inválida por conter outros componentes inválidos, conforme mostrado abaixo:
Para exibir erros de validação para componentes identificados como implicitamente inválidos, clique no botão Í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 torna os componentes 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 utilizados 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:
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:
Os nomes de [Operação / Conexão / Atividade / Transformação / Script / E-Email / Variável] devem ser exclusivos.
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, tiver importado um projeto que contém componentes com nomes duplicados.
Se você receber um desses erros, verifique se atribuiu um nome exclusivo a cada componente do projeto e renomeie as duplicatas, quando necessário. Os links da 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, a seguinte mensagem de erro de validação será retornada:
A atividade não está configurada corretamente.
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 esta 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.
- Se a atividade estiver parcialmente configurada ou se a validação de campos individuais na 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 informações válidas.
Alguns conectores estão disponíveis e podem ser usados apenas 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, conexões e atividades criadas usando conectores exclusivos para agentes privados são inválidas, com a seguinte mensagem de erro:
O conector está disponível apenas em agentes privados.
As atividades podem estar sujeitas a regras de validação próprias e 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 facilmente determinado, esta mensagem de erro será retornada:
Atividade inválida.
Para resolver, consulte a documentação de 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:
O Script não está configurado corretamente.
Esta mensagem aparece mais comumente quando você adiciona um novo script a uma operação e ele está vazio. Para resolver, abra a tela de configuração de script e crie um script no editor.
Além disso, para que um Jitterbit Script para ser válido, não deve haver erros de validação no 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:
O Script é inválido.
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 conforme o esperado. Documentação adicional está disponível em Scripts.
Nota
Um JavaScript configurado pode ser implantado mesmo com erros de validação presentes.
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, a seguinte mensagem de erro de validação será retornada:
A Transformação não está configurada corretamente.
Esta mensagem aparece mais comumente quando você adiciona 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 transformação adequadamente.
Além disso, para que uma transformação seja válida, ela não deve conter erros de transformação. Para ser considerada válida, uma transformação deve atender às seguintes 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, determinados campos de destino podem exigir um mapeamento ou não permitir um mapeamento. Mapeamentos inválidos são indicados visualmente na tela de configuração da transformação (consulte Validade do mapeamento da Transformação).
Dependendo do erro, a variação apropriada dessas possíveis mensagens de erro é retornada se esta regra não for atendida:
Mapeamento refere-se a um campo [origem / destino / variável] $[caminho] inexistente.
Possível conflito de tipo de dados no mapeamento.
Campo de destino $[node.name] [deve ser mapeado / não pode ser mapeado].
Os mapeamentos de um nó de loop de destino dependem de mais de um nó de loop de origem.
O esquema [Origem / Destino] deve ser fornecido.
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 se 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. Esquemas de arquivo podem ser fornecidos 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:
A Transformação é inválida.
Para obter informações mais detalhadas, consulte Validade do mapeamento de Transformação, bem como páginas adicionais em Transformações.