Verwenden Sie angepasste Konnektoren mit dem Steuerelement für die Zeitleiste

Die angepassten Konnektoren sind eine Funktion, die es Entwicklern ermöglicht, Informationen wie Dataverse-Tabellenzeilen, externe Datenquellen usw. als Datensätze in der Komponente TimelineWallControl anzuzeigen. Es lässt eine breitere Palette von Szenarien zu, zusätzlich zu den bestehenden „Out-of-Box“-Notizen, -Posts und -Aktivitäten.

Informationen zur Konfiguration und Verwendung der Zeitleiste finden Sie in den folgenden Themen:

• Zeitskala verwenden
• Konfigurieren der Zeitskala
• Konfiguration der Datensätze für die Zeitleiste

Datensätze, die innerhalb angepasster Konnektoren konfiguriert werden, sind eine JavaScript-Webressource, die der IRecordSource-Schnittstelle entspricht. Der Name einer Webressource kann zusammen mit dem Konstruktor (Name einschließlich Namespace) und dem optionalen JSON-Webressourcenpfad als UClientRecordSourcesJSON-Parameter-Konfiguration innerhalb von FormXML hinzugefügt werden.

JSON

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

Von TimelineWallControl wird erwartet, dass es die JavaScript-Webressource lädt und dann die Instanz von IRecordSource über den konfigurierten Konstruktor erstellt.

Die IRecordSource wird dann initialisiert (init), mit einer Anfrage für Seiten von Datensätzen (getRecordsData), Anfrage für Filterdetails (getFilterDetails), und einer Anfrage für die UX-Darstellung eines einzelnen Datensatzes (getRecordUX).

Die Antwort auf die Abfrage von Datensätzen wird gespeichert, um die Anzahl der Datensatzabfragen in Multisession-Szenarien zu minimieren.

Den benutzerdefinierten Connector für das „timeline“-Steuerelement konfigurieren

Sie können Ihren benutzerdefinierten Connector für das „timeline“-Steuerelement hinzufügen oder bearbeiten, indem Sie ihn in der Umgebung für Ersteller konfigurieren.

1. Wählen Sie im „timeline“-Steuerelement das Formular aus, für das Sie den benutzerdefinierten Connector hinzufügen oder bearbeiten möchten.

2. Führen Sie eine der folgenden Optionen aus:

   • Um einen neuen benutzerdefinierten Connector hinzuzufügen, wählen Sie im Bereich Eigenschaften für die Zeitachsentabelle und unter Benutzerdefinierte Connectors Connector hinzufügen aus. Der Bereich Neuer benutzerdefinierter Connector wird angezeigt.

     

   • Um einen vorhandenen benutzerdefinierten Connector zu bearbeiten, den Sie bereits hochgeladen haben, wählen Sie im Bereich Eigenschaften für die Zeitleistenentität, wählen Sie dann den benutzerdefinierten Connector und dann Bearbeiten aus. Der Bereich Benutzerdefinierten Connector bearbeiten wird angezeigt.

     

3. Bearbeiten Sie die Seite und wählen Sie Speichern.

Filterunterstützung

Die Unterstützung für benutzerdefinierte Connector-Filter umfasst die folgenden Fähigkeiten.

• Neuen Filtertyp zu bestehender Filtergruppe hinzufügen
• Neue Filtergruppe hinzufügen
• Aktualisieren Sie die Anzahl der vorhandenen Filtertypen
• Filter in Suchtaste

Benutzerdefinierte Konnektoren müssen UserSettings-Zeitzoneninformationen aus dem in init() übergebenen Kontext verwenden, um mit dem Rendern der Zeitachse konsistent zu sein.

Geltungsbereich

Die angepasste Konnektorenfunktion werden innerhalb von Single-Session- und Multi-Session-Tabellenformularen in Unified Interface Client Model Apps unterstützt.

Außerhalb des Bereichs

Die folgenden Funktionen sind für die Funktion der angepassten Konnektoren nicht verfügbar:

• Offline- und Offline-by-default-Szenarien
• Dashboards
• Orte, an denen TimelineWallControl nicht verfügbar ist (z.B. konvergente Apps, Canvas Apps, Power Pages, angepasste Seiten usw.)

Bekannte Einschränkungen

Die konfigurierten Web-Ressourcen sind nicht formell als Abhängigkeiten zum Formular deklariert. Das bedeutet, dass beim Export eines Formulars die Webressourcen nicht automatisch exportiert werden, sondern manuell hinzugefügt werden müssen. Außerdem kann es leicht passieren, dass diese Webressourcen versehentlich gelöscht werden.

Entwickeln Sie eine Datensatz-Quelle

Achten Sie bei der Entwicklung einer Datensatz-Quelle darauf, diese Praktiken zu befolgen:

• Stellen Sie sicher, dass Sie die Daten sicher abrufen. Das Sicherheitsmodell der einheitlichen Benutzeroberfläche betrachtet JS- und JSON-Web-Ressourcen als nicht vertrauenswürdig und daher sollten solche Ressourcen keine Token oder Geheimnisse enthalten, da diese im Klartext gespeichert werden würden.
• Wenn sich die Daten innerhalb von Dataverse befinden, verwenden Sie das Kontextobjekt aus dem Init-Verhalten, um Anfragen in Dataverse zu stellen. Bei Aufrufen von Dataverse aus dem Kontext werden die Anfragen durch einen sicheren Iframe geleitet. So rufen die standardmäßigen Datensätze in TimelineWallControl Daten ab.
• Wenn die Daten außerhalb von Dataverse liegen, verwenden Sie vorhandene Mechanismen der Plattform, um externe Daten abzurufen.
• Testen Sie Änderungen vor Ort mit Fiddler: Verbessern Sie die Agilität bei der Entwicklung und Fehlersuche von JavaScript Web-Ressourcen durch den Einsatz von Fiddler AutoResponder. Weitere Informationen: Skript zur Entwicklung von Web-Ressourcen mit Fiddler AutoResponder.
• Verringern Sie das Risiko von XSS-Angriffen: Das Risiko von XSS-Angriffen besteht beim Hinzufügen/Binden von HTML zum DOM. Verwenden Sie nach Möglichkeit reinen Text, um dieses Risiko zu verringern. Wenn HTML erforderlich ist, müssen Sie diesen Inhalt bereinigen, bevor Sie ihn dem Datensatz hinzufügen.
• Befolgen Sie die allgemeinen bewährten Verfahren für Client-Skripting. Weitere Informationen: Client-Scripting in modellbasierten Apps
• Sorgen Sie für ein inklusives Design, einschließlich der Verwendung von automatisierten Test-Tools wie Accessibility Insights.

Beispiel für eine Lösung

Sie können mit einem Angepassten Konnektoren-Lösungsbeispiel beginnen, das die Webressource „SecondaryRecordSource“ enthält, die für die Formulare „Konto für interaktive Erlebnisse“ und „Konto für Multisession-Erlebnisse“ konfiguriert ist.

Siehe auch

Zeitskala verwenden
Konfigurieren der Zeitskala

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).