Differences

This shows you the differences between two versions of the page.

--- syntax:functions:system [2018/12/23 22:17] – dmitry
+++ syntax:functions:system [2021/11/22 07:38] (current) – [Currently supported keywords:] dmitry
@@ Line 1: / Line 1: @@
-===== System(keyword) =====
+====== System(keyword) ======
+Category:  Special function
-Returns system values. They keyword must be a text constant. Reference to a field or parameter not allowed.
+\\
+=====Description=====
+This function returns the system value specified by the //keyword// argument.  The //keyword// must be a text constant from the table below and may not be a data field reference or parameter.
-Currently supported keywords:
+\\
+=====Arguments=====
+^Argument^Type^Description^
+|keyword|Text  |One of the text constants from the table below specifying the system data desired.  |
+**Return value type:** Text (one of the Result values from the table below)
+\\
+====Currently supported keywords:====
 ^  Keyword  ^  Result  ^
-| user |The current Windows user. |
+| user |The Windows account of the current Windows process. On EasyMorph Server, it's the account of the worker that executes the project. |
-| projectpath |The full path to the current project including file name. |
+| identity | The Windows identity of the user that triggered the workflow. In EasyMorph Desktop, Launcher, and CLW it's the same as the Windows account of the current Windows process. On EasyMorph Server, if the current space uses authentication via Active Directory, then the function returns the account of the current user that is logged into the space. For all other space types, it returns an empty value. |
-| projectfilename |Current project’s file name only, without extension. |
+| projectpath |The full path to the current project, including file name. |
-| projectdir |Current project’s directory. |
+| projectfilename |The current project’s file name only, without the extension. |
-| callerpath |The full path to the calling project ((The calling project is the project that contains the [[transformations:call|Call]] or [[transformations:iterate|Iterate]] transformation that called the current project)) including file name. |
+| projectdir |The current project’s directory. |
+| callerpath |The full path to the calling project ((The calling project is the project that contains the [[transformations:call|Call]] or [[transformations:iterate|Iterate]] action that called the current project))  including file name. |
 | callerfilename |The file name (without extension) of the calling project. |
 | programdir |The full path to morph.exe. |
@@ Line 15: / Line 27: @@
 | utcoffset |The UTC offset to the system time zone ( e.g. "-04:00:00"). |
 | tempdir |The current temporary directory. |
-| projectappversion|The version of application that created current project |
+| projectappversion|The version of the application that created current project |
+\\
+=====Examples=====
-**Example**
+  system('projectpath') = "C:\Documents\myproject.morph"
-^  Example  ^  Result  ^
-| system('projectpath')  |C:\Documents\myproject.morph |
-**See also**
+  system('projectfilename') = "myproject.morph"
-  * [[syntax:functions:today]]
-  * [[syntax:functions:now]]
+\\
+=====See also=====
+  * [[syntax:functions:metadata|Metadata(keyword)]]
+  * [[syntax:functions:now|Now()]]
+  * [[syntax:functions:today|Today()]]