@fmsim/fmsim 0.0.97 → 0.0.98

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

@@ -1,44 +0,0 @@
-## 模板字面量（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/mqtt-connector.md

@@ -1,17 +0,0 @@
-# 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

@@ -1,38 +0,0 @@
-# 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

@@ -1,66 +0,0 @@
-# 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

@@ -1,34 +0,0 @@
-# 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

@@ -1,17 +0,0 @@
-# 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

@@ -1,37 +0,0 @@
-# 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

@@ -1,27 +0,0 @@
-# Bookup Scenario
-
-[지연 큐](../concept/pending-queue.md)에 지연된 시나리오를 추가하는 태스크이다.
-
-## parameters
-
-- scenario
-  - 필수입력값
-  - [지연 큐](../concept/pending-queue.md)에 추가될 지연 시나리오를 선택한다.
-- delay
-
-  - 필수입력값
-  - 지연 시간을 초 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

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

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

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

package/dist-app/helps/integration/task/database-query.ja.md

@@ -1,14 +0,0 @@
-# データベースクエリタスク
-
-このタスクは、データベースコネクタを対象として SQL クエリを実行できるタスクです。
-
-SQL クエリを作成する際に、変数性の値はシナリオコンテキストの data および variables など、[スクリプト内蔵変数](../concept/script-internal-variables.md)を活用できます。
-
-```
-# SQLの例
-
-Select * from LOT
-where product='${variables.search.product}' // variables: シナリオ入力変数
-  and operation='${data.lot.operation}' // data: シナリオ実行データ
-  and factory='${domain.attributes.factory}' // domain: 現在のテナント情報
-```

package/dist-app/helps/integration/task/database-query.ko.md

@@ -1,14 +0,0 @@
-# Database Query Task
-
-데이타베이스 커넥터를 대상으로 SQL 쿼리를 실행할 수 있는 태스크이다.
-
-SQL 쿼리를 작성할 때, 변수성 값은 시나리오 컨텍스트의 data와 variables등 [스크립트 내장변수](../concept/script-internal-variables.md)를 활용할 수 있다.
-
-```
-# SQL 예시
-
-Select * from LOT
-where product='${variables.search.product}' // variables : 시나리오 입력변수
-  and operation='${data.lot.operation}' // data : 시나리오 실행 데이타
-  and factory='${domain.attributes.factory}' // domain : 현재 테넌시 정보
-```

package/dist-app/helps/integration/task/database-query.md

@@ -1,14 +0,0 @@
-# Database Query Task
-
-This is a task that allows executing SQL queries on a database connector.
-
-When writing SQL queries, variable values can be used from the scenario context, such as data and variables, including [Script Internal Variables](../concept/script-internal-variables.md).
-
-```
-# SQL Example
-
-Select * from LOT
-where product='${variables.search.product}' // variables: Scenario input variables
-  and operation='${data.lot.operation}' // data: Scenario execution data
-  and factory='${domain.attributes.factory}' // domain: Current tenant information
-```

package/dist-app/helps/integration/task/database-query.ms.md

@@ -1,14 +0,0 @@
-# Tugas Pertanyaan Pangkalan Data
-
-Ini adalah tugas yang membolehkan pelaksanaan pertanyaan SQL terhadap penyambung pangkalan data.
-
-Semasa menulis pertanyaan SQL, pembolehubah boleh digunakan dengan menggunakan data dan pembolehubah dalam konteks senario, seperti yang diterangkan dalam [Pembolehubah Dalaman Skrip](../concept/script-internal-variables.md).
-
-```
-# Contoh SQL
-
-Select * from LOT
-where product='${variables.search.product}' // variables: pembolehubah input senario
-  and operation='${data.lot.operation}' // data: data pelaksanaan senario
-  and factory='${domain.attributes.factory}' // domain: maklumat penyewa semasa ini
-```

package/dist-app/helps/integration/task/database-query.zh.md

@@ -1,14 +0,0 @@
-# 数据库查询任务
-
-这是一个可以对数据库连接器执行 SQL 查询的任务。
-
-在编写 SQL 查询时，可以使用脚本上下文的 data 和 variables 等[脚本内置变量](../concept/script-internal-variables.md)中的变量值。
-
-```
-# SQL示例
-
-Select * from LOT
-where product='${variables.search.product}' // variables：场景输入变量
-  and operation='${data.lot.operation}' // data：场景执行数据
-  and factory='${domain.attributes.factory}' // domain：当前租户信息
-```

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

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

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

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

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

@@ -1,34 +0,0 @@
-# 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-app/helps/integration/task/goto.md

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

package/dist-app/helps/integration/task/graphql-mutate.ja.md

@@ -1,41 +0,0 @@
-# GraphQL Mutate Task
-
-これはサーバーが提供する GraphQL mutate API を呼び出すタスクです。MutationQuery を作成する際、変数の処理は 2 つの方法で行うことができ、方法 2 を使用することをお勧めします。
-
-方法 1：シナリオコンテキストから data と variables、および[スクリプトの内部変数](../concept/script-internal-variables.md)を使用できます。この方法は文字列変数を適用するのに適しています。
-
-```graphql
-mutation {
-  syncAllMarketplaceOrder(fromDate: "${this.variables.fromDate}", toDate: "${this.variables.toDate}") {
-    ...
-  }
-
-  removeTagFromObject(tag: "${this.data.tag}") {
-    ...
-  }
-}
-```
-
-方法 2：`variables`に使用する変数を指定し、GraphQL 変数処理を使用します。 `variables`の値は、シナリオコンテキスト内のデータへのアクセサとして指定できます。この方法はオブジェクトタイプの変数を適用するのに適しています。
-
-```graphql
-mutation($fromDate: String!, $toDate: String!) {
-  syncAllMarketplaceOrder(fromDate: $fromDate, toDate: $toDate) {
-    ...
-  }
-
-  removeTagFromObject(tag: $tag) {
-    ...
-  }
-}
-```
-
-## パラメータ
-
-- `mutation`
-
-  - GraphQL mutation クエリを入力します。
-
-- `variables`
-  - GraphQL クエリで使用する変数を定義します。
-  - 変数名をキーとし、変数値に対応するデータアクセサを値として設定します.

package/dist-app/helps/integration/task/graphql-mutate.ko.md

@@ -1,44 +0,0 @@
-# GraphqlMutate Task
-
-서버에서 제공하는 graphql mutate API를 호출하는 태스크이다.
-MutationQuery를 작성할 때, 변수 처리는 다음과 같이 두 가지 방법으로 가능하며, 방법 2를 사용하기를 권장한다.
-
-방법 1. 시나리오 컨텍스트의 data와 variables등 [스크립트 내장변수](../concept/script-internal-variables.md)를 활용할 수 있다.
-이 방법은 문자열 변수를 적용할 때 적합하다.
-
-```
-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-app/helps/integration/task/graphql-mutate.md

@@ -1,41 +0,0 @@
-# GraphQL Mutate Task
-
-This is a task that calls the GraphQL mutate API provided by the server. When writing the MutationQuery, variable processing can be done in two ways, and it is recommended to use Method 2.
-
-Method 1: You can use the data and variables from the scenario context, as well as [script internal variables](../concept/script-internal-variables.md). This method is suitable for applying string variables.
-
-```graphql
-mutation {
-  syncAllMarketplaceOrder(fromDate: "${this.variables.fromDate}", toDate: "${this.variables.toDate}") {
-    ...
-  }
-
-  removeTagFromObject(tag: "${this.data.tag}") {
-    ...
-  }
-}
-```
-
-Method 2: Specify the variables to be used in `variables`, and use GraphQL variable processing. The value of `variables` can be specified as an accessor for the data in the scenario context. This method is suitable for applying object-type variables.
-
-```graphql
-mutation($fromDate: String!, $toDate: String!) {
-  syncAllMarketplaceOrder(fromDate: $fromDate, toDate: $toDate) {
-    ...
-  }
-
-  removeTagFromObject(tag: $tag) {
-    ...
-  }
-}
-```
-
-## Parameters
-
-- `mutation`
-
-  - Input the GraphQL mutation query.
-
-- `variables`
-  - Define the variables to be used in the GraphQL query.
-  - Specify the variable names as keys, and set the data accessor corresponding to the variable value as the value.

package/dist-app/helps/integration/task/graphql-mutate.ms.md

@@ -1,41 +0,0 @@
-# Tugas GraphQL Mutate
-
-Ini adalah tugas yang memanggil GraphQL mutate API yang disediakan oleh server. Ketika menulis MutationQuery, pengolahan variabel dapat dilakukan dengan dua cara, dan disarankan menggunakan Metode 2.
-
-Metode 1: Anda dapat menggunakan data dan variabel dari konteks skenario, serta [variabel internal skrip](../concept/script-internal-variables.md). Metode ini cocok untuk menerapkan variabel string.
-
-```graphql
-mutation {
-  syncAllMarketplaceOrder(fromDate: "${this.variables.fromDate}", toDate: "${this.variables.toDate}") {
-    ...
-  }
-
-  removeTagFromObject(tag: "${this.data.tag}") {
-    ...
-  }
-}
-```
-
-Metode 2: Tentukan variabel yang akan digunakan dalam `variabel`, dan gunakan pengolahan variabel GraphQL. Nilai dari `variabel` dapat ditentukan sebagai akses data dalam konteks skenario. Metode ini cocok untuk menerapkan variabel tipe objek.
-
-```graphql
-mutation($fromDate: String!, $toDate: String!) {
-  syncAllMarketplaceOrder(fromDate: $fromDate, toDate: $toDate) {
-    ...
-  }
-
-  removeTagFromObject(tag: $tag) {
-    ...
-  }
-}
-```
-
-## Parameter
-
-- `mutation`
-
-  - Masukkan kueri mutasi GraphQL.
-
-- `variables`
-  - Tentukan variabel yang akan digunakan dalam kueri GraphQL.
-  - Tentukan nama variabel sebagai kunci, dan atur akses data yang sesuai dengan nilai variabel sebagai nilai.

package/dist-app/helps/integration/task/graphql-mutate.zh.md

@@ -1,41 +0,0 @@
-# GraphQL Mutate Task
-
-这是一个调用服务器提供的 GraphQL mutate API 的任务。在编写 MutationQuery 时，可以通过两种方式进行变量处理，建议使用方法 2。
-
-方法 1：您可以使用情境上下文中的 data 和 variables，以及 script 内部变量。这种方法适用于应用字符串变量。
-
-```graphql
-mutation {
-  syncAllMarketplaceOrder(fromDate: "${this.variables.fromDate}", toDate: "${this.variables.toDate}") {
-    ...
-  }
-
-  removeTagFromObject(tag: "${this.data.tag}") {
-    ...
-  }
-}
-```
-
-方法 2：在`variables`中指定要在 GraphQL 查询中使用的变量，并使用 GraphQL 变量处理。 `variables`的值可以指定为情境上下文中数据的访问器。这种方法适用于应用对象类型变量。
-
-```graphql
-mutation($fromDate: String!, $toDate: String!) {
-  syncAllMarketplaceOrder(fromDate: $fromDate, toDate: $toDate) {
-    ...
-  }
-
-  removeTagFromObject(tag: $tag) {
-    ...
-  }
-}
-```
-
-## 参数
-
-- `mutation`
-
-  - 输入 GraphQL mutation 查询。
-
-- `variables`
-  - 定义要在 GraphQL 查询中使用的变量。
-  - 将变量名称指定为键，并将对应于变量值的数据访问器设置为值。