Textové šablony¶

Textové šablony poskytují centrální správu lokalizovaných textů pro workflow akce, notifikace a formuláře. Šablony jsou uloženy v Cosmos DB a přístupné přes API.

Přehled¶

Systém šablon podporuje čtyři typy:

Typ	Lokalizační pole	Použití
Text	`content`	Obecné texty, popisky, zprávy
Task	`title`, `body`	Názvy a popisy workflow úloh
Email	`subject`, `body`	Předmět a tělo e-mailových notifikací
Print	`title`, `body`	Tiskové šablony s Handlebars syntaxí (viz Tiskové šablony)

Struktura šablony¶

Každá šablona je uložena jako dokument v kontejneru templates v Cosmos DB. Dokument obsahuje všechny jazykové lokalizace:

{
  "id": "template-WelcomeMessage",
  "templateName": "WelcomeMessage",
  "templateType": "Text",
  "localizations": {
    "1029": { "content": "Vítejte {User.Name}" },
    "1033": { "content": "Welcome {User.Name}" }
  },
  "version": 1,
  "isActive": true,
  "tenantId": "<tenant-id>"
}

Šablona úlohy (Task)¶

{
  "id": "template-ApprovalTask",
  "templateName": "ApprovalTask",
  "templateType": "Task",
  "localizations": {
    "1029": {
      "title": "Vyžadováno schválení: {item:Title}",
      "body": "Zkontrolujte a schvalte dokument."
    },
    "1033": {
      "title": "Approval Required: {item:Title}",
      "body": "Please review and approve the document."
    }
  },
  "version": 1,
  "isActive": true,
  "tenantId": "<tenant-id>"
}

Šablona e-mailu (Email)¶

{
  "id": "template-TaskAssignedEmail",
  "templateName": "TaskAssignedEmail",
  "templateType": "Email",
  "localizations": {
    "1029": {
      "subject": "Nový úkol přiřazen: {item:Title}",
      "body": "<p>Dobrý den,</p><p>Byl vám přiřazen nový úkol.</p>"
    },
    "1033": {
      "subject": "New Task Assigned: {item:Title}",
      "body": "<p>Hello,</p><p>A new task has been assigned to you.</p>"
    }
  },
  "version": 1,
  "isActive": true,
  "tenantId": "<tenant-id>"
}

Lokalizace¶

Jazykové verze jsou identifikovány pomocí LCID kódu:

LCID	Jazyk
1029	Čeština
1033	Angličtina (US)
1031	Němčina

Priorita výběru jazyka¶

Požadovaný LCID (dle parametru nebo nastavení uživatele)
Angličtina (1033) — výchozí fallback
První dostupná lokalizace v šabloně
Prázdný řetězec — pokud šablona nemá žádnou lokalizaci

Použití ve workflow¶

Token `{TextResource:}`¶

Textové šablony se ve workflow akcích odkazují tokenem {TextResource:NázevŠablony}:

<SetFieldValue
  TargetField="Comments"
  Value="{TextResource:WelcomeMessage}" />

Token se nahradí hodnotou šablony v jazyce odpovídajícím aktuálnímu kontextu.

Poznámka: Starší formát {TiSp:NázevŠablony} je stále podporován pro zpětnou kompatibilitu, ale pro nové konfigurace se doporučuje {TextResource:}.

Šablony v akcích úloh¶

Akce Assign Task podporuje vlastnosti TaskTitleTemplate a TaskBodyTemplate, které odkazují na šablonu typu Task. Hodnoty title a body ze šablony se použijí pro název a popis úlohy.

Šablony v e-mailových akcích¶

Akce Send Mail podporuje vlastnost EmailTemplate, která odkazuje na šablonu typu Email. Hodnoty subject a body ze šablony se použijí pro předmět a tělo e-mailu.

Vytvoření šablony¶

Vytvořte dokument v kontejneru templates v Cosmos DB s příslušným templateType
Přidejte lokalizace pro požadované jazyky
Nastavte isActive na true
Odkazujte šablonu ve workflow akcích pomocí tokenu {TextResource:NázevŠablony} nebo pomocí vlastnosti *Template příslušné akce

API přístup¶

Šablony jsou dostupné přes API endpoint:

GET /templates?type=text&templates=WelcomeMessage&lcid=1029

Parametr	Popis	Výchozí
type	Typ šablony (`text` nebo `print`).	`text`
templates	Názvy šablon oddělené čárkou, nebo `all` pro všechny.	`all`
lcid	Kód jazyka.	`1033`

Poznámka: Pouze šablony s isActive: true jsou vráceny API.