Erros comuns e resoluções no OmniStudio

1. Faça login como administrador do sistema.
2. Em Configuração, localize e selecione Omnistudio.
3. Habilite a permissão do OmniStudio para sua organização.

Se a opção não estiver visível, verifique se sua organização tem licenças do OmniStudio. Entre em contato com seu executivo de contas do Salesforce se forem necessárias licenças.

Dica Depois de habilitar as permissões do OmniStudio, pode levar alguns minutos para que as alterações se propagem em toda a sua organização. Se você continuar vendo esse erro, tente fazer logout e login novamente.

• Tentativa de excluir um OmniScript ativo
• Tentativa de atualizar campos estruturais em um OmniScript ativo
• Tentativa de alterar Tipo, Subtipo ou Idioma em um OmniScript ativo

1. No Iniciador de aplicativos, localize e selecione OmniScripts.
2. Localize o OmniScript que deseja modificar ou excluir.
3. Observe a versão atual e avise os usuários sobre a desativação futura.
4. Desmarque a caixa de seleção Ativo para desativar o OmniScript e salvar suas alterações.
5. Agora você pode fazer as alterações desejadas ou excluir o OmniScript.
6. Se você tiver feito alterações, poderá reativá-las marcando a caixa de seleção Ativo novamente.

Aviso A desativação de um OmniScript afeta imediatamente todos os usuários e processos que o usam no momento. Considere criar uma nova versão em vez de modificar a ativa se precisar manter a continuidade do serviço.

• Outro OmniScript com Tipo, Subtipo e Idioma idênticos já está ativo
• Criar uma nova versão sem desativar a versão anterior
• Várias versões criadas e tentando ativar mais de uma

Verifique se você tem permissões para editar registros do OmniScript e concluir essas tarefas.

1. No Iniciador de aplicativos, localize e selecione OmniScripts.
2. Use filtros ou pesquise OmniScripts com Tipo e SubTipo correspondentes.
3. Identifique o OmniScript ativo no momento com o mesmo Tipo/SubTipo/Idioma.
4. Revise ambas as versões para determinar quais devem permanecer ativas.
5. Abra o OmniScript que deseja desativar.
6. Desmarque a caixa de seleção Ativo e salve suas alterações.
7. Volte para a nova versão e ative-a.

Aviso Antes de ativar uma nova versão, teste-a cuidadosamente em um ambiente de visualização ou de sandbox. Quando estiver pronto para implantar, desative a versão antiga e ative imediatamente a nova para minimizar o tempo de inatividade.

• O campo de tipo está vazio ou é nulo
• O campo de subtipo está vazio ou é nulo
• O campo de idioma não está selecionado
• Tentativa de salvar um novo OmniScript sem preencher todos os campos obrigatórios

Verifique se você tem permissões para editar registros do OmniScript e concluir essas tarefas.

1. No Iniciador de aplicativos, localize e selecione OmniScripts.
2. No painel de propriedades do OmniScript, localize o campo Tipo.
3. Insira um nome de Tipo descritivo, como CustomerOnboarding ou ClaimSubmission.
4. Localize o campo Subtipo e insira um nome de Subtipo específico, como Residencial ou Commercial.
5. Selecione um Idioma na lista suspensa.
6. Certifique-se de que todos os três campos estejam preenchidos e salve suas alterações.
7. Volte para a nova versão e ative-a.

Dica Escolha nomes de Tipo e Subtipo relevantes que indiquem claramente o propósito do OmniScript. Esses valores se tornam parte de como você faz referência ao OmniScript em seus aplicativos e não podem ser alterados facilmente depois de serem criados.

• Campos de Tipo ou Subtipo contêm espaços
• Campos de Tipo ou Subtipo contêm sublinhados
• Campos de Tipo ou Subtipo contêm caracteres especiais sem suporte: !@#$%^&*, e assim por diante
• Campos de Tipo ou Subtipo contêm hifens ou outra pontuação

1. Revise os valores de Tipo e Subtipo.
2. Remova todos os espaços – use UpperCamelCase (ou PascalCase) em vez disso. Por exemplo, CustomerOnboarding.
3. Remova os sublinhados e substitua-os por UpperCamelCase (ou PascalCase).
4. Remova todos os caracteres especiais.
5. Certifique-se de que somente letras (A-Z, a-z) e números (0-9) sejam usados.
6. Salve suas alterações.

Dica Use PascalCase (também chamado UpperCamelCase) para valores de Tipo e Subtipo. Isso melhora a legibilidade sem exigir espaços ou sublinhados.

• O valor do tipo é longo demais.
• O valor de Subtipo é longo demais.
• Tipo combinado + Subtipo + Idioma excede o limite de caracteres.

1. Revise a mensagem de erro para ver o comprimento máximo permitido.
2. Reduza o valor de Tipo ou Subtipo.
3. Salve suas alterações.

Dica Use abreviações quando necessário. Remova palavras redundantes. Use uma convenção de nomenclatura mais curta.

O campo Tipo ou Subtipo usa uma palavra-chave reservada. Palavras-chave comuns restritas incluem: em, fora, exc, cb, kt, vt, v, x785f, x5f

Conforme sugerido na mensagem de erro, substitua a palavra-chave restrita por um valor diferente. Consulte Palavras reservadas na página Convenções de nomenclatura do Omnistudio para obter mais informações.

• Tentativa de adicionar um novo elemento a um OmniScript ativo.
• Tentativa de modificar um elemento existente em um OmniScript ativo.
• Tentativa de excluir um elemento de um OmniScript ativo.
• O OmniScript está ativo e em uso.

Verifique se você tem permissões para editar registros do OmniScript e concluir essas tarefas.

1. Verifique se o OmniScript está ativo no momento.
2. Considere criar uma nova versão em vez de modificar a ativa.
3. Para criar uma nova versão: Clique em Clonar no OmniScript.
4. Para modificar existentes: Desative desmarcando a caixa de seleção Ativo e salve suas alterações.
5. Agora você pode adicionar, atualizar ou excluir elementos.
6. Teste suas alterações.
7. Ative o OmniScript quando estiver pronto para uso.

Aviso Recomendamos criar uma nova versão para alterações significativas em vez de desativar e modificar a versão ativa. Isso permite que você teste cuidadosamente antes de implementar e fornece uma opção de reversão fácil se ocorrerem problemas.

• Outro elemento no mesmo OmniScript tem o mesmo nome.
• Colisão de nomes entre elementos em diferentes etapas.
• O elemento foi copiado e o nome não mudou.

1. Revise todos os elementos em seu OmniScript.
2. Identifique os elementos com os nomes conflitantes.
3. Decida qual elemento deve manter o nome.
4. Renomeie o outro elemento com um nome exclusivo.
5. Considere usar prefixos para indicar a etapa ou seção, por exemplo, step1_firstName, step2_firstName.
6. Atualize quaisquer fórmulas ou mapeamentos de dados que façam referência ao elemento renomeado e salve suas alterações.

• O OmniScript é de um pacote gerenciado e você não tem permissões para modificá-lo ou excluí-lo.
• Tentativa de atualizar um OmniScript empacotado de fora do namespace do pacote.

1. Verifique se o OmniScript é de um pacote gerenciado.
2. Se precisar personalizar o OmniScript, clone-o.
3. Renomeie a versão clonada com sua própria combinação Type/SubType/Language.
4. Faça as modificações desejadas na versão clonada, salve e ative seu OmniScript.
5. Atualize quaisquer fórmulas ou mapeamentos de dados que façam referência ao elemento renomeado e salve suas alterações.

Dica Entre em contato com o provedor do pacote ou com o administrador do Salesforce se precisar fazer alterações nos componentes empacotados. Eles podem fornecer opções de configuração ou pontos de extensão que não exigem modificar o OmniScript empacotado diretamente.

• O OmniScript é reutilizável.
• O OmniScript contém elementos do OmniScript (OmniScripts integrados).
• Tentativa de tornar um OmniScript reutilizável depois de adicionar OmniScripts integrados

1. Decida se esse OmniScript deve ser reutilizável ou conter OmniScripts integrados.
2. Opção 1: mantê-la reutilizável – Remova todos os elementos do OmniScript integrados
3. Opção 2: Permitir integração: Desmarque a caixa de seleção Reutilizável.
4. Se você estiver removendo OmniScripts integrados, considere usar Procedimentos de integração. Você pode refatorar a lógica em Procedimentos de integração que podem ser chamados do OmniScript.

Dica Use Procedimentos de integração para lógica de negócios compartilhada em vez de aninhar OmniScripts reutilizáveis. Isso cria uma arquitetura mais limpa e evita a complexidade nas dependências do OmniScript.

• Outro FlexCard com o mesmo nome já está ativo.
• Tentativa de ativar uma nova versão sem desativar a antiga.

1. Pesquise FlexCards com o mesmo campo Nome.
2. Revise-os para determinar quais devem permanecer ativos.
3. Abra o FlexCard que deseja desativar.
4. Desmarque a caixa de seleção Ativo para desativar o FlexCard e salvar suas alterações.

Aviso Desativar um FlexCard afeta imediatamente todos os usuários e processos que o usam no momento. Considere criar uma nova versão em vez de modificar a ativa se precisar manter a continuidade do serviço.

1. Verifique se o FlexCard é de um pacote gerenciado.
2. Se precisar removê-lo do uso, desative-o em vez de excluí-lo.
3. Para fazer isso, abra o FlexCard e desmarque a caixa de seleção Ativo.
4. Se você precisar de uma versão personalizada do FlexCard, clone-a.

Dica Entre em contato com o provedor do pacote ou com o administrador do Salesforce se precisar fazer alterações nos componentes empacotados. Eles podem fornecer opções de configuração ou pontos de extensão que não exigem modificar o FlexCard empacotado diretamente.

• O nome do nome do FlexCard filho está escrito incorretamente.
• O FlexCard filho existe, mas não está ativo.
• O FlexCard filho foi excluído.
• O FlexCard filho está em um namespace diferente.

1. No Iniciador de aplicativos, localize e selecione Anote o nome do FlexCard filho na mensagem de erro.
2. Pesquise o FlexCard filho pelo nome.
3. Se encontrado, mas inativo, ative-o.
4. Se não for encontrado, verifique o nome correto.
5. Se o nome estiver incorreto, atualize a configuração do FlexCard pai.
6. No FlexCard pai, localize a referência do FlexCard filho.
7. Corrija o nome para corresponder a um FlexCard ativo existente e salve o FlexCard pai.

Nota FlexCards filho devem ser ativados para que o FlexCard pai possa referenciá-los. Crie e teste primeiro FlexCards filho e, em seguida, configure FlexCards pai para usá-los.

• O Tipo/SubTipo/Idioma do OmniScript está incorreto.
• O OmniScript existe, mas não está ativo.
• O OmniScript foi excluído.
• O Tipo/SubTipo/Idioma do OmniScript foi alterado.

1. Observe o Tipo, o Subtipo e o Idioma da mensagem de erro.
2. Pesquise o OmniScript com Tipo e Subtipo correspondentes.
3. Verifique as correspondências de Idioma.
4. Se encontrado, mas inativo, ative o OmniScript.
5. Se não for encontrado, verifique os valores corretos de Tipo/SubTipo/Language.
6. Volte para o FlexCard e atualize a referência do OmniScript com os valores corretos.
7. Salve suas alterações.

Dica Certifique-se de que o OmniScript referenciado esteja ativo antes de ativar o FlexCard. Se você estiver implementando ambos juntos, primeiro ative o OmniScript.

• O nome do Mapeador de dados está escrito incorretamente.
• O Mapeador de dados existe, mas não está ativo.
• O Mapeador de dados foi excluído.
• O nome do Mapeador de dados foi alterado.

1. Anote o nome do Data Mapper da mensagem de erro.
2. Pesquise o Mapeador de dados por nome.
3. Se encontrado, mas inativo, ative-o.
4. Se não for encontrado, verifique o nome correto.
5. Retorne ao FlexCard, atualize a referência do Data Mapper com o nome correto e salve suas alterações.

Dica Ative Mapeadores de dados antes de ativar FlexCards que fazem referência a eles. Teste o Data Mapper de modo independente para garantir que ele retorne a estrutura de dados esperada.

• O nome do Procedimento de integração está incorreto.
• O Mapeador de dados existe, mas não está ativo.
• O Mapeador de dados foi excluído.
• Você está usando o formato de nomenclatura errado (deve usar o formato Type_SubType).

1. Anote o nome do Procedimento de integração da mensagem de erro.
2. Pesquise o Procedimento de integração.
3. Verifique se ele existe e anote seu Tipo e Subtipo.
4. Se encontrado, mas inativo, ative-o.
5. Volte para seu FlexCard.
6. Atualize a referência Procedimento de integração usando o formato: Type_SubType e salve suas alterações.

Aviso Os procedimentos de integração são referenciados usando sua OmniProcessKey, que segue o formato Type_SubType. Use o formato correto ao configurar o FlexCard.

• Tentativa de renomear um FlexCard existente.
• Tentativa de alterar o autor de um FlexCard existente.
• O UniqueName é usado por outros componentes e não pode ser alterado.

1. Se precisar de um nome ou autor diferente, clone o FlexCard.
2. Localize seu FlexCard e clone-o.
3. Insira o novo Nome ou Autor.
4. Faça quaisquer outras alterações necessárias à versão clonada e ative seu novo FlexCard.
5. Atualize todos os componentes que fazem referência ao FlexCard antigo para usar o novo.
6. Desative o FlexCard antigo depois que todas as referências forem atualizadas.

• O Nome do procedimento de integração começa com FileBased.
• O Tipo de procedimento de integração começa com com base em arquivos.
• O Subtipo do procedimento de integração começa com FileBased.

1. Abra o Procedimento de integração.
2. Verifique os campos Nome, Tipo e Subtipo.
3. Se começar com FileBased, escolha um prefixo diferente.
4. Considere usar prefixos como Arquivo, Documento, Dados ou o nome da sua organização.
5. Atualize os campos sujeitos a erros e salve suas alterações.

• O esquema de entrada JSON tem objetos aninhados com mais de 10 níveis.
• O esquema de saída JSON tem objetos aninhados com mais de 10 níveis.

1. Revise sua estrutura de esquema JSON.
2. Identifique seções profundamente aninhadas.
3. Nivelar a estrutura reduzindo os níveis de aninhamento.
4. Considere mover dados profundamente aninhados para separar Procedimentos de integração.
5. Use matrizes com objetos mais planos em vez de hierarquias profundamente aninhadas.
6. Reestruture para continuar aninhando abaixo de 10 níveis.
7. Salve o esquema atualizado.

Os esquemas JSON do Procedimento de integração têm um limite máximo de 500 chaves em toda a estrutura. Isso inclui todas as chaves em todos os níveis de aninhamento combinados. Especificamente:

• O esquema de entrada JSON contém mais de 500 chaves no total.
• O esquema de saída JSON contém mais de 500 chaves no total.
• O esquema inclui grandes números de campos em vários objetos aninhados.

1. Revise seu esquema JSON.
2. Conte o número total de chaves em todos os níveis.
3. Identifique seções com chaves excessivas.
4. Considere dividir o Procedimento de integração em vários procedimentos menores.
5. Remova chaves não usadas ou redundantes.
6. Use matrizes para representar estruturas repetidas em vez de chaves numeradas.
7. Consolide campos relacionados em subobjetos.
8. Salve o esquema otimizado.

Dica Se você precisar legalmente de mais de 500 chaves, considere dividir o processo em vários procedimentos de integração que podem ser encadeados.

• O sObject selecionado não é compatível com operações do Data Mapper.
• O sObject selecionado é um objeto do sistema que não oferece suporte a consultas.
• O sObject selecionado não tem o suporte de API necessário para funcionar com Mapeadores de dados.

1. Revise o sObject selecionado como o tipo de entrada e verifique a Ajuda do Salesforce quanto a objetos com suporte.
2. Considere usar um objeto relacionado diferente com suporte.
3. Se precisar de dados do objeto sem suporte, use um Procedimento de integração com Apex personalizado.
4. Atualize sua configuração do Data Mapper com um objeto com suporte e salve suas alterações.

Nota A maioria dos objetos padrão e personalizados tem suporte. Se você encontrar um objeto sem suporte, considere se é possível reestruturar seu fluxo de dados para usar uma alternativa com suporte.

• O OmniAnalytics para OmniStudio não está habilitado.
• Sua organização não foi configurada para OmniAnalytics.

1. Faça login como administrador do sistema e, em Configuração, procure por Configurações do OmniStudio ou Configurações de interação Omni.
2. Localize a configuração OmniAnalytics para Core e habilite-a.
3. Salve suas alterações e aguarde alguns minutos para que a alteração entre em vigor.
4. Teste se seu rastreamento de análise funciona.

Nota Verifique se o Decision Explainer está configurado corretamente.

• O ID não está no formato de ID do Salesforce válido, com 15 ou 18 caracteres.
• O ID não pertence ao objeto OmniTrackingComponentDef.
• A definição do componente de rastreamento foi excluída.
• O ID é nulo ou malformado.

1. Verifique o ID de definição do componente que você está usando.
2. Navegue até Configuração > OmniStudio > Rastreamento do Analytics e encontre a definição correta do componente de rastreamento.
3. Copie o ID correto do registro.
4. Atualize seu código ou configuração com o ID correto.
5. Se a definição tiver sido excluída, crie uma nova definição de componente de rastreamento. Consulte Criar um grupo de rastreamento e Adicionar componentes para rastrear.
6. Teste o rastreamento novamente.

Nota Verifique se o Decision Explainer está configurado corretamente.