{"componentChunkName":"component---src-templates-default-template-tsx","path":"/ki-syntax/functions/if/","result":{"data":{"asciidoc":{"id":"c31facd1-17f1-5551-a32c-6e18ce9737ff","html":"
\n
Table of Contents
\n\n
\n
\n
\n
\n\n\n\n\n\n
\n\n\nAvoid using if constructs for large algorithms in a single KI. Please see the Logical Branching section for more information.\n
\n
\n
\n
\n
\n

Definition

\n
\n
\n

if allows conditional execution. It contains a condition to be evaluated first. If the condition is true, the then block gets executed. Otherwise if the condition is false, the optional else block gets executed.

\n
\n
\n
\n
\n

Usage

\n
\n
\n

The if block will check the exit code of a command:

\n
\n
\n
\n
stdout: ExecuteOutput,\nexit: Error = execute(\n\"/some/command/path -with arguments\",\nhost: \"_AAE_\"\n)\n\nif Error then\n    log.error(\"command exited with non-zero exit code\")\nelse\n    log(\"execute returned ${ExecuteOutput}\")\nend
\n
\n
\n
\n
\n
\n

Example

\n
\n
\n

The following example will check the numerical exit code of a command:

\n
\n
\n
\n
if LOCAL::CODE == \"0\" then\n    persData = \"extracted\"\n    delete(GetPersonData)\nelse\n    persData = \"failed\"\n    log(\"failed to get data for Person: ${persNo}\")\nend
\n
\n
\n
\n

You can also use \"and\" and \"or\" to consider multiple conditions within a single if block.

\n
\n
\n
\n
if LOCAL::CODE == \"0\" and LOCAL::Status == \"SUCCESS\" then\n    persData = \"extracted\"\n    delete(GetPersonData)\nend
\n
\n
\n
\n
","document":{"main":"if","title":"if","subtitle":""},"fields":{"toc":true,"location":["ki-syntax","functions","if"]}},"sidebarYaml":{"id":"6f28bdca-d703-5e79-ae00-b0508f8ee82a","showIndex":true}},"pageContext":{"id":"c31facd1-17f1-5551-a32c-6e18ce9737ff","parent":"ki-syntax"}},"staticQueryHashes":["1010459453","1010459453","2356112386","2356112386","2603905930","2603905930","3026652197","3026652197","3167850324","3167850324","63159454","63159454"]}