Utilizar conectores personalizados com o controlo de linha cronológica

Artigo
04/09/2023

A funcionalidade de conectores personalizados fornece uma forma dos programadores exporem informações como linhas de tabela do Dataverse, origens de dados externas, etc., como entradas de registos no componente TimelineWallControl. Permite um conjunto mais alargado de cenários para além das notas, publicações e atividades existentes prontas a utilizar.

Para obter informações sobre como configurar e utilizar a linha cronológica, consulte os seguintes tópicos:

Os registos configurados nos conectores personalizados são um recurso Web JavaScript que está em conformidade com a interface IRecordSource. O nome de um recurso Web, a par do construtor (nome incluindo espaço de nomes) e o caminho do recurso Web JSON opcional, podem ser adicionados como configuração de parâmetro UClientRecordSourcesJSON no FormXML.

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

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

Em seguida, o IRecordSource é inicializado (init), com um pedido de páginas de registos (getRecordsData), pedido para filtrar detalhes (getFilterDetails) e um pedido para a representação UX de um único registo (getRecordUX).

A resposta do pedido de registos é conservada para minimizar o número de pedidos de registo que ocorrem em cenários de múltiplas sessões.

Configure o conector personalizado para o controlo timeline

Pode adicionar ou editar o seu conector personalizado ao controlo timeline configurando-o na experiência de criador.

No controlo timeline, selecione o formulário para o qual pretende adicionar ou editar o conector personalizado.
Conclua uma das seguintes opções:
- Para adicionar um novo conector personalizado, no painel Propriedades para a tabela de linha cronológica, em Conectores personalizados, selecione Adicionar conector. É apresentado o painel Novo conector personalizado.
- Para editar um conector personalizado existente que já tenha carregado, no painel Propriedades para a entidade de linha cronológica, selecione o conector personalizado e, em seguida, selecione Editar. É apresentado o painel Editar conector personalizado.
Edite a página e, em seguida, selecione Guardar.

Suporte de filtro

O suporte de filtro de conectores personalizados inclui as capacidades que se seguem.

Adicionar novo tipo de filtro a grupo de filtros existente
Adicionar novo grupo de filtros
Atualizar a contagem de tipo de filtro existente
Filtro na chave de pesquisa

Os conectores personalizados têm de utilizar informações de UserSettings Timezone a partir do contexto passado em init() para serem consistentes com a composição da linha cronológica.

Âmbito

A funcionalidade de conectores personalizados é suportada em formulários de sessão única e de várias sessões em aplicações de modelo de cliente de Interface Unificada.

Fora de âmbito

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

Cenários offline e offline por predefinição
Dashboards
Localizações onde TimelineWallControl não está disponível (tais como aplicações convergentes, aplicações de tela, Power Pages, páginas personalizadas, etc.)

Limitações conhecidas

Os recursos Web configurados não são declarados formalmente como dependências do formulário. Isto significa que exportar um formulário não exportará automaticamente os recursos Web e precisariam de ser adicionados a essa exportação manualmente. Além disso, poderá ser fácil eliminar acidentalmente estes recursos Web.

Desenvolver uma origem de registo

Ao desenvolver uma origem de registo, certifique-se de que segue estas práticas:

Certifique-se de que está a obter os dados de forma segura. O modelo de segurança Interface Unificada considera os recursos Web JS e JSON como não fidedignos, e, portanto, estes recursos não devem conter tokens ou segredos neles, uma vez que seriam armazenados em texto simples.
Se os dados estiverem no Dataverse, utilize o objeto de contexto do comportamento inicial para fazer pedidos para o Dataverse. As chamadas para o Dataverse a partir do contexto têm pedidos com proxy através de um iframe seguro. É assim que as origens de registo prontas a utilizar no TimelineWallControl obtêm dados.
Se os dados estiverem fora do Dataverse, utilize os mecanismos existentes da plataforma para obter dados externos.
Testar localmente as alterações através do Fiddler: melhore a agilidade do desenvolvimento e a depuração dos recursos Web JavaScript através do Fiddler AutoResponder. Mais informações: Desenvolvimento de recursos Web de script com Fiddler AutoResponder.
Reduzir o risco de ataques XSS: o risco de ataques XSS ocorre ao adicionar/enlaçar HTML ao DOM. Utilize texto simples sempre que possível para reduzir este risco. Se for necessário HTML, tem de limpar este conteúdo antes de o adicionar ao registo.
Siga as melhores práticas gerais para scripting de clientes. Mais informações: Scripting de clientes em aplicações condicionadas por modelo
Assegure práticas de conceção inclusivas, incluindo a utilização de ferramentas de testes automatizadas, tais como Insights de Acessibilidade.

Amostra de solução

Poderá começar com uma amostra de solução de conectores personalizados que tem o recurso Web "SecondaryRecordSource", que está configurado para formulários "Conta para Experiências Interativas" e "Conta para Experiências de Sessões Múltiplas".

Consulte também

Utilizar linha cronológica
Configurar linha cronológica

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).

Partilhar via