Použití vlastních konektorů s ovládacím prvkem časové osy

Článek
03/15/2023

Funkce vlastních konektorů poskytuje vývojářům způsob, jak získat informace – například řádky tabulky Dataverse, externí zdroje dat a tak dále – v podobě záznamů v rámci komponenty TimelineWallControl. Kromě existujících integrovaných poznámek, příspěvků a aktivit umožňuje rozsáhlejší sadu scénářů použití.

Informace o konfiguraci a používání časové osy naleznete v následujících tématech:

Záznamy, které jsou konfigurovány v rámci vlastních konektorů, jsou webovým zdrojem jazyka JavaScript, který umí využívat rozhraní IRecordSource. Název webového zdroje spolu s konstruktorem (název včetně jmenného prostoru) a volitelnou cestou webového zdroje JSON lze přidat jako konfiguraci parametru UClientRecordSourcesJSON v rámci FormXML.

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

Očekává se, že TimelineWallControl načte webový zdroj JavaScriptu a poté vytvoří instanci s rozhraním IRecordSource z konfigurovaného konstruktoru.

Poté se inicializuje IRecordSource (init) požadavkem na stránky záznamů (getRecordsData), požadavkem na detaily filtru (getFilterDetails) a požadavkem na UX reprezentaci jednoho záznamu (getRecordUX).

Odpověď z požadujících záznamů je trvale uložena, aby se minimalizoval počet požadavků na záznamy, ke kterým dochází v rámci scénářů s více relacemi.

Konfigurace vlastního konektoru pro ovládací prvek časové osy

Vlastní konektor pro ovládání časové osy můžete přidat nebo upravit tak, že ho nakonfigurujete v prostředí pro tvůrce.

Na ovládacím prvku časové osy vyberte formulář, pro který chcete přidat nebo upravit vlastní konektor.
Proveďte jednu z následujících možností:
- Chcete-li přidat nový vlastní konektor, v podokně Vlastnosti pro tabulku časové osy v části Vlastní konektory vyberte Přidat konektor. Zobrazí se podokno Nový vlastní konektor.
- Chcete-li upravit existující vlastní konektor, který jste již nahráli, v podokně Vlastnosti pro entitu časové osy vyberte vlastní konektor a poté vyberte Upravit. Zobrazí se podokno Upravit vlastní konektor.
Upravte stránku a poté vyberte Uložit.

Podpora filtrů

Podpora filtru vlastního konektoru zahrnuje následující schopnosti.

Přidání nového typu filtru do existující skupiny filtrů
Přidání nové skupiny filtrů
Aktualizace počtu existujících typů filtrů
Filtrování podle vyhledávacího klíče

Vlastní konektory musejí používat informace o časovém pásmu uživatelského nastavení z kontextu předávaného v init(), aby byly konzistentní s vykreslováním časové osy.

Obor

V aplikacích klientského modelu se sjednoceným rozhraním je funkce vlastních konektorů podporována ve formulářích tabulek s jednou relací a více relacemi.

Mimo rozsah

U vlastních konektorů nejsou k dispozici následující funkce:

Offline a výchozí offline scénáře
Řídicí panely
Místa, kde ovládací prvek TimelineWallControl není k dispozici (jako jsou konvergované aplikace, aplikace plátna, Power Pages, vlastní stránky atd.)

Známá omezení

Konfigurované webové zdroje nejsou formálně deklarovány jako závislosti na formuláři. To znamená, že při exportu formuláře se automaticky neexportují webové zdroje a je třeba je do exportu přidat ručně. Kromě toho se tyto webové zdroje dají snadno náhodně odstranit.

Vytvoření zdroje záznamů

Při návrhu zdroje záznamů se ujistěte, že dodržujete tyto postupy:

Ujistěte se, že data načítáte bezpečně. Model zabezpečení sjednoceného rozhraní považuje webové zdroje JS a JSON za nedůvěryhodné, a proto by takové zdroje neměly obsahovat tokeny ani tajné klíče, protože by byly uloženy jako prostý text.
Pokud jsou data uvnitř Dataverse, použijte k zadávání požadavků do Dataverse objekt kontextu z chování init. U volání směrovaného do Dataverse z kontextu jsou požadavky zasílány přes proxy zabezpečeného prvku iframe. Takto získávají data integrované zdroje záznamů v rámci ovládacího prvku TimelineWallControl.
Pokud jsou data mimo Dataverse, použijte k načtení externích dat existující mechanismy platformy.
Lokální testy změny provádějte pomocí nástroje Fiddler: Zlepšete agilitu vývoje a ladění webových zdrojů JavaScriptu pomocí nástroje Fiddler AutoResponder. Další informace: Vývoj webových prostředků skriptu pomocí nástroje Fiddler AutoResponder.
Snížení rizika útoků XSS: K riziku útoků XSS dochází při přidávání/vazbě HTML kódu do modelu DOM. Ke snížení tohoto rizika používejte formát prostého textu, kdykoli je to možné. Pokud je vyžadováno HTML, musíte tento obsah před přidáním do záznamu ošetřit.
Dodržujte obecné doporučené postupy pro klientské skriptování. Další informace: Klientské skriptování v modelem řízených aplikacích
Zajistěte dodržování inkluzivních návrhových postupů, včetně použití automatizovaných testovacích nástrojů, jako je Accessibility Insights.

Vzorové řešení

V začátcích použijte vzorové řešení vlastních konektorů obsahující webový zdroj „SecondaryRecordSource“, který je konfigurován pro formuláře „Obchodní vztah pro interaktivní prostředí“ a „Obchodní vztah pro prostředí vícenásobné relace“.

Viz také

Používání časové osy
Konfigurace časové osy

Poznámka

Můžete nám sdělit, jaké máte jazykové preference pro dokumentaci? Zúčastněte se krátkého průzkumu. (upozorňujeme, že tento průzkum je v angličtině)

Průzkum bude trvat asi sedm minut. Nejsou shromažďovány žádné osobní údaje (prohlášení o zásadách ochrany osobních údajů).

Sdílet prostřednictvím