@things-factory/integration-base 6.1.119 → 6.1.123

package/helps/integration/task/oracle-procedure.ko.md

@@ -5,16 +5,21 @@ Oracle 데이터베이스에 저장되어 있는 프로시저를 호출하는
 
 ## Parameters
 
-### 프로시저
-  - 프로시저를 호출하는 함수부를 작성한다. 작성 시에 BEGIN과 END는 실제 내부에서 추가되기 때문에 별도로 지정할 필요가 없다.
-  - 호출 이후에 ;을 추가해야 한다.
-  - 프로시저의 입출력 파라미터는 :과 함께 사용한다.
-  - 프로시저 작성 예는 다음과 같다.
-    
-    ```sql
+### 프로시저 코드
+  - 프로시저 코드는 *프로시저 이름*과 *파라미터*에 의해서 자동으로 생성되는 코드로서, 별도로 사용자가 입력할 필요는 없다.
+  - 만약, 프로시저의 이름이 *mcs.myproc*이고, 파라미터가 *id*와 *out_name*으로 구성된다면, 다음과 같이 표현된다.
+    ```text
     mcs.myproc(:id, :out_name);
     ```
 
+### 프로시저 이름
+  - 프로시저의 이름을 지정한다.
+  - 프로시저가 패키지나 사용자 이름등으로 구분이 필요할 경우 '.'을 통해서 구분한다.
+  - 사용 예.
+    ```text
+    mcs.myproc
+    ```
+
 ### 파라미터
   - 파라미터는 다음과 같은 요소로 구성되어 있다.
     - 파라미터 이름
@@ -101,7 +106,6 @@ BEGIN
             SELECT * FROM FARMWEATHER WHERE rownum <= 1000;
     END;
 END PROCEDURE1;
-
 ```
 
 ### 프로시저 호출 예

package/helps/integration/task/oracle-procedure.md

@@ -1,48 +1,51 @@
 # Oracle Procedure Task
 
-A task that calls a procedure stored in an Oracle database, 
-Depending on the individual data type, it returns a list of data or a value of a specific data type.
+A task that calls a procedure stored in the Oracle database, 
+It returns a list of data or a value of a specific data type, depending on the individual data type.
 
 ## Parameters
 
-### Procedure
-  - Write a function that calls the procedure. You don't need to specify BEGIN and END at the time of writing because they are actually added internally.
-  - You need to add ;after the call.
-  - The input and output parameters of a procedure are used with :.
-  - An example of writing a procedure is as follows
-    
-    ```sql
+### Procedure Code
+  - The procedure code is the code that is automatically generated by the *procedure name* and *parameters* and does not need to be entered by the user.
+  - If a procedure is named *mcs.myproc* and the parameters consist of *id* and *out_name*, it would look like this
+    ```text
     mcs.myproc(:id, :out_name);
     ```
 
+### Procedure Name
+  - Specifies the name of the procedure.
+  - If the procedure needs to be separated by a package or user name, use a '.' to separate them.
+  - Example.
+    ```text
+    mcs.myproc
+    ```text mcs.myproc
+
 ### Parameters
   - A parameter consists of the following elements
-    - The parameter name
+    - A parameter name
     - Input/output designation: IN, INOUT, OUT
     - Parameter type: String, Number, Date, Cursor
     - Value: If the variable is an input, the value for that input.
-    - MaxSize: If the variable is of type String or Buffer, specifies the maximum size of the variable.
+    - MaxSize: If the variable is of type String or Buffer, the maximum size of the variable.
 
-#### Paramter name
+#### Parameter names
 
-Parameter name specifies the name of the parameter used in the procedure.
+The parameter name specifies the name of the parameter used in the procedure.
 For the previous example,
-
   ```sql
   mcs.myproc(:id, :out_name);
   ```
+id and out_name are the parameter names.
 
-id and out_name are the parameter names, respectively.
+### Specifying input and output
 
-### In/Out Type
+Specifies whether the variable is input (IN) or output (OUT).
 
-Specifies whether the variable is an input (IN) or output (OUT).
+### parameter type
 
-### Paramter type
+Specifies the type of the parameter. The type must be the same as the name specified in the actual procedure creation.
 
-Specifies the parameter type. The type must be the same as the name given to the actual procedure when it is created.
-
-If the procedure is implemented as follows,
+If the procedure is implemented like this
 
 ```sql
 CREATE OR REPLACE NONEDITIONABLE PROCEDURE myproc (in_id IN VARCHAR2, out_name OUT VARCHAR2) AS
@@ -51,35 +54,36 @@ BEGIN
 END;
 ```
 
-Both the first and second parameters are specified as VARCHAR2, 
+Note that both the first and second parameters are specified as VARCHAR2, 
 
-If you need to call these procedures, the parameter types should all be String, 
+If you need to call these procedures, the parameter types must be specified as String, 
 For the output, the maximum size should be specified.
 
 An example call specification is as follows
 
-![procedure example1](./assets/../../../../assets/images/oracle-procedure-example1.png 'procedure example1')
+![procedure example1](./assets/../../../../../assets/images/oracle-procedure-example1.png 'procedure example1')
+
 
+### Accessor [accessor](../concept/data-accessor.md)
 
-# Accessor [accessor](../concept/data-accessor.md)
+Follow the [JSONATA documentation](http://docs.jsonata.org/overview.html) for configuration.
 
-- Set when you want to propagate only a part of the data object of the source component or the transformed data.
-- The setting method follows [JSONATA document](http://docs.jsonata.org/overview.html).
 
-### Value(for Input)
+### Value
 
 If the parameter is an input (IN), specify its value. 
-Do not enter a constant value directly into the value, but rather specify a specific task name.
+Do not enter a constant value directly into the value, but specify a specific task name.
 
-In the example above, if the input value for id is specified as ID, specify the value returned by the ID task as the input value.
+In the example above, if the input value of id is specified as ID, specify the value returned by the ID task as the input value.
 
-### Maxsize
 
-If the parameter type is String or Buffer, specify the maximum size. For other types, no value is specified and it is ignored.
+### Maximum size
+
+If the parameter type is String or Buffer, specify the maximum size. For other types, do not specify a value and ignore it.
 
 ## Task Result
 
-The result of a procedure call is returned as an Object, where the name of the parameter specified as output is the key, and the value is returned.
+The result of the procedure call is returned in the form of an Object, and the parameter name specified as the output is the key and returns the value.
 
 For example, the task introduced above returns the following result value.
 
@@ -90,26 +94,25 @@ For example, the task introduced above returns the following result value.
 ```
 
 
-## Another Example(using cursor)
+## Other usage examples (cursor)
 
-### Procedure using cursor parameter
+### Example of writing a procedure
 
 ```sql
-CREATE OR REPLACDE NONEDITIONABLE PROCEDURE PROCEDURE1(out_cursor OUT SYS_REFCURSOR) AS 
+CREATE OR REPLACE NONEDITIONABLE PROCEDURE PROCEDURE1(out_cursor OUT SYS_REFCURSOR) AS 
 BEGIN
     BEGIN
         OPEN out_cursor FOR
             SELECT * FROM FARMWEATHER WHERE rownum <= 1000;
     END;
 END PROCEDURE1;
-
 ```
 
-### Task example to call the procedure using a cursor as an output
+### Example of calling a procedure
 
-![procedure example2](./assets/../../../../assets/images/oracle-procedure-example2.png 'procedure example2')
+![procedure example2](./assets/../../../../../assets/images/oracle-procedure-example2.png 'procedure example2')
 
-### Task result
+### Procedure task call result
 
 ```javascript
 {
@@ -133,4 +136,4 @@ END PROCEDURE1;
     ...
   ]
 }
-```
+```

package/helps/integration/task/oracle-procedure.ms.md

@@ -0,0 +1,139 @@
+# Tugas Prosedur Oracle
+
+Tugas ini memanggil prosedur yang disimpan dalam pangkalan data Oracle,
+dan mengembalikan senarai data atau nilai jenis data tertentu bergantung pada jenis data individu.
+
+## Parameter
+
+### Kod Prosedur
+  - Kod prosedur adalah kod yang dihasilkan secara automatik oleh *nama prosedur* dan *parameter*, dan pengguna tidak perlu memasukkannya secara berasingan.
+  - Jika nama prosedur adalah *mcs.myproc* dan parameter terdiri daripada *id* dan *out_name*, ia akan dinyatakan seperti berikut.
+    ```text
+    mcs.myproc(:id, :out_name);
+    ```
+
+### Nama Prosedur
+  - Tentukan nama prosedur.
+  - Jika prosedur perlu dibezakan dengan nama pakej atau pengguna, dll., ia dibezakan dengan '.'.
+  - Contoh penggunaan.
+    ```text
+    mcs.myproc
+    ```
+
+### Parameter
+  - Parameter terdiri daripada elemen-elemen berikut.
+    - Nama parameter
+    - Penentuan input / output: IN, INOUT, OUT
+    - Jenis parameter: String, Number, Date, Cursor
+    - Nilai: Jika pemboleh ubah itu adalah input, nilai untuk input itu
+    - Saiz maksimum: Jika jenis pemboleh ubah adalah String atau Buffer, tentukan saiz maksimum pemboleh ubah.
+
+#### Nama Parameter
+
+Nama parameter menentukan nama parameter yang digunakan semasa membuat prosedur.
+Dalam contoh di atas,
+  ```sql
+  mcs.myproc(:id, :out_name);
+  ```
+id dan out_name adalah nama parameter masing-masing.
+
+### Penentuan Input / Output
+
+Tentukan sama ada pemboleh ubah itu adalah input (IN) atau output (OUT).
+
+### Jenis Parameter
+
+Tentukan jenis parameter. Jenis harus ditentukan sama dengan nama yang ditentukan semasa membuat prosedur sebenar.
+
+Jika prosedur diimplementasikan seperti berikut,
+
+```sql
+CREATE OR REPLACE NONEDITIONABLE PROCEDURE myproc (in_id IN VARCHAR2, out_name OUT VARCHAR2) AS
+BEGIN
+    SELECT name INTO out_name FROM MCS.FMB_USERS WHERE id = in_id ;
+END;
+```
+
+Parameter pertama dan kedua kedua-duanya ditentukan sebagai VARCHAR2,
+
+Jika anda perlu memanggil prosedur seperti itu, anda harus menentukan semua jenis parameter sebagai String,
+dan dalam kes output, anda juga harus menentukan saiz maksimum.
+
+Contoh penentuan panggilan adalah seperti berikut.
+
+![contoh prosedur1](./assets/../../../../assets/images/oracle-procedure-example1.png 'contoh prosedur1')
+
+
+### Akses [accessor](../concept/data-accessor.md)
+
+Cara menetapkan mengikuti [dokumen JSONATA](http://docs.jsonata.org/overview.html).
+
+
+### Nilai
+
+Jika parameter adalah input (IN), tentukan nilainya.
+Alih-alih memasukkan nilai konstan secara langsung ke dalam nilai ini, tentukan nama tugas tertentu.
+
+Dalam contoh di atas, jika nilai input untuk id ditetapkan sebagai ID, nilai yang dikembalikan oleh tugas ID ditetapkan sebagai nilai input.
+
+
+### Saiz Maksimum
+
+Jika jenis parameter adalah String atau Buffer, tentukan saiz maksimum. Untuk jenis lain, abaikan nilai yang tidak ditentukan.
+
+## Hasil Tugas
+
+Hasil panggilan prosedur dikembalikan dalam bentuk Objek, dan nama parameter yang ditetapkan sebagai output menjadi kunci untuk mengembalikan nilainya.
+
+Jika tugas yang diperkenalkan di atas mengembalikan hasil seperti berikut.
+
+```javascript
+{
+  out_name: 'Admin'
+}
+```
+
+
+## Contoh Penggunaan Lain (Kursor)
+
+### Contoh Pembuatan Prosedur
+
+```sql
+CREATE OR REPLACDE NONEDITIONABLE PROCEDURE PROCEDURE1(out_cursor OUT SYS_REFCURSOR) AS 
+BEGIN
+    BEGIN
+        OPEN out_cursor FOR
+            SELECT * FROM FARMWEATHER WHERE rownum <= 1000;
+    END;
+END PROCEDURE1;
+```
+
+### Contoh Panggilan Prosedur
+
+![contoh prosedur2](./assets/../../../../assets/images/oracle-procedure-example2.png 'contoh prosedur2')
+
+### Hasil Panggilan Tugas Prosedur
+
+```javascript
+{
+  "out_cursor": [
+    {
+      "FARMDATE": "2006-01-07T15:00:00.000Z",
+      "MAXT": 29.5,
+      "MINT": 21.8,
+      "WINDSPEED": 1.6,
+      "FARMHUM": 70.2,
+      "PRECIPITATION": 0
+    },
+    {
+      "FARMDATE": "2006-01-08T15:00:00.000Z",
+      "MAXT": 30.1,
+      "MINT": 21,
+      "WINDSPEED": 1.6,
+      "FARMHUM": 67.4,
+      "PRECIPITATION": 0
+    },
+    ..
+  ]
+}
+```

package/helps/integration/task/oracle-procedure.zh.md

@@ -0,0 +1,141 @@
+# Oracle 存储过程任务
+
+调用 Oracle 数据库中存储的存储过程的任务、 
+它根据数据类型返回数据列表或特定数据类型的值。
+
+### 参数
+
+### 过程代码
+  - 存储过程代码是由*存储过程名称*和*参数*自动生成的代码，用户无需输入。
+  - 例如，如果存储过程的名称为 *mcs.myproc*，参数为 *id* 和 *out_name*，那么存储过程代码将如下所示
+    ```文本
+    mcs.myproc(:id, :out_name)；
+    ```
+
+### 存储过程名称
+  - 指定存储过程的名称。
+  - 如果存储过程需要用包或用户名分隔，请使用". "分隔。
+  - 例如
+    文本
+    mcs.myproc
+    文本 mcs.myproc
+
+### 参数
+  - 参数由以下元素组成
+    - 参数名称
+    - 输入/输出名称：IN、INOUT、OUT
+    - 参数类型：字符串、数字、日期、光标
+    - 值：如果变量是输入，则是该输入的值。
+    - MaxSize：如果变量是字符串或缓冲区类型，则为变量的最大大小。
+
+#### 参数名称
+
+参数名指定存储过程中使用的参数名称。
+例如
+  ``sql
+  mcs.myproc(:id, :out_name)；
+  ```
+id 和 out_name 是参数名。
+
+### 指定输入和输出
+
+指定变量是输入（IN）还是输出（OUT）。
+
+### 参数类型
+
+指定参数的类型。类型必须与实际创建存储过程时指定的名称相同。
+
+如果存储过程以
+
+存储过程
+CREATE OR REPLACE NONEDITIONABLE PROCEDURE myproc (in_id IN VARCHAR2, out_name OUT VARCHAR2) AS
+开始
+    SELECT name INTO out_name FROM MCS.FMB_USERS WHERE id = in_id ；
+结束；
+```
+
+请注意，第一个和第二个参数都指定为 VARCHAR2、 
+
+如果需要调用这些存储过程，必须将参数类型指定为字符串、 
+对于输出，必须指定最大大小。
+
+调用说明示例如下
+
+[存储过程 example1]（./assets/././././././././assets/images/oracle-procedure-example1.png '存储过程 example1')
+
+
+### Accessor [accessor](../concept/data-accessor.md)
+
+按照 [JSONATA 文档](http://docs.jsonata.org/overview.html) 进行配置。
+
+
+### 值
+
+如果参数是输入（IN），请指定其值。
+不要直接在值中输入常量，而应指定具体的任务名称。
+
+在上例中，如果 id 的输入值指定为 ID，则指定 ID 任务返回的值作为输入值。
+
+
+### 最大大小
+
+如果参数类型为字符串或缓冲区，请指定最大大小。对于其他类型，请不要指定值，并忽略它。
+
+### 任务结果
+
+存储过程调用的结果以对象的形式返回，指定为输出的参数名称是关键字，并返回值。
+
+例如，上面介绍的任务会返回以下结果值。
+
+```javascript
+}
+  out_name: 'Admin
+}
+```
+
+
+### 其他使用示例（光标）
+
+### 编写存储过程的示例
+
+``sql
+CREATE OR REPLACE NONEDITIONABLE PROCEDURE PROCEDURE1(out_cursor OUT SYS_REFCURSOR) AS 
+开始
+    开始
+        打开 out_cursor FOR
+            SELECT * FROM FARMWEATHER WHERE rownum <= 1000；
+    结束；
+结束过程1；
+```
+
+### 调用存储过程的示例
+
+![存储过程 example2](./assets/././././././././assets/images/oracle-procedure-example2.png'存储过程 example2')
+
+### 程序任务调用结果
+
+```javascript
+{ }
+  "out_cursor"： [].
+    {
+      "FARMDATE"： "2006-01-07T15:00:00.000Z",
+      "MAXT"： 29.5,
+      "MINT"： 21.8,
+      "WINDSPEED"： 1.6,
+      "FARMHUM": 70： 70.2,
+      "降水量": 0 0
+    },
+    {
+      "FARMDATE"： "2006-01-08T15:00:00.000Z",
+      "MAXT"： 30.1,
+      "MINT"： 21,
+      "WINDSPEED"： 1.6,
+      "FARMHUM": 67： 67.4,
+      "precipitation": 0 0
+    },
+    ...
+  ]
+}
+```
+
+通过www.DeepL.com/Translator（免费版）翻译

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/integration-base",
-  "version": "6.1.119",
+  "version": "6.1.123",
   "main": "dist-server/index.js",
   "browser": "client/index.js",
   "things-factory": true,
@@ -26,11 +26,11 @@
   },
   "dependencies": {
     "@apollo/client": "^3.6.9",
-    "@things-factory/api": "^6.1.118",
-    "@things-factory/auth-base": "^6.1.118",
+    "@things-factory/api": "^6.1.123",
+    "@things-factory/auth-base": "^6.1.123",
     "@things-factory/env": "^6.1.116",
-    "@things-factory/oauth2-client": "^6.1.118",
-    "@things-factory/scheduler-client": "^6.1.118",
+    "@things-factory/oauth2-client": "^6.1.123",
+    "@things-factory/scheduler-client": "^6.1.123",
     "@things-factory/shell": "^6.1.118",
     "async-mqtt": "^2.5.0",
     "chance": "^1.1.11",
@@ -46,5 +46,5 @@
   "devDependencies": {
     "@types/cron": "^2.0.1"
   },
-  "gitHead": "a3729089483f19175214666ef9959ad88328d4a6"
+  "gitHead": "b1440f932f519e74aca05dabf2dd7f6690fcb3cf"
 }

package/server/engine/task/oracle-procedure.ts

@@ -19,6 +19,12 @@ type ProcedureParameterType = {
   maxSize?: number
 }
 
+type ValueType = {
+  code?: string
+  procedure?: string
+  parameters?: ProcedureParameterType[]
+}
+
 const TYPES = {
   Number: oracledb?.NUMBER,
   String: oracledb?.STRING,
@@ -39,7 +45,7 @@ async function OracleProcedure(step, context) {
   var { domain, data, variables } = context
   var { connection: connectionName, params } = step
 
-  var { procedure, parameters } = params as { procedure: string; parameters: ProcedureParameterType[] }
+  var { code = '', parameters = [] } = params.parameters as ValueType
 
   var dbconnection = ConnectionManager.getConnectionInstanceByName(domain, connectionName)
 
@@ -51,7 +57,11 @@ async function OracleProcedure(step, context) {
     }
   })
 
-  procedure = vm.run('`' + procedure + '`')
+  if (!code) {
+    throw 'procedure code not defined'
+  }
+
+  code = vm.run('`' + code + '`')
 
   const procedureParameters =
     parameters &&
@@ -81,7 +91,7 @@ async function OracleProcedure(step, context) {
       return sum
     }, {})
 
-  const result = await dbconnection.execute(procedure, procedureParameters)
+  const result = await dbconnection.execute(code, procedureParameters)
 
   var taskResult = {}
   let paramKeys = Object.keys(procedureParameters)
@@ -106,15 +116,10 @@ async function OracleProcedure(step, context) {
 }
 
 OracleProcedure.parameterSpec = [
-  {
-    type: 'textarea',
-    name: 'procedure',
-    label: 'procedure'
-  },
   {
     type: 'procedure-parameters',
     name: 'parameters',
-    label: 'params'
+    label: ''
   }
 ]