Você está aqui:
Implantação de metadados limpa para o OmniStudio
A Implantação de metadados limpos moderniza a maneira como você implementa componentes do OmniStudio. Quando você a ativa, os componentes do OmniStudio se comportam como metadados padrão do Salesforce, portanto, você os implanta com Salesforce CLI, DevOps Center, conjuntos de alterações e empacotamento, junto com componentes da Web Lightning, fluxos e classes do Apex em um único pipeline.
Os componentes do OmniStudio se tornam entidades de configuração padrão, representadas por novos tipos de metadados. Cada componente expõe apenas uma única versão, as dependências são detectadas automaticamente e os arquivos de origem usam nomes limpos e sem versão. Você implanta componentes do OmniStudio com as mesmas ferramentas e fluxos de trabalho que já usa para o restante da Salesforce Platform.
Principais benefícios
A Implantação de metadados limpos traz essas melhorias à implantação do OmniStudio.
- Implantação atômica: Implemente as alterações do OmniStudio junto com outros tipos de metadados do Salesforce em uma implantação coesa.
- Detecção automática de dependência em pacotes de primeira geração (1GP): Quando você recupera ou implementa um componente do OmniStudio, a estrutura identifica os componentes dos quais ela depende e os inclui.
- Gerenciamento de versão simplificado: Cada componente expõe apenas sua única versão para implantação. Cada implantação cria uma versão na organização de destino, assim, você não precisa mais verificar uma longa lista de versões para encontrar a certa.
- Difs legíveis: Os novos metadados produzem diffs consistentes e legíveis de suas alterações do OmniStudio implantadas para revisores.
- Suporte de empacotamento: Os novos metadados podem ser empacotados em pacotes de primeira geração (1GP) e segunda geração (2GP).
- Suporte para cópia de sandbox: Quando você cria um sandbox de cópia completa ou de cópia parcial, seus componentes do OmniStudio são copiados para o sandbox. Consulte Tipo e modelos de sandbox.
- Rastreamento de origem: Acompanhe as alterações entre seu projeto local e uma organização teste ou sandbox ao criar, atualizar ou excluir componentes do OmniStudio. Consulte Rastrear alterações entre seu projeto e sua organização.
Principais diferenças
Esta tabela compara a implantação do OmniStudio antes e depois de você ativar a Implantação de metadados limpa.
| Capacidade | Implantação legada | Implantação de metadados limpos |
|---|---|---|
| Implantar junto com outros tipos de metadados | Não | Sim |
| Versões expostas para implantação | Todas as versões | Somente versão única |
| Detecção automática de dependência | Não suportado | Com suporte (1GP apenas) |
| Arquivos de origem no controle de versão | Difícil comparar | Difs legíveis e consistentes |
| Nomenclatura do arquivo | Inclui o número da versão | Agnóstico à versão |
| Rastreamento de origem | Não suportado | Suportado |
| Sandbox completo | Componentes do OmniStudio não copiados | Componentes do OmniStudio copiados |
| Empacotamento 1GP | Limitado | Suportado |
| Empacotamento 2GP | Limitado | Suportado |
| Conjuntos de alterações | Não suportado | Suportado |
Métodos e ferramentas de implementação com suporte
Depois de ativar o recurso, você pode usar componentes do OmniStudio com estas opções:
- Salesforce CLI: Recupere, implemente e empacote componentes do OmniStudio com comandos de
sf project. Consulte Commandos do projeto. - Conjuntos de alterações: Inclua componentes do OmniStudio em conjuntos de alterações, com dependências identificadas automaticamente. Consulte Implantar usando conjuntos de alterações.
- API de metadados: Trabalhe com os novos tipos de metadados de modo programático. Consulte Entendendo a API de metadados.
- Empacotamento 1GP e 2GP: Empacote componentes do OmniStudio em pacotes de primeira e segunda gerações. Consulte Pacotes gerenciados de primeira geração e Pacotes gerenciados de segunda geração.
- Cópia de sandbox: Quando você cria ou atualiza um Developer, Developer Pro, Partial Copy ou Sandbox completo, os componentes do OmniStudio são copiados automaticamente. Veja Sandboxes.
Novos tipos de metadados
Quando a opção Limpar implantação de metadados estiver ativada, use estes tipos de metadados para operações de recuperação e implantação. Esses tipos de metadados exigem a API versão 67.0 ou posterior.
| Componente | Novos tipos de metadados | Tipo legado (não há mais suporte) |
|---|---|---|
| OmniScript | OmniscriptDefinition | OmniScriptConfig |
| Procedimento de integração | IntegrationProcdDefinition | OmniIntegrationProcConfig |
| Mapeador de dados | DataMapperDefinition | OmniDataTransformConfig |
| FlexCard | FlexcardDefinition | OmniUiCardConfig |
Limitações
Considere estas limitações ao planejar sua implantação.
- A API do conjunto de ferramentas não tem suporte.
- Não há suporte para componentes do OmniStudio que fazem referência a Mapeadores de dados no pacote gerenciado que não seja de Indústrias.
- O empacotamento não permite substituições de versão. Se o nome de um componente entrar em conflito com um componente existente durante a instalação, a instalação criará uma versão.
- Configurar implantação de metadados limpos
Ative Limpar implementação de metadados nas Configurações do OmniStudio em Configuração. Ative-o na organização de origem e na organização de destino. - O OmniStudio limpa metadados de perguntas frequentes (FAQs)
Obtenha respostas para perguntas comuns sobre o uso da Implementação de metadados limpa para OmniStudio.
