@fmsim/fmsim 0.0.98 → 0.0.101

package/dist-app/helps/integration/connector/oracle-connector.ms.md

@@ -0,0 +1,87 @@
+# Oracle penghubung
+
+## Sokongan
+
+    1. memerlukan pustaka Klien Oracle versi 11.2 atau lebih tinggi
+    2. Boleh menyambung ke Pangkalan Data Oracle 10g atau lebih tinggi
+
+## Tetapan
+
+### MAC OS
+
+- pasang klien Oracle
+
+  ```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
+
+- buat laluan Oracle
+  ```sh
+  mkdir -p /opt/oracle
+  cd /opt/oracle
+  ```
+- muat turun klien Oracle terbaru untuk menyambung ke Pangkalan Data Oracle
+  ```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
+  ```
+
+### Untuk maklumat lanjut sila rujuk
+
+- https://oracle.github.io/node-oracledb/INSTALL.html
+
+## titik akhir
+
+Nama hos enjin Oracle dan port perkhidmatan
+
+- hostname : hos pelayan pangkalan data
+- service port : port perkhidmatan pangkalan data (lalai - 1521)
+- format
+  - {hostname}[:{port}]
+  - contoh
+    - "localhost:1521"
+    - "localhost"
+    - "192.168.0.1:1521"
+
+## Parameter
+
+### user
+
+- ID pengguna untuk pangkalan data Oracle
+
+### password
+
+- kata laluan pengguna untuk pangkalan data Oracle
+
+### database
+
+- nama sid Oracle
+
+### pool-increment
+
+- saiz peningkatan kolam sambungan
+- nilai lalai 1
+
+### min. connection pool
+
+- Bilangan sambungan yang ditubuhkan ke pangkalan data apabila kolam dicipta. Ini juga adalah bilangan sambungan minimum yang dikekalkan oleh kolam apabila ia mengecil.
+- nilai lalai 0
+
+### max. connection pool
+
+- Bilangan maksimum sambungan yang boleh berkembang ke kolam sambungan.
+- Pentingnya, jika anda meningkatkan "max. connection pool", anda juga harus meningkatkan bilangan utas yang tersedia untuk node-oracledb. Lihat [Sambungan dan Bilangan Utas](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#numberofthreads).
+- nilai lalai 4

package/dist-app/helps/integration/connector/oracle-connector.zh.md

@@ -0,0 +1,87 @@
+# Oracle 连接器
+
+## 支持
+
+    1. 需要 Oracle 客户端库版本 11.2 或更高
+    2. 可以连接到 Oracle 数据库 10g 或更高
+
+## 设置
+
+### MAC OS
+
+- 安装 Oracle 客户端
+
+  ```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
+
+- 创建 Oracle 路径
+  ```sh
+  mkdir -p /opt/oracle
+  cd /opt/oracle
+  ```
+- 下载最新的 Oracle 客户端以连接到 Oracle 数据库
+  ```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
+  ```
+
+### 详情请参考
+
+- https://oracle.github.io/node-oracledb/INSTALL.html
+
+## 端点
+
+Oracle 引擎主机名和服务端口
+
+- hostname : 数据库服务器主机
+- service port : 数据库服务端口（默认 - 1521）
+- 格式
+  - {hostname}[:{port}]
+  - 例如
+    - "localhost:1521"
+    - "localhost"
+    - "192.168.0.1:1521"
+
+## 参数
+
+### user
+
+- Oracle 数据库用户 ID
+
+### password
+
+- Oracle 数据库用户密码
+
+### database
+
+- Oracle SID 名称
+
+### pool-increment
+
+- 连接池增量大小
+- 默认值 1
+
+### min. connection pool
+
+- 创建池时数据库建立的连接数。这也是池缩小时保持的最小连接数。
+- 默认值 0
+
+### max. connection pool
+
+- 连接池可以增长的最大连接数。
+- 重要的是，如果你增加了“max. connection pool”，你也应该增加 node-oracledb 可用的线程数。参见[连接和线程数](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#numberofthreads)。
+- 默认值 4

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

@@ -0,0 +1,34 @@
+# Postgresqlコネクタ
+
+## Postgresqlとは
+
+[PostgreSQL](https://www.postgresql.org/)は世界で最も先進的なオープンソースのリレーショナルデータベースです。
+
+## 設定
+
+### エンドポイント
+
+Postgresqlエンジンのホスト名とサービスポート
+
+- ホスト名：データベースサーバーホスト
+- サービスポート：データベースサービスポート（デフォルト - 5432）
+- フォーマット
+  - {ホスト名}[:{ポート}]
+  - 例
+    - "localhost:5432"
+    - "localhost"
+    - "192.168.0.1:5432"
+
+## パラメーター
+
+### ユーザー
+
+- PostgresqlデータベースのユーザーID
+
+### パスワード
+
+- Postgresqlデータベースのユーザーパスワード
+
+### データベース
+
+- データベース名

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

@@ -0,0 +1,34 @@
+# Postgresql 커넥터
+
+## Postgresql은
+
+[PostgreSQL](https://www.postgresql.org/)은 세계에서 가장 진보한 오픈 소스 관계형 데이터베이스입니다.
+
+## 설정
+
+### 엔드포인트
+
+Postgresql 엔진 호스트 이름과 서비스 포트
+
+- 호스트 이름 : 데이터베이스 서버 호스트
+- 서비스 포트 : 데이터베이스 서비스 포트 (기본값 - 5432)
+- 형식
+  - {호스트 이름}[:{포트}]
+  - 예시
+    - "localhost:5432"
+    - "localhost"
+    - "192.168.0.1:5432"
+
+## 매개변수
+
+### 사용자
+
+- Postgresql 데이터베이스의 사용자 ID
+
+### 비밀번호
+
+- Postgresql 데이터베이스의 사용자 비밀번호
+
+### 데이터베이스
+
+- 데이터베이스 이름

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/postgresql-connector.ms.md

@@ -0,0 +1,34 @@
+# Penyambung Postgresql
+
+## Postgresql ialah
+
+[PostgreSQL](https://www.postgresql.org/) adalah Pangkalan Data Relasional Sumber Terbuka Paling Terkini di Dunia
+
+## Tetapan
+
+### titik akhir
+
+Nama hos dan port perkhidmatan enjin Postgresql
+
+- nama hos : hos pelayan pangkalan data
+- port perkhidmatan : port perkhidmatan pangkalan data (lalai - 5432)
+- format
+  - {nama hos}[:{port}]
+  - contoh
+    - "localhost:5432"
+    - "localhost"
+    - "192.168.0.1:5432"
+
+## Parameter
+
+### pengguna
+
+- ID pengguna untuk pangkalan data Postgresql
+
+### kata laluan
+
+- Kata laluan pengguna untuk pangkalan data Postgresql
+
+### pangkalan data
+
+- Nama pangkalan data

package/dist-app/helps/integration/connector/postgresql-connector.zh.md

@@ -0,0 +1,34 @@
+# Postgresql连接器
+
+## Postgresql是什么
+
+[PostgreSQL](https://www.postgresql.org/)是世界上最先进的开源关系型数据库
+
+## 设置
+
+### 终端点
+
+Postgresql引擎主机名和服务端口
+
+- 主机名：数据库服务器主机
+- 服务端口：数据库服务端口（默认 - 5432）
+- 格式
+  - {主机名}[:{端口}]
+  - 例如
+    - "localhost:5432"
+    - "localhost"
+    - "192.168.0.1:5432"
+
+## 参数
+
+### 用户
+
+- Postgresql数据库的用户ID
+
+### 密码
+
+- Postgresql数据库的用户密码
+
+### 数据库
+
+- 数据库名称

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

@@ -0,0 +1,17 @@
+# SQLiteコネクタ
+
+## SQLiteは
+
+[SQLite](https://www.sqlite.org/index.html)は、小規模で高速で、自己完結型で、高信頼性かつ充実したSQLデータベースエンジンを実装したC言語ライブラリです。
+
+## 設定
+
+### エンドポイント
+
+sqliteファイルのパス
+
+- 相対パス：
+  - ベースパス(".")はアプリケーションがインストールされたフォルダです。
+  - 例: "./db.sqlite"
+- または絶対パス：
+  - 例: "/home/super/operato/db.sqlite"

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

@@ -0,0 +1,17 @@
+# SQLite 커넥터
+
+## SQLite는
+
+[SQLite](https://www.sqlite.org/index.html)은 소형, 빠르고 자체 포함, 고신뢰성, 다기능, SQL 데이터베이스 엔진을 구현한 C 언어 라이브러리입니다.
+
+## 설정
+
+### 엔드포인트
+
+sqlite 파일 경로
+
+- 상대 경로 :
+  - 기본 경로(".")는 응용 프로그램이 설치된 폴더입니다.
+  - 예: "./db.sqlite"
+- 또는 절대 경로 :
+  - 예: "/home/super/operato/db.sqlite"

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/connector/sqlite-connector.ms.md

@@ -0,0 +1,17 @@
+# Penyambung SQLite
+
+## SQLite adalah
+
+[SQLite](https://www.sqlite.org/index.html) adalah perpustakaan berbahasa C yang mengimplementasikan mesin database SQL yang kecil, cepat, mandiri, tinggi kehandalan, dan lengkap fitur.
+
+## Tetapan
+
+### titik akhir
+
+Jalur fail sqlite
+
+- jalur relatif:
+  - jalur dasar(".") adalah folder aplikasi yang terpasang
+  - contoh: "./db.sqlite"
+- atau jalur mutlak:
+  - contoh: "/home/super/operato/db.sqlite"

package/dist-app/helps/integration/connector/sqlite-connector.zh.md

@@ -0,0 +1,17 @@
+# SQLite连接器
+
+## SQLite是什么
+
+[SQLite](https://www.sqlite.org/index.html)是一个用C语言实现的小型、快速、自包含、高可靠性、功能齐全的SQL数据库引擎库。
+
+## 设置
+
+### 终端点
+
+sqlite文件路径
+
+- 相对路径：
+  - 基本路径(".")是应用程序安装的文件夹。
+  - 例如: "./db.sqlite"
+- 或绝对路径：
+  - 例如: "/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.ja.md

@@ -0,0 +1,27 @@
+# book-up-scenario
+
+[保留キュー](../concept/pending-queue.md)に遅延シナリオを追加するタスクです。
+
+## パラメータ
+
+- シナリオ
+  - 必須入力値
+  - [保留キュー](../concept/pending-queue.md)に追加される遅延シナリオを選択します。
+- 遅延
+
+  - 必須入力値
+  - 遅延時間を秒単位で指定します。 -1に指定すると、遅延なしで直ちに[pickup](./pick-pending-scenario.md)できます。
+  - この値には変数を適用できます。
+  - 例
+    - -1 => 遅延なし
+    - 100 => 100秒
+    - #{recipe} => 'recipe'ステップの結果値
+    - #{pizza.cookingTime} => 'pizza'ステップの結果データのcookingTime値
+
+- 優先度
+  - 遅延シナリオの優先度を指定します。デフォルト値は0です。
+- 変数
+  - シナリオに変数として渡される[アクセサ](../concept/data-accessor.md)の値を設定します。
+- タグ
+  - シナリオに付けられるタグを設定します。
+  - 予約されたシナリオはこのタグ値でグループ化されるため、シナリオキューモニタリング機能でこのタグ値で検索できます。

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

@@ -0,0 +1,27 @@
+# book-up-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/book-up-scenario.md

@@ -0,0 +1,27 @@
+# book-up-scenario
+
+This is a task to add delayed scenarios to the [pending queue](../concept/pending-queue.md).
+
+## Parameters
+
+- Scenario
+  - Required input
+  - Select the delayed scenario to be added to the [pending queue](../concept/pending-queue.md).
+- Delay
+
+  - Required input
+  - Specify the delay time in seconds. If set to -1, it can be immediately [picked up](./pick-pending-scenario.md) without delay.
+  - Variables can be applied to this value.
+  - Examples
+    - -1 => No delay
+    - 100 => 100 seconds
+    - #{recipe} => Result value of the 'recipe' step
+    - #{pizza.cookingTime} => Cooking time value of the 'pizza' step result data
+
+- Priority
+  - Specify the priority of the delayed scenario. The default value is 0.
+- Variables
+  - Set the value of the [accessor](../concept/data-accessor.md) to be passed as a variable to the scenario.
+- Tag
+  - Set the tag attached to the scenario.
+  - Since reserved scenarios are grouped by this tag value, they can be queried in the scenario queue monitoring function with this tag value.

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

@@ -0,0 +1,27 @@
+# book-up-scenario
+
+Ini adalah tugasan untuk menambahkan senario yang ditangguhkan ke dalam [barisan menunggu](../concept/pending-queue.md).
+
+## Parameter
+
+- Senario
+  - Input yang diperlukan
+  - Pilih senario yang ditangguhkan untuk ditambahkan ke dalam [barisan menunggu](../concept/pending-queue.md).
+- Tangguh
+
+  - Input yang diperlukan
+  - Tetapkan masa tangguh dalam satuan saat. Jika ditetapkan sebagai -1, ia boleh segera [diambil](./pick-pending-scenario.md) tanpa tangguh.
+  - Pembolehubah boleh digunakan pada nilai ini.
+  - Contoh
+    - -1 => Tiada tangguh
+    - 100 => 100 saat
+    - #{recipe} => Nilai hasil langkah 'resipi'
+    - #{pizza.cookingTime} => Nilai masa memasak data hasil langkah 'pizza'
+
+- Keutamaan
+  - Tetapkan keutamaan senario yang ditangguh. Nilai lalai adalah 0.
+- Pembolehubah
+  - Tetapkan nilai [pencapai](../concept/data-accessor.md) yang akan dipindahkan sebagai pembolehubah ke dalam senario.
+- Tag
+  - Tetapkan tag yang melekat pada senario.
+  - Kerana senario yang dipesan dikelompokkan oleh nilai tag ini, mereka boleh dicari dalam fungsi pemantauan barisan senario dengan nilai tag ini.

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

@@ -0,0 +1,27 @@
+# book-up-scenario
+
+这是一个将延迟场景添加到[挂起队列](../concept/pending-queue.md)的任务。
+
+## 参数
+
+- 场景
+  - 必填项
+  - 选择要添加到[挂起队列](../concept/pending-queue.md)的延迟场景。
+- 延迟
+
+  - 必填项
+  - 以秒为单位指定延迟时间。如果设置为-1，则可以立即[pickup](./pick-pending-scenario.md)而无需延迟。
+  - 此值可以应用变量。
+  - 例子
+    - -1 => 无延迟
+    - 100 => 100秒
+    - #{recipe} => 'recipe'步骤的结果值
+    - #{pizza.cookingTime} => 'pizza'步骤结果数据的cookingTime值
+
+- 优先级
+  - 指定延迟场景的优先级。默认值为0。
+- 变量
+  - 设置作为场景变量传递的[访问器](../concept/data-accessor.md)的值。
+- 标签
+  - 设置附加到场景的标签。
+  - 由于预订的场景是根据此标签值分组的，因此可以在场景队列监控功能中使用此标签值查询。

package/dist-app/helps/integration/task/csv-readline.ja.md

@@ -0,0 +1,10 @@
+# csv-readline
+
+与えられたCSV形式のファイルを1レコードずつ読み取り、データとして返すタスクです。
+最終行以降にはデータが返されないため、
+次のステップではempty-checkなどのタスクを使用してデータがこれ以上返らない場合にシナリオを終了するなどのシナリオ構成が可能です。
+
+## パラメータ
+
+- path
+  - CSVファイルのパス情報を入力します。

package/dist-app/helps/integration/task/csv-readline.ko.md

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

package/dist-app/helps/integration/task/csv-readline.md

@@ -0,0 +1,9 @@
+# csv-readline
+
+This is a task that reads a given file in CSV format, one record at a time, and returns it as data.
+Since no data is returned after the last line, in the next step, you can configure scenarios such as ending the scenario with tasks like empty-check when no more data is returned.
+
+## Parameters
+
+- path
+  - Enter the path information of the CSV file.

package/dist-app/helps/integration/task/csv-readline.ms.md

@@ -0,0 +1,9 @@
+# csv-readline
+
+Ini adalah tugasan yang membaca fail dalam format CSV yang diberikan, satu rekod pada satu masa, dan mengembalikannya sebagai data.
+Kerana tiada data yang dikembalikan selepas baris terakhir, pada langkah seterusnya, anda boleh menyusun senario seperti mengakhiri senario dengan tugasan seperti pemeriksaan-kosong apabila tiada data lagi yang dikembalikan.
+
+## Parameter
+
+- path
+  - Masukkan maklumat laluan fail CSV.

package/dist-app/helps/integration/task/csv-readline.zh.md

@@ -0,0 +1,9 @@
+# csv-readline
+
+这是一个按行读取给定CSV格式文件的任务，每次读取一条记录，并将其作为数据返回。
+由于在最后一行之后不再返回数据，因此在下一步中，可以使用像empty-check这样的任务配置场景，以在不再返回数据时结束场景。
+
+## 参数
+
+- 路径
+  - 输入CSV文件的路径信息。