@fmsim/fmsim-restful 1.0.61 → 1.0.62

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: 시나리오 실행과정에 생성된 각 스텝의 결과 데이타

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

@@ -0,0 +1,24 @@
+# Built-in Script Variables
+
+In script-type task properties (Script, SQL, GraphQL Query/Mutation, Log, etc.), there are five built-in variables provided by default.
+
+- Built-in Variables:
+
+  - domain: Contains information about the tenant where the current scenario is running.
+
+    - name: Domain name
+    - description: Domain description
+    - timezone: Domain timezone
+    - attributes: Domain attributes (System superusers can specify custom attributes for the domain, such as company name, address, factory code, owner's name, etc.).
+
+  - user: Contains information about the user who initiated the scenario. (When executed by the system, such as schedulers, there may be no user)
+
+    - name: User name
+    - email: User email
+    - userType: User type
+
+  - lng: The language used by the user's browser when initiating the scenario (e.g., en-US, ko-KR, etc.). This built-in variable may not be provided when processing requests not through the user's browser.
+
+  - variables: An object received from the caller at the time of scenario invocation.
+
+  - data: Results data generated for each step during scenario execution.

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

@@ -0,0 +1,20 @@
+# Variabel Skrip Terbina Dalam
+
+Dalam sifat tugas jenis skrip (Skrip, SQL, Pertanyaan/Mutasi GraphQL, Log, dsb.), terdapat lima pembolehubah terbina dalam yang disediakan secara asas.
+
+- Pembolehubah Terbina:
+
+  - domain: Mengandungi maklumat tentang penyewa di mana senario semasa sedang berjalan.
+
+    - name: Nama domain
+    - description: Penerangan domain
+    - timezone: Zon masa domain
+    - attributes: Atribut domain (Superpengguna sistem boleh menentukan atribut kustom untuk domain, seperti nama syarikat, alamat, kod kilang, nama pemilik, dll.).
+
+  - user: Mengandungi maklumat tentang pengguna yang memulakan senario. (Apabila dilaksanakan oleh sistem, seperti penjadual, mungkin tiada pengguna)
+
+    - name: Nama pengguna
+    - email: E-mel pengguna
+    - userType: Jenis pengguna
+
+  - lng: Bahasa yang digunakan oleh pelayar pengguna ketika memulakan senario (contohnya, en-US, ko

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

@@ -0,0 +1,24 @@
+# 内置脚本变量
+
+脚本类型的任务属性（Script、SQL、GraphQL 查询/变更、Log 等）基本上提供了 5 种内置变量。
+
+- 内置变量:
+
+  - domain: 包含当前方案正在运行的租户信息。
+
+    - name: 域名
+    - description: 域描述
+    - timezone: 域时区
+    - attributes: 域属性（系统超级用户可以为域指定自定义属性，例如公司名称、地址、工厂代码、负责人姓名等）。
+
+  - user: 包含启动方案的用户信息。 （由系统调度程序等系统执行时，可能没有用户）
+
+    - name: 用户名
+    - email: 用户电子邮件
+    - userType: 用户类型
+
+  - lng: 启动方案的用户在其浏览器中使用的语言（例如：en-US、ko-KR 等）。 当处理不通过用户的浏览器进行的请求时，可能不会提供此内置变量。
+
+  - variables: 在方案调用时从调用者那里接收的对象
+
+  - data: 在方案执行过程中生成的每个步骤的结果数据

package/dist-app/helps/integration/concept/state-register.ja.md

@@ -0,0 +1,8 @@
+# 状態登録簿（State-Register）
+
+- 状態登録簿は、ある状態を長期間維持するために定義する機能を意味します。
+- 各状態は独自の名前で識別できます。
+- 各状態は文字列、数字、またはオブジェクトなど、任意の形式の値を保持できます。
+- 各状態は TTL（Time To Live）によって、最後に設定された値の有効性を指定できます。（TTL が 0 より大きければ設定されたと判断します）
+  - もし、状態値が最後に設定された時刻が現在時刻に比べて TTL（秒）よりも前であれば、その値は無効になります。
+  - TTL が過ぎた状態値は null として表示されます。

package/dist-app/helps/integration/concept/state-register.ko.md

@@ -0,0 +1,8 @@
+# 상태등록부 (state-register)
+
+- 상태등록부는 값을 일정기간 유지하고자하는 상태들을 정의하는 기능을 의미한다.
+- 각 상태는 고유한 이름으로 식별할 수 있다.
+- 각 상태는 문자열, 숫자 또는 오브젝트 등 어떤 형태의 값도 유지할 수 있다.
+- 각 상태는 TTL(Time To Live)에 의해서 마지막 설정된 값의 유효성을 지정할 수도 있다.(TTL이 0보다 크면 설정된 것으로 판단한다)
+  - 만약, 상태값이 마지막으로 설정된 시간이 현재 시간대비 TTL(초)보다 더 이전이라면 그 값은 유효하지 않게된다.
+  - TTL이 지난 상태값은 null로 조회된다

package/dist-app/helps/integration/concept/state-register.md

@@ -0,0 +1,8 @@
+# State-Register
+
+- The state-register refers to a function that defines states that are intended to be maintained over a certain period.
+- Each state can be identified by a unique name.
+- Each state can maintain values in any form, such as strings, numbers, or objects.
+- Each state's validity of the last set value can be determined by TTL (Time To Live). (It is considered set if TTL is greater than 0)
+  - If the state value was set at a time earlier than the current time compared to TTL (seconds), then that value becomes invalid.
+  - State values past their TTL are queried as null.

package/dist-app/helps/integration/concept/state-register.ms.md

@@ -0,0 +1,8 @@
+# Daftar Status (State-Register)
+
+- Daftar Status adalah fungsi yang bermaksud untuk menentukan status yang ingin dikekalkan dalam tempoh tertentu.
+- Setiap status boleh dikenalpasti melalui nama uniknya.
+- Setiap status boleh mengekalkan nilai dalam bentuk apa pun, seperti string, nombor, atau objek.
+- Setiap status boleh menetapkan keabsahan nilai terakhir yang ditetapkan melalui TTL (Time To Live). (Jika TTL lebih besar daripada 0, maka dianggap telah ditetapkan)
+  - Jika nilai status yang ditetapkan terakhir kali lebih awal daripada masa sekarang berbanding dengan TTL (saat), maka nilai tersebut menjadi tidak sah.
+  - Nilai status yang telah melebihi TTL akan ditunjukkan sebagai null.

package/dist-app/helps/integration/concept/state-register.zh.md

@@ -0,0 +1,8 @@
+# 状态注册簿（State-Register）
+
+- 状态注册簿是指定义要长期保持某些状态的功能。
+- 每个状态都可以通过唯一的名称来识别。
+- 每个状态可以保持任何形式的值，如字符串、数字或对象等。
+- 每个状态可以通过 TTL（Time To Live）来指定最后设置值的有效性。（如果 TTL 大于 0，则认为已设置）
+  - 如果状态值最后设置的时间比当前时间早于 TTL（秒），那么该值将变得无效。
+  - 过期的状态值将被视为 null。

package/dist-app/helps/integration/concept/task.ja.md

@@ -0,0 +1,25 @@
+# タスク（Task）
+
+- タスクは、[シナリオエンジン](./scenario-engine.md)によって実行される最小単位の作業です。
+- タスクは、[シナリオ](./scenario.md)の各ステップを定義するために実装されたプログラムです。
+- タスクは、複雑な機能の組み合わせを避け、単純で明確な機能で実装することが望ましいです。
+- タスク実装に必要な様々な情報と機能をサポートするために、シナリオでは[シナリオコンテキスト](./scenario-context.md)を提供しています。
+- タスクの種類は以下のように区分されます。
+
+## 分類
+
+- 独立タスク
+  - Sleep, Log,
+  - publish - タグ付きデータを購読者に通知
+- フロー制御タスク
+  - Goto Step：Map, Range, ..
+  - サブシナリオ：Map, Range, ..
+  - Throw
+  - End
+- [コネクション](./connection.md) ベースのタスク
+  - database-query
+  - graphql-query, mutator
+  - mqtt：subscribe/publish
+  - indydcp：Indy7 ロボット制御
+  - modbus：読み書き..
+  - ロボティクス関連：カメラ、マーカー等

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

@@ -0,0 +1,25 @@
+# Task
+
+- A task is the smallest unit of work executed by the [Scenario Engine](./scenario-engine.md).
+- A task is a program implemented to define each step of a [Scenario](./scenario.md).
+- It is advisable to implement tasks with simple and clear functions, avoiding complex combinations of features.
+- To support various information and functionalities needed for task implementation, the scenario provides a [Scenario Context](./scenario-context.md).
+- Types of tasks can be distinguished as follows:
+
+## Categories
+
+- Independent Tasks
+  - Sleep, Log,
+  - Publish - notify data with tag to subscribers
+- Flow Control Tasks
+  - Goto Step: Map, Range, ..
+  - Sub Scenario: Map, Range, ..
+  - Throw
+  - End
+- [Connection](./connection.md) Based Tasks
+  - database-query
+  - graphql-query, mutator
+  - mqtt: subscribe/publish
+  - indydcp: Indy7 robot control
+  - modbus: read/writes..
+  - robotics related: camera, markers, ..

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

@@ -0,0 +1,28 @@
+# Tugas (Task)
+
+- Tugas adalah unit kerja terkecil yang dilaksanakan oleh [Enjin Senario](./scenario-engine.md).
+- Tugas adalah program yang dilaksanakan untuk mendefinisikan
+
+setiap langkah dalam [Senario](./scenario.md).
+
+- Adalah disarankan untuk melaksanakan tugas dengan fungsi yang mudah dan jelas, mengelakkan gabungan ciri-ciri yang kompleks.
+- Untuk menyokong pelbagai maklumat dan fungsi yang diperlukan untuk pelaksanaan tugas, senario menyediakan [Konteks Senario](./scenario-context.md).
+- Jenis tugas boleh dibezakan seperti berikut:
+
+## Pengelasan
+
+- Tugas Bebas
+  - Sleep, Log,
+  - Terbitkan - maklumkan data dengan tag kepada pelanggan
+- Tugas Kawalan Aliran
+  - Pergi ke Langkah: Map, Range, ..
+  - Sub Senario: Map, Range, ..
+  - Lempar
+  - Akhir
+- Tugas Berasaskan [Sambungan](./connection.md)
+  - pertanyaan-pangkalan data
+  - pertanyaan-graphql, mutator
+  - mqtt: langgan/terbitkan
+  - indydcp: kawalan robot Indy7
+  - modbus: baca/tulis..
+  - berkaitan robotik: kamera, penanda, ..

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

@@ -0,0 +1,25 @@
+# 任务（Task）
+
+- 任务是由[场景引擎](./scenario-engine.md)执行的最小工作单位。
+- 任务是为了定义[场景](./scenario.md)的每个步骤而实现的程序。
+- 建议将任务实现为简单明了的功能，避免复杂的功能组合。
+- 为了支持任务实现所需的各种信息和功能，场景提供了[场景上下文](./scenario-context.md)。
+- 任务类型可以如下分类：
+
+## 分类
+
+- 独立任务
+  - Sleep, Log,
+  - Publish - 用标签通知数据给订阅者
+- 流程控制任务
+  - Goto Step：Map, Range, ..
+  - 子场景：Map, Range, ..
+  - Throw
+  - End
+- [连接](./connection.md) 基础任务
+  - database-query
+  - graphql-query, mutator
+  - mqtt：subscribe/publish
+  - indydcp：Indy7 机器人控制
+  - modbus：读/写..
+  - 与机器人相关：相机、标记点等

package/dist-app/helps/integration/concept/template-literal.ja.md

@@ -0,0 +1,44 @@
+## テンプレートリテラル（Template Literals）
+
+テンプレートリテラルは、ES6（ECMAScript 2015）で導入された文字列の記法の拡張で、バッククオート（``）で文字列を囲むことができます。
+
+### 文字列内挿（String Interpolation）
+
+テンプレートリテラルを使用すると、`${変数}`の構文を使って変数を文字列に挿入することができます。
+
+```javascript
+const name = 'Alice'
+const greeting = `Hello, ${name}!`
+console.log(greeting) // 出力: Hello, Alice!
+```
+
+### タスクで使用できる変数には 'data'、'variables'、および 'domain' が含まれます。
+
+- data
+  - タスク（ステップ）を含むシナリオのコンテキストデータで、各ステップの名前と実行結果を属性として、シナリオインスタンス内でキーと値のペアとして保持します。
+- variables
+  - タスク（ステップ）を含むシナリオのコンテキストデータで、シナリオインスタンスが開始される際に渡されたパラメータの名前と値を、キーと値のペアとして保持します。
+- domain
+  - タスク（ステップ）を含むシナリオのコンテキストデータで、このタスクが実行されるテナントに関する情報を保持します。
+
+```
+// テンプレートリテラルを使用して URL パスを構築する例。
+https://abc.com:8000/fetch-tools?search=${variables.search}
+```
+
+```
+// テンプレートリテラルを使用してログ文字列を構築する例。
+result code: ${data.result.code}
+```
+
+```
+// テンプレートリテラルを使用して GraphQL クエリを構築する例。
+query {
+  fetchTools(search="${variables.search}") {
+    items {
+      id
+      name
+    }
+  }
+}
+```

package/dist-app/helps/integration/concept/template-literal.ko.md

@@ -0,0 +1,44 @@
+## 템플릿 리터럴 (Template Literals)
+
+ES6에서 도입된 문자열 표기법의 확장으로, 백틱 (`)으로 문자열을 감싸서 사용합니다.
+
+### 변수 삽입 (String Interpolation)
+
+템플릿 리터럴을 사용하면 `${변수}` 형식으로 변수를 문자열에 삽입할 수 있습니다.
+
+```javascript
+const name = 'Alice'
+const greeting = `Hello, ${name}!`
+console.log(greeting) // 출력: Hello, Alice!
+```
+
+### 태스크에서 활용할 수 있는 변수는 'data', 'variables' 그리고, 'domain' 등이 있다.
+
+- data
+  - 태스크(step)를 포함하는 시나리오의 컨텍스트 데이터로서 시나리오 인스턴스에서 수행한 각 스텝의 이름과 실행 결과를 속성의 key와 value로 유지하는 object이다.
+- variables
+  - 태스크(step)를 포함하는 시나리오의 컨텍스트 데이터로서 시나리오 인스턴스가 시작될 때 넘겨진 파라미터들의 이름과 값을 속성의 key와 value로 유지하는 object이다.
+- domain
+  - 태스크(step)를 포함하는 시나리오의 컨텍스트 데이터로서 이 태스크가 실행되는 테넌시 정보를 가지고 있다.
+
+```
+// 템플릿 리터럴을 활용해서 URL path에 활용하는 예시.
+https://abc.com:8000/fetch-tools?search=${variables.search}
+```
+
+```
+// 템플릿 리터럴을 활용해서 logging string에 활용하는 예시.
+result code: ${data.result.code}
+```
+
+```
+// 템플릿 리터럴을 활용해서 graphq query에 활용하는 예시.
+query {
+  fetchTools(search="${variables.search}") {
+    items {
+      id
+      name
+    }
+  }
+}
+```

package/dist-app/helps/integration/concept/template-literal.md

@@ -0,0 +1,44 @@
+## Template Literals
+
+Template literals are an extension of string notation introduced in ES6 (ECMAScript 2015) that allows strings to be enclosed in backticks (`).
+
+### String Interpolation
+
+With template literals, you can insert variables into strings using the `${variable}` syntax.
+
+```javascript
+const name = 'Alice'
+const greeting = `Hello, ${name}!`
+console.log(greeting) // Output: Hello, Alice!
+```
+
+### Variables that can be used in tasks include 'data', 'variables', and 'domain'.
+
+- data
+  - Contextual data for the scenario containing the task (step), maintaining the names and execution results of each step as attributes with key-value pairs in the scenario instance.
+- variables
+  - Contextual data for the scenario containing the task (step), maintaining the names and values of parameters passed when the scenario instance starts as attributes with key-value pairs.
+- domain
+  - Contextual data for the scenario containing the task (step), holding information about the tenancy in which this task is executed.
+
+```
+// Example of using template literals to construct a URL path.
+https://abc.com:8000/fetch-tools?search=${variables.search}
+```
+
+```
+// Example of using template literals to construct a logging string.
+result code: ${data.result.code}
+```
+
+```
+// Example of using template literals to construct a GraphQL query.
+query {
+  fetchTools(search="${variables.search}") {
+    items {
+      id
+      name
+    }
+  }
+}
+```

package/dist-app/helps/integration/concept/template-literal.zh.md

@@ -0,0 +1,44 @@
+## 模板字面量（Template Literals）
+
+模板字面量是在 ES6（ECMAScript 2015）中引入的一种扩展字符串表示法，允许字符串用反引号（``）括起来。
+
+### 字符串插值（String Interpolation）
+
+使用模板字面量，您可以使用`${变量}`语法将变量插入字符串中。
+
+```javascript
+const name = 'Alice'
+const greeting = `你好，${name}！`
+console.log(greeting) // 输出：你好，Alice！
+```
+
+### 任务中可以使用的变量包括 'data'、'variables' 和 'domain'。
+
+- data
+  - 作为包含任务（步骤）的场景的上下文数据，以属性的键值对形式在场景实例中维护每个步骤的名称和执行结果。
+- variables
+  - 作为包含任务（步骤）的场景的上下文数据，以属性的键值对形式在场景实例中维护在场景实例启动时传递的参数的名称和值。
+- domain
+  - 作为包含任务（步骤）的场景的上下文数据，保存有关执行此任务的租户信息。
+
+```
+// 使用模板字面量构建 URL 路径的示例。
+https://abc.com:8000/fetch-tools?search=${variables.search}
+```
+
+```
+// 使用模板字面量构建日志字符串的示例。
+result code: ${data.result.code}
+```
+
+```
+// 使用模板字面量构建 GraphQL 查询的示例。
+query {
+  fetchTools(search="${variables.search}") {
+    items {
+      id
+      name
+    }
+  }
+}
+```

package/dist-app/helps/integration/connector/graphql-connector.ja.md

@@ -0,0 +1,23 @@
+# GraphQLコネクタ
+
+## 説明
+
+リモートGraphQLサーバーに接続し、クエリまたはミューテーションを実行するためのコネクタです。内部サーバー上のGraphQLサーバーに接続し、別のコネクタを指定せずに 'local-graphql-mutate' タスクと 'local-graphql-query' タスクを使用するには、以下を使用してください。
+
+## 設定
+
+### エンドポイント
+
+GraphQLサーバーエンドポイントを指定します。
+
+例： *https://example.com/graphql*
+
+## パラメーター
+
+### OAuth2クライアント
+
+- アプリケーションOAuth2認証のために事前に作成されたクライアントを指定します。
+- Operatoアプリケーションの次のメニューでアプリケーションOAuth2認証のためのクライアントを作成します。
+  ![oauth2-client-menu](./assets/../../../../assets/images/graphql-oauth2-menu.png 'oauth2-client-menu')
+- このメニューを選択すると、以下のようにOAuth2クライアントを作成および管理できます。ここで作成したクライアントはパラメーターとして選択できます。
+  ![oauth2-client-screen](./assets/../../../../assets/images/graphql-oauth2-screen.png 'oauth2-client-screen')

package/dist-app/helps/integration/connector/graphql-connector.ko.md

@@ -0,0 +1,23 @@
+# GraphQL 커넥터
+
+## 설명
+
+원격 GraphQL 서버에 연결하고 쿼리 또는 뮤테이션을 수행하기 위한 커넥터입니다. 내부 서버의 GraphQL 서버에 연결하고 별도의 커넥터를 지정하지 않고 'local-graphql-mutate' 작업 및 'local-graphql-query' 작업을 사용하려면 이용하세요.
+
+## 설정
+
+### 엔드포인트
+
+GraphQL 서버 엔드포인트를 지정합니다.
+
+예: *https://example.com/graphql*
+
+## 매개변수
+
+### OAuth2 클라이언트
+
+- 미리 생성된 어플리케이션 OAuth2 인증을 위한 클라이언트를 지정합니다.
+- Operato 어플리케이션의 다음 메뉴에서 어플리케이션 OAuth2 인증을 위한 클라이언트를 생성하세요.
+  ![oauth2-client-menu](./assets/../../../../assets/images/graphql-oauth2-menu.png 'oauth2-client-menu')
+- 이 메뉴를 선택하면 아래와 같이 OAuth2 클라이언트를 생성하고 관리할 수 있으며, 여기에서 생성한 클라이언트를 매개변수로 선택할 수 있습니다.
+  ![oauth2-client-screen](./assets/../../../../assets/images/graphql-oauth2-screen.png 'oauth2-client-screen')