@things-factory/dataset 7.0.0-alpha.1 → 7.0.0-alpha.18

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/helps/dataset/task/issue-collect-data.ja.md

@@ -0,0 +1,35 @@
+# IssueCollectData タスク
+
+このタスクは、特定のデータセットに関連付けられたデータ収集活動を開始します。指定されたソースからデータを収集するプロセスをトリガーして管理するように設計されており、データセットの構成と要件に合わせています。
+
+## 概要
+
+`IssueCollectData` タスクは、指定されたデータセットのデータ収集プロセスをトリガーする自動化関数です。センサー、API、またはその他のデータ生成エンティティなど、様々なソースから定期的またはイベント駆動でデータを収集する必要があるシナリオにおいて、このプロセスは不可欠です。
+
+## パラメータ
+
+- **データセット (dataset)**
+  - 説明：データ収集活動を開始するデータセットのユニークな識別子（ID）。この ID は
+
+、システム内に既に設定されているデータセットに対応している必要があります。
+
+- タイプ：`entity-selector`
+- プロパティ：
+  - `queryName`：データセットオプションを取得するためのクエリを指定します。通常は `dataSets` です。
+  - `valueKey`：選択のための値として使用するプロパティを示します。通常は `id` です。
+
+## 機能
+
+実行時に、タスクはデータセット ID の存在を確認します。ID が提供されていない場合、タスクはデータセットが見つからないことを示すエラーを投げます。有効なデータセット ID が提供された場合、タスクはそのデータセットに特定のデータ収集活動を発行します。`issueCollectData` によって処理される基本的なプロセスには、データセットの存在の検証、データ収集環境の準備、およびデータセットの構成および関連するデータソースに従ってデータ収集プロセスを開始するなどの操作が含まれます。
+
+タスクは開始された活動のインスタンスを返し、これを使用して進行状況を追跡し、データ収集ワークフローを管理するか、収集したデータを処理するための後続のタスクと統合することができます。
+
+## 使用法
+
+このタスクは、定期的に事前定義されたソースからデータを収集する必要がある自動化されたワークフローで特に有用です。データ収集プロセスを開始するトリガーとして機能し、データ摂取パイプライン、モニタリングシステム、または信頼できる構造化されたデータ収集メカニズムが必要なアプリケーションの自動管理を可能にします。
+
+データセット ID がシステム内の適切に構成されたデータセットに対応していることを確認してください。このタスクは、自動化されたプロセスの一部としてデータ収集活動を開始するためのプログラマブルなインターフェースを提供し、より広範なデータ管理および分析ワークフローにシームレスに統合するように設計されています。
+
+## 結論
+
+`IssueCollectData` タスクは、指定されたデータセットのデータ収集活動の開始を自動化します。データ収集プロセスを開始するための柔軟でプログラマブルな方法を提供することにより、効率的なデータ管理を促進し、ユーザーが最小限の手動介入で最新のデータセットを維持できるようにします。このタスクは、定期的なデータ更新が必要な多様なソースからのデータ駆動型アプリケーションの不可欠な要素です。

package/helps/dataset/task/issue-collect-data.ko.md

@@ -0,0 +1,32 @@
+# IssueCollectData 작업
+
+이 작업은 특정 데이터셋과 관련된 데이터 수집 활동을 시작합니다. 이는 지정된 소스에서 데이터를 수집하는 프로세스를 트리거하고 관리하도록 설계되었습니다. 데이터셋의 구성 및 요구 사항에 맞게 맞춰져 있습니다.
+
+## 개요
+
+`IssueCollectData` 작업은 지정된 데이터셋에 대한 데이터 수집 프로세스를 트리거하는 자동화된 함수입니다. 이 프로세스는 센서, API 또는 기타 데이터 생성 엔티티와 같은 다양한 소스에서 주기적 또는 이벤트 기반 데이터 수집이 필요한 시나리오에 필수적입니다.
+
+## 매개변수
+
+- **데이터셋 (dataset)**
+  - 설명: 데이터 수집 활동을 시작하기 위한 데이터셋의 고유 식별자(ID)입니다. 이 ID는 시스템 내에 이미 구성된 데이터셋과 일치해야 합니다.
+  - 타입: `entity-selector`
+  - 속성:
+    - `queryName`: 데이터셋 옵션을 검색하는 쿼리를 지정합니다. 일반적으로 `dataSets`입니다.
+    - `valueKey`: 선택을 위한 값으로 사용할 속성을 나타냅니다. 보통 `id`입니다.
+
+## 기능
+
+실행 시, 작업은 데이터셋 ID의 존재를 확인합니다. ID가 제공되지 않으면, 데이터셋이 발견되지 않았다는 오류를 발생시킵니다. 유효한 데이터셋 ID가 제공되면, 작업은 해당 데이터셋에 특정한 데이터 수집 활동을 발행합니다. `issueCollectData`에 의해 처리되는 기본 프로세스는 데이터셋의 존재를 확인, 데이터 수집 환경 준비, 데이터셋의 구성 및 관련 데이터 소스에 따라 데이터 수집 프로세스 시작과 같은 작업을 포함합니다.
+
+작업은 시작된 활동의 인스턴스를 반환하며, 이는 진행 상황을 추적하고, 데이터 수집 워크플로를 관리하거나, 수집된 데이터를 처리하기 위한 후속 작업과 통합하는 데 사용할 수 있습니다.
+
+## 사용법
+
+이 작업은 주기적으로 미리 정의된 소스에서 데이터를 수집해야 하는 자동화된 워크플로에서 특히 유용합니다. 데이터 수집 프로세스를 시작하기 위한 트리거 역할을 하여, 데이터 수집 파이프라인, 모니터링 시스템 또는 신뢰할 수 있고 구조화된 데이터 수집 메커니즘이 필요한 모든 애플리케이션의 자동 관리를 가능하게 합니다.
+
+데이터셋 ID가 시스템 내에 올바르게 구성된 데이터셋과 일치하는지 확인하십시오. 이 작업은 자동화된 프로세스의 일부로 데이터 수집 활동을 시작하는 프로그래밍 가능한 인터페이스를 제공하여, 더 넓은 데이터 관리 및 분석 워크플로와 원활하게 통합됩니다.
+
+## 결론
+
+`IssueCollectData` 작업은 지정된 데이터셋에 대한 데이터 수집 활동을 시작하는 과정을 자동화합니다. 데이터 수집 프로세스를 시작하기 위한 유연하고 프로그래밍 가능한 방법을 제공함으로써, 사용자가 최소한의 수동 개입으로 최신 데이터셋을 유지할 수 있게 하여 효율적인 데이터 관리를 촉진합니다. 이 작업은 정기적인 데이터 업데이트가 필요한 다양한 소스에서 데이터 기반 애플리케이션의 필수 구성 요소입니다.

package/helps/dataset/task/issue-collect-data.md

@@ -0,0 +1,32 @@
+# IssueCollectData Task
+
+This task initiates a data collection activity associated with a specific dataset. It is designed to trigger and manage the process of gathering data from designated sources, aligning with the dataset's configuration and requirements.
+
+## Overview
+
+The `IssueCollectData` task is an automated function that triggers a data collection process for a specified dataset. This process is essential in scenarios requiring periodic or event-driven data collection from various sources, such as sensors, APIs, or other data-producing entities.
+
+## Parameters
+
+- **Dataset (dataset)**
+  - Description: The unique identifier (ID) of the dataset for which the data collection activity is to be initiated. This ID should correspond to a dataset already configured within the system.
+  - Type: `entity-selector`
+  - Properties:
+    - `queryName`: Specifies the query to retrieve dataset options, typically `dataSets`.
+    - `valueKey`: Indicates the property to use as the value for selection, usually `id`.
+
+## Functionality
+
+Upon execution, the task checks for the presence of a dataset ID. If the ID is not provided, the task will throw an error indicating that no dataset has been found. If a valid dataset ID is provided, the task proceeds to issue a data collection activity specific to that dataset. The underlying process handled by `issueCollectData` involves operations such as validating the dataset's existence, preparing the data collection environment, and initiating the data collection process according to the dataset's configuration and associated data sources.
+
+The task returns an instance of the activity initiated, which can be used to track the progress, manage the data collection workflow, or integrate with subsequent tasks for processing the collected data.
+
+## Usage
+
+This task is particularly useful in automated workflows where data needs to be periodically collected from predefined sources. It serves as a trigger for starting the data collection process, allowing for the automated management of data ingestion pipelines, monitoring systems, or any application requiring reliable and structured data collection mechanisms.
+
+Ensure that the dataset ID corresponds to a properly configured dataset within your system. The task is designed to integrate seamlessly into broader data management and analysis workflows, offering a programmable interface for initiating data collection activities as part of an automated process.
+
+## Conclusion
+
+The `IssueCollectData` task automates the initiation of data collection activities for specified datasets. By providing a flexible and programmable way to start data collection processes, it facilitates efficient data management, enabling users to maintain up-to-date datasets with minimal manual intervention. This task is an essential component of data-driven applications, particularly those requiring regular data updates from diverse sources.

package/helps/dataset/task/issue-collect-data.ms.md

@@ -0,0 +1,34 @@
+# Tugas IssueCollectData
+
+Tugas ini memulakan aktiviti pengumpulan data yang berkaitan dengan set data tertentu. Ia direka untuk memicu dan mengurus proses mengumpul data dari sumber yang ditetapkan, selaras dengan
+
+konfigurasi dan keperluan set data.
+
+## Gambaran Keseluruhan
+
+Tugas `IssueCollectData` adalah fungsi automatik yang memicu proses pengumpulan data untuk set data yang ditentukan. Proses ini penting dalam skenario yang memerlukan pengumpulan data secara berkala atau berdasarkan peristiwa dari pelbagai sumber, seperti sensor, API, atau entiti penghasil data lain.
+
+## Parameter
+
+- **Dataset (dataset)**
+  - Deskripsi: Pengenal unik (ID) set data yang akan dimulakan aktiviti pengumpulan datanya. ID ini harus sesuai dengan set data yang sudah dikonfigurasi dalam sistem.
+  - Jenis: `entity-selector`
+  - Properti:
+    - `queryName`: Menentukan query untuk mengambil opsi set data, biasanya `dataSets`.
+    - `valueKey`: Menunjukkan properti yang digunakan sebagai nilai untuk seleksi, biasanya `id`.
+
+## Fungsi
+
+Saat dieksekusi, tugas memeriksa keberadaan ID set data. Jika ID tidak disediakan, tugas akan melempar kesalahan yang menunjukkan bahwa tidak ada set data yang ditemukan. Jika ID set data yang valid disediakan, tugas melanjutkan untuk mengeluarkan aktiviti pengumpulan data yang spesifik untuk set data tersebut. Proses dasar yang ditangani oleh `issueCollectData` melibatkan operasi seperti validasi keberadaan set data, persiapan lingkungan pengumpulan data, dan memulai proses pengumpulan data sesuai dengan konfigurasi set data dan sumber data terkait.
+
+Tugas mengembalikan instansi aktivitas yang dimulai, yang dapat digunakan untuk melacak kemajuan, mengurus alur kerja pengumpulan data, atau mengintegrasikan dengan tugas berikutnya untuk memproses data yang dikumpulkan.
+
+## Penggunaan
+
+Tugas ini sangat berguna dalam alur kerja otomatis di mana data perlu dikumpulkan secara berkala dari sumber yang telah ditentukan. Ia berfungsi sebagai pemicu untuk memulai proses pengumpulan data, memungkinkan pengelolaan otomatis pipa pengambilan data, sistem pemantauan, atau aplikasi apa pun yang memerlukan mekanisme pengumpulan data yang dapat diandalkan dan terstruktur.
+
+Pastikan bahwa ID set data sesuai dengan set data yang dikonfigurasi dengan benar dalam sistem Anda. Tugas ini dirancang untuk terintegrasi secara mulus ke dalam alur kerja pengelolaan dan analisis data yang lebih luas, menawarkan antarmuka yang dapat diprogram untuk memulai aktivitas pengumpulan data sebagai bagian dari proses otomatis.
+
+## Kesimpulan
+
+Tugas `IssueCollectData` mengotomatiskan inisiasi aktivitas pengumpulan data untuk set data tertentu. Dengan menyediakan cara yang fleksibel dan dapat diprogram untuk memulai proses pengumpulan data, ia memfasilitasi pengelolaan data yang efisien, memungkinkan pengguna untuk memelihara set data yang terkini dengan intervensi manual minimal. Tugas ini merupakan komponen penting dari aplikasi berbasis data, terutama yang memerlukan pembaruan data reguler dari sumber yang beragam.

package/helps/dataset/task/issue-collect-data.zh.md

@@ -0,0 +1,32 @@
+# IssueCollectData 任务
+
+此任务启动与特定数据集关联的数据收集活动。它旨在触发和管理从指定来源收集数据的过程，以符合数据集的配置和要求。
+
+## 概览
+
+`IssueCollectData` 任务是一个自动化函数，用于触发特定数据集的数据收集过程。在需要从各种来源（如传感器、API 或其他数据生成实体）定期或事件驱动数据收集的场景中，此过程至关重要。
+
+## 参数
+
+- **数据集 (dataset)**
+  - 描述：要启动数据收集活动的数据集的唯一标识符（ID）。此 ID 应对应系统内已配置的数据集。
+  - 类型：`entity-selector`
+  - 属性：
+    - `queryName`：指定检索数据集选项的查询，通常为 `dataSets`。
+    - `valueKey`：指示用作选择值的属性，通常为 `id`。
+
+## 功能
+
+执行时，任务会检查数据集 ID 的存在。如果未提供 ID，则任务会抛出错误，指示未找到数据集。如果提供了有效的数据集 ID，则任务将继续针对该数据集发起数据收集活动。`issueCollectData` 处理的底层过程涉及验证数据集的存在、准备数据收集环境以及根据数据集的配置和关联数据源启动数据收集过程。
+
+任务返回启动的活动实例，可用于跟踪进度、管理数据收集工作流或与后续任务集成以处理收集的数据。
+
+## 用途
+
+此任务在需要定期从预定义来源收集数据的自动化工作流中特别有用。它充当启动数据收集过程的触发器，允许自动管理数据摄取管道、监控系统或任何需要可靠和结构化数据收集机制的应用程序。
+
+确保数据集 ID 对应于系统内正确配置的数据集。该任务旨在无缝集成到更广泛的数据管理和分析工作流中，提供用于启动自动化过程中数据收集活动的可编程接口。
+
+## 结论
+
+`IssueCollectData` 任务自动化了为特定数据集启动数据收集活动的过程。通过提供一种灵活和可编程的方式来启动数据收集过程，它促进了高效的数据管理，使用户能够以最小的手动干预维护最新的数据集。此任务是数据驱动应用的必要组成部分，特别是那些需要定期从多样化来源更新数据的应用程序。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/dataset",
-  "version": "7.0.0-alpha.1",
+  "version": "7.0.0-alpha.18",
   "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.1",
+    "@things-factory/auth-base": "^7.0.0-alpha.18",
+    "@things-factory/aws-base": "^7.0.0-alpha.18",
+    "@things-factory/board-service": "^7.0.0-alpha.18",
     "@things-factory/env": "^7.0.0-alpha.0",
-    "@things-factory/integration-base": "^7.0.0-alpha.1",
-    "@things-factory/organization": "^7.0.0-alpha.1",
-    "@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.1",
+    "@things-factory/integration-base": "^7.0.0-alpha.18",
+    "@things-factory/organization": "^7.0.0-alpha.18",
+    "@things-factory/scheduler-client": "^7.0.0-alpha.18",
+    "@things-factory/shell": "^7.0.0-alpha.18",
+    "@things-factory/work-shift": "^7.0.0-alpha.18",
+    "@things-factory/worklist": "^7.0.0-alpha.18",
     "cron-parser": "^4.3.0",
     "moment-timezone": "^0.5.40",
     "simple-statistics": "^7.8.3",
     "statistics": "^3.3.0"
   },
-  "gitHead": "778315d165d7f15e147583a45d5079c3d7cbce38"
+  "gitHead": "f695ce9c0e3a8f2d715d27a2e7674c9b9c6b1ee1"
 }

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

@@ -1,19 +1,11 @@
 import { In } from 'typeorm'
 
-import {
-  Activity,
-  ActivityInstance,
-  ActivityInstanceStatus,
-  UpdateActivityInstanceStateAddendum
-} from '@things-factory/worklist'
+import { User } from '@things-factory/auth-base'
+import { Activity, ActivityInstance, ActivityInstanceStatus, UpdateActivityInstanceStateAddendum } from '@things-factory/worklist'
 import { NewDataSample } from 'service/data-sample/data-sample-type'
 import { createDataSample } from '../controllers/create-data-sample'
 
-async function callback(
-  activityInstance: ActivityInstance,
-  addendum: UpdateActivityInstanceStateAddendum,
-  context: ResolverContext
-) {
+async function callback(activityInstance: ActivityInstance, addendum: UpdateActivityInstanceStateAddendum, context: ResolverContext) {
   const { domain, tx } = context.state
   const { input, output, state } = activityInstance
 

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 || {}
@@ -25,7 +16,7 @@ async function callback(
 
     if (activity) {
       const { dataOocId } = input
-      const correctiveInstruction = output.instruction
+      const correctiveInstruction = output?.instruction
 
       var dataOoc = await tx.getRepository(DataOoc).findOne({
         where: {
@@ -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.')