SetVariableStr

Nastaví proměnnou typu string v procesu 
declare function SetVariableStr dll "ActualDocument" (string, string, string, pointer): boolean
Res := SetVariableStr("", "Firma", "Leviom data", actualdocument)
SetVariableStr(CaseId, Name, Value, ActualDocument)

Parametry

CaseId

Typ: string

Obsahuje id procesu. Pro aktuální proces je možné zadat prázdný řetezec nebo klíčové slovo actualdocument .

Name

Typ: string

Název proměnné.

Value

Typ: string

Hodnota, jenž má být uložena do proměnné.

ActualDocument

Typ: pointer

Klíčové slovo actualdocument odkazující na aktuální proces. Je-li zadáno nil , vytváří se nové připojení k enTeam (pomalejší).

Návratová hodnota

Typ: boolean

Pokud se podařilo proměnnou nastavit, vrátí true , jinak false . Pro získání popisu chyby použijte funkci GetLastErrorMessage .

Popis

Pokud proměnná zadaná v parametru Name v procesu existuje, je naplněna hodnotou Value . Pokud neexistuje v procesu, ale existuje v datovém slovníku, funkce ji do procesu přidá. Pokud neexistuje ani v datovém slovníku, funkce skončí chybou.

Ukázky volání

  • Nastaví proměnnou Firma v aktuálním procesu 
    Res := SetVariableStr("", "Firma", "Leviom data", actualdocument)
  • Nastaví proměnnou Firma v definovaném procesu, vytvoří si nové připojení do enTeam (pomalé) 
    Res := SetVariableStr("MTB_000020O", "Firma", "Leviom data", nil)