@fmsim/fmsim 0.0.98 → 0.0.99

package/dist-app/helps/config/publicHomeRoute.md

@@ -0,0 +1,14 @@
+# publicHomeRoute
+
+로그인되지 않은 사용자가 어플리케이션 URL에 처음 접근했을 때, 보여지게 될 페이지의 path를 지정한다.
+
+보통 '/public/home' 패스로 라우팅되어 인트로 화면을 볼 수 있다.
+만약, 로그인 페이지로 바로 이동하고 싶다면, 이 설정을 '/auth/signin' 으로 설정하면 된다.
+
+## default
+
+```
+module.exports = {
+  publicHomeRoute: '/public/home',
+}
+```

package/dist-app/helps/config/scheduler.md

@@ -0,0 +1,22 @@
+# scheduler
+
+Scheduler(https://github.com/hatiolab/operato-foundation-service) 서비스 연결 정보 설정
+
+## 예시
+
+```
+module.exports = {
+  scheduler: {
+    /* Name to be used for setting client's "application" properties when registering a schedule */
+    application: 'operato-schedule',
+    /* Base endpoint to be used for setting "callback" properties when registering a schedule */
+    callbackBase: 'http://localhost:3000',
+    /*
+      Scheduler service endpoint
+      caution) endpoint for "localhost" has some problem.
+      https://github.com/node-fetch/node-fetch/issues/1624
+    */
+    endpoint: 'http://127.0.0.1:9902'
+  },
+}
+```

package/dist-app/helps/config/session.md

@@ -0,0 +1,49 @@
+# session
+
+세션 유효기간과 관련한 설정을 할 수 있다.
+
+- expirySeconds: Session Expiry Time in Seconds
+
+  - This value defines the duration in seconds after which a user session will expire due to inactivity.
+  - Setting this to 1800 means the session will expire after 30 minutes of inactivity.
+
+- expiryPolicy: Session Expiry Policy
+
+  - This setting determines how the session timeout is managed.
+  - Options:
+
+    - 'rolling' - The session timeout is extended based on user activity.
+      Each new request resets the timer to the specified timeout duration.
+    - 'fixed' - The session timeout is fixed and based on the initial login time.
+      The session will expire after the specified duration, regardless of user activity.
+
+          Example:
+          expiryPolicy: 'rolling' or 'fixed'
+
+## default
+
+```
+module.exports = {
+  session: {
+    /*
+      Session Expiry Time in Seconds
+      This value defines the duration in seconds after which a user session will expire due to inactivity.
+      Setting this to 1800 means the session will expire after 30 minutes of inactivity.
+    */
+    expirySeconds: 60 * 60 * 24 * 7,
+    /*
+      Session Expiry Policy
+      This setting determines how the session timeout is managed.
+      Options:
+        'rolling' - The session timeout is extended based on user activity.
+                    Each new request resets the timer to the specified timeout duration.
+        'fixed'   - The session timeout is fixed and based on the initial login time.
+                    The session will expire after the specified duration, regardless of user activity.
+
+      Example:
+      expiryPolicy: 'rolling' or 'fixed'
+    */
+    expiryPolicy: 'fixed'
+  },
+}
+```

package/dist-app/helps/config/storage.md

@@ -0,0 +1,69 @@
+# storage
+
+첨부파일이 보관될 스토리지의 타입과 관련된 옵션 정보를 설정한다.
+
+## filesystem backed storage
+
+- type: 'file'
+- base: folder
+
+## database backed storage
+
+- type: 'database'
+
+## AWS S3 bucket backed storage
+
+- type: 's3'
+- accessKeyId: 'YOUR ACCESS KEY ID',
+- secretAccessKey: 'YOUR SECRET ACCESS KEY',
+- bucketName: 'YOUR S3 BUCKET NAME',
+- region: 'YOUR S3 REGION'
+
+## Azure Blob backed storage
+
+- type: 'azureblob'
+- accountName: '{account-name}',
+- accountKey: '{account-key}',
+- containerName: '{container-name}',
+- url: 'https://{account-name}.blob.core.windows.net/',
+- connectionString: 'DefaultEndpointsProtocol=https;AccountName={account-name};AccountKey={account-key};EndpointSuffix=core.windows.net'
+
+## default
+
+```
+module.exports = {
+  storage: {
+    type: 'file',
+    base: 'attachments'
+  }
+  /* storage configurations
+  --
+  storage: {
+    type: 'file', // for filesystem backed
+    base: 'attachments'
+  }
+  --
+  storage: {
+    type: 'database' // for database backed
+  }
+  --
+  storage: {
+    type: 's3', // for s3-bucket
+    accessKeyId: 'YOUR ACCESS KEY ID',
+    secretAccessKey: 'YOUR SECRET ACCESS KEY',
+    bucketName: 'YOUR S3 BUCKET NAME',
+    region: 'YOUR S3 REGION'
+  }
+  --
+  storage: {
+    type: 'azureblob', // for azure-blob-storage
+    accountName: '{account-name}',
+    accountKey: '{account-key}',
+    containerName: '{container-name}',
+    url: 'https://{account-name}.blob.core.windows.net/',
+    connectionString:
+      'DefaultEndpointsProtocol=https;AccountName={account-name};AccountKey={account-key};EndpointSuffix=core.windows.net'
+  }
+  */
+}
+```

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/data-grist/grist-editor/privilege.ja.md

@@ -0,0 +1,13 @@
+# 権限エディター
+
+特定の操作を実行するために必要な権限を設定します。
+
+# プロパティ
+
+- 権限
+  - 特定の操作を実行するために必要な権限を指定します。
+  - 権限が設定されていない場合、特別な権限は必要ないことを意味し、ドメインの所有者やスーパーユーザーの設定は無意味です。
+- ドメインの所有者
+  - このプロパティが設定されている場合、ドメインの管理者は上記の権限が設定されていなくてもこの操作を実行できることを意味します。
+- スーパーユーザー
+  - このプロパティが設定されている場合、スーパーユーザーは上記の権限が設定されていなくてもこの操作を実行できることを意味します。

package/dist-app/helps/data-grist/grist-editor/privilege.ko.md

@@ -0,0 +1,13 @@
+# privilege editor
+
+어떤 작업을 수행하기위해 필요한 권한을 설정한다.
+
+# properties
+
+- privilege
+  - 어떤 작업을 수행하기위해 필요한 권한을 지정한다.
+  - privilage가 설정되지 않으면, 특별한 권한을 필요로 하지 않음을 의미하므로 domain owner나 super user 설정은 무의미하다.
+- domain owner
+  - 이 속성이 설정되면, 도메인의 관리자인 경우에는 위에서 설정한 권한이 없어도 이 작업을 수행할 수 있는 권한이 부여된다는 것을 의미한다.
+- super user
+  - 이 속성이 설정되면, 수퍼유저인 경우에는 위에서 설정한 권한이 없어도 이 작업을 수행할 수 있는 권한이 부여된다는 것을 의미한다.

package/dist-app/helps/data-grist/grist-editor/privilege.md

@@ -0,0 +1,15 @@
+# Privilege Editor
+
+Configure the permissions required to perform a specific action.
+
+# Properties
+
+- Privilege
+  - Specify the permissions required to perform a specific action.
+  - If no privilege is set, it means the action does not require any special permissions, rendering domain owner or super user settings meaningless.
+- Domain Owner
+  - When this attribute is set, it means that domain administrators have the permission to perform this action without needing the specified privileges above.
+- Super User
+  - When this attribute is set, it means that super users have the permission to perform this action without needing the specified privileges above.
+
+--

package/dist-app/helps/data-grist/grist-editor/privilege.ms.md

@@ -0,0 +1,13 @@
+# Penyunting Privilej
+
+Mengatur kebenaran yang diperlukan untuk menjalankan sesuatu tindakan.
+
+# Ciri-ciri
+
+- kebenaran
+  - Menetapkan kebenaran yang diperlukan untuk menjalankan sesuatu tindakan.
+  - Jika kebenaran tidak ditetapkan, bermakna tindakan ini tidak memerlukan kebenaran khusus, oleh itu pengaturan pemilik domain atau pengguna super adalah tidak bermakna.
+- pemilik domain
+  - Apabila ciri ini ditetapkan, bermakna pengurus domain mempunyai kebenaran untuk menjalankan tindakan ini tanpa mengira kebenaran yang ditetapkan di atas.
+- super pengguna
+  - Apabila ciri ini ditetapkan, bermakna super pengguna mempunyai kebenaran untuk menjalankan tindakan ini tanpa mengira kebenaran yang ditetapkan di atas.

package/dist-app/helps/data-grist/grist-editor/privilege.zh.md

@@ -0,0 +1,13 @@
+# 权限编辑器
+
+用于设置执行某项操作所需的权限。
+
+# 属性
+
+- 权限
+  - 指定执行某项操作所需的权限。
+  - 如果未设置权限，则表示不需要特殊权限，因此域所有者或超级用户设置将无意义。
+- 域所有者
+  - 如果设置了此属性，则表示域的管理员可以执行此操作，即使没有设置上面的权限。
+- 超级用户
+  - 如果设置了此属性，则表示超级用户可以执行此操作，即使没有设置上面的权限。

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.ja.md

@@ -0,0 +1,4 @@
+# シナリオ（Scenario）
+
+- シナリオは、順番に実行される[タスク](./task.md)のシリーズです。
+- シナリオを構成する各段階のタスクをステップと呼びます。

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

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

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

@@ -0,0 +1,4 @@
+# Scenario
+
+- A scenario is a series of [tasks](./task.md) that are executed sequentially.
+- The tasks constituting each step of the scenario are referred to as steps.

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

@@ -0,0 +1,4 @@
+# Senario (Scenario)
+
+- Senario adalah siri [tugas](./task.md) yang dilaksanakan secara berurutan.
+- Tugas yang membentuk setiap langkah senario disebut sebagai langkah.

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

@@ -0,0 +1,4 @@
+# 场景（Scenario）
+
+- 场景是按顺序执行的[任务](./task.md)系列。
+- 构成场景的每个阶段的任务称为步骤。

package/dist-app/helps/integration/concept/script-internal-variables.ja.md

@@ -0,0 +1,24 @@
+# 組み込みスクリプト変数
+
+スクリプトタイプのタスクプロパティ（スクリプト、SQL、GraphQL クエリ/ミューテーション、ログなど）では、デフォルトで提供されている 5 つの組み込み変数があります。
+
+- 組み込み変数:
+
+  - domain: 現在のシナリオが実行されているテナントに関する情報が含まれています。
+
+    - name: ドメイン名
+    - description: ドメインの説明
+    - timezone: ドメインのタイムゾーン
+    - attributes: ドメイン属性（システムのスーパーユーザーは、ドメインに対して会社名、住所、工場コード、所有者の名前などのカスタム属性を指定できます）。
+
+  - user: シナリオを開始したユーザーに関する情報が含まれています。 （システムによって実行される場合、スケジューラなど、ユーザーがいないことがあります）
+
+    - name: ユーザー名
+    - email: ユーザーの電子メール
+    - userType: ユーザータイプ
+
+  - lng: シナリオを開始するユーザーのブラウザで使用されている言語（例：en-US、ko-KR など）。 ユーザーのブラウザを介さないリクエストを処理する場合、この組み込み変数は提供されない場合があります。
+
+  - variables: シナリオ呼び出し時に呼び出し元から受け取るオブジェクト。
+
+  - data: シナリオの実行中に生成された各ステップの結果データ。

package/dist-app/helps/integration/concept/script-internal-variables.ko.md

@@ -0,0 +1,18 @@
+# 스크립트 내장 변수
+
+스크립트 형태의 태스크 속성(Script, SQL, GraphQL Query/Mutation, Log 등)에는 기본적으로 5가지의 내장변수가 제공된다.
+
+- 내장변수들
+  - domain : 시나리오가 실행중인 테넌시 정보
+    - name: 도메인 이름
+    - description: 도메인 설명
+    - timezone : 도메인 타임존
+    - attributes: 도메인 속성들 (시스템 수퍼유저가 도메인에 대한 커스텀 속성을 지정할 수 있다. - 예를 들어, 회사이름, 주소, 공장코드, 대표자명 등)
+  - user : 시나리오를 요청한 유저 정보 (스케쥴러 등 시스템에 의해 실행되는 경우에는 사용자가 없을 수 있다.)
+    - name
+    - email
+    - userType
+  - lng : 시나리오를 요청한 유저 브라우저의 사용 언어(en-US, ko-KR, ..)
+    - 사용자 브라우저를 통하지 않은 요청을 처리할 때에는 이 내장변수가 제공되지 않을 수 있다.
+  - variables : 시나리오 호출 시점에 호출자로부터 전달받은 오브젝트
+  - data: 시나리오 실행과정에 생성된 각 스텝의 결과 데이타