Usar conectores personalizados com o controle de linha do tempo

O recurso de conectores personalizados fornece uma maneira para os desenvolvedores exibirem informações como linhas de tabelas do Dataverse, fontes de dados externas etc. como entradas de registros no componente TimelineWallControl. Isso permite um conjunto mais amplo de cenários, além das anotações, postagens e atividades prontas para uso existentes.

Para obter informações sobre como configurar e usar a linha do tempo, consulte os seguintes tópicos:

• Usar a linha do tempo
• Configurar a linha do tempo
• Configuração do cartão de registro da linha do tempo

Os registros configurados em conectores personalizados são um recurso da Web JavaScript em conformidade com a interface IRecordSource. O nome de um recurso da Web, juntamente com o construtor (nome incluindo namespace) e o caminho do recurso da Web JSON opcional, podem ser adicionados como uma configuração de parâmetro UClientRecordSourcesJSON no FormXML.

<UClientRecordSourcesJSON>
  {"recordSources": [{
    "name": "new_SecondaryRecordSource", 
    "constructor": "SampleNamespace.SecondaryRecordSource"}]
  }
</UClientRecordSourcesJSON>

Espera-se que TimelineWallControl carregue o recurso da Web JavaScript e, em seguida, crie a instância de IRecordSource com base no construtor configurado.

A IRecordSource é então inicializada (init), com uma solicitação de páginas de registros (getRecordsData), uma solicitação de detalhes de filtros (getFilterDetails) e uma solicitação de representação de UX de um único registro (getRecordUX).

A resposta da solicitação de registros é mantida para minimizar o número de solicitações de registro que ocorrem em cenários multissessão.

Configurar conectores personalizados para o controle de linha do tempo

Você pode adicionar ou editar seu conector personalizado para o controle de linha do tempo configurando-o na experiência do criador.

1. No controle da linha do tempo, selecione o formulário ao qual deseja adicionar ou editar o conector personalizado.

2. Conclua uma das opções a seguir:

   • Para adicionar um novo conector personalizado, no painel Propriedades da tabela de linha do tempo, em Conectores personalizados, selecione Adicionar conector. O painel Novo conector personalizado é exibido.

     

   • Para editar um conector personalizado existente que você já carregou, no painel Propriedades da entidade da linha do tempo, selecione o conector personalizado e selecione Editar. A opção Editar painel de conector personalizado é exibida.

     

3. Edite o formulário e selecione Salvar.

Suporte a filtros

O suporte a filtros do conector personalizado inclui os seguintes recursos.

• Adicionar novo tipo de filtro ao grupo de filtros existente
• Adicionar novo grupo de filtros
• Atualizar a contagem de tipos de filtro existente
• Filtrar com base na chave de pesquisa

Os conectores personalizados devem usar as informações de fuso horário UserSettings do contexto passado em init() para serem consistentes com a renderização da linha do tempo.

Escopo

O recurso de conectores personalizados tem suporte em formulários de tabela com uma ou várias sessões em aplicativos de modelo de cliente da Interface Unificada.

Fora do escopo

A seguinte funcionalidade não está disponível para o recurso de conectores personalizados:

• Cenários offline e offline por padrão
• Dashboards
• Locais onde TimelineWallControl não está disponível (como aplicativos convergidos, aplicativos de tela, Power Pages, páginas personalizadas e assim por diante)

Limitações conhecidas

Os recursos da Web configurados não são declarados formalmente como dependências do formulário. Isso significa que exportar um formulário não exportará automaticamente os recursos da Web e eles precisarão ser adicionados a essa exportação de forma manual. Além disso, pode ser fácil excluir acidentalmente esses recursos da Web.

Desenvolver uma fonte de registro

Ao desenvolver uma fonte de registro, siga estas práticas:

• Garanta a segurança na recuperação de dados. O modelo de segurança da Interface Unificada considera os recursos da Web JS e JSON como não confiáveis, portanto, esses recursos não devem conter tokens ou segredos neles, pois seriam armazenados em texto sem formatação.
• Se os dados estiverem dentro do Dataverse, use o objeto de contexto do comportamento init para fazer solicitações no Dataverse. As chamadas para o Dataverse do contexto têm solicitações enviadas por proxy usando um iframe seguro. É assim que as fontes de registro prontas para uso no TimelineWallControl recuperam dados.
• Se os dados estiverem fora do Dataverse, use mecanismos existentes da plataforma para recuperar dados externos.
• Teste as alterações localmente usando o Fiddler: melhore a agilidade de desenvolvimento e depuração de recursos da Web JavaScript usando o Fiddler AutoResponder. Mais informações: Desenvolvimento de recursos da Web de script usando o Fiddler AutoResponder.
• Reduza o risco de ataques de XSS: o risco de ataques de XSS ocorre ao adicionar/associar HTML ao DOM. Use texto sem formatação sempre que possível para reduzir esse risco. Se o HTML for necessário, você deve limpar esse conteúdo antes de adicioná-lo ao registro.
• Siga as práticas recomendadas gerais para scripts de clientes. Mais informações: Scripts de clientes em aplicativos baseados em modelo
• Garanta práticas de design inclusivas, incluindo o uso de ferramentas de teste automatizadas, como o Accessibility Insights.

Exemplo de solução

Você pode começar com um exemplo de solução de conectores personalizados que tenha o recurso da Web "SecondaryRecordSource" configurado para os formulários "Conta para Experiências Interativas" e "Conta para Experiências Multissessão".

Confira também

Usar linha do tempo
Configurar linha do tempo

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).