@things-factory/dataset 7.0.0-alpha.5 → 7.0.0-alpha.7

package/helps/dataset/task/create-data-sample.ja.md

@@ -0,0 +1,28 @@
+# create-data-sample
+
+このタスクは、特定のデータセットに関連するデータサンプルを作成し、接続されたデバイスや外部データソースからデータを抽出して処理します。
+
+## パラメーター
+
+- **データセット (dataset)**
+  - データサンプルが追加されるデータセットの一意の識別子(ID)です。このデータセットはシステム内に既に存在している必要があります。
+- **ソース (source)**
+  - データが収集されるデバイスまたはデータソースの識別子です。これは、デバイス ID または記述的な名前である可能性があります。
+  - [アクセッサー](../../integration/concept/data-accessor.md)
+- **生データ (rawData)**
+  - コンテキストまたは受信データペイロードから生データを取得するためのアクセスパスです。このパスは、提供されたデータ構造内で生データを見つける場所を指定します。
+  - [アクセッサー](../../integration/concept/data-accessor.md)
+- **データ (data)**
+  - コンテキストまたは受信データペイロードから処理されたまたは抽出されたデータを取得するためのアクセスパスです。rawData と同様に、これは提供されたデータ構造内で関連データを見つける場所を指定します。
+  - [アクセッサー](../../integration/concept/data-accessor.md)
+- **タイムスタンプ (timestamp)**
+  - データサンプルの作成に関連するタイムスタンプです。提供されない場合は、現在の時刻が使用されます。このタイムスタンプは、データが収集または生成された時点をマークします。
+  - [アクセッサー](../../integration/concept/data-accessor.md)
+
+## 使用法
+
+このタスクは、デバイスや外部ソースから収集されたデータを構造化して大規模なデータセットの一部として保存する必要があるシナリオで設計されています。IoT アプリケーション、データ分析ワークフロー、およびさまざまなソースからのデータを集約して処理および分析するあらゆる状況で特に役立ちます。
+
+タスクを構成する際には、データセット ID がシステム内の既存のデータセットに対応していることを確認してください。ソース、生データ、およびデータパラメーターは、受信ペイロード内のデータを正確に位置付けて処理するために正しく指定されている必要があります。タイムスタンプパラメーターにより、データサンプルをその起源または収集点の時点と時間的に関連付けることができます。
+
+このタスクは、データ収集および保存プロセスを自動化し、アプリケーション内で効率的なデータ管理および分析を可能にします。それは、データ中心のワークフローにシームレスに統合され、さまざまなソースからのデータが体系的にキャプチャされ、カタログ化されて将来の使用のために保存されることを保証します。

package/helps/dataset/task/create-data-sample.ko.md

@@ -0,0 +1,28 @@
+# create-data-sample
+
+이 작업은 특정 데이터셋과 관련된 데이터 샘플을 생성하며, 연결된 장치나 외부 데이터 소스에서 데이터를 추출하고 처리합니다.
+
+## 매개변수
+
+- **데이터셋 (dataset)**
+  - 데이터 샘플이 추가될 데이터셋의 고유 식별자(ID)입니다. 이 데이터셋은 시스템 내에 이미 존재해야 합니다.
+- **소스 (source)**
+  - 데이터가 수집되는 장치 또는 데이터 소스의 식별자입니다. 이는 장치 ID 또는 설명적 이름일 수 있습니다.
+  - [접근자](../../integration/concept/data-accessor.md)
+- **원시 데이터 (rawData)**
+  - 맥락이나 들어오는 데이터 페이로드에서 원시 데이터를 검색하기 위한 접근자 경로입니다. 이 경로는 제공된 데이터 구조 내에서 원시 데이터를 찾을 위치를 지정합니다.
+  - [접근자](../../integration/concept/data-accessor.md)
+- **데이터 (data)**
+  - 맥락이나 들어오는 데이터 페이로드에서 처리되거나 추출된 데이터를 검색하기 위한 접근자 경로입니다. rawData와 유사하게, 이는 제공된 데이터 구조 내에서 관련 데이터를 찾을 위치를 지정합니다.
+  - [접근자](../../integration/concept/data-accessor.md)
+- **타임스탬프 (timestamp)**
+  - 데이터 샘플 생성과 관련된 타임스탬프입니다. 제공되지 않은 경우, 현재 시간이 사용됩니다. 이 타임스탬프는 데이터가 수집되거나 생성된 시점을 표시합니다.
+  - [접근자](../../integration/concept/data-accessor.md)
+
+## 사용 방법
+
+이 작업은 장치나 외부 소스에서 수집된 데이터를 구조화하고 큰 데이터셋의 일부로 저장해야 하는 시나리오에 설계되었습니다. IoT 애플리케이션, 데이터 분석 워크플로우 및 다양한 소스에서 데이터를 집계하여 처리 및 분석하는 모든 상황에서 유용합니다.
+
+작업을 구성할 때, 데이터셋 ID가 시스템 내에 존재하는 데이터셋에 해당하는지 확인해야 합니다. 소스, rawData, 데이터 매개변수는 들어오는 페이로드 내에서 데이터를 정확하게 찾아내고 처리할 수 있도록 올바르게 지정되어야 합니다. 타임스탬프 매개변수는 데이터 샘플이 그 기원이나 수집 지점과 시간적으로 연관되도록 합니다.
+
+이 작업은 데이터 수집 및 저장 과정을 자동화하여, 애플리케이션 내에서 효율적인 데이터 관리 및 분석을 가능하게 합니다. 다양한 소스에서의 데이터를 체계적으로 캡처하고 카탈로그화하여 향후 사용을 위해 저장하는 데이터 중심 워크플로우에 원활하게 통합됩니다.

package/helps/dataset/task/create-data-sample.md

@@ -0,0 +1,28 @@
+# create-data-sample
+
+This task creates a data sample associated with a specific dataset, extracting and processing data from a connected device or an external data source.
+
+## Parameters
+
+- **Dataset (dataset)**
+  - The unique identifier (ID) of the dataset to which the data sample will be added. This dataset should already exist within the system.
+- **Source (source)**
+  - The identifier of the device or data source from which the data is being collected. This could be a device ID or a descriptive name.
+  - [accessor](../../integration/concept/data-accessor.md)
+- **Raw Data (rawData)**
+  - An accessor path to retrieve the raw data from the context or the incoming data payload. This path specifies where to find the raw data within the data structure provided to the task.
+  - [accessor](../../integration/concept/data-accessor.md)
+- **Data (data)**
+  - An accessor path to retrieve the processed or extracted data from the context or the incoming data payload. Similar to rawData, this specifies where to find the relevant data within the provided data structure.
+  - [accessor](../../integration/concept/data-accessor.md)
+- **Timestamp (timestamp)**
+  - The timestamp associated with the data sample creation. If not provided, the current time will be used. This timestamp marks when the data was collected or generated.
+  - [accessor](../../integration/concept/data-accessor.md)
+
+## Usage
+
+This task is designed for scenarios where data collected from devices or external sources needs to be structured and stored as part of a larger dataset. It is particularly useful in IoT applications, data analysis workflows, and any situation where data from various sources is aggregated for processing and analysis.
+
+When configuring the task, ensure that the dataset ID corresponds to an existing dataset within your system. The source, rawData, and data parameters must be correctly specified to accurately locate and process the data within the incoming payload. The timestamp parameter allows for the temporal association of the data sample with its point of origin or collection.
+
+This task automates the process of data collection and storage, enabling efficient data management and analysis within your applications. It integrates seamlessly into data-centric workflows, ensuring that data from varied sources is systematically captured and catalogued for future use.

package/helps/dataset/task/create-data-sample.ms.md

@@ -0,0 +1,30 @@
+# create-data-sample
+
+Tugas ini mencipta sampel data yang berkaitan dengan set data tertentu, mengeluarkan dan memproses data dari peranti yang disambungkan atau sumber data luaran.
+
+## Parameter
+
+- **Dataset (dataset)**
+  - Pengenal unik (ID) set data yang sampel datanya akan ditambahkan. Set data ini seharusnya sudah wujud dalam sistem.
+- **Sumber (source)**
+  - Pengenal peranti atau sumber data dari mana data sedang dikumpul. Ini boleh jadi ID peranti atau nama deskriptif.
+  - [aksesor](../../integration/concept/data-accessor.md)
+- **Data Mentah (rawData)**
+  - Laluan akses untuk mengambil data mentah dari konteks atau muatan data masuk. Laluan ini menentukan di mana untuk mencari data mentah dalam struktur data yang disediakan.
+  - [aksesor](../../integration/concept/data-accessor.md)
+- **Data (data)**
+  - Laluan akses untuk mengambil data yang diproses atau diekstrak dari konteks atau muatan data masuk. Sama seperti rawData, ini menentukan di mana untuk mencari data yang relevan dalam struktur data yang disediakan.
+  - [aksesor](../../integration/concept/data-accessor.md)
+- **Timestamp (timestamp)**
+  - Cap waktu yang berkaitan dengan penciptaan sampel data. Jika tidak disediakan, waktu sekarang akan digunakan. Cap waktu ini menandai bila data dikumpulkan atau dihasilkan.
+  - [aksesor](../../integration/concept/data-accessor.md)
+
+## Penggunaan
+
+Tugas ini direka untuk skenario di mana data yang dikumpul dari peranti atau sumber luaran perlu disusun dan disimpan sebagai sebahagian dari set data yang lebih besar. Ia sangat berguna dalam aplikasi IoT, aliran kerja analisis data, dan situasi apa pun di mana data dari pelbagai sumber diagregasi untuk pemprosesan dan analisis.
+
+Semasa mengkonfigurasi tugas, pastikan ID set data sesuai dengan set data yang sudah ada dalam sistem anda. Sumber, rawData, dan parameter
+
+data harus ditentukan dengan tepat untuk secara akurat menemukan dan memproses data dalam muatan yang masuk. Parameter timestamp membolehkan pengaitan temporal sampel data dengan titik asal atau pengumpulan.
+
+Tugas ini mengautomatikkan proses pengumpulan dan penyimpanan data, memungkinkan pengurusan data dan analisis yang efisien dalam aplikasi anda. Ia berintegrasi dengan lancar ke dalam aliran kerja berpusat data, memastikan data dari pelbagai sumber secara sistematis ditangkap dan dikatalogkan untuk penggunaan masa depan.

package/helps/dataset/task/create-data-sample.zh.md

@@ -0,0 +1,28 @@
+# create-data-sample
+
+这个任务创建了一个与特定数据集相关的数据样本，从连接的设备或外部数据源提取和处理数据。
+
+## 参数
+
+- **数据集 (dataset)**
+  - 数据样本将被添加到的数据集的唯一标识符(ID)。该数据集应该已经存在于系统中。
+- **来源 (source)**
+  - 数据收集来源的标识符，可以是设备 ID 或描述性名称。
+  - [访问器](../../integration/concept/data-accessor.md)
+- **原始数据 (rawData)**
+  - 从上下文或传入的数据负载中检索原始数据的访问路径。此路径指定在提供的数据结构内找到原始数据的位置。
+  - [访问器](../../integration/concept/data-accessor.md)
+- **数据 (data)**
+  - 从上下文或传入的数据负载中检索处理或提取的数据的访问路径。类似于 rawData，这指定了在提供的数据结构内找到相关数据的位置。
+  - [访问器](../../integration/concept/data-accessor.md)
+- **时间戳 (timestamp)**
+  - 与数据样本创建相关的时间戳。如果未提供，将使用当前时间。此时间戳标记数据被收集或生成的时刻。
+  - [访问器](../../integration/concept/data-accessor.md)
+
+## 使用场景
+
+此任务设计用于从设备或外部来源收集的数据需要被结构化并作为更大数据集的一部分存储的场景。它在 IoT 应用、数据分析工作流程以及任何需要聚合各种来源数据进行处理和分析的情况下特别有用。
+
+配置任务时，确保数据集 ID 对应于您系统内的现有数据集。必须正确指定来源、原始数据和数据参数，以准确地定位和处理传入负载中的数据。时间戳参数允许数据样本与其起源点或收集点时间上的关联。
+
+这个任务自动化了数据收集和存储过程，使得在应用程序中进行高效的数据管理和分析成为可能。它无缝集成到以数据为中心的工作流程中，确保来自各种来源的数据被系统地捕获和编目，以备将来使用。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/dataset",
-  "version": "7.0.0-alpha.5",
+  "version": "7.0.0-alpha.7",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -27,9 +27,12 @@
     "migration:create": "node ../../node_modules/typeorm/cli.js migration:create -d ./server/migrations"
   },
   "dependencies": {
+    "@material/mwc-fab": "^0.27.0",
+    "@material/mwc-icon": "^0.27.0",
     "@operato/app": "^2.0.0-alpha.0",
     "@operato/data-grist": "^2.0.0-alpha.0",
     "@operato/dataset": "^2.0.0-alpha.0",
+    "@operato/ghost-print": "^2.0.0-alpha.0",
     "@operato/graphql": "^2.0.0-alpha.0",
     "@operato/grist-editor": "^2.0.0-alpha.0",
     "@operato/i18n": "^2.0.0-alpha.0",
@@ -37,20 +40,20 @@
     "@operato/shell": "^2.0.0-alpha.0",
     "@operato/styles": "^2.0.0-alpha.0",
     "@operato/utils": "^2.0.0-alpha.0",
-    "@things-factory/auth-base": "^7.0.0-alpha.1",
-    "@things-factory/aws-base": "^7.0.0-alpha.1",
-    "@things-factory/board-service": "^7.0.0-alpha.4",
+    "@things-factory/auth-base": "^7.0.0-alpha.7",
+    "@things-factory/aws-base": "^7.0.0-alpha.7",
+    "@things-factory/board-service": "^7.0.0-alpha.7",
     "@things-factory/env": "^7.0.0-alpha.0",
-    "@things-factory/integration-base": "^7.0.0-alpha.4",
-    "@things-factory/organization": "^7.0.0-alpha.5",
-    "@things-factory/scheduler-client": "^7.0.0-alpha.1",
-    "@things-factory/shell": "^7.0.0-alpha.1",
-    "@things-factory/work-shift": "^7.0.0-alpha.1",
-    "@things-factory/worklist": "^7.0.0-alpha.5",
+    "@things-factory/integration-base": "^7.0.0-alpha.7",
+    "@things-factory/organization": "^7.0.0-alpha.7",
+    "@things-factory/scheduler-client": "^7.0.0-alpha.7",
+    "@things-factory/shell": "^7.0.0-alpha.7",
+    "@things-factory/work-shift": "^7.0.0-alpha.7",
+    "@things-factory/worklist": "^7.0.0-alpha.7",
     "cron-parser": "^4.3.0",
     "moment-timezone": "^0.5.40",
     "simple-statistics": "^7.8.3",
     "statistics": "^3.3.0"
   },
-  "gitHead": "e21713e554a4ba282190ab3781040ea7150e03f4"
+  "gitHead": "85c46b9027d6188ddbd5104215a2256ff5331c19"
 }

package/server/activities/activity-data-review.ts

@@ -3,11 +3,7 @@ import { ActivityInstance, ActivityInstanceStatus, UpdateActivityInstanceStateAd
 import { DataOocStatus } from '../service/data-ooc/data-ooc'
 import { DataSample } from '../service/data-sample/data-sample'
 
-async function callback(
-  activityInstance: ActivityInstance,
-  addendum: UpdateActivityInstanceStateAddendum,
-  context: ResolverContext
-) {
+async function callback(activityInstance: ActivityInstance, addendum: UpdateActivityInstanceStateAddendum, context: ResolverContext) {
   const { domain, tx, user } = context.state
   const { input, output, state } = activityInstance
 

package/server/activities/activity-ooc-review.ts

@@ -1,18 +1,9 @@
-import {
-  Activity,
-  ActivityInstance,
-  ActivityInstanceStatus,
-  UpdateActivityInstanceStateAddendum
-} from '@things-factory/worklist'
+import { Activity, ActivityInstance, ActivityInstanceStatus, UpdateActivityInstanceStateAddendum } from '@things-factory/worklist'
 import { issue } from '@things-factory/worklist/dist-server/controllers/activity-instance/issue'
 
 import { DataOoc, DataOocStatus } from '../service/data-ooc/data-ooc'
 
-async function callback(
-  activityInstance: ActivityInstance,
-  addendum: UpdateActivityInstanceStateAddendum,
-  context: ResolverContext
-) {
+async function callback(activityInstance: ActivityInstance, addendum: UpdateActivityInstanceStateAddendum, context: ResolverContext) {
   const { domain, user, tx } = context.state
   const { input, output, state, terminatedAt } = activityInstance
   const { causedBy } = addendum || {}
@@ -62,11 +53,10 @@ async function callback(
           approvalLine: outlierApprovalLine
         }
 
-        await issue(activityInstance, context)
+        dataOoc.resolveActivityInstance = await issue(activityInstance, context)
+        await tx.getRepository(DataOoc).save(dataOoc)
       } else {
-        console.error(
-          `Assignees are not set. So, Data OOC Resolve task for ${dataOoc.name}(${dataOoc.id}) could not be issued.`
-        )
+        console.error(`Assignees are not set. So, Data OOC Resolve task for ${dataOoc.name}(${dataOoc.id}) could not be issued.`)
       }
     } else {
       console.error('OOC Resolve Activity not installed.')

package/server/controllers/create-data-sample.ts

@@ -55,16 +55,16 @@ const formatDate = (keys, _moment) => {
   return keys
 }
 
-export async function createDataSample(dataSample: NewDataSample, context: ResolverContext): Promise<DataSample> {
+export async function createDataSample(newDataSample: NewDataSample, context: ResolverContext): Promise<DataSample> {
   const { domain, user, tx } = context.state
 
   const dataSet = await tx.getRepository(DataSet).findOne({
-    where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id: dataSample.dataSet.id },
+    where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id: newDataSample.dataSet.id },
     relations: ['dataKeySet']
   })
 
   const { dataItems, tag: publishTag, normalScenarioId, outlierScenarioId } = dataSet
-  const collectedAt = dataSample.collectedAt || new Date()
+  const collectedAt = newDataSample.collectedAt || new Date()
 
   const timezone = dataSet.timezone || domain.timezone || 'UTC'
   const format = 'YYYY-MM-DD'
@@ -77,7 +77,7 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
   const localDateTz = moment(collectedAt).tz(timezone)
   const defaultPartitionKeys = {
     domain: domain.subdomain,
-    datasetid: dataSample.dataSet.id /* It should not be 'data_set_id' as column name duplicated for Glue */,
+    datasetid: newDataSample.dataSet.id /* It should not be 'data_set_id' as column name duplicated for Glue */,
     date: localDateTz.format(format) /* local time date */,
     workdate: workDate /* working date */,
     workshift: workShift
@@ -89,11 +89,11 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
   }
 
   partitionKeys = formatDate(partitionKeys, localDateTz)
-  partitionKeys = replaceVariables(partitionKeys, dataSample.data)
+  partitionKeys = replaceVariables(partitionKeys, newDataSample.data)
 
-  const dataKeys = fillDataKeys(dataSet?.dataKeySet, dataSample.data)
+  const dataKeys = fillDataKeys(dataSet?.dataKeySet, newDataSample.data)
 
-  const { ooc, oos, judgment } = DataUseCase.evaluate(dataSet, dataItems, dataSample.data) || {}
+  const { ooc, oos, judgment } = DataUseCase.evaluate(dataSet, dataItems, newDataSample.data) || {}
 
   const old = await tx.getRepository(DataSample).findOne({
     where: {
@@ -110,7 +110,7 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
     If [FileUpload[]] type needed, add 'files' type for dataset
   */
 
-  const data = dataSample.data
+  const data = newDataSample.data
   const attachments = []
 
   for (let dataItem of dataItems) {
@@ -164,13 +164,13 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
     }
   }
 
-  const result = await tx.getRepository(DataSample).save({
+  const dataSample = await tx.getRepository(DataSample).save({
     ...old,
     name: dataSet.name,
     description: dataSet.description,
     useCase: dataSet.useCase,
     type: dataSet.type,
-    ...dataSample,
+    ...newDataSample,
     ...dataKeys,
     dataSetVersion: dataSet.version,
     domain,
@@ -197,13 +197,13 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
 
   /* post-process for for file attachment. */
   if (attachments.length > 0) {
-    attachments.forEach(attachment => (attachment.refId = result.id))
+    attachments.forEach(attachment => (attachment.refId = dataSample.id))
     tx.getRepository(Attachment).save(attachments)
   }
 
   if (ooc || oos) {
     const dataOoc = await tx.getRepository(DataOoc).save({
-      ...result,
+      ...dataSample,
       history: [
         {
           user: {
@@ -214,7 +214,8 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
           timestamp: collectedAt
         }
       ],
-      state: DataOocStatus.ISSUED
+      state: DataOocStatus.ISSUED,
+      dataSample: dataSample
     })
 
     if (outlierScenarioId) {
@@ -227,9 +228,9 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
       })
 
       if (scenario) {
-        scenario.start(scenario.name + ':' + dataSet.name + ':' + result.id, {
+        scenario.start(scenario.name + ':' + dataSet.name + ':' + dataSample.id, {
           dataOocId: dataOoc.id,
-          dataSampleId: result.id,
+          dataSampleId: dataSample.id,
           dataSet: dataSet.id,
           data,
           ooc,
@@ -260,9 +261,7 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
     })) as Activity
 
     if (activity) {
-      const assignee =
-        dataSet.supervisoryRoleId &&
-        (await tx.getRepository(Role).findOneBy({ domain: { id: domain.id }, id: dataSet.supervisoryRoleId }))
+      const assignee = dataSet.supervisoryRoleId && (await tx.getRepository(Role).findOneBy({ domain: { id: domain.id }, id: dataSet.supervisoryRoleId }))
 
       const assignees = dataSet.supervisoryRoleId ? [{ type: 'Role', value: dataSet.supervisoryRoleId, assignee }] : []
 
@@ -280,11 +279,10 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
           approvalLine: []
         }
 
-        await issue(activityInstance, context)
+        dataOoc.reviewActivityInstance = await issue(activityInstance, context)
+        await tx.getRepository(DataOoc).save(dataOoc)
       } else {
-        console.error(
-          `Assignees are not set. So Data OOC Review task for ${dataOoc.name}(${dataOoc.id}) could not be issued.`
-        )
+        console.error(`Assignees are not set. So Data OOC Review task for ${dataOoc.name}(${dataOoc.id}) could not be issued.`)
       }
     } else {
       console.error('OOC Review Activity not installed.')
@@ -320,8 +318,8 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
       })
 
       if (scenario) {
-        scenario.start(scenario.name + ':' + dataSet.name + ':' + result.id, {
-          dataSampleId: result.id,
+        scenario.start(scenario.name + ':' + dataSet.name + ':' + dataSample.id, {
+          dataSampleId: dataSample.id,
           dataSet: dataSet.id,
           data,
           ooc,
@@ -353,30 +351,27 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
       })) as Activity
 
       if (activity) {
-        const assignee =
-          dataSet.supervisoryRoleId &&
-          (await tx.getRepository(Role).findOneBy({ domain: { id: domain.id }, id: dataSet.supervisoryRoleId }))
+        const assignee = dataSet.supervisoryRoleId && (await tx.getRepository(Role).findOneBy({ domain: { id: domain.id }, id: dataSet.supervisoryRoleId }))
 
-        const assignees = dataSet.supervisoryRoleId
-          ? [{ type: 'Role', value: dataSet.supervisoryRoleId, assignee }]
-          : []
+        const assignees = dataSet.supervisoryRoleId ? [{ type: 'Role', value: dataSet.supervisoryRoleId, assignee }] : []
 
         /* 해당 dataset의 supervisor로 하여금, data를 리뷰하고 instruction을 작성해서, approvalLine을 이용해서 승인을 한다. */
         if (assignees && assignees instanceof Array && assignees.length > 0) {
-          result.dataItems = dataItems
+          dataSample.dataItems = dataItems
           const activityInstance = {
             name: `[Data 검토] ${dataSet.name}`,
             description: dataSet.description,
             activityId: activity.id,
             dueAt: new Date(collectedAt.getTime() + 24 * 60 * 60 * 1000),
             input: {
-              dataSample: result
+              dataSampleId: dataSample.id
             },
             assignees,
             approvalLine: dataSet.reviewApprovalLine
           }
 
-          await issue(activityInstance, context)
+          dataSample.reviewActivityInstance = await issue(activityInstance, context)
+          await tx.getRepository(DataSample).save(dataSample)
 
           try {
             pubsub.publish('notification', {
@@ -385,7 +380,7 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
                 type: 'info',
                 title: `[Data Review] ${dataSet.name}`,
                 body: `Data Review occurred on '${dataSet.name}'`,
-                url: getRedirectSubdomainPath(context, domain.subdomain, `/data-sample/${result.id}`),
+                url: getRedirectSubdomainPath(context, domain.subdomain, `/data-sample/${dataSample.id}`),
                 timestamp: collectedAt
               }
             })
@@ -393,9 +388,7 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
             logger.error('Notification', err)
           }
         } else {
-          console.error(
-            `Assignees are not set. So Data Review task for ${dataSet.name}(${dataSet.id}) could not be issued.`
-          )
+          console.error(`Assignees are not set. So Data Review task for ${dataSet.name}(${dataSet.id}) could not be issued.`)
         }
       } else {
         console.error('Data Review Activity not installed.')
@@ -403,5 +396,5 @@ export async function createDataSample(dataSample: NewDataSample, context: Resol
     }
   }
 
-  return result
+  return dataSample
 }

package/server/engine/index.ts

@@ -0,0 +1 @@
+import './task'

package/server/engine/task/create-data-sample.ts

@@ -0,0 +1,92 @@
+import { TaskRegistry } from '@things-factory/integration-base'
+import { getDataSource } from '@things-factory/shell'
+import { access } from '@things-factory/utils'
+import i18next from 'i18next'
+
+import { DataSet } from '../../service/data-set/data-set'
+
+import { createDataSample } from '../../controllers/create-data-sample'
+
+async function CreateDataSample(step, context) {
+  const { logger, data, domain, user, lng } = context
+  var {
+    params: { dataset: dataSetId, source: sourceAccessor, rawData: rawDataAccessor, data: dataAccessor, timestamp }
+  } = step
+
+  if (!dataSetId) {
+    throw new Error(`no dataset found`)
+  }
+
+  // make new data-sample
+  await getDataSource().transaction(async tx => {
+    const dataSet = await tx.getRepository(DataSet).findOne({
+      where: {
+        id: dataSetId
+      }
+    })
+
+    var source = await access(sourceAccessor, data)
+    var extractedData = await access(dataAccessor, data)
+    var extractedRawData = rawDataAccessor && (await access(rawDataAccessor, data))
+
+    const dataSample = await createDataSample(
+      {
+        dataSet,
+        data: extractedData,
+        rawData: extractedRawData,
+        source,
+        collectedAt: new Date(timestamp || new Date())
+      },
+      {
+        t: i18next.t,
+        state: {
+          domain,
+          user,
+          lng,
+          tx
+        }
+      }
+    )
+
+    return {
+      data: dataSample
+    }
+  })
+}
+
+CreateDataSample.parameterSpec = [
+  {
+    type: 'entity-selector',
+    name: 'dataset',
+    label: 'data-set',
+    property: {
+      queryName: 'dataSets',
+      valueKey: 'id'
+    }
+  },
+  {
+    type: 'string',
+    name: 'source',
+    label: 'source'
+  },
+  {
+    type: 'string',
+    name: 'rawData',
+    label: 'raw-data'
+  },
+  {
+    type: 'string',
+    name: 'data',
+    label: 'data'
+  },
+  {
+    type: 'string',
+    name: 'timestamp',
+    label: 'timestamp'
+  }
+]
+
+CreateDataSample.connectorFree = true
+CreateDataSample.help = 'dataset/task/create-data-sample'
+
+TaskRegistry.registerTaskHandler('create-data-sample', CreateDataSample)

package/server/engine/task/index.ts

@@ -0,0 +1 @@
+import './create-data-sample'

package/server/index.ts

@@ -1,5 +1,6 @@
 import './routes'
 import './activities'
+import './engine'
 
 export * from './controllers'
 export * from './service'