Utilitzar connectors personalitzats amb el control de la cronologia

Els connectors personalitzats són una característica que proporciona una manera perquè els desenvolupadors puguin obtenir informació de superfície, com ara Dataverse files de taules, fonts de dades externes, etc., com a entrades de registres dins del component TimelineWallControl. Permet un conjunt més ampli d'escenaris, a més de les notes, publicacions i activitats existents.

Per obtenir informació sobre la configuració i l'ús de la cronologia, vegeu els temes següents:

Els registres que estan configurats dins de connectors personalitzats són un recurs web JavaScript que s'ajusta a la interfície IRecordSource. El nom d'un recurs web, juntament amb el constructor (nom que inclou l'espai de noms) i el camí opcional del recurs web JSON, es pot afegir com a configuració de paràmetres UClientRecordSourcesJSON dins del FormXML.

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

S'espera que TimelineWallControl carregui el recurs web JavaScript i després creï la instància d'IRecordSource des del constructor configurat.

L'IRecordSource s'inicialitza (init), amb una sol·licitud de pàgines de registres (getRecordsData) i una sol·licitud per a la representació UX d'un sol registre (getRecordUX).

La resposta dels registres de sol·licitud es manté per minimitzar el nombre de sol·licituds de registres que es produeixen en escenaris de diverses sessions.

Scope

Els connectors personalitzats s'admeten en formularis de taula d'una sessió i diverses sessions a Interfície unificada aplicacions de models de client.

Fora de l'abast

La funcionalitat següent no està disponible per a la característica de connectors personalitzats:

  • Escenaris fora de línia i fora de línia per defecte
  • Escriptoris digitals
  • Ubicacions on TimelineWallControl no està disponible (com ara aplicacions convergents, aplicacions de llenç, portals, pàgines personalitzades, etc.)

Limitacions conegudes

Els recursos web configurats no es declaren formalment com a dependències del formulari. Això vol dir que l'exportació d'un formulari no exportarà automàticament els recursos web i s'haurien d'afegir a aquesta exportació manualment. A més, pot ser fàcil eliminar accidentalment aquests recursos web.

Desenvolupar una font de registre

Quan desenvolupeu una font de registre, assegureu-vos de seguir aquestes pràctiques:

  • Assegureu-vos que esteu recuperant dades de manera segura. El model de seguretat Interfície unificada considera que els recursos web JS i JSON no són de confiança i, per tant, aquests recursos no haurien de contenir testimonis o secrets en ells, ja que s'emmagatzemarien en text sense format.
  • Si les dades són dins Dataverse de, utilitzeu l'objecte context del comportament init per fer sol·licituds a Dataverse. Les trucades en Dataverse context tenen sol·licituds apoderades a través d'un iframe segur. Així és com les fonts de registres fora de caixa dins de TimelineWallControl recuperen dades.
  • Si les dades estan fora de Dataverse, utilitzeu els mecanismes existents des de la plataforma per recuperar dades externes.
  • Prova localment els canvis mitjançant l'ús de Fiddler: Millora l'agilitat del desenvolupament i depuració dels recursos web de JavaScript mitjançant l'ús de Fiddler AutoResponder. Més informació: Desenvolupament de recursos web de scripts mitjançant Fiddler AutoResponder.
  • Reduir el risc d'atacs XSS: El risc d'atacs XSS es produeix quan s'afegeix / vincula HTML al DOM. Utilitzeu text sense format sempre que sigui possible per reduir aquest risc. Si es requereix HTML, heu de desinfectar aquest contingut abans d'afegir-lo al registre.
  • Seguiu les pràctiques recomanades generals per a l'scripting de clients. Més informació: Scripting de clients en aplicacions basades en models
  • Assegureu pràctiques de disseny inclusives, com ara l'ús d'eines de prova automatitzades, com ara estadístiques d'accessibilitat.

Mostra de solució

Podeu començar amb una mostra de solució de connectors personalitzada que tingui el recurs web "SecondaryRecordSource", que està configurat per als formularis "Compte per a experiències interactives" i "Compte per a experiències de multisessió".

Consulteu també

Utilitzar la cronologia
Configurar la cronologia