Aangepaste connectors gebruiken met het besturingselement voor de tijdlijn

Artikel
03/16/2023

Met de functie voor aangepaste connectors kunnen ontwikkelaars informatie vinden, zoals Dataverse-tabelrijen, externe gegevensbronnen, enzovoort, als recordinvoer in het onderdeel TimelineWallControl. Deze functie zorgt voor een bredere set scenario's naast de bestaande standaard notities, berichten en activiteiten.

Zie de volgende onderwerpen voor informatie over het configureren en gebruiken van de tijdlijn:

Records die zijn geconfigureerd binnen aangepaste connectors, zijn een JavaScript-webresource die voldoet aan de IRecordSource-interface. De naam van een webresource, samen met de constructor (naam inclusief naamruimte) en optioneel JSON-webresourcepad, kan worden toegevoegd als een UClientRecordSourcesJSON-parameterconfiguratie binnen FormXML.

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

Met TimelineWallControl wordt naar verwachting de JavaScript-webresource geladen en wordt vervolgens de instantie van IRecordSource vanuit de geconfigureerde constructor gemaakt.

De IRecordSource wordt vervolgens geïnitialiseerd (init) met een verzoek om pagina's met records (getRecordsData), een verzoek om filterdetails (getFilterDetails) en een verzoek om de UX-weergave van één record (getRecordUX).

Het antwoord van aanvragende records blijft behouden om het aantal recordaanvragen dat optreedt in scenario's met meerdere sessies te minimaliseren.

De aangepaste connector gebruiken voor het besturingselement voor de tijdlijn

U kunt uw aangepaste connector voor het besturingselement voor de tijdlijn toevoegen of bewerken door deze te configureren in de ervaring voor makers.

Selecteer in het besturingselement voor de tijdlijn het formulier waarvoor u de aangepaste connector wilt toevoegen of bewerken.
Voltooi een van de volgende opties:
- Als u een nieuwe aangepaste connector wilt toevoegen, selecteert u in het deelvenster Eigenschappen voor de tijdlijntabel in Aangepaste connectors de optie Connector toevoegen. Het deelvenster Nieuwe aangepaste connector wordt weergegeven.
- Als u een bestaande aangepaste connector wilt bewerken die u al hebt geüpload, selecteert u in het deelvenster Eigenschappen voor de tijdlijnentiteit de aangepaste connector en vervolgens Bewerken. Het deelvenster Aangepaste connector bewerken wordt weergegeven.
Bewerk de pagina en selecteer vervolgens Opslaan.

Filterondersteuning

Ondersteuning voor aangepaste connectorfilters omvat de volgende mogelijkheden.

Nieuw filtertype toevoegen aan bestaande filtergroep
Nieuwe filtergroep toevoegen
Het aantal bestaande filtertypen bijwerken
Filteren op zoeksleutel

Aangepaste connectoren moeten UserSettings-tijdzone-informatie gebruiken uit de context die is doorgegeven in init() om consistent te zijn met tijdlijnweergave.

Bereik

De functie Aangepaste connectors wordt ondersteund in tabelformulieren voor één sessie en meerdere sessies in apps van Unified Interface-clientmodel.

Buiten bereik

De volgende functionaliteit is niet beschikbaar voor de functie Aangepaste connectors:

Offline en standaard offline scenario's
Dashboards
Locaties waar TimelineWallControl niet beschikbaar is (zoals geconvergeerde apps, canvas-apps, Power Pages, aangepaste pagina's enzovoort)

Bekende beperkingen

De geconfigureerde webresources zijn niet formeel gedeclareerd als afhankelijkheden van het formulier. Dit betekent dat bij het exporteren van een formulier de webresources niet automatisch worden geëxporteerd en dat ze handmatig aan die export moeten worden toegevoegd. Bovendien kan het gemakkelijk zijn om deze webresources per ongeluk te verwijderen.

Een recordbron ontwikkelen

Zorg er bij het ontwikkelen van een recordbron voor dat u de volgende werkwijzen volgt:

Zorg ervoor dat u gegevens veilig ophaalt. Het Unified Interface-beveiligingsmodel beschouwt JS- en JSON-webresources als niet-vertrouwd, en daarom mogen dergelijke resources geen tokens of geheimen bevatten, omdat ze in platte tekst worden opgeslagen.
Als de gegevens binnen Dataverse zijn, gebruikt u het contextobject van init-gedrag om verzoeken in te voeren in Dataverse. Oproepen naar Dataverse vanuit context hebben verzoeken via een beveiligd iframe geproxied. Dit is hoe standaard recordbronnen binnen TimelineWallControl gegevens ophalen.
Als de gegevens zich buiten Dataverse bevinden, gebruikt u bestaande mechanismen van het platform om externe gegevens op te halen.
Lokaal wijzigingen met behulp van Fiddler testen: verbeter de flexibiliteit van ontwikkeling en foutopsporing van JavaScript-webresources door Fiddler AutoResponder te gebruiken. Meer informatie: Ontwikkeling van scriptwebresources met Fiddler AutoResponder.
Verminder het risico op XSS-aanvallen: het risico op XSS-aanvallen treedt op bij het toevoegen/verbinden van HTML aan DOM. Gebruik waar mogelijk platte tekst om dit risico te verkleinen. Als HTML vereist is, moet u deze inhoud opschonen voordat u deze aan de record toevoegt.
Volg de algemene aanbevolen procedures voor clientscripting. Meer informatie: Clientscripting in modelgestuurde apps
Zorg voor inclusieve ontwerpmethoden, inclusief het gebruik van geautomatiseerde testtools zoals Accessibility Insights.

Voorbeeld van oplossing

U kunt aan de slag gaan met een voorbeeld van een oplossing voor aangepaste connectors die de "SecondaryRecordSource"-webresource heeft, die is geconfigureerd voor de formulieren "Account voor interactieve ervaring" en "Account voor meerdere sessies".

Zie ook

Tijdlijn gebruiken
Tijdlijn configureren

Notitie

Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)

De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).

Delen via