Ir para o conteúdo

Regeneração de esquemas no Jitterbit Integration Studio

Introdução

Os esquemas são gerados de duas maneiras. Dependendo do conector específico utilizado, seus esquemas são gerados pelo conector ou definidos pelo usuário:

  • Gerados pelo conector: Esquemas gerados pelo conector são fixos no conector ou são gerados diretamente do endpoint.

  • Definidos pelo usuário: Esquemas definidos pelo usuário são fornecidos pelo usuário, seja criando um esquema personalizado, fazendo o upload de um arquivo ou URL, ou inserindo manualmente o esquema.

Esta página fornece informações sobre a regeneração de esquemas para ambos os tipos de esquema.

Esquemas gerados pelo conector

Um esquema gerado pelo conector (em contraste com um esquema definido pelo usuário) é fixo no conector ou o conector interage com esse endpoint com base na configuração do usuário usando os metadados fornecidos pela API do endpoint correspondente.

Uma vez que um esquema gerado pelo conector é configurado, o Integration Studio armazena os esquemas dentro do projeto para facilitar um carregamento mais rápido durante o design do projeto.

Se houver alterações externas em um esquema sendo gerado a partir de um endpoint, você deve regenerar o esquema dentro do Integration Studio para usar essas alterações no projeto. Isso pode ser necessário se, por exemplo, você adicionou um campo personalizado ou se você atualizou sua instância para usar uma versão mais recente da API.

Dependendo do endpoint, existem duas maneiras de regenerar esquemas:

Quando um esquema gerado a partir de um endpoint é atualizado, o Integration Studio utiliza a API fornecida pelo endpoint para regenerar o esquema para essa atividade.

Quando um esquema que está fixo em um conector é atualizado, o esquema atual incluído com o conector é recarregado, efetivamente atualizando o esquema.

Regenerar ou atualizar um esquema a partir de uma atividade ou transformação atualiza o esquema em todos os locais onde ele é referenciado. Ou seja, se você tiver referenciado várias cópias da mesma atividade em diferentes lugares ao longo do projeto, atualizar o esquema na configuração da atividade ou avançar pelos passos de configuração da atividade em um lugar atualiza-o para todos. Da mesma forma, se você atualizar um esquema em uma transformação, essa ação o atualiza na atividade e em todos os lugares dentro do projeto onde a mesma atividade é referenciada.

Se um esquema tiver alterações no sistema do endpoint, mas você ainda não tiver regenerado o esquema nem na atividade nem na transformação, a operação pode ou não ser bem-sucedida. Isso depende de uma variedade de fatores, como o endpoint individual, os campos individuais que estão mapeados na transformação e se esses campos mudaram dentro do esquema. Por exemplo, em um cenário onde um campo obrigatório no esquema original é posteriormente removido no esquema atualizado, erros do sistema do endpoint provavelmente serão relatados em tempo de execução. No entanto, se um campo foi removido, mas é opcional no mapeamento, os erros podem não ser relatados.

Regeneração de esquema de atividade

Para regenerar um esquema gerado por um conector a partir de uma tela de configuração de atividade (exceto para esquemas fornecidos por Database, NetSuite, Salesforce, Salesforce Service Cloud ou ServiceMax activities), na etapa Data Schema, clique em Refresh:

ServiceNow criar etapa 2 atualização do esquema de dados

Para regenerar um esquema gerado por conector a partir de uma tela de configuração de atividade (incluindo esquemas fornecidos por Banco de Dados, NetSuite, Salesforce, Salesforce Service Cloud e atividades do ServiceMax), abra a configuração da atividade e avance por cada etapa de configuração da atividade. É necessário fazer pelo menos uma alteração (como adicionar e remover um caractere do final do nome da atividade) na configuração para forçar uma atualização do esquema na etapa Esquema de Dados:

inserir banco de dados etapa 1 selecionar tabela próximo

inserir banco de dados etapa 2 esquema de dados concluído

Regeneração do esquema de transformação

Para regenerar um esquema gerado por conector a partir de uma transformação (exceto para esquemas fornecidos por Banco de Dados, Salesforce, Salesforce Service Cloud ou atividades do ServiceMax), clique em Atualizar Esquema:

menu de ações do esquema de destino atualizar esquema

Esquemas definidos pelo usuário

Um esquema definido pelo usuário (em contraste com um esquema gerado por conector) refere-se a um endpoint cujos esquemas são fornecidos pelo usuário, seja criando um esquema personalizado, fazendo o upload de um arquivo ou URL, ou inserindo manualmente o esquema.

Mudanças em esquemas definidos pelo usuário são propagadas automaticamente para todas as referências de esquema. Ao abrir um esquema que é referenciado por múltiplos componentes, um diálogo exibe uma lista de quaisquer componentes que referenciam o esquema e que serão afetados por quaisquer mudanças:

Texto do diálogo

Esquema usado por múltiplos componentes
Este esquema é usado por múltiplos componentes. Quaisquer mudanças feitas nele podem afetar a validade desses componentes:

  • Componente 1

  • Componente 2

Se você não quiser que as mudanças sejam propagadas por todos os locais onde o esquema é referenciado, deve primeiro editar a configuração desses componentes para remover ou substituir a referência ao esquema.

Projetos anteriores a 10.33.2

Esquemas definidos pelo usuário referenciados por múltiplas transformações em projetos criados antes da versão 10.33.2 do Harmony são automaticamente renomeados usando esta convenção de nomenclatura:

<Nome do Esquema Original>_<Nome da Transformação>_<Fonte ou Destino>

A convenção de nomenclatura consiste nos seguintes componentes:

  • Nome do Esquema Original: O nome original do esquema antes de 10.33.2.
  • Nome da Transformação: O nome da transformação na qual o esquema é referenciado.
  • Fonte ou Destino: Se o esquema é usado no lado da fonte ou do destino da transformação.