Utilizar conectores personalizados con el control timeline

Artículo
03/16/2023

La función de conectores personalizados proporciona a los desarrolladores una forma de mostrar información como filas de tabla de Dataverse, fuentes de datos externas, etc., como entradas de registros dentro del componente TimelineWallControl. Permite un conjunto más amplio de escenarios además de las notas, publicaciones y actividades listas para usar existentes.

Para obtener información sobre cómo configurar y usar la línea de tiempo, consulte los siguientes temas:

Los registros que se configuran dentro de conectores personalizados son un recurso web de JavaScript que se ajusta a la interfaz IRecordSource. El nombre de un recurso web, junto con el constructor (el nombre incluye el espacio de nombres) y la ruta del recurso web JSON opcional, se pueden agregar como una configuración de parámetro UClientRecordSourcesJSON dentro de FormXML.

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

Se espera que TimelineWallControl cargue el recurso web JavaScript y luego cree la instancia de IRecordSource desde el constructor configurado.

Luego se inicializa IRecordSource (init), con una solicitud de páginas de registros (getRecordsData), una solicitud para los detalles del filtro (getFilterDetails) y una solicitud de la representación UX de un solo registro (getRecordUX).

La respuesta de la solicitud de registros se conserva para minimizar el número de solicitudes de registros que se producen en escenarios de múltiples sesiones.

Configurar el conector personalizado para el control de la escala de tiempo

Puede agregar o editar su conector personalizado para el control de la escala de tiempo configurándolo en la experiencia del creador.

En el control de escala de tiempo, seleccione el formulario para el que desea agregar o editar el conector personalizado.
Complete una de las siguientes opciones:
- Para agregar un nuevo conector personalizado, en el panel Propiedades de la tabla de escala de tiempo, en Conectores personalizados, seleccione Agregar conector. Se muestra el panel Nuevo conector personalizado.
- Para editar un conector personalizado existente que ya cargó, en el panel Propiedades de la entidad de escala de tiempo, seleccione el conector personalizado y luego seleccione Editar. Se muestra el panel Editar conector personalizado.
Edite la página y luego seleccione Guardar.

Soporte de filtro

La compatibilidad con el filtro de conector personalizado incluye las siguientes capacidades.

Agregar un nuevo tipo de filtro al grupo de filtros existente
Agregar un nuevo grupo de filtros
Actualizar el conteo del tipo de filtro existente
Filtrar en la clave búsqueda

Los conectores personalizados deben usar la información de la zona horaria de UserSettings del contexto pasado en init() para ser coherentes con la representación de la línea de tiempo.

Ámbito

La característica de conectores personalizados es compatible con los formularios de tabla de sesión única y multisesión en las aplicaciones de modelo de cliente de Interfaz unificada.

Fuera de ámbito

La siguiente funcionalidad no está disponible para la función de conectores personalizados:

Escenarios sin conexión y sin conexión de forma predeterminada
Paneles
Ubicaciones donde TimelineWallControl no está disponible (como aplicaciones convergentes, aplicaciones de lienzo, Power Pages, páginas personalizadas, etc.)

Limitaciones conocidas

Los recursos web configurados no se declaran formalmente como dependencias del formulario. Esto significa que exportar un formulario no exportará automáticamente los recursos web y deberán agregarse a esa exportación manualmente. Además, puede ser fácil eliminar accidentalmente estos recursos web.

Desarrollar un origen de registro

Al desarrollar un origen de registro, asegúrese de seguir estas prácticas:

Asegúrese de que está recuperando datos de forma segura. El modelo de seguridad Interfaz unificada considera que los recursos web JS y JSON no son de confianza y, por lo tanto, dichos recursos no deben contener tokens ni secretos, ya que se almacenarían en texto sin formato.
Si los datos están dentro de Dataverse, use el objeto de contexto del comportamiento inicial para realizar solicitudes en Dataverse. Llama a Dataverse desde el contexto, las solicitudes se han enviado a través de un iFrame seguro. Así es como las fuentes de registro listas para usar dentro de TimelineWallControl recuperan datos.
Si los datos están fuera de Dataverse, utilice los mecanismos existentes de la plataforma para recuperar datos externos.
Pruebe los cambios localmente mediante Fiddler: mejore la agilidad del desarrollo y la depuración de recursos web de JavaScript mediante Fiddler AutoResponder. Más información: Desarrollo de recursos web de scripts con Fiddler AutoResponder.
Reducir el riesgo de ataques XSS: el riesgo de ataques XSS se produce al agregar/vincular HTML al DOM. Utilice texto sin formato siempre que sea posible para reducir este riesgo. Si se requiere HTML, debe limpiar este contenido antes de agregarlo al registro.
Siga las mejores prácticas generales para la creación de scripts de clientes. Más información: Scripts de cliente en aplicaciones basadas en modelos
Garantizar prácticas de diseño inclusivas, incluido el uso de herramientas de prueba automatizadas, como Accessibility Insights.

Muestra de solución

Puede empezar con una muestra de solución de conectores personalizados que tiene el recurso web "SecondaryRecordSource", que está configurado para los formularios "Cuenta para experiencias interactivas" y "Cuenta para experiencias multisesión".

Consulte también

Usar la escala de tiempo
Configurar la escala de tiempo

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).

Compartir a través de