Uživatelem definované funkce v důvěrném registru Azure (Preview)

Důvěrný registr Azure poskytuje uživatelem definované funkce (UDF) pro spouštění vlastní logiky v registru. Tato funkce umožňuje rozšířit funkce registru tím, že napíšete vlastní kód, který lze spustit v důvěrném prostředí a pracovat s daty registru.

Nové možnosti programování umožňují uživatelům vytvářet jednoduché a pokročilé uživatelsky definované funkce pro provádění různých operací s různou úrovní přizpůsobení. Po definování lze uživatelem definované funkce vyvolat z klientů důvěrného účetního dokladu Azure tak, aby se přímo spustily uvnitř motoru registru.

Důležité

Uživatelem definované funkce jsou aktuálně ve verzi PREVIEW. Přístup k této verzi Preview můžete požádat prostřednictvím tohoto registračního formuláře. Další podmínky použití pro Microsoft Azure Preview najdete v právních podmínkách, které se vztahují na funkce Azure, které jsou v beta verzi, preview nebo jinak dosud nebyly vydány v obecné dostupnosti.

Jednoduché a pokročilé funkce definované uživatelem

Důvěrný registr Azure nabízí dva typy funkcí definované uživatelem:

  • Jednoduché funkce definované uživatelem: Jednoduché funkce definované uživatelem jsou jednoduché vlastní funkce, které lze definovat a spouštět uvnitř registru. Umožňují provádět jednoduché operace pomocí javascriptového rozhraní API a dají se integrovat s existujícím rozhraním API pro zápis do registru. Další informace o jednoduchých uživatelem definovaných funkcích najdete tady.

  • Pokročilé definované funkce uživatelem (UDF): Pokročilé definované funkce uživatelem (UDF) jsou uživatelsky definované koncové body, které je možné definovat a vystavit v aplikaci účetní knihy. Tyto koncové body je možné použít k zveřejnění sofistikovanějších rozhraní API s přizpůsobitelnými parametry, formáty dat a mechanismy ověřování. Další informace o pokročilých UDF najdete zde.

Tady je porovnání hlavních funkcí a možností jednoduchých a pokročilých UDF (funkcí definovaných uživatelem):

Schopnost Jednoduché funkce definované uživatelem Pokročilé funkce definované uživatelem
Spuštění vlastní obchodní logiky Ano Ano
Přizpůsobení argumentů runtime / parametrů Ano Ano
Zveřejnění nového rozhraní API nebo koncových bodů Ne Ano
Spuštění jednotlivých funkcí Ano Ne
Spuštění háků před /po operaci zápisu položky registru Ano Ne
Vytvoření a aktualizace vlastního kódu Ano (podrobná aktualizace nebo odstranění jednotlivých funkcí) Ano (aktualizace jedné sady aplikací pro všechny koncové body)
Vlastní možnosti modulu runtime JavaScriptu Ano (pro každé spuštění) Ano (globálně)
Provádění na záložních uzlech Ne Ano
Podpora více formátů dat pro vstup a výstup Ne Ano
Vlastní ověřování a autorizace Ne Ano
Cílové scénáře Provádění jednoduché vlastní logiky a integrace s rozhraním API registru Pokročilé případy použití vyžadující vlastní rozhraní API a kontrolu nad pokročilými parametry JavaScriptu

Přepínání mezi jednoduchými a pokročilými funkcemi definovanými uživatelem

Jednoduché a pokročilé funkce definované uživatelem jsou navzájem neslučitelné. Pokud jsou definované pokročilé funkce definované uživatelem a naopak, nemůžete vytvářet ani spouštět jednoduché funkce definované uživatelem. Mezi těmito dvěma funkcemi je možné přepínat pomocí následujícího postupu.

Důležité

Přepínání mezi jednoduchými a pokročilými UDF je ničivý proces. Při přechodu na jinou funkci se odstraní všechny existující jednoduché nebo pokročilé UDF (uživatelsky definované funkce). Než budete pokračovat, nezapomeňte zálohovat všechna důležitá data.

Jednoduché až pokročilé funkce definované uživatelem (UDFs)

Chcete-li změnit jednoduché UDF na pokročilé UDF, musíte odstranit všechny stávající UDF:

  1. Vypište všechny uživatelsky definované funkce uložené v registru pomocí GET /app/userDefinedFunctions rozhraní API.

  2. Odstraňte jednotlivé uživatelem definované funkce jeden po druhém pomocí DELETE /app/userDefinedFunctions/{functionId} rozhraní API.

Od pokročilých UDF po jednoduché

Pokud chcete přejít z pokročilých na jednoduché funkce definované uživatelem, musíte definovat pokročilé funkce definované uživatelem s prázdnými moduly a definicemi koncových bodů.

  1. Vytvořte novou sadu aplikací s následující strukturou:

    {
    "metadata": {
        "endpoints": {}
    }, 
   "modules": []
}

  2. Nasaďte sadu aplikací s textem požadavku definovaným v kroku 1 pomocí PUT /app/userDefinedEndpoints rozhraní API.

Další kroky

Pokud chcete začít s funkcemi UDF v důvěrném registru Azure, podívejte se na následující články:

Související obsah

  • Last updated on