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 é fixo no conector ou utiliza metadados da API do endpoint correspondente. Isso difere de um esquema definido pelo usuário.

Quando você configura um esquema gerado pelo conector, o Integration Studio armazena os esquemas dentro do projeto. Esse armazenamento permite um carregamento mais rápido durante o design do projeto.

Se ocorrerem mudanças externas em um esquema que é gerado a partir de um endpoint, você deve regenerar o esquema dentro do Integration Studio para usar essas mudanças no projeto. Você pode precisar regenerar esquemas nas seguintes situações:

  • Você adicionou um campo personalizado ao endpoint.
  • Você atualizou sua instância para usar uma versão mais recente da API.

Você pode regenerar esquemas de duas maneiras, dependendo do endpoint:

Quando o Integration Studio atualiza um esquema que está fixo em um conector, o esquema atual incluído com o conector é recarregado. Esse processo efetivamente atualiza o esquema.

Quando você regenera ou atualiza um esquema a partir de uma atividade ou transformação, o Integration Studio atualiza o esquema em todos os locais onde ele é referenciado. Por exemplo, 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 passar pelas etapas de configuração da atividade em um lugar atualiza-o para todos os locais. Da mesma forma, se você atualizar um esquema em uma transformação, essa ação o atualizará 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 ter sucesso ou falhar. O sucesso depende de vários fatores, incluindo o endpoint individual, os campos individuais que estão mapeados na transformação e se esses campos mudaram dentro do esquema. Por exemplo, se um campo obrigatório no esquema original for removido no esquema atualizado, o sistema do endpoint provavelmente relatará erros em tempo de execução. No entanto, se um campo foi removido, mas é opcional no mapeamento, o sistema pode não relatar erros.

Regeneração de esquema de atividade

O método para regenerar esquemas depende de qual conector você está usando:

Atualização direta (a maioria dos conectores)

Para atualizar diretamente um esquema, complete estas etapas:

Nota

Você não pode usar esta opção para esquemas fornecidos por Database, NetSuite, Salesforce, Salesforce Service Cloud ou ServiceMax activities. Em vez disso, reconfigure a atividade.

  1. Abra a configuração da atividade.
  2. Vá para a etapa Data Schema (a última etapa).

  3. Clique em Refresh:

    ServiceNow create step 2 data schema refresh

Reconfigurar atividade (todos os conectores)

Para reconfigurar uma atividade, complete estas etapas:

  1. Abra a configuração da atividade.
  2. Passe por cada etapa de configuração.
  3. Faça pelo menos uma alteração para forçar uma atualização do esquema. Por exemplo, você pode adicionar ou remover um caractere do nome da atividade.

  4. O esquema será atualizado automaticamente na etapa Data Schema.

    database insert step 1 select table next

    database insert step 2 data schema finished

Regeneração de esquema de transformação

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

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.

As alterações nos 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 alterações:

Texto do diálogo

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

  • Componente 1

  • Componente 2

Se você não quiser que as alterações sejam propagadas em 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 à 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 Original do Esquema>_<Nome da Transformação>_<Fonte ou Destino>

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

  • Nome Original do Esquema: O nome original do esquema antes da 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.