Usar conectores personalizados co control da liña de tempo

A función de conectores personalizados proporciona aos desenvolvedores unha forma de mostrar información como Dataverse filas da táboa, fontes de datos externas, etc., como entradas de rexistro dentro do compoñente TimelineWallControl. Permite un conxunto máis amplo de escenarios ademais das notas, publicacións e actividades existentes.

Para obter información sobre a configuración e o uso da liña de tempo, consulte os seguintes temas:

• Usar a liña de tempo
• Configurar a liña de tempo
• Configuración da tarxeta de rexistro de cronoloxía

Os rexistros que se configuran dentro de conectores personalizados son un recurso web de JavaScript que se axusta á interface IRecordSource. O nome dun recurso web, xunto co construtor (nome incluído o espazo de nomes) e a ruta do recurso web JSON opcional, pódense engadir como unha configuración de parámetro UClientRecordSourcesJSON dentro de FormXML.

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

Espérase que TimelineWallControl cargue o recurso web JavaScript e despois cree a instancia de IRecordSource desde o construtor configurado.

A continuación, inicialízase o IRecordSource (init), cunha solicitude de páxinas de rexistros (getRecordsData), unha solicitude de detalles do filtro (getFilterDetails) e unha solicitude para a representación UX dun único rexistro (getRecordUX).

A resposta dos rexistros solicitados persiste para minimizar o número de solicitudes de rexistro que se producen en escenarios de varias sesións.

Soporte de filtros

A compatibilidade de filtros de conectores personalizados inclúe as seguintes habilidades.

• Engade un novo tipo de filtro ao grupo de filtros existente
• Engadir un novo grupo de filtros
• Actualiza o reconto de tipos de filtro existente
• Filtro na clave de busca

Os conectores personalizados deben usar a información de fuso horario de UserSettings do contexto pasado en init() para ser coherentes coa representación da liña de tempo.

Scope

A función de conectores personalizados é compatible con formularios de táboa de sesión única e multisesión nas aplicacións do modelo de cliente Interface unificada.

Fóra do alcance

A seguinte funcionalidade non está dispoñible para a función de conectores personalizados:

• Escenarios sen conexión e sen conexión por defecto
• Paneis
• Lugares onde TimelineWallControl non está dispoñible (como aplicacións converxentes, aplicacións de lenzo, portais, páxinas personalizadas, etc.)

Limitacións coñecidas

Os recursos web configurados non se declaran formalmente como dependencias do formulario. Isto significa que exportar un formulario non exportará automaticamente os recursos web e que deberían engadirse a esa exportación manualmente. Ademais, pode ser doado eliminar accidentalmente estes recursos web.

Desenvolver unha fonte de rexistro

Ao desenvolver unha fonte de rexistro, asegúrate de seguir estas prácticas:

• Asegúrate de que estás recuperando datos de forma segura. O modelo de seguranza Interface unificada considera que os recursos web JS e JSON non son fiables e, polo tanto, tales recursos non deben conter fichas ou segredos, xa que se almacenarían en texto plano.
• Se os datos están dentro Dataverse, use o obxecto de contexto do comportamento init para facer solicitudes en Dataverse. Chamadas a Dataverse desde o contexto ten solicitudes enviadas por proxy a través dun iframe seguro. Así é como as fontes de rexistro listadas dentro de TimelineWallControl recuperan datos.
• Se os datos están fóra de Dataverse, use os mecanismos existentes da plataforma para recuperar datos externos.
• Proba localmente os cambios usando Fiddler: mellora a axilidade de desenvolvemento e depuración de recursos web de JavaScript mediante Fiddler AutoResponder. Máis información: Desenvolvemento de recursos web de script usando Fiddler AutoResponder.
• Reducir o risco de ataques XSS: o risco de ataques XSS prodúcese ao engadir/enlazar HTML ao DOM. Use texto simple sempre que sexa posible para reducir este risco. Se é necesario HTML, debes desinfectar este contido antes de engadilo ao rexistro.
• Siga as prácticas recomendadas xerais para a creación de scripts de clientes. Máis información: Scripts de cliente en aplicacións baseadas en modelos
• Garantir prácticas de deseño inclusivas, incluíndo o uso de ferramentas de proba automatizadas como Accesibilidade Insights.

Mostra de solución

Podes comezar con a mostra de solución de conectores personalizados que ten o recurso web "SecondaryRecordSource", que está configurado para os formularios "Conta para experiencias interactivas" e "Conta para experiencias multisesión".

Consulte tamén

Usar a liña de tempo
Configurar a liña de tempo

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).