@fmsim/fmsim 0.0.49

package/dist-app/helps/contact/contact.md

@@ -0,0 +1,160 @@
+# Contact
+
+Paragraphs are separated by a blank line.
+
+2nd paragraph. _Italic_, **bold**, and `monospace`. Itemized lists
+look like:
+
+- this one
+- that one
+- the other one
+
+Note that --- not considering the asterisk --- the actual text
+content starts at 4-columns in.
+
+> Block quotes are
+> written like so.
+>
+> They can span multiple paragraphs,
+> if you like.
+
+Use 3 dashes for an em-dash. Use 2 dashes for ranges (ex., "it's all
+in chapters 12--14"). Three dots ... will be converted to an ellipsis.
+Unicode is supported. ☺
+
+## An h2 header
+
+Here's a numbered list:
+
+1. first item
+2. second item
+3. third item
+
+Note again how the actual text starts at 4 columns in (4 characters
+from the left side). Here's a code sample:
+
+# Let me re-iterate ...
+
+for i in 1 .. 10 { do-something(i) }
+
+As you probably guessed, indented 4 spaces. By the way, instead of
+indenting the block, you can use delimited blocks, if you like:
+
+```
+define foobar() {
+print "Welcome to flavor country!";
+}
+```
+
+(which makes copying & pasting easier). You can optionally mark the
+delimited block for Pandoc to syntax highlight it:
+
+```python
+import time
+# Quick, count to ten!
+for i in range(10):
+# (but not *too* quick)
+time.sleep(0.5)
+print(i)
+```
+
+### An h3 header
+
+Now a nested list:
+
+1. First, get these ingredients:
+
+- carrots
+- celery
+- lentils
+
+2. Boil some water.
+
+3. Dump everything in the pot and follow
+   this algorithm:
+
+find wooden spoon
+uncover pot
+stir
+cover pot
+balance wooden spoon precariously on pot handle
+wait 10 minutes
+goto first step (or shut off burner when done)
+
+Do not bump wooden spoon or it will fall.
+
+Notice again how text always lines up on 4-space indents (including
+that last line which continues item 3 above).
+
+Here's a link to [a website](http://foo.bar), to a [local
+doc](local-doc.html), and to a [section heading in the current
+doc](#an-h2-header). Here's a footnote [^1].
+
+[^1]: Some footnote text.
+
+Tables can look like this:
+
+Name Size Material Color
+
+---
+
+All Business 9 leather brown
+Roundabout 10 hemp canvas natural
+Cinderella 11 glass transparent
+
+Table: Shoes sizes, materials, and colors.
+
+(The above is the caption for the table.) Pandoc also supports
+multi-line tables:
+
+---
+
+Keyword Text
+
+---
+
+red Sunsets, apples, and
+other red or reddish
+things.
+
+green Leaves, grass, frogs
+and other things it's
+not easy being.
+
+---
+
+A horizontal rule follows.
+
+---
+
+Here's a definition list:
+
+apples
+: Good for making applesauce.
+
+oranges
+: Citrus!
+
+tomatoes
+: There's no "e" in tomatoe.
+
+Again, text is indented 4 spaces. (Put a blank line between each
+term and its definition to spread things out more.)
+
+Here's a "line block" (note how whitespace is honored):
+
+| Line one
+| Line too
+| Line tree
+
+and images can be specified like so:
+
+![example image](example-image.jpg 'An exemplary image')
+
+Inline math equation: $\omega = d\phi / dt$. Display
+math should get its own line like so:
+
+$$I = \int \rho R^{2} dV$$
+
+And note that you can backslash-escape any punctuation characters
+which you wish to be displayed literally, ex.: \`foo\`, \*bar\*, etc.

package/dist-app/helps/index.md

@@ -0,0 +1 @@
+# help

package/dist-app/helps/integration/concept/connection.md

@@ -0,0 +1,27 @@
+# Connection
+
+외부 시스템을 연결하기 위해 제공되는 기능을 Connector라고 하며, Connector를 작동시키기 위한 설정 정보가 Connection 이다.
+한 종류의 Connector는 여러 Connection을 가질 수 있다.
+
+외부 시스템을 연결하기 위해서는 외부 시스템에 연결하기 위한 연결 정보와 프로토콜을 정의해야 하며,
+커넥션은 외부 시스템 연결 정보를 의미한다.
+
+외부 시스템은 대표적으로 데이타베이스, 메시지 브로커 등의 서비스를 제공하는 네트워크 기반의 시스템이 될 수도 있고,
+때로는 카메라, 프린터, 스캐너 같은 디바이스를 직접 연결하는 USB 포트 등이 될 수 있다.
+그 밖에 가상의 오브젝트가 될 수도 있다.
+
+시나리오는 태스크의 시리즈로 정의된다. 일부 태스크는 커넥션에 기반한 태스크들이 될 수 있다.
+예를 들면, 데이타베이스 커넥션에 기반한 태스크로는 데이타베이스 쿼리가 될 수 있으며,
+메시지 브로커를 기반한 태스크로는 메시지 서브스크라이브나 메시지 퍼블리시 같은 태스크들이 있을 수 있다.
+
+## endpoint
+
+- 외부 시스템의 연결 정보를 설정한다.
+- 네트워크 기반 커넥션의 엔드포인트는 보통 protocol과 host, service port 그리고 path 정보로 구성된다.
+- USB 디바이스에 대한 커넥션의 엔드포인트는 USB 포트번호가 될 수 있다.
+- 각 커넥터별 엔드포인트 설정 방법은 커넥터의 구현에 따른다. 커넥터의 도움말 기능을 통해서 엔드포인트 설정 방법을 가이드한다.
+
+## parameters
+
+- Connector를 동작시키기 위한 속성을 설정한다.
+- Connector 구현에 따라서 속성들은 정의된다.

package/dist-app/helps/integration/concept/data-accessor.ko.md

@@ -0,0 +1,11 @@
+# 데이터 접근자(data accessor)
+
+- 태스크의 속성으로 [시나리오 컨텍스트](./scenario-context.md) 내의 Data 중에서 필요한 value를 한정하고자 할 때 사용된다
+- 컨텍스트의 데이타는 각 스텝의 이름을 Key로 가지며, 스텝의 결과값을 Value로 유지하는 오브젝트이다.
+- 따라서 accessor는 항상 스텝의 이름으로 시작되며, 그 값 아래로도 더 한정하고 싶은 경우에는 자바스크립트 오브젝트의 Value를 지정하는 표현을 사용할 수 있다.
+- 또한, 데이터를 변환한 결과를 사용할 수도 있다.
+- 데이터 접근자(data accessor)를 설정하는 방법은 [JSONATA Document](http://docs.jsonata.org/overview)의 명세를 따른다.
+- 예시
+  - `stepname`
+  - `stepname.property`
+  - `stepname.property.property. ...`

package/dist-app/helps/integration/concept/data-accessor.md

@@ -0,0 +1,11 @@
+# data accessor
+
+- As a property of the task, it is used to limit the required value among the data in [scenario context](./scenario-context.md).
+- Context data is an object that has the name of each step as a Key and maintains the result value of the step as a Value.
+- Therefore, the accessor always starts with the name of the step, and if you want to further limit the value below that value, you can use an expression that specifies the value of the JavaScript object.
+- You can also use the result of data transformation.
+- How to set data accessor follows the specification of [JSONATA Document](http://docs.jsonata.org/overview).
+- example
+  - `stepname`
+  - `stepname.property`
+  - `stepname.property.property. ...`

package/dist-app/helps/integration/concept/data-accessor.zh.md

@@ -0,0 +1,11 @@
+# 数据访问器
+
+- 作为任务的一个属性，用于限制[scenario context](./scenario-context.md) 中数据中所需的值。
+- 上下文数据是将每个步骤的名称作为 Key，并将步骤的结果值作为 Value 来维护的对象。
+- 因此，访问器总是以步骤名称开头，如果您想进一步限制低于该值的值，您可以使用指定 JavaScript 对象值的表达式。
+- 您还可以使用数据转换的结果。
+- 如何设置数据访问器遵循 [JSONATA Document](http://docs.jsonata.org/overview) 的规范。
+- 例子
+  - `stepname`
+  - `stepname.property`
+  - `stepname.property.property。 ...`

package/dist-app/helps/integration/concept/pending-queue.md

@@ -0,0 +1,32 @@
+# Pending Scenario Queue
+
+일정 시간 이후에 실행될 지연 예약된 시나리오를 등록할 수 있도록 제공되는 장치이다.
+
+## Operation
+
+- 지연 큐는 [book-up-scenario](../task/book-up-scenario.md) 태스크에 의해서 일정 시간 후에 실행될 시나리오를 등록할 수 있는 대기 큐이다.
+- 지연 큐에 보관된 지연 시나리오는 지연 시간이 만료되면 [pick-pending-scenario](../task/pick-pending-scenario.md) 태스크에 의해서 꺼내져서 실행되게 된다.
+- 지연 큐는 reset-pending-queue 태스크에 의해서 클리어될 수 있다.
+
+### 태그 tag
+
+- 지연된 시나리오는 'tag' 속성으로 카테고리화 될 수 있다. 즉, book-up 시에는 지연 시나리오에 'tag'를 부여할 수 있으며, [pick-pending-scenario](../task/pick-pending-scenario.md) 시에는 특정 'tag'가 부여된 시나리오 중에서 지연시간이 만료된 시나리오를 실행할 수 있다.
+
+### 시나리오 우선 순위 priority
+
+- 지연 큐에 [book-up-scenario](../task/book-up-scenario.md)되는 시나리오는 우선순위 priority 를 속성으로 가질 수 있다.
+- 지연 만료된 시나리오 중에서 [pick-pending-scenario](../task/pick-pending-scenario.md)에 의해서 시나리오가 선택될 때, 우선 순위가 높은 것이 최우선으로 선택되며, 동일 우선순위의 시나리오 중에서는 만료시간이 가장 오래된 시나리오가 선택된다.
+
+## 활용
+
+### long 시나리오 구현에 활용
+
+- 여러 단계의 다양한 서브 시나리오들로 구성된 긴 시나리오를 이해하고 관리하는 것은 쉽지 않다.
+- 이련 경우에 여러개의 단위 시나리오를 정의하고, 지연 큐를 활용해서 단위 시나리오들을 순차적으로 작동시키는 방법으로 재구성할 수 있다.
+
+### 유한 자원의 시나리오 실행 쓰로틀링 throttling 에 활용
+
+- [pick-pending-scenario](../task/pick-pending-scenario.md) 태스크는 지연만료된 시나리오를 지연 큐에서 꺼내서 실행 run 하는 태스크이다.
+- 유한 자원을 가진 경우, 동시에 자원 이상의 시나리오를 실행하지 못하게 컨트롤 하고자 하는 경우에 유용하게 응용할 수 있다.
+- 예를 들어, 하나의 로봇암 A는 한 시점에 하나의 시나리오만을 수행해야 하는 경우가 있다고 가정하면, 로봇암 A가 주로 실행하는 시나리오들을 'RA'라는 태그를 붙여서 지연 큐에 [book-up-scenario](../task/book-up-scenario.md)한다.
+  그리고, 로봇암 A를 위해서 무한 반복하는 하나의 시나리오를 만들고, 그 시나리오에 [pick-pending-scenario](../task/pick-pending-scenario.md) 태스크를 이용해서, 'RA' 태그가 붙여진 지연 만료된 시나리오를 하나씩 꺼내서 순차적으로 실행한다.

package/dist-app/helps/integration/concept/scenario-context.md

@@ -0,0 +1,83 @@
+# context
+
+시나리오 엔진은 시나리오를 구성하는 태스크를 순차적으로 실행하게 되는데, 각 태스크가 자신의 구현에 집중할 수 있도록 컨텍스트를 통해서 여러가지 기능과 데이타를 태스크에 제공하게 된다.
+
+## 기능
+
+- logger
+  - 태스크 수행 중에 로그를 남겨야 할 필요가 있을 때, 컨텍스트로 제공된 logger를 사용할 수 있다.
+
+```
+  logger.info('...')
+  logger.warn('...')
+  logger.error('...')
+```
+
+- publish
+  - 태스크 수행 중에 데이타를 브로드캐스트할 경우에 사용할 수 있다.
+
+```
+  publish('tag', data)
+```
+
+- load
+  - 태스크 수행 중에 다른 시나리오를 실행할 경우에 사용한다.
+  - 이 때 새로 만들어지는 시나리오 인스턴스를 서브시나리오라고 한다.
+  - 서브시나리오는 동기 개념으로 실행되어야 한다. 즉, load에 의해 시작된 시나리오 인스턴스가 완료될 때까지 기다린다.
+
+```
+load(instanceName, scenarioConfig, context)
+```
+
+- client
+  - 서버에 내장된 GraphQL API를 호출할 때 사용한다.
+  - client는 현재 시나리오가 실행되는 프로세스의 API를 호출할 수 있도록 바인드된 graphql client 객체이다.
+
+```
+client.query(...)
+client.mutate(...)
+```
+
+- closures
+  - 태스크는 보통 실행 시작 시점에 필요한 리소스를 할당하고, 종료하기 전에 리소스를 해제하도록 권장된다.
+  - 하지만, 어떤 경우에는 태스크는 효율을 위해서 최초 시작 시점에 필요한 리소스를 할당하고, 시나리오 인스턴스가 종료되는 시점에 리소스를 해제하고자 할 수 있다.
+  - 이 때에 closuers 에 리소스 해제를 위한 함수를 등록해 놓으면, 시나리오 인스턴스가 종료되는 시점에 자동으로 호출되어 리소스 해제의 기회를 얻을 수 있다.
+- checkState
+  - 현재 시나리오의 상태가 어떤 상태인지를 확인하는 함수이다.
+
+```
+if(checkState(ScenarioInstanceStatus.STARTED)) {
+  ...
+}
+```
+
+## 데이타
+
+- domain
+  - 시나리오의 도메인 정보
+  - 도메인은 시나리오가 정의 및 실행되는 경계가 된다.
+- variables
+  - 시나리오가 시작될 때, 넘겨진 입력변수 오브젝트
+  - 시나리오를 실행하는 여러가지 방법에는 일반적으로 입력변수를 제공하는 기능이 제공된다.
+- data
+  - 시나리오가 진행되면서 수행된 각 스텝의 반환값을 유지하는 오브젝트이다.
+  - 각 스텝의 이름을 Key로 하며, 그 결과 값을 Value로 유지하는 오브젝트이다.
+  - 서브시나리오 스텝의 결과 값은 해당 서브시나리오의 스텝의 반환값을 모두 포함한다.
+  - 주의. 시나리오에서 하나의 스텝이 여러번 실행되는 경우 마지막 결과값만 유지한다.
+- state
+  - 현재 시나리오의 상태값을 유지한다.
+  - 시나리오의 상태 정의는 다음과 같다.
+
+```
+enum ScenarioInstanceStatus {
+  READY,
+  STARTED,
+  STOPPED,
+  HALTED,
+  UNLOADED
+}
+```
+
+- root
+  - 시나리오는 스텝으로 다른 시나리오를 가질 수 있으며, 이 경우 스텝으로 정의된 시나리오를 서브시나리오라고 한다.
+  - root 는 최상위 부모 시나리오를 가리킨다.

package/dist-app/helps/integration/concept/scenario-engine.md

@@ -0,0 +1,10 @@
+# Scenario Engine
+
+사전에 정의된 시나리오를 구동시키는 엔진을 의미한다.
+시나리오 인스턴스들의 라이프사이클을 관리하며, 시나리오의 스텝을 구성하는 태스크를 수행하는 역할을 한다.
+
+시나리오를 시작시키는 방법은 다음과 같다.
+
+- 스케쥴에 의한 시나리오 시작
+- 시나리오 관리 페이지를 통한 시나리오 시작
+- 시나리오 컨트롤 API를 통한 시나리오 시작

package/dist-app/helps/integration/concept/scenario.md

@@ -0,0 +1,4 @@
+# scenario
+
+- 시나리오는 순차적으로 실행되는 [태스크](./task.md)의 시리즈이다.
+- 시나리오를 구성하는 각 단계의 태스크를 스텝이라고 한다.

package/dist-app/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-app/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-app/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-app/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-app/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-app/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-app/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-app/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-app/helps/integration/task/csv-readline.md

@@ -0,0 +1,10 @@
+# csv-readline Task
+
+주어진 CSV 형식의 파일을 한레코드씩 읽어서 데이타로 반환하는 태스크이다.
+마지막줄 이후로는 데이터가 반환되지 않으므로,
+다음 스텝에서는 empty-check같은 태스크로 데이터가 더 이상 반환되지 않는 경우에 시나리오를 종료하는 등의 시나리오 구성을 할 수 있다.
+
+## parameters
+
+- path
+  - CSV 파일의 패스정보를 입력한다.

package/dist-app/helps/integration/task/data-mapper.md

@@ -0,0 +1,14 @@
+# data-mapper Task
+
+특정 accessor의 결과 값을 새로운 데이터로 변환하는 기능을 제공한다.
+기존 데이터가 단일 오브젝트이면 새로운 데이터도 단일 오브젝트 형태로 변환되며,
+기존 데이터가 오브젝트의 배열 형태이면 새로운 데이터도 오브젝트의 배열 형태로 반환된다.
+
+## parameters
+
+- [accessor](../concept/data-accessor.md)
+  - 변환하고자 하는 대상 데이터를 설정한다.
+- 매핑 규칙(mapping-rule)
+  - 기존 데이터를 기반으로 새로운 데이터를 만드는 규칙을 설정한다.
+  - key 부분에 설정된 값들은 새로 만들어질 데이터의 key들이 된다.
+  - value 부분에는 기존 데이터의 key를 입력한다. 기존 데이터의 key에 해당되는 값이 새로운 데이터의 값이 된다.

package/dist-app/helps/integration/task/empty-check.md

@@ -0,0 +1,10 @@
+# empty-check Task
+
+특정 accessor의 결과 값이 빈값인지를 판단하여, 빈값인 경우에는 'goto' 파라미터로 지정된 스텝으로 점프하는 태스크이다.
+
+## parameters
+
+- [accessor](../concept/data-accessor.md)
+  - 비어있는 지 판단을 하는 대상을 지정한다.
+- goto
+  - 이동할 스텝의 이름을 지정한다.

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

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