Brug brugerdefinerede forbindelser sammen med tidslinjekontrol

Brugerdefinerede connectorer er en funktion, der giver udviklere en måde at få vist oplysninger på, f.eks. Dataverse-tabelrækker, eksterne datakilder osv. som poster i komponenten TimelineWallControl. Det giver mulighed for et mere omfattende sæt scenarier ud over de eksisterende in-of-box-noter, indlæg og aktiviteter.

Du kan finde oplysninger om, hvordan du konfigurerer og bruger tidslinjen, i følgende emner:

• Bruge tidslinje
• Konfigurere tidslinje
• Konfiguration af tidslinjepostkort

Poster, der er konfigureret i brugerdefinerede forbindelser, er en JavaScript-webressource, der er i overensstemmelse med grænsefladen i IRecordSource. Navnet på en webressource kan sammen med konstruktøren (navnet inklusive navneområdet) og den valgfrie JSON-webressourcesti tilføjes som en UClientRecordSourcesJSON-parameterkonfiguration i FormXML.

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

TimelineWallControl forventes at indlæse JavaScript-webressourcen og derefter oprette forekomsten af IRecordSource ud fra den konfigurerede konstruktør.

Derefter initialiseres IRecordSource (init) med en forespørgsel på sider med poster (getRecordsData), forespørgesel efter filerdetaljer (getFilterDetails) og en forespørgsel om UX-repræsentation af en enkelt post (getRecordUX).

Svaret fra anmodende poster er vedvarende for at minimere antallet af postanmodninger, der opstår i scenarier med flere sessioner.

Konfigurer den brugerdefinerede connector for tidslinjekontrolelementet

Du kan tilføje eller redigere din brugerdefinerede connector for tidslinjekontrolelementet ved at konfigurere den i udvikleroplevelsen.

1. Vælg den formular, du vil tilføje eller redigere den brugerdefinerede connector for, i tidslinjekontrolelementet.

2. Udfyld en af følgende indstillinger:

   • Hvis du vil tilføje en ny brugerdefineret connector, skal du vælge Tilføj connector i Brugerdefinerede connectorer i ruden Egenskaber for tidslinjetabellen. Ruden Ny brugerdefineret connector vises.

     

   • Hvis du vil redigere en eksisterende brugerdefineret connector, du allerede har overført, skal du vælge den brugerdefinerede connector i ruden Egenskaber for tidslinjeobjektet og derefter vælge Rediger. Ruden Rediger brugerdefineret connector vises.

     

3. Rediger siden, og vælg Gem.

Filersupport

Det brugerdefinerede connectorfilter understøttes i følgende funktioner.

• Føj ny filtertype til eksisterende filtergruppe
• Tilføje nye filtergruppe
• Opdatere det eksisterende antal filtertyper
• Filter på søgenøgle

Brugerdefinerede connectorer skal bruge UserSettings Timezone-oplysninger fra den kontekst, der overføres i init() for at være konsistente med tidsvisning.

Område

Brugerdefinerede connectorer understøttes i formularer til en enkelt session og tabelformularer med flere sessioner Unified Interface klientmodelapps.

Uden for område

Følgende funktioner er ikke tilgængelige for brugerdefinerede forbindelser-funktioner:

• Offline- og offlinescenarier som standard
• Dashboards
• Steder, hvor TimelineWallControl ikke er tilgængelig (f.eks. konvergerede apps, lærredapps, Power Pages, brugerdefinerede sider osv)

Kendte begrænsninger

De konfigurerede webressourcer understøtter ikke afhængigheder i formularen. Det betyder, at eksport af en formular ikke automatisk eksporterer webressourcerne, og at de skal føjes til den pågældende eksport manuelt. Derudover kan det være nemt ved et uheld at slette disse webressourcer.

Udvikling af en postkilde

Når du udvikler en postkilde, skal du følge disse fremgangsmåder:

• Sørg for, at du henter data sikkert. I Unified Interface-sikkerhedsmodellen betragter JS og JSON-webressourcer som ikke-tillid til dem, og sådanne ressourcer skal derfor ikke indeholde tokener eller hemmeligheder i dem, da de ville være gemt som almindelig tekst.
• Hvis dataene findes i Dataverse, kan du bruge kontekstobjektet fra init-funktionsmåden til at foretage forespørgsler til Dataverse. Når der ringes ind til Dataverse fra konteksten, vises forespørgsler via en sikker iframe. Det er på den måde, in-of-box postkilder i TimelineWallControl henter data på.
• Hvis dataene ikke findes i Dataverse, kan du bruge eksisterende mekanismer fra platformen til at hente eksterne data.
• Test ændringerne lokalt ved hjælp af Fiddler: Øg fleksibiliteten i udviklingen og fejlfindingen af JavaScript-webressourcer ved hjælp af Fiddler AutoResponder. Yderligere oplysninger: Udvikling af scriptbaserede webressourcer ved hjælp af Fiddler AutoResponder.
• Reducer risikoen for XSS-angreb: Der opstår en risiko for XSS-angreb under tilføjelse/binding af HTML til DOM. Brug almindelig tekst, når det er muligt, for at reducere denne risiko. Hvis der kræves HTML, skal du rense indholdet, før du føjer det til posten.
• Følg de generelle bedste fremgangsmåder for klientscripts. Flere oplysninger: Klientscripts i modelbaserede apps
• Sikre effektive designmetoder, herunder brug af automatiserede testværktøjer, f.eks. tilgængelighedsindblik.

Eksempel på løsning

Du kan komme i gang med et eksempel på en brugerdefineret connector-løsning, der indeholder webressourcen "SecondaryRecordSource", som er konfigureret til formularerne "Account for Interactive Experiences" og "Account for Multisession Experiences".

Se også

Bruge tidslinje
Konfigurere tidslinje

Bemærk

Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)

Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).