Integrace s GetCourse
Automatizované vytváření a rozesílání diplomů a certifikátů z GetCourse po dokončení školení nebo webináře. Odkaz na vytvořený diplom bude uložen v údajích studenta v GetCourse.
Vytvoření procesu
Pro zasílání požadavků na vytvoření souborů v DiMaker je nutné vytvořit proces v GetCourse. Otevřete záložku „Úkoly“ – „Procesy“. Poté klikněte na „Vytvořit proces“. Vyplňte název a vyberte možnost „Typ objektu“ – „Uživatelé“.
Okno tvorby procesu
Dále v procesu zvolte záložku „Proces“ a vpravo klikněte na „Přidat blok“ – „Operace“.
Okno vytvoření procesu – přidání URL volání
V zobrazeném okně vyberte „Volání URL“ (poslední položka) a klikněte na „Uložit“.
Okno tvorby procesu – úkol
V hlavním okně vyberte metodu POST a do pole URL vložte příkazový řetězec, který musí obsahovat:
- URL požadavku – https://dimaker.app/api/v1/create/?
- API token – secure (dostupné v nastavení DiMakeru)
- ID dokumentu – doc_id Dokument, na jehož základě bude certifikát nebo diplom vytvořen
- ID složky – folder_id Složka na Disku, kde bude soubor uložen
- ID šablony e-mailu – mail_id Šablona e-mailu pro zaslání souboru
- Data pro nahrazení, každá proměnná začínající mask_
Nejprve rozebereme detailně všechny tyto datumy, a poté ukážeme, jak má finální příkaz vypadat.
Proměnné
V požadavku jsou povinné proměnné, které umožňují přístup k DiMaker účtu, zadávají, který dokument použít, do jaké složky uložit soubor atd.
Povinné proměnné jsou označeny hvězdičkou.
-
secure*
Token (řetězec, 36 znaků) z nastavení „API Tokeny“ v DiMakeru.
-
doc_id*
ID dokumentu (řetězec, 36 znaků), který bude použit pro vytvoření souboru. ID lze získat z adresního řádku při otevření dokumentu. Dokument nesmí být v koši, ale může být uložen v libovolné složce Dokumenty.
-
mail_id
ID šablony e-mailu (řetězec, 36 znaků), který bude použit k odeslání souboru. Pokud není proměnná předána, e-mail nebude odeslán.
-
email_send
Čas odeslání e-mailu. Může nabývat následujících hodnot:
onfinish – Odeslat všechny e-maily po vytvoření všech souborů (výchozí)
oncreate – Odeslat e-maily ihned po vytvoření každého souboru.
timeout – E-maily budou odeslány po zadaném časovém intervalu. V tomto případě je nutné dodat ještě dvě další hodnoty:
email_timeout_value – číslo intervalu (např. počet hodin/dnů)
email_timeout_unit – jednotka intervalu: „m“ (minuty), „h“ (hodiny) nebo „d“ (dny).
Nebo lze zadat přesný čas odeslání v unixovém formátu pod email_timeout_timestamp. Pokud jsou předány timeout a email_timeout_timestamp současně, má timestamp přednost. -
folder_id
ID složky na Disku (řetězec, 36 znaků), kam se budou soubory ukládat. Pokud složka neexistuje, bude vytvořena automaticky při vytvoření prvního souboru.
-
page_id
Číslo listu (číslo nebo řetězec), pokud dokument obsahuje více listů. Můžete předat jedno číslo (první list = 0) nebo více čísel oddělených čárkou.
-
result
Určuje, v jakém formátu bude vrácen výsledek:
- Prázdná hodnota – vrací se obsahující výsledek požadavku.
- link – vrací odkaz na vytvořený soubor, pokud je požadavek úspěšný.
- file – vrací přímo vytvořený soubor, pokud je požadavek úspěšný.
Proměnné v dokumentu
DiMaker vyžaduje minimálně jednu proměnnou pro nahrazení, například %name nebo %city. Proměnné musí být psány latinkou.
Při sestavování URL musí být proměnná pojmenována pomocí prefixu mask_. Např. proměnná %name se v URL zapíše mask_name. Data pro tyto proměnné lze převzít z údajů v profilu uživatele v GetCourse. Hodnoty se zapisují do požadavku pomocí formátu {object.jmeno_pole}.
Toto je překládací ukázka části textu. V případě zájmu lze překlad rozšířit o další části dle vašich potřeb.