Você está aqui:
Limitações da autenticação de dados
Revise as limitações de nomenclatura do token de autenticação de dados, formatos de modelo, recursos com suporte e recursos de edição antes de configurar seus modelos. Essas restrições afetam o comportamento do token, as atualizações de registro e a compatibilidade do modelo.
Regras e limitações gerais de token DT
- A autenticação de dados não oferece suporte a:
- Caracteres especiais em nomes de token DT.
- Transformações de dados para tokens DT.
- Tokens de DT de RTB, HYP e IMG.
- Tokens DT dentro de cláusulas, incluindo a cláusula Marcada. Você pode criar tokens DT dentro de seções.
- Tokens DT colocados dentro de cabeçalhos ou rodapés.
- Tokens DT colocados dentro de cabeçalhos e títulos de seção ou cláusula.
- O True Up de dados oferece suporte a:
- Repetir tokens de item de linha quando a seção e seus tokens de campo usam o prefixo DT_.
- Tokens DT aninhados para campos de objeto relacionados com até um nível de profundidade quando você usa o prefixo DT_.
- Um máximo de 1.000 tokens DT e 2.000 tokens de item de linha DT em um documento.
- Comportamento do token DT e impacto do documento:
- Exige que você defina tokens DT no nível superior no tokenMap.
- Reconhece apenas tokens DT que incluem o prefixo DT_.
- Excluir uma linha contendo um valor de token DT em um documento baixado pode remover o limite de conteúdo associado.
- Use nomes de token exclusivos para tokens DT variáveis e tokens DT de item de linha. Isso garante que o True Up de dados possa distinguir e reconciliar corretamente cada tipo de token.
- O painel Verificação de dados é desabilitado depois de você verificar o documento no complemento do Microsoft 365.
Requisitos de token de item de linha
- Use o prefixo DT_ nos nomes de nó principal e de token de campo nas seções de item de linha para a Verificação de dados para processar itens de linha.
- Não coloque itens de linha dentro de seções; use áreas de item de linha repetidas dedicadas no modelo.
- Mantenha uma nomenclatura de token com prefixo DT_ consistente para itens de linha mapeados para várias tabelas no documento.
- Calcula o status de sincronização para itens de linha de modo coletivo em todos os itens de linha relacionados.
Tokens de objeto aninhados e relacionados
- Os tokens aninhados DT oferecem suporte apenas a um nível de um objeto relacionado. Referências aninhadas mais profundas não são suportadas.
- A True Up de dados reconcilia campos de objeto aninhados apenas para mapeamentos de um para um; para relacionamentos de um para muitos, use itens de linha.
Compatibilidade do modelo
- O modelo de documento funciona apenas com a Geração de documentos 2.0 e requer o tipo de versão da API de Geração de documentos avançada.
- Mesclar dados do token de True-Up de dados durante a geração de documento funciona apenas com Salesforce Contracts.
- Dá suporte apenas a modelos DOCX. Arquivos PPTX e PDF não são compatíveis.
- Não oferece suporte a tokens DT na tabela de conteúdo de um modelo de documento.
- Evite importar documentos que contenham campos DT de outra organização ou de um objeto de contrato diferente. Os tokens DT fazem referência ao objeto de contrato do qual eles foram gerados ou ao objeto especificado no campo ObjectId do OmniStudio Data Mapper ou do Serviço de contexto.
Compatibilidade da fonte de dados
- Não há suporte para formatos de data personalizados quando os dados são adquiridos por meio de Mapeadores de dados e transformados com formatos. Há suporte apenas para o formato de data padrão.
- A True Up de dados usa valores de banco de dados para buscar valores sem formatação intermediária. A formatação do documento não afeta os valores de reconciliação.
- Para campos numéricos, como número, porcentagem e moeda, os valores com mais casas decimais do que o definido para o campo mostram um aviso de validação, mas podem ser salvos no documento sem arredondamento.
Edição e formatação
- Os valores do token DT no documento gerado são bloqueados e podem ser editados apenas por meio da opção Editar valor no complemento Microsoft 365 Word.
- Tokens DT do tipo de data oferecem suporte a alterações de formato de exibição (por exemplo, AAAA/MM/DD ou MM/DD/AAAA). O formato padrão é AAAA-MM-DD.
- Os revisores devem aceitar ou rejeitar alterações de documentos existentes antes de atualizar os valores do token DT por meio da opção Editar valor.
Requisitos de acesso
- O recurso Atualizar registros não tem suporte para campos de numeração automática.
- O acesso de leitura e edição de segurança em nível de campo é necessário para qualquer campo referenciado pelo token DT para reconciliação e atualização de registro.
- Os usuários da Comunidade de parceiros podem abrir documentos no complemento do Microsoft 365 apenas no Firefox e no Safari quando a configuração de privacidade do navegador "Privacidade do navegador" estiver personalizada em "Privacidade e segurança". Sem essa configuração, não há suporte para acesso de complemento. Os usuários também devem ter acesso de segurança em nível de campo (FLS) para usar o Data TrueUp do Microsoft 365. Sem o acesso necessário, não há suporte para ações de check-in e atualização.
Diretrizes (não limitações)
- Não é possível editar campos bloqueados na janela Editar valor. Use a opção de cópia na janela para sincronizar o valor do registro com o valor do documento.
- Realize a busca de valores antes de iniciar Atualizar campos para garantir que todos os status de token reflitam os dados mais recentes do Salesforce.
- Se um token DT fizer referência a um campo que não seja editável, realize um valor de repetição para esse campo antes de iniciar um registro de atualização.
- Você pode excluir tokens DT individuais do painel Verificação de dados antes da reconciliação.
- Quando a opção Buscar valores ou Atualizar campos encontra um erro de validação em um campo para um ID de registro, a Atualização de dados não atualiza nenhum campo para esse ID de registro.
- A formatação do token DT é preservada em documentos gerados quando estas condições são atendidas:
- A formatação deve ser aplicada a todo o token, de {{ a}}.
- A formatação deve ser uniforme em todo o token. Não é possível formatar parte do token de uma maneira e outra de forma diferente, por exemplo, em negrito e itálico.
- Há suporte apenas para as seguintes opções de formatação: Negrito, itálico, sublinhado, fonte (typeface) e tamanho da fonte. Opções adicionais de formatação podem ser adicionadas sob demanda.
- Você pode editar valores de token DT por meio da opção Editar valor no complemento do Microsoft 365 Word, mesmo quando os tokens têm formatação aplicada.
Este artigo resolveu seu problema?
Diga-nos para podermos melhorar!
