Utilizarea de conectori personalizați cu controlul cronologiei

Articol
03/14/2023

Funcția de conectori particularizați oferă dezvoltatorilor o modalitate de a afișa informații precum rânduri de tabel Dataverse, surse de date externe și așa mai departe, ca intrări de înregistrări în componenta TimelineWallControl. Permite un set mai larg de scenarii în plus față de notele, postările și activitățile existente, gata de utilizare.

Pentru informații despre configurarea și utilizarea cronologiei, consultați următoarele subiecte:

Înregistrările care sunt configurate în conectori particularizați sunt o resursă web JavaScript care este conformă cu interfața IRecordSource. Numele unei resurse web, împreună cu constructorul (numele inclusiv spațiul de nume) și calea opțională a resursei web JSON, pot fi adăugate ca o configurație a parametrului UClientRecordSourcesJSON în FormXML.

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

TimelineWallControl este de așteptat să încarce resursa web JavaScript și apoi să creeze instanța IRecordSource din constructorul configurat.

IRecordSource este apoi inițializat (init), cu o solicitare pentru pagini de înregistrări (getRecordsData), o solicitare pentru detalii de filtrare (getFilterDetails) și o solicitare pentru reprezentarea UX a unei singure înregistrări (getRecordUX).

Răspunsul de la solicitarea înregistrărilor este persistent pentru a minimiza numărul de solicitări de înregistrări care apar în scenariile cu mai multe sesiuni.

Configurați conectorul personalizat pentru controlul cronologiei

Puteți adăuga sau edita conectorul personalizat pentru controlul cronologiei, configurându-l în experiența maker.

Pe controlul cronologiei, selectați formularul pentru care doriți să adăugați sau să editați conectorul personalizat.
Completați una dintre următoarele opțiuni:
- Pentru a adăuga un nou conector personalizat, în panoul Proprietăți pentru tabelul cronologic, în Conectori personalizați, selectați Adăugați conector. Este afișat panoul Conector personalizat nou .
- Pentru a edita un conector personalizat existent pe care l-ați încărcat deja, în panoul Proprietăți pentru entitatea cronologică, selectați conectorul personalizat, apoi selectați Editați. Se afișează panoul Editare conector personalizat .
Editați pagina, apoi selectați Salvați.

Compatibilitate filtru

Compatibilitatea pentru filtrul de conector particularizat include următoarele abilități.

Adăugați un nou tip de filtru la grupul de filtre existent
Adăugați un grup nou de filtre
Actualizați numărul existent de tipuri de filtru
Filtrați după cheia de căutare

Conectorii particularizați trebuie să utilizeze informațiile UserSettings Timezone din contextul transmis în init() pentru a fi consecvenți cu randarea cronologiei.

Domeniu de acoperire

Caracteristica conectorilor particularizați este acceptată în formularele de tabel cu o singură sesiune și cu mai multe sesiuni în aplicațiile model client Interfață unificată.

În afara domeniului de aplicare

Următoarea funcționalitate nu este disponibilă pentru caracteristica conectorilor particularizați:

Scenarii offline și offline implicite
Tablouri de bord
Locații în care TimelineWallControl nu este disponibil (cum ar fi aplicațiile convergente, aplicațiile create pe planșă, Power Pages, paginile particularizate și așa mai departe)

Limitări cunoscute

Resursele web configurate nu sunt declarate oficial ca dependențe de formular. Aceasta înseamnă că exportarea unui formular nu va exporta automat resursele web și ar trebui adăugate manual la acel export. În plus, poate fi ușor să ștergeți accidental aceste resurse web.

Dezvoltați o sursă de înregistrare

Când dezvoltați o sursă de înregistrare, asigurați-vă că urmați aceste practici:

Asigurați-vă că preluați datele în siguranță. Modelul de securitate Interfață unificată consideră resursele web JS și JSON ca nefiind de încredere și, prin urmare, astfel de resurse nu ar trebui să conțină tokenuri sau secrete în ele, deoarece ar fi stocate în text simplu.
Dacă datele sunt în interiorul Dataverse, utilizați obiectul context din comportamentul init pentru a face solicitări în Dataverse. Apelurile în Dataverse din context au solicitările trecute printr-un iframe securizat. Acesta este modul în care sursele de înregistrare gata de utilizare din TimelineWallControl regăsesc date.
Dacă datele sunt în afara Dataverse, utilizați mecanismele existente de pe platformă pentru a regăsi date externe.
Testați local modificările utilizând Fiddler: îmbunătățiți agilitatea dezvoltării și depanării resurselor web JavaScript utilizând Fiddler AutoResponder. Mai multe informații: Dezvoltarea resurselor web de script folosind Fiddler AutoResponder.
Reduceți riscul de atacuri XSS: Riscul de atacuri XSS apare atunci când adăugați/legați HTML la DOM. Folosiți text simplu ori de câte ori este posibil pentru a reduce acest risc. Dacă este necesar HTML, trebuie să dezinfectați acest conținut înainte de a-l adăuga la înregistrare.
Urmați cele mai bune practici generale pentru scriptarea clientului. Mai multe informații: Scriptarea clientului în aplicațiile proiectate pe bază de model
Asigurați practici de proiectare incluzive, inclusiv utilizarea instrumentelor automate de testare, cum ar fi Accesibility Insights.

Eșantion de soluție

Puteți începe cu un eșantion de soluție de conectori paarticularizați care are resursa web "SecondaryRecordSource", care este configurată pentru formularele "Cont pentru experiențe interactive" și "Cont pentru experiențe cu mai multe sesiuni".

Consultați și

Utilizați cronologia
Configurare cronologie

Notă

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).

Partajați prin