Ir para o conteúdo

Regeneração do Esquema

Introdução

Os esquemas são gerados de duas maneiras. Dependendo do conector específico que está sendo usado, seus esquemas são gerados pelo conector ou definido pelo usuário:

  • gerado pelo conector: Os esquemas gerados pelo conector são fixados no conector ou são gerados diretamente do endpoint.

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

Esta página fornece informações sobre a regeneração de esquemas para esses dois 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.

Depois que um esquema gerado pelo conector é configurado, o Cloud Studio armazena os esquemas no projeto para facilitar o 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ê deverá gerar novamente o esquema no Cloud Studio para usar essas alterações no projeto. Isso pode ser necessário se, por exemplo, você tiver adicionado um campo personalizado ou se tiver atualizado sua instância para usar uma versão de API posterior.

Dependendo do endpoint, há duas maneiras de regenerar esquemas:

Quando um esquema gerado a partir de um endpoint é atualizado, o Cloud Studio usa a API fornecida pelo endpoint para regenerar o esquema dessa atividade.

Quando um esquema que é corrigido em um conector é atualizado, o esquema atual incluído no conector é recarregado, atualizando efetivamente o esquema.

Regenerar ou atualizar um esquema de uma atividade ou transformação atualiza o esquema em todos os locais onde ele é referenciado. Ou seja, se você fez referência a várias cópias da mesma atividade em locais diferentes ao longo do projeto, atualizar o esquema na configuração da atividade ou avançar pelas etapas de configuração da atividade em um local o atualiza para todos. Da mesma forma, se você atualizar um esquema em uma transformação, essa ação o atualizará na atividade e em todos os locais do projeto em que a mesma atividade é referenciada.

Se um esquema tiver alterações no sistema do terminal, mas você ainda não tiver gerado novamente o esquema na atividade ou na transformação, a operação poderá ou não ser bem-sucedida. Isso depende de vários fatores, como o endpoint individual, os campos individuais que são mapeados na transformação e se esses campos foram alterados no esquema. Por exemplo, em um cenário em que um campo obrigatório no esquema original é removido posteriormente no esquema atualizado, é provável que erros do sistema de endpoint sejam relatados no tempo de execução. No entanto, se um campo foi removido, mas é opcional no mapeamento, os erros podem não ser relatados.

Regeneração do Esquema de Atividade

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

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

Para regenerar um esquema gerado pelo conector a partir de uma tela de configuração de atividade (incluindo esquemas fornecidos por Database, NetSuite, Salesforce, Salesforce Service Cloud e atividades ServiceMax), abra a configuração da atividade e avance em cada etapa de configuração da atividade. Você deve 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 Data Schema:

etapa de inserção de banco de dados 1 selecione a próxima tabela

esquema de dados da etapa 2 da inserção do banco de dados concluído

Regeneração do Esquema de Transformação

Para regenerar um esquema gerado pelo conector a partir de uma transformação (exceto para esquemas fornecidos por Database, NetSuite, Salesforce, Salesforce Service Cloud ou atividades ServiceMax), clique no ícone de engrenagem do esquema engrenagem para abrir um menu. No menu, selecione Atualizar esquema:

esquema de atualização do esquema de menu de ações do esquema de destino

Esquemas Definidos pelo Usuário

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

As alterações nos esquemas definidos pelo usuário são propagadas para todas as referências de esquema automaticamente. Ao abrir um esquema referenciado por vários componentes, uma caixa de diálogo exibe uma lista de todos os componentes que fazem referência ao esquema e serão afetados por quaisquer alterações:

esquema usado por vários componentes

Se você não deseja que as alterações sejam propagadas em todos os locais onde o esquema é referenciado, você deve primeiro editar a configuração desses componentes para remover ou substituir a referência do esquema.

Projetos Anteriores a 33.10.2

Os esquemas definidos pelo usuário referenciados por várias transformações em projetos criados antes do Harmony versão 10.33.2 são renomeados automaticamente usando esta convenção de nomenclatura:

<Original Schema Name>_<Transformation Name>_<Source or Target>

A convenção de nomenclatura consiste nestes componentes:

  • Original Schema Name: O nome original do esquema anterior a 10.33.2.
  • Nome da Transformação: O nome da transformação na qual o esquema é referenciado.
  • Origem ou Destino: se o esquema é usado na origem ou no destino da transformação.