Bruk egendefinerte koblinger med tidslinjekontrollen

Artikkel
03/15/2023

Egendefinerte koblinger-funksjonen gjør det mulig for utviklere å vise informasjon som Dataverse-tabellrader, eksterne datakilder og så videre, som postoppføringer i TimelineWallControl-komponenten. Det gir mulighet for et bredere sett med scenarier i tillegg til eksisterende standardnotater, -innlegg og -aktiviteter.

Hvis du vil ha informasjon om hvordan du konfigurerer og bruker tidslinjen, kan du se følgende emner:

Poster som er konfigurert i egendefinerte koblinger, er en JavaScript-webressurs som samsvarer med IRecordSource-grensesnittet. Navnet på en webressurs, sammen med konstruktøren (navn inkludert navneområde) og valgfri JSON-webressursbane, kan legges til som en UClientRecordSourcesJSON-parameterkonfigurasjon i FormXML.

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

TimelineWallControl forventes å laste inn JavaScript-webressursen og deretter opprette forekomsten av IRecordSource fra den konfigurerte konstruktøren.

IRecordSource initialiseres deretter (init), med en forespørsel om sider med poster (getRecordsData), forespørsel om filterdetaljer (getFilterDetails) og en forespørsel om UX-representasjon av en enkelt post (getRecordUX).

Svaret fra anmodende poster er vedvarende for å minimere antallet postforespørsler som forekommer i scenarier for flere økter.

Konfigurere den egendefinerte koblingen for tidslinjekontrollen

Du kan legge til eller redigere den egendefinerte koblingen for tidslinjekontrollen ved å konfigurere den i maker-opplevelsen.

På tidslinjekontrollen velger du skjemaet du vil legge til eller redigere den egendefinerte koblingen for.
Fullfør et av følgende alternativer:
- Hvis du vil legge til en ny egendefinert kobling, velger du Legg til kobling i Egendefinerte koblinger i Egenskaper-ruten for tidslinjetabellen. Ruten Ny egendefinert kobling vises.
- Hvis du vil redigere en eksisterende egendefinert kobling du allerede har lastet opp, går du til Egenskaper-ruten for tidslinjeenheten, velger den egendefinerte koblingen og velger deretter Rediger. Rediger egendefinert kobling vises.
Rediger siden, og velg deretter Lagre.

Filterstøtte

Støtte for egendefinert tilkoblingsfilter inkluderer følgende.

Legge til ny filtertype i eksisterende filtergruppe
Legge til en ny filtergruppe
Oppdater eksisterende filtertype
Filtrer på søkenøkkel

Egendefinerte koblinger må bruke informasjon om UserSettings Timezone fra kontekst som sendes i init() for å være konsekvent med gjengivelse av tidslinje.

Omfang

Egendefinerte koblinger-funksjonen støttes i tabellskjemaer for én økt og flere økter i Enhetlig grensesnitt-klientmodellapper.

Utenfor området

Følgende funksjonalitet er ikke tilgjengelig for funksjonen for egendefinerte koblinger:

Scenarioer i frakoblet modus og frakoblet som standard
Instrumentbord
Steder der TimelineWallControl ikke er tilgjengelig (for eksempel konvergerte apper, lerretsapper, Power Pages, egendefinerte sider og så videre)

Kjente begrensninger

De konfigurerte webressursene deklareres ikke formelt som avhengigheter til skjemaet. Dette betyr at eksport av et skjema ikke automatisk eksporterer webressursene, og at de må legges til i eksporten manuelt. I tillegg kan det være enkelt å slette disse webressursene ved et uhell.

Utvikle en postkilde

Når du utvikler en postkilde, må du følge disse fremgangsmåtene:

Kontroller at du henter data på en sikker måte. Den Enhetlig grensesnitt-sikkerhetsmodellen anser JS- og JSON-nettressurser som ikke-klarerte, og dermed bør slike ressurser ikke inneholde tokener eller hemmeligheter, da de vil bli lagret i ren tekst.
Hvis dataene er innenfor Dataverse, bruker du kontekstobjektet fra init-virkemåten til å sende forespørsler til Dataverse. Ved kall til Dataverse fra kontekst vises forespørsler via en sikker iFrame. Slik henter standard postkilder i TimelineWallControl data.
Hvis dataene er utenfor Dataverse, bruker du eksisterende mekanismer fra plattformen til å hente eksterne data.
Test endringer lokalt ved hjelp av Fiddler: Forbedre smidigheten ved utvikling og feilsøking av JavaScript-nettressurser ved hjelp av Fiddler AutoResponder. Mer informasjon: Utvikling av Skript-webressurs ved bruk av Fiddler AutoResponder.
Reduser risikoen for XSS-angrep: Risikoen for XSS-angrep oppstår når du legger til / binder HTML til DOM. Bruk ren tekst når det er mulig for å redusere denne risikoen. Hvis HTML kreves, må du desinfisere dette innholdet før du legger det til i oppføringen.
Følg generelle gode fremgangsmåter for klientskripting. Mer informasjon: Klientskripting i modelldrevne apper
Sikre inkluderende designpraksis, inkludert bruk av automatiserte testverktøy som Accessibility Insights.

Eksempel på løsning

Du kan komme i gang med et løsningseksempel på egendefinerte koblinger som har nettressursen SecondaryRecordSource, som er konfigurert for skjemaene Konto for interaktive opplevelser og Forretningsforbindelse for opplevelse for flere økter.

Se også

Bruke tidslinjen
Konfigurere tidslinjen

Obs!

Kan du fortelle oss om språkinnstillingene for dokumentasjonen? Ta en kort undersøkelse. (vær oppmerksom på at denne undersøkelsen er på engelsk)

Undersøkelsen tar rundt sju minutter. Det blir ikke samlet inn noen personopplysninger (personvernerklæring).

Del via