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:
- Atualize o esquema: Para todos os esquemas gerados pelo conector, exceto aqueles fornecidos em Database, NetSuite, Salesforce, Salesforce Service Cloud ou atividades ServiceMax, o Cloud Studio inclui a opção de atualizar os esquemas nestas telas de configuração de componentes:
- Dentro de uma configuração de atividade, na etapa Esquema de dados (consulte Regeneração do esquema de atividade abaixo).
- Dentro de uma transformação, como uma opção no esquema de solicitação ou resposta (consulte Regeneração do esquema de Transformação abaixo).
- Reconfigure a atividade: Para todos os esquemas gerados pelo conector, incluindo aqueles fornecidos em Database, NetSuite, Salesforce, Salesforce Service Cloud e atividades ServiceMax, você pode regenerar um esquema abrindo a configuração de atividade existente do Cloud Studio e avançando em cada etapa de configuração de atividade. Selecionar objetos ou fazer outras alterações força uma atualização do esquema na etapa Esquema de dados (consulte Regeneração do esquema de atividade abaixo).
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:
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:
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 para abrir um menu. No menu, selecione 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, 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:
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.