Ir para o conteúdo

Regeneração de 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 fixos no conector ou são gerados diretamente do endpoint.

  • Definido pelo usuário: Os esquemas definidos pelo usuário são fornecidos pelo usuário, seja criando um esquema personalizado, carregando um arquivo ou URL ou inserindo manualmente o esquema.

Esta página fornece informações sobre como regenerar esquemas para ambos os tipos de esquema.

Esquemas Gerados por Conectores

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 ponto de extremidade correspondente.

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

Se houver alterações externas em um esquema sendo gerado de um endpoint, você deverá regenerar o esquema dentro do 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 de um endpoint é atualizado, o Cloud Studio usa a API fornecida pelo endpoint para regenerar o esquema para essa atividade.

Quando um esquema corrigido em um conector é atualizado, o esquema atual incluído no conector é recarregado, efetivamente atualizando 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ê tiver referenciado várias cópias da mesma atividade em diferentes locais 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 atualiza na atividade e em todos os locais dentro do projeto onde a mesma atividade é referenciada.

Se um esquema tiver alterações no sistema do ponto de extremidade, mas você ainda não tiver regenerado o esquema na atividade ou 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 são mapeados na transformação e se esses campos foram alterados dentro do esquema. Por exemplo, em um cenário em que um campo obrigatório no esquema original é removido posteriormente no esquema atualizado, os erros do sistema do endpoint provavelmente serão relatados no tempo de execução. No entanto, se um campo tiver sido removido, mas for 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 Banco de Dados, NetSuite, Salesforce, Salesforce Service Cloud, ou atividades ServiceMax), na etapa Esquema de Dados, clique em Atualizar:

ServiceNow cria atualização do esquema de dados da etapa 2

Para regenerar um esquema gerado pelo 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 ServiceMax), abra a configuração da atividade e avance por cada etapa da 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:

inserir banco de dados etapa 1 selecionar tabela próxima

etapa 2 de inserção do banco de dados esquema 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 Banco de Dados, NetSuite, Salesforce, Salesforce Service Cloud, ou atividades ServiceMax), clique no esquema ícone de engrenagem para abrir um menu. No menu, selecione Refresh Schema:

esquema de destino menu de ações atualizar esquema

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, carregando um arquivo ou URL ou inserindo manualmente o esquema.

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

esquema usado por vários componentes

Se você não quiser que as alterações sejam propagadas em todos os locais onde o esquema é referenciado, primeiro edite 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 renomeados automaticamente usando esta convenção de nomenclatura:

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

A convenção de nomenclatura consiste nestes componentes:

  • Nome do esquema original: O nome original do esquema anterior à versão 10.33.2.
  • Nome da Transformação: O nome da transformação na qual o esquema é referenciado.
  • Origem ou destino: Se o esquema é usado no lado de origem ou de destino da transformação.