Använda anpassade anslutningsprogram med tidslinjekontrollen

Anpassade anslutningsprogram är en funktion som gör det möjligt för utvecklare att lyfta information som t.ex. Dataverse-tabellrader, externa datakällor o.s.v. som poster inom komponenten TimelineWallControl. Det möjliggör en större uppsättning scenarier utöver de befintliga anteckningarna, inläggen och aktiviteterna.

Information om hur du konfigurerar och använder tidslinjen finns i följande avsnitt:

• Använd tidslinje
• Konfigurera tidslinje
• Konfiguration av kort för tidslinjepost

Poster som konfigureras i anpassade anslutningsprogram är en JavaScript-webbresurs som överensstämmer med IRecordSource-gränssnittet. Namnet på en webbresurs, tillsammans med konstruktorn (namn inklusive namnrymd) och en valfri JSON-webbresursväg, kan läggas till som en UClientRecordSourcesJSON-parameterkonfiguration i FormXML.

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

TimelineWallControl förväntas läsa in JavaScript-webbresursen och sedan skapa instansen av IRecordSource från den konfigurerade konstruktorn.

IRecordSource initieras sedan (init), med en begäran om sidor med poster (getRecordsData), begäran om filterdetaljer (getFilterDetails) och en begäran om UX-representation av en enskild post (getRecordUX).

Svaret från att begära poster bevaras för att minimera antalet postförfrågningar som sker i scenarier med flera sessioner.

Konfigurera det anpassade anslutningsprogram för tidslinjekontrollen

Du kan lägga till eller redigera dit anpassade anslutningsprogram för tidslinjekontrollen genom att konfigurera den i skaparupplevelsen.

1. På tidslinjekontrollen väljer du det formulär där du vill lägga till eller redigera det anpassade anslutningsprogram.

2. Slutför ett av följande alternativ:

   • Om du vill lägga till ett nytt anpassat anslutningsprogram, i rutan Egenskaper för tidslinjetabellen, i Anpassade anslutningsprogram, välj Lägg till anslutningsprogram. Fönstret Nytt anpassat anslutningsprogram visas.

     

   • För att redigera ett befintligt anpassat anslutningsprogram som du redan har laddat upp väljer du anpassat anslutningsprogram i rutan Egenskaper för entiteten tidslinje och sedan Redigera. Fönstret Nytt anpassat anslutningsprogram visas.

     

3. Redigera formuläret och välj spara.

Filtersupport

Anpassad kontaktfiltersupport omfattar följande:

• Lägga till ny filtertyp i befintlig filtergrupp
• Lägg till ny filtergrupp
• Uppdatera det befintliga filtertypantalet
• Filtrera söknyckel

För anpassade anslutningar måste UserSettings tidszonsinformation från sammanhang som skickas i init() användas för att vara konsekventa med rendering i tidslinjen.

Definitionsområde

Anpassade anslutningsprogram stöds i ensessions- och flersessionstabellformulär i klientmodellappar med enhetligt gränssnitt.

Omfattas ej

Följande funktioner är inte tillgängliga för funktionen för anpassade anslutningsprogram:

• Offline- och offline som standard-scenarier
• Instrumentpaneler
• Platser där TimelineWallControl inte är tillgängligt (t.ex. konvergerade appar, arbetsyteappar, Power Pages, anpassade sidor o.s.v.)

Kända begränsningar

De konfigurerade webbresurserna fungerar inte som beroenden i formuläret. Det betyder att när du exporterar ett formulär exporteras inte webbresurserna automatiskt och de måste läggas till i den exporten manuellt. Dessutom kan det vara enkelt att av misstag ta bort dessa webbresurser.

Utveckla en postkälla

När du utvecklar en postkälla bör du följa dessa metoder:

• Se till att du hämtar data på ett säkert sätt. I enhetligt gränssnitt-säkerhetsmodellen anses inte JS- och JSON-webbresurser vara betrodda. Sådana resurser bör därför inte innehålla token eller hemligheter eftersom de lagras i oformaterad text.
• Om data finns i Dataverse kan du använda kontextobjektet från init för att göra förfrågningar till Dataverse. Anrop till Dataverse från sammanhang har förfrågningar via en säker iframe. På det här viset hämtar de färdiga postkällorna inom TimelineWallControl data.
• Om informationen finns utanför Dataverse använder du befintliga metoder från plattformen för att hämta externa data.
• Lokalt testar du ändringar med hjälp av Fiddler: Förbättra flexibiliteten i utvecklingen och felsökningen av JavaScript-webbresurser med hjälp av Fiddler AutoResponder. Mer information: Utvecking av skriptwebbresurs med Fiddler AutoResponder.
• Minska risken för XSS-angrepp: Risken för XSS-angrepp uppstår när HTML läggs till/binds till DOM. Minska risken genom att använda oformaterad text när det är möjligt. Om HTML krävs måste du sanera innehållet innan du lägger till det i posten.
• Följ allmänna rekommendationer för klientskript. Mer information: Klientskript i modellbaserade appar
• Säkerställa utformningsrutiner, bland annat användning av automatiserade testverktyg som tillgänglighetsinsikter.

Exempel på lösning

Du kan komma igång med ett exempel på lösning för anpassade anslutningsprogram som har webbresursen "SecondaryRecordSource", som har konfigurerats för formulären "Konto för interaktiva upplevelser" och "Konto för upplevelser av flera sessioner".

Se även

Använd tidslinje
Konfigurera tidslinje

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).