@things-factory/reference-app 6.0.27 → 6.0.28

package/dist-client/helps/integration/concept/task.md

@@ -0,0 +1,25 @@
+# task
+
+- 태스크는 [시나리오 엔진](./scenario-engine.md)에 의해서 실행되는 최소 단위의 작업이다.
+- 태스크는 [시나리오](./scenario.md)의 각 스텝을 정의하기 위해 구현된 프로그램이다.
+- 태스크는 여러가지 기능을 복합적으로 가지지 않도록 단순하고 명료한 기능으로 구현하는 것이 좋다.
+- 태스크 구현에 필요한 여러가지 정보와 기능을 지원하기 위해서 시나리오에서는 [Scenario Context](./scenario-context.md)를 제공한다.
+- 태스크 종류는 다음과 같이 구분될 수 있다.
+
+## 구분
+
+- 독립 태스크
+  - Sleep, Log,
+  - publish - notify data with tag to subscribers
+- 플로우 컨트롤 태스크
+  - Goto Step : Map, Range, ..
+  - Sub Scenario : Map, Range, ..
+  - Throw
+  - End
+- [커넥션](./connection.md) 기반 태스크
+  - database-query
+  - graphql-query, mutator
+  - mqtt : subscribe/publish
+  - indydcp : Indy7 robot control
+  - modbus : read/writes..
+  - robotics related : camera, markers, ..

package/dist-client/helps/integration/connector/mqtt-connector.md

@@ -0,0 +1,17 @@
+# MQTT connector
+
+## MQTT is
+
+[MQTT](https://mqtt.org/) is The Standard for IoT Messaging
+
+## Setting
+
+### endpoint
+
+- MQTT Server URI
+  - Scheme
+    - mqtt[s]://[username][:password]@host.domain[:port]
+    - [mosquitto](https://mosquitto.org/) default port : 1883
+    - [RabbitMQ](https://www.rabbitmq.com/) default port : 15675
+  - eg.
+    - mqtt://user:password@localhost:1883

package/dist-client/helps/integration/connector/mssql-connector.md

@@ -0,0 +1,38 @@
+# MSSql connector
+
+## MSSql is
+
+[MSSql](https://www.microsoft.com/sql-server) is Microsoft SQL Server
+
+## Setting
+
+### endpoint
+
+MSSql engine hostname and service port
+
+- hostname : database server host
+- service port : database service port (default - 5432)
+- format
+  - {hostname}[:{port}]
+  - eg.
+    - "localhost:5432"
+    - "localhost"
+    - "192.168.0.1:5432"
+
+## Parameters
+
+### user
+
+- user id for MSSql database
+
+### password
+
+- user password for MSSql database
+
+### database
+
+- database name
+
+### encrypt
+
+- encrypted connection

package/dist-client/helps/integration/connector/oracle-connector.md

@@ -0,0 +1,66 @@
+# Oracle connector
+
+## Support
+    1. requires Oracle Client libraries version 11.2 or later
+    2. Can connect to Oracle Database 10g or later
+
+## Setting
+### MAC OS
+* install oracle client 
+    ```sh
+    cd $HOME/Downloads
+    curl -O https://download.oracle.com/otn_software/mac/instantclient/198000/instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+    hdiutil mount instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+    /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru/install_ic.sh
+    hdiutil unmount /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru
+
+    ln -s ~/Downloads/instantclient_19_8/libclntsh.dylib node_modules/oracledb/build/Release
+    ```
+
+### Linux
+* make oracle path
+    ```sh
+    mkdir -p /opt/oracle
+    cd /opt/oracle
+    ```
+* download newest oracle cilent for connect to Oracle Database
+    ```sh
+    wget https://download.oracle.com/otn_software/linux/instantclient/instantclient-basiclite-linuxx64.zip && \
+        unzip instantclient-basiclite-linuxx64.zip && \ 
+        rm -f instantclient-basiclite-linuxx64.zip && \
+        cd /opt/oracle/instantclient* && \
+        rm -f *jdbc* *occi* *mysql* *mql1* *ipc1* *jar uidrvci genezi adrci && \
+        echo /opt/oracle/instantclient* > /etc/ld.so.conf.d/oracle-instantclient.conf &&\
+        ldconfig
+    ```
+### Detail please Refer
+* https://oracle.github.io/node-oracledb/INSTALL.html
+
+
+## endpoint
+
+Oracle engine hostname and service port
+
+- hostname : database server host
+- service port : database service port (default - 1521)
+- format
+  - {hostname}[:{port}]
+  - eg.
+    - "localhost:1521"
+    - "localhost"
+    - "192.168.0.1:1521"
+
+## Parameters
+
+### user
+
+- user id for oracle database
+
+### password
+
+- user password for oracle database
+
+### database
+
+- oracle sid name
+

package/dist-client/helps/integration/connector/postgresql-connector.md

@@ -0,0 +1,34 @@
+# Postgresql connector
+
+## Postgresql is
+
+[PostgreSQL](https://www.postgresql.org/) is the World's Most Advanced Open Source Relational Database
+
+## Setting
+
+### endpoint
+
+Postgresql engine hostname and service port
+
+- hostname : database server host
+- service port : database service port (default - 5432)
+- format
+  - {hostname}[:{port}]
+  - eg.
+    - "localhost:5432"
+    - "localhost"
+    - "192.168.0.1:5432"
+
+## Parameters
+
+### user
+
+- user id for Postgresql database
+
+### password
+
+- user password for Postgresql database
+
+### database
+
+- database name

package/dist-client/helps/integration/connector/sqlite-connector.md

@@ -0,0 +1,17 @@
+# SQLite connector
+
+## SQLite is
+
+[SQLite](https://www.sqlite.org/index.html) is a C-language library that implements a small, fast, self-contained, high-reliability, full-featured, SQL database engine.
+
+## Setting
+
+### endpoint
+
+sqlite file path
+
+- relative path :
+  - base path(".") is folder application installed
+  - eg. "./db.sqlite"
+- or absolute path :
+  - eg. "/home/super/operato/db.sqlite"

package/dist-client/helps/integration/index.md

@@ -0,0 +1,37 @@
+# integration
+
+Integration은 외부 시스템과의 연결 서비스를 담당하는 관련 기능 세트로 정의된다.
+
+## concept
+
+- [connection](./concept/connection.md)
+- [scenario](./concept/scenario.md)
+- [task](./concept/task.md)
+- [scenario engine](./concept/scenario-engine.md)
+- [pending queue](./concept/pending-queue.md)
+- [scenario context](./concept/scenario-context.md)
+- [data accessor](./concept/data-accessor.md)
+
+## connector
+
+- [MQTT](./connector/mqtt-connector.md)
+- [oracle](./connector/oracle-connector.md)
+- [postgresql](./connector/postgresql-connector.md)
+- [mssql](./connector/mssql-connector.md)
+- [sqlite](./connector/sqlite-connector.md)
+
+## task
+
+- [book-up-scenario](./task/book-up-scenario.md)
+- [end](./task/end.md)
+- [floating-point](./task/floating-point.md)
+- [goto](./task/goto.md)
+- [local-graphql-mutate](./task/local-graphql-mutate.md)
+- [local-graphql-query](./task/local-graphql-query.md)
+- [mqtt-publish](./task/mqtt-publish.md)
+- [mqtt-subscribe](./task/mqtt-subscribe.md)
+- [pick-pending-scenario](./task/pick-pending-scenario.md)
+- [publish](./task/publish.md)
+- [script](./task/script.md)
+- [throw](./task/throw.md)
+- [variables](./task/variables.md)

package/dist-client/helps/integration/task/book-up-scenario.md

@@ -0,0 +1,24 @@
+# Bookup Scenario
+
+[지연 큐](../concept/pending-queue.md)에 지연된 시나리오를 추가하는 태스크이다.
+
+## parameters
+
+- scenario (mandatory)
+  - [지연 큐](../concept/pending-queue.md)에 추가될 지연 시나리오를 선택한다.
+- delay (mandatory)
+
+  - 지연 시간을 초 seconds 단위로 지정한다. -1로 지정하면, 지연없이 바로 [pickup](./pick-pending-scenario.md) 될 수 있다.
+  - 이 값에는 변수를 적용할 수 있다.
+  - 예시
+    - -1 => 지연 없음 no-delay
+    - 100 => 100 seconds
+    - #{recipe} => 'recipe' 스텝 결과 값
+    - #{pizza.cookingTime} => 'pizza' 스텝 결과 데이타의 cookingTime 값
+
+- priority
+  - 지연 시나리오의 우선 순위를 지정한다. default 값은 0이다.
+- variables
+  - 시나리오에 변수로 전달될 [accessor](../concept/data-accessor.md) 값을 설정한다.
+- tag
+  - 시나리오에 붙여질 태그를 설정한다.

package/dist-client/helps/integration/task/end.md

@@ -0,0 +1,3 @@
+# End Task
+
+Scenario를 정상 종료하는 태스크이다.

package/dist-client/helps/integration/task/floating-point.md

@@ -0,0 +1,34 @@
+# Floating Point
+
+The IEEE Standard for Floating-Point Arithmetic (IEEE 754) is a technical standard for floating-point arithmetic established in 1985 by the Institute of Electrical and Electronics Engineers (IEEE). The standard addressed many problems found in the diverse floating-point implementations that made them difficult to use reliably and portably. Many hardware floating-point units use the IEEE 754 standard.
+
+## parameters
+
+- [accessor](../concept/data-accessor.md)
+  - specify the value to be processed
+- operation
+  - read : Read IEEE754 floating point numbers from a Buffer
+  - write : Write IEEE754 floating point numbers to a Buffer
+- endian
+  - little : little endian
+  - big : big endian
+- float type
+  - float : 4byte single precision floating point
+  - double : 8byte double precision floating point
+
+## pseudo code
+
+```
+  const isLittleEndian = endian === 'little'
+  const nBytes = floatType === 'float' ? 4 : 8
+  const mantissa = floatType === 'float' ? 23 : 52
+
+  var result
+
+  if(operation == 'write') {
+    result = Buffer.alloc(nBytes)
+    ieee754.write(result, value, 0, isLittleEndian, mantissa, nBytes)
+  } else {
+    result = ieee754.read(value, 0, isLittleEndian, mantissa, nBytes)
+  }
+```

package/dist-client/helps/integration/task/goto.md

@@ -0,0 +1,8 @@
+# Goto Task
+
+'goto' 파라미터로 지정된 스텝으로 점프하는 태스크이다.
+
+## parameters
+
+- goto
+  - 이동할 스텝의 이름을 지정한다.

package/dist-client/helps/integration/task/graphql-mutate.md

@@ -0,0 +1,44 @@
+# GraphqlMutate Task
+
+서버에서 제공하는 graphql mutate API를 호출하는 태스크이다.
+MutationQuery를 작성할 때, 변수 처리는 다음과 같이 두 가지 방법으로 가능하며, 방법 2를 사용하기를 권장한다.
+
+방법 1. 시나리오 컨텍스트의 data와 variables를 변수로 활용할 수 있다.
+이 방법은 문자열 변수를 적용할 때 적합하다.
+
+```
+mutation {
+  syncAllMarketplaceOrder(fromDate: "${this.variables.fromDate}", toDate: "${this.variables.toDate}") {
+    ...
+  }
+
+  removeTagFromObject(tag: "${this.data.tag}") {
+    ...
+  }
+}
+```
+
+방법 2. varibles에 사용할 변수를 지정하고, graphql 변수 처리방법을 사용한다. variables의 값은 시나리오 컨텍스트의 data 에 대한 accessor로 지정할 수 있다.
+이 방법은 문자열 변수를 적용할 때 적합하다.
+
+```
+mutation($fromDate: String!, $toDate: String!) {
+  syncAllMarketplaceOrder(fromDate: $fromDate, toDate: $toDate) {
+    ...
+  }
+
+  removeTagFromObject(tag: $tag) {
+    ...
+  }
+}
+```
+
+## parameters
+
+- mutation
+
+  - graphql mutation 쿼리를 입력한다.
+
+- variables
+  - graphql query에서 사용될 변수를 정의한다.
+  - key예는 변수의 이름을 지정하며, value에는 변수값에 해당하는 data accessor를 설정한다.

package/dist-client/helps/integration/task/graphql-query.md

@@ -0,0 +1,44 @@
+# GraphqlQuery Task
+
+서버에서 제공하는 graphql query API를 호출하는 태스크이다.
+Query를 작성할 때, 변수 처리는 다음과 같이 두 가지 방법으로 가능하며, 방법 2를 사용하기를 권장한다.
+
+방법 1. 시나리오 컨텍스트의 data와 variables를 변수로 활용할 수 있다.
+이 방법은 문자열 변수를 적용할 때 적합하다.
+
+```
+query {
+  fetchWorkOrderHistory(fromDate: "${this.variables.fromDate}", toDate: "${this.variables.toDate}") {
+    ...
+  }
+
+  searchObjectWithTag(tag: "${this.data.tag}") {
+    ...
+  }
+}
+```
+
+방법 2. varibles에 사용할 변수를 지정하고, graphql 변수 처리방법을 사용한다. variables의 값은 시나리오 컨텍스트의 data 에 대한 accessor로 지정할 수 있다.
+이 방법은 문자열 변수를 적용할 때 적합하다.
+
+```
+query($filters: [Filter!], $sortings: [Sorting!], $pagination: Pagination, tag: String!) {
+  boards(filters: $filters, sortings: $sortings, pagination: $pagination) {
+    ...
+  }
+
+  searchObjectWithTag(tag: $tag) {
+    ...
+  }
+}
+```
+
+## parameters
+
+- query
+
+  - graphql query를 입력한다.
+
+- variables
+  - graphql query에서 사용될 변수를 정의한다.
+  - key예는 변수의 이름을 지정하며, value에는 변수값에 해당하는 data accessor를 설정한다.

package/dist-client/helps/integration/task/local-graphql-mutate.md

@@ -0,0 +1,44 @@
+# LocalGraphqlMutate Task
+
+서버에서 제공하는 graphql mutate API를 호출하는 태스크이다.
+MutationQuery를 작성할 때, 변수 처리는 다음과 같이 두 가지 방법으로 가능하며, 방법 2를 사용하기를 권장한다.
+
+방법 1. 시나리오 컨텍스트의 data와 variables를 변수로 활용할 수 있다.
+이 방법은 문자열 변수를 적용할 때 적합하다.
+
+```
+mutation {
+  syncAllMarketplaceOrder(fromDate: "${this.variables.fromDate}", toDate: "${this.variables.toDate}") {
+    ...
+  }
+
+  removeTagFromObject(tag: "${this.data.tag}") {
+    ...
+  }
+}
+```
+
+방법 2. varibles에 사용할 변수를 지정하고, graphql 변수 처리방법을 사용한다. variables의 값은 시나리오 컨텍스트의 data 에 대한 accessor로 지정할 수 있다.
+이 방법은 문자열 변수를 적용할 때 적합하다.
+
+```
+mutation($fromDate: String!, $toDate: String!) {
+  syncAllMarketplaceOrder(fromDate: $fromDate, toDate: $toDate) {
+    ...
+  }
+
+  removeTagFromObject(tag: $tag) {
+    ...
+  }
+}
+```
+
+## parameters
+
+- mutation
+
+  - graphql mutation 쿼리를 입력한다.
+
+- variables
+  - graphql query에서 사용될 변수를 정의한다.
+  - key예는 변수의 이름을 지정하며, value에는 변수값에 해당하는 data accessor를 설정한다.

package/dist-client/helps/integration/task/local-graphql-query.md

@@ -0,0 +1,44 @@
+# LocalGraphqlQuery Task
+
+서버에서 제공하는 graphql query API를 호출하는 태스크이다.
+Query를 작성할 때, 변수 처리는 다음과 같이 두 가지 방법으로 가능하며, 방법 2를 사용하기를 권장한다.
+
+방법 1. 시나리오 컨텍스트의 data와 variables를 변수로 활용할 수 있다.
+이 방법은 문자열 변수를 적용할 때 적합하다.
+
+```
+query {
+  fetchWorkOrderHistory(fromDate: "${this.variables.fromDate}", toDate: "${this.variables.toDate}") {
+    ...
+  }
+
+  searchObjectWithTag(tag: "${this.data.tag}") {
+    ...
+  }
+}
+```
+
+방법 2. varibles에 사용할 변수를 지정하고, graphql 변수 처리방법을 사용한다. variables의 값은 시나리오 컨텍스트의 data 에 대한 accessor로 지정할 수 있다.
+이 방법은 문자열 변수를 적용할 때 적합하다.
+
+```
+query($filters: [Filter!], $sortings: [Sorting!], $pagination: Pagination, tag: String!) {
+  boards(filters: $filters, sortings: $sortings, pagination: $pagination) {
+    ...
+  }
+
+  searchObjectWithTag(tag: $tag) {
+    ...
+  }
+}
+```
+
+## parameters
+
+- query
+
+  - graphql query를 입력한다.
+
+- variables
+  - graphql query에서 사용될 변수를 정의한다.
+  - key예는 변수의 이름을 지정하며, value에는 변수값에 해당하는 data accessor를 설정한다.

package/dist-client/helps/integration/task/log.md

@@ -0,0 +1,14 @@
+# log Task
+
+시나리오의 상태가 값의 변화를 확인하기 위해서 로그를 출력하는 기능이다. 
+해당 로그는 어플리케이션의 logs 폴더에 저장되며 'scenario-시나리오명'으로 시작하는 로그 파일에 저장된다.
+
+## parameters
+
+- 접근자
+  - 시나리오 내의 하나의 스텝이름으로, 해당 스텝의 결과 값을 출력하고자 할 경우에 접근자를 사용한다.
+- 메시지
+  - 특정한 메시지를 로그로 남겨둘 필요가 있을 경우 사용하며 메시지의 로그가 유효하기 위해서는 접근자가 빈 상태로 있어야 한다.
+  - 접근자는 항상 메시지보다 높은 우선 순위를 가진다. 접근자와 메시지가 모두 입력되어 있으면 접근자가 로그로 출력된다.
+- 레벨
+  - 로그 메시지의 레벨을 설정할 수 있다. 레벨은 'info', 'warn', 'error' 중에 하나를 선택할 수 있다.

package/dist-client/helps/integration/task/mqtt-publish.md

@@ -0,0 +1,10 @@
+# MQTT publish
+
+MQTT 브로커에 설정된 tag를 붙여 accessor의 데이타를 송신하는 태스크이다.
+
+## parameters
+
+- topic
+  - 브로커로 보낼 메시지의 tag를 지정한다.
+- [accessor](../concept/data-accessor.md)
+  - 브로커로 보낼 메시지 data의 접근자를 지정한다.

package/dist-client/helps/integration/task/mqtt-subscribe.md

@@ -0,0 +1,15 @@
+# MQTT subscribe
+
+MQTT 브로커로부터 메시지를 수신하여 data로 리턴하는 태스크이다.
+MQTT 브로커로부터 지정된 태그에 해당하는 메시지를 계속 수신해서 마지막 메시지를 보관하고 있다가, 이 태스크가 실행되는 시점에 리턴한다.
+만일, 태스크 실행 시점까지 새로 받은 메시지가 없다면, 새로운 메시지를 받을 때까지 기다린다.
+
+## parameters
+
+- topic
+  - 브로커로부터 받을 메시지의 tag를 지정한다.
+- data format
+  - MQTT 브로커로부터 받은 메시지의 형식을 지정한다.
+  - formats
+    - Plain Text : 수신한 메시지를 문자열로 해석하여 data로 리턴한다.
+    - JSON : 수신한 메시지를 Object 형식으로 파싱하여 data로 리턴한다.

package/dist-client/helps/integration/task/pick-pending-scenario.md

@@ -0,0 +1,13 @@
+# Pickup Scenario
+
+[지연 큐](../concept/pending-queue.md)에 지연 만료된 시나리오를 꺼내서 실행(run)하는 태스크이다.
+
+## parameters
+
+- tag
+  - 시나리오에 붙여질 태그를 설정한다.
+- waitFor
+  - 지연 만료된 시나리오가 발생하는 것을 얼마의 시간동안 기다릴 것인지를 설정한다.
+  - 단위는 milli-seconds 이다.
+  - '-1'을 설정하면, 지연 만료된 시나리오를 무한시간동안 기다린다.
+  - 시나리오 선택을 기다리더라도, 해당 시나리오가 종료되면, 태스크도 종료된다.

package/dist-client/helps/integration/task/publish.md

@@ -0,0 +1,16 @@
+# publish
+
+subscription API를 통해서 요청된 모든 Subscriber에게 데이타를 브로드캐스트하는 태스크이다.
+
+클라이언트 어플리케이션에서 data subscription을 요청하는 방법은
+
+- Board UI에서 subscriber를 통해서 요청할 수 있다.
+- wss://[server host:port]/subscription API를 통해서 subscribe 요청할 수 있다.
+
+## parameters
+
+- [accessor](../concept/data-accessor.md)
+  - 시나리오 내의 하나의 스텝이름으로, 브로드캐스트하고자 하는 데이타를 지정한다.
+- tag
+  - 데이타를 브로드캐스트할 때 태그를 부여해서 보내야한다.
+  - subscriber들도 data를 subscribe할 때, 받고자 하는 테그를 설정하여, 해당 태그가 부여된 브로드캐스트만 받을 수 있다.

package/dist-client/helps/integration/task/script.md

@@ -0,0 +1,39 @@
+# Script
+
+Javascript Syntax로 작성된 script를 실행하여 그 결과를 리턴하는 태스크이다.
+
+## parameters
+
+- script
+  - javascript systax로 작성한다.
+  - global 오브젝트는 해당된 [Scenario Context](../concept/scenario-context.md)중 data 와 variables 를 가진 단순한 오브젝트이다. 즉, 스크립트 내에서 해당된 시나리오의 data 변수와 variables 변수를 특별한 수식자없이 또는 this 접근자를 통해서 사용할 수 있다.
+    - data : 시나리오 인스턴스 컨텍스트의 data 속성
+    - variables : 시나리오 인스턴스 컨텍스트의 시작 파라미터 속성
+  - 태스크의 수행 결과는 return 신택스를 통해서 반환된다.
+  - script 내에서는 global 오브젝트가 data와 variables로 한정되므로, 대부분의 시스템 관련된 기능은 사용할 수 없는 sandbox 환경이라고 이해하고, 단순한 연산정도의 기능을 구현하는 것을 권장한다.
+    - [Node Sandbox](https://medium.com/@devnullnor/a-secure-node-sandbox-f23b9fc9f2b0)
+    - [vm2](https://github.com/patriksimek/vm2/blob/master/README.md)
+
+## sample script
+
+```
+return data['step1'].map(record => {
+  return {
+    ...record,
+    id: 'PREFIX-' + record.id
+  }
+})
+```
+
+```
+return Math.floor(Number(this.data['step2']))
+```
+
+```
+return this.data['step3'].map(record => {
+  return {
+    ...record,
+    id: (this.variables.prefix || 'DEFAULT-') + record.id
+  }
+})
+```

package/dist-client/helps/integration/task/sleep.md

@@ -0,0 +1,8 @@
+# sleep Task
+
+'sleep' 파라미터로 지정된 지속시간만큼 대기하고, 지정된 시간이 만료되면 다음 태스크로 이동한다.
+
+## parameters
+
+- 지속시간
+  - 대기해야 하는 시간을 설정한다. 단위는 밀리세컨드(ms)이다.

package/dist-client/helps/integration/task/throw.md

@@ -0,0 +1,12 @@
+# Throw
+
+Scenario 진행 중에 강제로 비정상 예외를 던지기 위한 태스크이다.
+(정상종료를 의미하는 'end' 태스크와 구분할 필요가 있다.)
+Scenario 진행 중에 Throw를 하게 되면, 해당 시나리오의 'preventErrorPropagation' 속성에 따라서, 부모 시나리오에 예외가 전파되거나 해당 시나리오에서 캐치되어 정상적으로 상위 시나리오의 태스크가 진행될 수도 있다.
+
+- preventErrorPropagation 이 true 인 경우
+  - 부모 시나리오가 있는 경우 : 해당 시나리오를 시작한 부모 'scenario' 태스크에도 예외가 전달된다. 결과적으로 부모 시나리오도 비정상 예외가 발생하게 된다.
+  - 부모 시나리오가 없는 경우 : 해당 시나리오는 시나리오 엔진에 의해 비정상 종료로 처리된다.
+- preventErrorPropagation 이 false 인 경우
+  - 부모 시나리오가 있는 경우 : 해당 시나리오를 시작한 부모 'scenario' 태스크에 예외가 전달되지 않으므로, 결과적으로 부모 시나리오도 정상적인 진행이 계속된다.
+  - 부모 시나리오가 없는 경우 : 해당 시나리오는 시나리오 엔진에 의해 정상 종료로 처리된다.

package/dist-client/helps/integration/task/variables.md

@@ -0,0 +1,37 @@
+# Variables
+
+Scenario의 입력변수를 [Scenario Context](../concept/scenario-context.md) Data에 추가하는 태스크이다.
+Variables Task는 이후 Step의 Task에서 Scenario Input 변수를 사용할 수 있도록, Scenario 시작 시에 받은 Input 변수들을 그대로 리턴하는 태스크이다.
+
+예를 들어,
+
+- Scenario Input 변수값
+
+```
+{
+  inputA: "ABC",
+  inputB: "DEF"
+}
+```
+
+이고,
+
+- Variables Task의 이름이 "VARIABLES" 인 경우,
+- Variables Task가 완료된 후에 Scenario Context의 Data에는 다음과 같은 값이 추가되게 된다.
+
+```
+# scenario.context.data
+{
+  ...,
+  VARIALBES: {
+    inputA: "ABC",
+    inputB: "DEF"
+  },
+  ...
+}
+
+```
+
+## parameters
+
+이 Task에는 별도 속성이 정의되지 않는다.