Używanie łączników niestandardowych z kontrolką osi czasu

Artykuł
03/15/2023

Łączniki niestandardowe to funkcja, która umożliwia deweloperom udostępnianie informacji, takich jak wiersze tabeli Dataverse, zewnętrzne źródła danych i tak dalej, jako wpisów rekordów w składniku TimelineWallControl. Pozwala na szerszy zestaw scenariuszy oprócz istniejących notatek, postów i działań.

Aby uzyskać informacje o konfigurowaniu i używaniu osi czasu, zobacz następujące tematy:

Rekordy skonfigurowane w ramach łączników niestandardowych są zasobem sieci Web JavaScript zgodnym z interfejsem IRecordSource. Nazwę zasobu sieci Web wraz z konstruktorem (nazwa łącznie z przestrzenią nazw) i opcjonalną ścieżką zasobu sieci Web JSON można dodać jako konfigurację parametru UClientRecordSourcesJSON w FormXML.

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

Oczekuje się, że TimelineWallControl załaduje zasób sieci Web JavaScript, a następnie utworzy wystąpienie IRecordSource ze skonfigurowanego konstruktora.

Następnie inicjowane jest IRecordSource (init), z żądaniem stron rekordów (getRecordsData), żądaniem szczegółów filtra (getFilterDetails) i żądaniem reprezentacji UX pojedynczego rekordu (getRecordUX).

Odpowiedź z żądających rekordów jest utrwalana w celu zminimalizowania liczby żądań rekordów, które występują w scenariuszach wielosesyjnych.

Konfigurowanie łącznika niestandardowego z kontrolką timeline

Łącznik niestandardowy formantu timeline można dodać lub edytować, konfigurując go w interfejsie tworzenia klienta.

W kontrolce timeline wybierz formularz, dla którego chcesz dodać lub zmodyfikować łącznik niestandardowy.
Zakończ jedną z następujących opcji:
- Aby dodać nowy łącznik niestandardowy, w okienku Właściwości tabeli osi czasu w łącznikach niestandardowych wybierz opcję Dodaj łącznik. Zostanie wyświetlone okienko Nowy łącznik niestandardowy.
- Aby edytować istniejący łącznik niestandardowy, który został już przekazany, w okienku Właściwości encji osi czasu zaznacz łącznik niestandardowy, a następnie wybierz opcję Edytuj. Zostanie wyświetlone okienko Edytuj łącznik niestandardowy.
Edytuj stronę i wybierz Zapisz.

Filtruj pomoc techniczną

Obsługa filtrów łącznika niestandardowego obejmuje następujące możliwości.

Dodawanie nowego typu filtru do istniejącej grupy filtrów
Dodaj nową grupę filtrów
Zaktualizuj istniejący typ filtru
Filtruj według klucza wyszukiwania

Łączniki niestandardowe muszą używać informacji o strefie czasowej UserSettings z kontekstu przekazanego w init(), aby były spójne z renderowaniem osi czasu.

Zakres

Funkcja łączników niestandardowych jest obsługiwana w formularzach tabel jednosesyjnych i wielosesyjnych w aplikacjach modelu klienta ujednoliconego interfejsu.

Poza zakresem

Następujące funkcje nie są dostępne dla funkcji łączników niestandardowych:

Scenariusze offline i domyślne offline
Pulpity nawigacyjne
Lokalizacje, w których TimelineWallControl nie jest dostępne (takie jak aplikacje konwergentne, aplikacje kanwy, Power Pages, strony niestandardowe itd.)

Znane ograniczenia

Skonfigurowane zasoby sieci Web nie są formalnie deklarowane jako zależności od formularza. Oznacza to, że eksportowanie formularza nie spowoduje automatycznego wyeksportowania zasobów sieci Web i należy je dodać do tego eksportu ręcznie. Ponadto może być łatwo przypadkowo usunąć te zasoby internetowe.

Tworzenie źródła rekordów

Opracowując źródło rekordów, postępuj zgodnie z poniższymi praktykami:

Upewnij się, że pobierasz dane bezpiecznie. Model zabezpieczeń ujednoliconego interfejsu traktuje zasoby sieci Web JS i JSON jako niezaufane, dlatego takie zasoby nie powinny zawierać w sobie tokenów ani wpisów tajnych, ponieważ byłyby przechowywane w postaci zwykłego tekstu.
Jeśli dane są w obrębie Dataverse, użyj obiektu context z zachowania init, aby wprowadzić żądania do Dataverse. Wywołania w Dataverse z kontekstu mają żądania proxy za pośrednictwem bezpiecznego elementu iframe. W ten sposób wychodzące z pudełka źródła rekordów w TimelineWallControl pobierają dane.
Jeśli dane są poza Dataverse, użyj istniejących mechanizmów z platformy, aby pobrać dane zewnętrzne.
Lokalnie testuj zmiany za pomocą Fiddler: Zwiększ elastyczność programowania i debugowania zasobów sieci Web JavaScript za pomocą Fiddler AutoResponder. Więcej informacji: Skrypt tworzenia zasobów internetowych przy użyciu narzędzia Fiddler AutoResponder.
Zmniejsz ryzyko ataków XSS: Ryzyko ataków XSS występuje podczas dodawania/wiązania kodu HTML z dom. Używaj zwykłego tekstu, gdy tylko jest to możliwe, aby zmniejszyć to ryzyko. Jeśli wymagany jest kod HTML, należy oczyścić tę zawartość przed dodaniem jej do rekordu.
Postępuj zgodnie z ogólnymi sprawdzonymi metodami dotyczących skryptów klienta. Więcej informacji: Skrypty klienta w aplikacjach opartych na modelu
Zapewnij kompleksowe praktyki projektowe, w tym korzystanie z automatycznych narzędzi do testowania, takich jak Accessibility Insights.

Przykład rozwiązania

Możesz rozpocząć pracę z przykładem rozwiązania łączników niestandardowych, który ma zasób sieci Web „SecondaryRecordSource”, który jest skonfigurowany dla formularzy „Konto dla środowisk interaktywnych” i „Konto dla środowisk wielosesyjnych”.

Zobacz też

Użyj oś czasu
Przeprowadź konfigurację osi czasu

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).

Share via