Token
Token {func:} umožňuje volání vestavěných funkcí workflow engine. Funkce mohou přijímat parametry a vracejí řetězcovou hodnotu.
Syntaxe
{func:FunctionName(param1, param2, ...)}
Parametry se oddělují čárkou. Pokud parametr obsahuje čárku, uzavřete jej do jednoduchých uvozovek: 'hodnota, s čárkou'.
Dostupné funkce
Datové funkce
| Funkce |
Popis |
{func:FormatDate(date, format)} |
Formátuje datum podle zadaného formátu (standard .NET). |
{func:DateAdd(date, datePart, amount)} |
Přičte k datu zadaný počet jednotek. |
{func:DateDiff(startDate, endDate, datePart)} |
Vrátí rozdíl mezi dvěma daty v zadaných jednotkách. |
{func:DateDiff(startDate, endDate, datePart, onlyPart)} |
Rozšířená varianta — onlyPart = true vrátí celkový rozdíl (např. celkový počet hodin). |
{func:DateCompare(date1, date2)} |
Vrátí true pokud date1 > date2. |
{func:DateCompare(date1, date2, dateOnly)} |
Porovná pouze datumovou část (bez času), pokud dateOnly = true. |
{func:GetSpDate} |
Vrátí aktuální datum ve formátu SharePoint. |
{func:GetSpDateTime} |
Vrátí aktuální datum a čas ve formátu SharePoint. |
Parametr datePart pro funkce DateAdd a DateDiff:
| Hodnota |
Význam |
y / yy / yyyy / year |
Roky |
m / mm / month |
Měsíce |
d / dd / day |
Dny |
h / hh / hour |
Hodiny |
mi / min / minute |
Minuty |
s / ss / sec / second |
Sekundy |
wk / wd / workday |
Pracovní dny |
Uživatelské funkce
| Funkce |
Popis |
{func:GetUserTitle(loginName)} |
Vrátí zobrazované jméno uživatele. |
{func:GetUserEmail(loginName)} |
Vrátí e-mailovou adresu uživatele. |
{func:GetUserId(loginName)} |
Vrátí SharePoint ID uživatele. |
{func:UserProp(loginName, propertyName)} |
Vrátí hodnotu vlastnosti uživatelského profilu. |
{func:ExpandUsers(users)} |
Rozbalí skupiny na jednotlivé uživatele. |
{func:ExpandUsers(users, recursive)} |
Rozbalí skupiny rekurzivně (true / false). |
Textové funkce
| Funkce |
Popis |
{func:Substring(text, maxLength)} |
Zkrátí text na zadanou délku s třemi tečkami. |
{func:Substring(text, maxLength, suffix)} |
Zkrátí text na zadanou délku s vlastní příponou. |
{func:GetValidName(text)} |
Odstraní z textu neplatné znaky pro názvy souborů SharePoint. |
{func:GetValidName(text, maxLength)} |
Odstraní neplatné znaky a ořízne na délku. |
{func:GetValidName(text, maxLength, isFile)} |
Parametr isFile (true/false) ovlivní validaci pro soubory. |
{func:GetValidName(text, folderPath, isFile, maxLength)} |
Validuje název v kontextu cílové složky. |
{func:GetValidName(text, folderPath, isFile, maxLength, hostUrl)} |
Validuje název včetně kontroly úplné URL. |
{func:Replace(text, find)} |
Odstraní výskyty řetězce find z textu. |
{func:Replace(text, find, replacement)} |
Nahradí výskyty řetězce find za replacement. |
{func:Replace(text, pattern, replacement, regexOptions)} |
Nahradí text pomocí regulárního výrazu. |
{func:Match(text, pattern, matchGroups, regexOptions)} |
Extrahuje části textu pomocí regulárního výrazu. |
{func:Match(text, pattern, matchGroups, regexOptions, separator)} |
Extrahuje s vlastním oddělovačem. |
{func:Enc(text)} |
Zakóduje text pro bezpečné vnořování do parametrů funkcí. |
{func:EncJson(variableName)} |
Zakóduje JSON proměnnou pro bezpečné použití ve výrazech. |
{func:EncLineBreak(text)} |
Nahradí konce řádků za \n. |
{func:EncText(text)} |
Zakóduje text pro bezpečné použití v JavaScript výrazech. Alias: EscapeJs. |
Parametr regexOptions pro funkce Replace a Match:
| Znak |
Význam |
i |
Ignorovat velikost písmen |
s |
Jednořádkový režim |
m |
Víceřádkový režim |
e |
ECMAScript režim |
c |
Nezávislé na kultuře |
r |
Zprava doleva |
Lookup funkce
| Funkce |
Popis |
{func:GetLookupValue(lookupField)} |
Extrahuje textovou hodnotu z lookup pole. |
{func:GetLookupId(lookupField)} |
Extrahuje ID z lookup pole. |
Výrazové funkce
| Funkce |
Popis |
{func:Expr(expression)} |
Vyhodnotí JavaScript výraz a vrátí výsledek. |
URL a kontextové funkce
| Funkce |
Popis |
{func:GetWebUrl} |
Vrátí absolutní URL aktuálního webu. |
{func:GetWebRelativeUrl} |
Vrátí relativní serverovou URL aktuálního webu. |
{func:GetAppUrl} |
Vrátí URL aplikace (bez serverové relativní cesty). |
{func:GetItemId} |
Vrátí ID aktuální položky. |
{func:IsOnline} |
Vrátí true pokud workflow běží v SharePoint Online. |
{func:GetVariable(name)} |
Vrátí hodnotu proměnné workflow. |
{func:GetVariable(name, workflowName)} |
Vrátí hodnotu proměnné z jiné instance workflow. |
{func:IsRunningWorkflow(wfName)} |
Vrátí true pokud na položce běží workflow se zadaným názvem. |
{func:IsRunningWorkflow(wfName, itemId)} |
Ověří na zadané položce. |
{func:IsRunningWorkflow(wfName, itemId, listName)} |
Ověří na zadané položce v zadaném seznamu. |
{func:GetTiSaAppUrl} |
Vrátí URL aplikace TiSa.BaseWeb. |
{func:GetTiSaVariable(key)} |
Vrátí hodnotu globální proměnné z konfigurace TiSa (podporuje šifrované hodnoty). |
Delegace a matice
| Funkce |
Popis |
{func:Oof(users)} |
Nahradí nepřítomné uživatele jejich zástupci. Alias: Delegate. |
{func:Oof(users, delegationName)} |
Použije konkrétní konfiguraci delegace. |
{func:GetMatrixUsers(matrixName, argumentValue)} |
Vrátí uživatele z konfigurační matice. |
{func:GetMatrixUsers(matrixName, argumentValue, allRows)} |
Pokud allRows = true, vrátí uživatele ze všech odpovídajících řádků. |
Data parsing
| Funkce |
Popis |
{func:JsonPath(json, path)} |
Extrahuje hodnotu z JSON řetězce pomocí JSONPath výrazu. |
{func:XPath(xml, xpath)} |
Extrahuje hodnotu z XML řetězce pomocí XPath výrazu. |
{func:XPath(xml, xpath, namespace)} |
Extrahuje s definicí namespace. |
Příklady
{func:FormatDate({item:Created}, 'dd.MM.yyyy')}
Výsledek: 15.01.2025
Příklad: Přičtení 5 pracovních dní
{func:DateAdd({func:GetSpDateTime}, workday, 5)}
Příklad: Zobrazovací jméno iniciátora
{func:GetUserTitle({wf:initiator})}
Příklad: JavaScript výraz
{func:Expr(var x = {item:Amount}; x > 1000 ? 'VIP' : 'Standard';)}
Příklad: Regulární výraz
{func:Replace({item:Description}, '\s+', ' ', i)}