From 8ea845c74dc11cfdc891f8726353513c443dd4e7 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 28 Mar 2026 14:06:05 +0000 Subject: [PATCH] Remove data-management page from all languages and navigation Generated-By: mintlify-agent --- ar/features/data-management.mdx | 312 --------------------------- de/features/data-management.mdx | 312 --------------------------- docs.json | 12 -- es/features/data-management.mdx | 248 --------------------- fr/features/data-management.mdx | 248 --------------------- hi/features/data-management.mdx | 248 --------------------- index.mdx | 7 - ja/features/data-management.mdx | 248 --------------------- ko/features/data-management.mdx | 248 --------------------- pt/features/data-management.mdx | 248 --------------------- vi/features/data-management.mdx | 248 --------------------- zh-Hant/features/data-management.mdx | 248 --------------------- zh/features/data-management.mdx | 248 --------------------- 13 files changed, 2875 deletions(-) delete mode 100644 ar/features/data-management.mdx delete mode 100644 de/features/data-management.mdx delete mode 100644 es/features/data-management.mdx delete mode 100644 fr/features/data-management.mdx delete mode 100644 hi/features/data-management.mdx delete mode 100644 ja/features/data-management.mdx delete mode 100644 ko/features/data-management.mdx delete mode 100644 pt/features/data-management.mdx delete mode 100644 vi/features/data-management.mdx delete mode 100644 zh-Hant/features/data-management.mdx delete mode 100644 zh/features/data-management.mdx diff --git a/ar/features/data-management.mdx b/ar/features/data-management.mdx deleted file mode 100644 index b6c252b..0000000 --- a/ar/features/data-management.mdx +++ /dev/null @@ -1,312 +0,0 @@ ---- -title: "إدارة البيانات" -description: "واجهة إدارة بيانات موحدة، تدعم عمليات بيانات النماذج والسير والمهام والنماذج الفرعية وما إلى ذلك." -icon: "database" ---- - -يوفر OpenYida CLI موحد لإدارة البيانات، يدعم عمليات كاملة لبيانات النماذج وحالات السير والمهام والنماذج الفرعية وما إلى ذلك. - ---- - -## نظرة عامة - - - - استعلام وإنشاء وتحديث بيانات حالات النموذج. - - - إدارة حالات السير وسجلات الموافقة وحالة السير. - - - استعلام المهام المعلقة والمكتملة والتي قدمتها والمُنسَخة إليّ. - - - استعلام وإدارة بيانات النماذج الفرعية بشكل مستقل. - - - ---- - -## تنسيق الأمر - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **resource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## إدارة بيانات النموذج - -### استعلام بيانات النموذج - -```bash -# استعلام أساسي -openyida data query form - -# استعلام مقسم إلى صفحات -openyida data query form --page 1 --size 50 - -# استعلام شرطي -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# استعلام حالة محددة -openyida data query form --inst-id - -# إرجاع المعرّفات فقط -openyida data query form --ids-only - -# التصفية حسب المنشئ ونطاق التاريخ -openyida data query form \ - --originator-id \ - --create-from "2026-01-01" --create-to "2026-12-31" -``` - -#### معلمات اختيارية - -| المعلمة | الوصف | -|---------|-------| -| `--page N` | رقم الصفحة (افتراضي `1`) | -| `--size N` | عناصر لكل صفحة (افتراضي `20`، الحد الأقصى `100`) | -| `--search-json JSON` | شروط البحث (يجب أن يكون JSON صالح) | -| `--inst-id ID` | استعلام سجل واحد بمعرّف المثيل | -| `--ids-only` | إرجاع معرّفات المثيلات فقط | -| `--originator-id ID` | التصفية حسب المنشئ | -| `--create-from DATE` / `--create-to DATE` | التصفية حسب تاريخ الإنشاء | -| `--modified-from DATE` / `--modified-to DATE` | التصفية حسب تاريخ التعديل | -| `--dynamic-order FIELD` | الترتيب حسب الحقل | - -### الحصول على سجل واحد - -```bash -openyida data get form --inst-id -``` - -### إنشاء بيانات - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### تحديث البيانات - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## إدارة بيانات السير - -### استعلام حالات السير - -```bash -# استعلام قائمة السير -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# الحالات المتاحة: RUNNING (قيد التشغيل), COMPLETED (مكتمل), TERMINATED (مُنهى) - -# إرجاع المعرّفات فقط -openyida data query process --ids-only - -# التصفية حسب المنشئ ونطاق التاريخ -openyida data query process \ - --originator-id \ - --create-from "2026-01-01" --create-to "2026-12-31" -``` - -#### معلمات اختيارية - -| المعلمة | الوصف | -|---------|-------| -| `--page N` | رقم الصفحة (افتراضي `1`) | -| `--size N` | عناصر لكل صفحة (افتراضي `20`، الحد الأقصى `100`) | -| `--search-json JSON` | شروط البحث (يجب أن يكون JSON صالح) | -| `--instance-status STATUS` | حالة السير: `RUNNING`، `COMPLETED`، `TERMINATED` | -| `--task-id ID` | معرّف المهمة | -| `--approved-result RESULT` | نتيجة الموافقة | -| `--ids-only` | إرجاع معرّفات المثيلات فقط | -| `--originator-id ID` | التصفية حسب المنشئ | -| `--create-from DATE` / `--create-to DATE` | التصفية حسب تاريخ الإنشاء | -| `--modified-from DATE` / `--modified-to DATE` | التصفية حسب تاريخ التعديل | - -### الحصول على تفاصيل السير - -```bash -openyida data get process --process-inst-id -``` - -### إنشاء حالة سير - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### تحديث حالة سير - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### استعلام سجلات الموافقة - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## إدارة المهام - - - للاستعلام عن بيانات مركز المهام العالمي دون تحديد `appType`، استخدم أمر `openyida task-center`. راجع [مرجع CLI](/ar/features/skills#مركز-المهام-العالمي). - - -### استعلام قائمة المهام - -```bash -# المهام المعلقة -openyida data query tasks --type todo - -# المهام المكتملة -openyida data query tasks --type done - -# التي قدمتها -openyida data query tasks --type submitted - -# المُنسَخة إليّ -openyida data query tasks --type cc - -# البحث بالكلمة المفتاحية -openyida data query tasks --type todo --keyword "طلب إجازة" -``` - -#### معلمات اختيارية - -| المعلمة | الوصف | -|---------|-------| -| `--type TYPE` | **(مطلوب)** نوع المهمة: `todo`، `done`، `submitted`، `cc` | -| `--page N` | رقم الصفحة (افتراضي `1`) | -| `--size N` | عناصر لكل صفحة (افتراضي `20`، الحد الأقصى `100`) | -| `--keyword TEXT` | البحث بالكلمة المفتاحية | -| `--process-codes CODES` | تصفية حسب رموز السير | -| `--instance-status STATUS` | حالة السير: `RUNNING`، `COMPLETED`، `TERMINATED` | - -### تنفيذ المهمة - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "موافق، يرجى المتابعة" \ - --data-json '{"comment": "تمت الموافقة"}' -``` - -#### معلمات - -| المعلمة | الوصف | -|---------|-------| -| `--task-id ID` | **(مطلوب)** معرّف المهمة | -| `--process-inst-id ID` | **(مطلوب)** معرّف نسخة العملية | -| `--out-result RESULT` | **(مطلوب)** `AGREE` (موافق) أو `DISAGREE` (غير موافق) | -| `--remark TEXT` | **(مطلوب)** تعليق الموافقة | -| `--data-json JSON` | بيانات النموذج للتحديث أثناء الموافقة | -| `--no-execute-expressions y` | تخطي تنفيذ التعبيرات بعد إتمام المهمة | - ---- - -## إدارة النماذج الفرعية - -### استعلام بيانات النموذج الفرعي - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## الاستخدام المتقدم - -### تنسيق شروط الاستعلام - -يقبل المعامل `--search-json` تنسيق استعلام قائم على المصفوفات. كل شرط هو كائن يحتوي على الحقول التالية: - - - يجب أن تكون قيمة `--search-json` نص JSON صالح. تأكد من استخدام علامات الاقتباس المزدوجة للمفاتيح والقيم النصية، وتجنب الفواصل الزائدة. يمكنك التحقق من صحة JSON باستخدام أدوات مثل `jq` قبل تمريره للأمر. - - -| الحقل | الوصف | -|-------|-------| -| `key` | معرّف الحقل (مثال: `field_xxx`) | -| `value` | القيمة للمقارنة | -| `type` | نوع البيانات: `TEXT`، `NUMBER`، `DATE`، إلخ | -| `operator` | العامل: `eq`، `like`، `gt`، `gte`، `lt`، `lte`، `in`، `range` | -| `componentName` | نوع المكون: `TextField`، `NumberField`، `DateField`، إلخ | - -مثال: - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### مثال سكريبت عملية مجمعة - -```bash -#!/bin/bash -# تصدير بيانات النموذج مجمعة - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # معالجة بيانات الصفحة الحالية - echo "$RESULT" >> ./export.json - - # التحقق مما إذا كانت هناك صفحة تالية - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## ملاحظات - - - عمليات البيانات دائمة، لا يمكن التراجع عن عمليات التحديث. يُنصح بإجراء اختبارات صغيرة النطاق قبل تنفيذ العمليات المجمعة. - - - - الاستعلام المقسم إلى صفحات افتراضيًا 20 سجلًا لكل صفحة، الحد الأقصى 100. لتصدير كميات كبيرة من البيانات، يُنصح باستخدام حلقة التقسيم إلى صفحات. - diff --git a/de/features/data-management.mdx b/de/features/data-management.mdx deleted file mode 100644 index 7827acd..0000000 --- a/de/features/data-management.mdx +++ /dev/null @@ -1,312 +0,0 @@ ---- -title: "Datenverwaltung" -description: "Einheitliche Datenverwaltungsschnittstelle, unterstützt Operationen für Formulare, Prozesse, Aufgaben, Unterformulare usw." -icon: "database" ---- - -OpenYida bietet ein einheitliches Datenverwaltungs-CLI, das vollständige Operationen für Formulardaten, Prozessinstanzen, Aufgaben, Unterformulare usw. unterstützt. - ---- - -## Funktionsübersicht - - - - Abfragen, Erstellen, Aktualisieren von Formularinstanzdaten. - - - Verwalten von Prozessinstanzen, Genehmigungsdatensätzen, Prozessstatus. - - - Abfragen von zu erledigenden, erledigten, von mir eingereichten, in Kopie befindlichen Aufgaben. - - - Unabhängiges Abfragen und Verwalten von Unterformulardaten. - - - ---- - -## Befehlsformat - -```bash -openyida data [args] -``` - -- **aktion**: `query` | `get` | `create` | `update` | `execute` -- **ressource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## Formulardatenverwaltung - -### Formulardaten abfragen - -```bash -# Basisabfrage -openyida data query form - -# Paginierte Abfrage -openyida data query form --page 1 --size 50 - -# Bedingte Abfrage -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# Spezifische Instanz abfragen -openyida data query form --inst-id - -# Nur IDs zurückgeben -openyida data query form --ids-only - -# Nach Ersteller und Datumsbereich filtern -openyida data query form \ - --originator-id \ - --create-from "2026-01-01" --create-to "2026-12-31" -``` - -#### Optionale Parameter - -| Parameter | Beschreibung | -|-----------|-------------| -| `--page N` | Seitennummer (Standard `1`) | -| `--size N` | Einträge pro Seite (Standard `20`, max `100`) | -| `--search-json JSON` | Suchbedingungen (muss gültiges JSON sein) | -| `--inst-id ID` | Einzelnen Datensatz nach Instanz-ID abfragen | -| `--ids-only` | Nur Instanz-IDs zurückgeben | -| `--originator-id ID` | Nach Ersteller filtern | -| `--create-from DATE` | Nach Erstellungsdatum filtern (ab) | -| `--create-to DATE` | Nach Erstellungsdatum filtern (bis) | -| `--modified-from DATE` | Nach Änderungsdatum filtern (ab) | -| `--modified-to DATE` | Nach Änderungsdatum filtern (bis) | -| `--dynamic-order FIELD` | Nach Feld sortieren | - -### Einzelne Daten abrufen - -```bash -openyida data get form --inst-id -``` - -### Daten erstellen - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### Daten aktualisieren - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## Prozessdatenverwaltung - -### Prozessinstanzen abfragen - -```bash -# Prozessliste abfragen -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# Verfügbare Status: RUNNING (laufend), COMPLETED (abgeschlossen), TERMINATED (beendet) - -# Nur IDs zurückgeben -openyida data query process --ids-only - -# Nach Aufgabe und Genehmigungsergebnis filtern -openyida data query process \ - --task-id \ - --approved-result AGREE -``` - -#### Optionale Parameter - -| Parameter | Beschreibung | -|-----------|-------------| -| `--page N` | Seitennummer (Standard `1`) | -| `--size N` | Einträge pro Seite (Standard `20`, max `100`) | -| `--search-json JSON` | Suchbedingungen (muss gültiges JSON sein) | -| `--instance-status STATUS` | Instanzstatus: `RUNNING`, `COMPLETED`, `TERMINATED` | -| `--task-id ID` | Nach Aufgaben-ID filtern | -| `--approved-result RESULT` | Genehmigungsergebnis: `AGREE`, `DISAGREE` | -| `--ids-only` | Nur Instanz-IDs zurückgeben | -| `--originator-id ID` | Nach Ersteller filtern | -| `--create-from DATE` | Nach Erstellungsdatum filtern (ab) | -| `--create-to DATE` | Nach Erstellungsdatum filtern (bis) | -| `--modified-from DATE` | Nach Änderungsdatum filtern (ab) | -| `--modified-to DATE` | Nach Änderungsdatum filtern (bis) | - -### Prozessdetails abrufen - -```bash -openyida data get process --process-inst-id -``` - -### Prozessinstanz erstellen - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### Prozessinstanz aktualisieren - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### Genehmigungsdatensätze abfragen - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## Aufgabenverwaltung - - - Um globale Aufgabenzentrumsdaten ohne Angabe eines `appType` abzufragen, verwenden Sie den Befehl `openyida task-center`. Siehe [CLI-Referenz](/de/features/skills#globales-aufgabenzentrum). - - -### Aufgabenliste abfragen - -```bash -# Zu erledigende Aufgaben -openyida data query tasks --type todo - -# Erledigte Aufgaben -openyida data query tasks --type done - -# Von mir eingereichte -openyida data query tasks --type submitted - -# In Kopie -openyida data query tasks --type cc - -# Mit Paginierung und Schlüsselwort-Filter -openyida data query tasks --type todo --page 1 --size 20 --keyword "dringend" -``` - -#### Optionale Parameter - -| Parameter | Beschreibung | -|-----------|-------------| -| `--type TYPE` | **(Erforderlich)** Aufgabentyp: `todo`, `done`, `submitted`, `cc` | -| `--page N` | Seitennummer (Standard `1`) | -| `--size N` | Einträge pro Seite (Standard `20`, max `100`) | -| `--keyword TEXT` | Nach Schlüsselwort filtern | -| `--process-codes CODES` | Nach Prozesscodes filtern | -| `--instance-status STATUS` | Instanzstatus: `RUNNING`, `COMPLETED`, `TERMINATED` | - -### Aufgabe ausführen - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "Zustimmung, bitte fortfahren" \ - --data-json '{"comment": "Genehmigung erfolgreich"}' -``` - -#### Parameter - -| Parameter | Erforderlich | Beschreibung | -|-----------|:------------:|-------------| -| `--task-id ID` | Ja | Aufgaben-ID | -| `--process-inst-id ID` | Ja | Prozessinstanz-ID | -| `--out-result RESULT` | Ja | Ergebnis: `AGREE` (Zustimmen), `DISAGREE` (Nicht zustimmen) | -| `--remark TEXT` | Ja | Bemerkung zur Aufgabenausführung | -| `--data-json JSON` | Nein | Zusätzliche Daten im JSON-Format | -| `--no-execute-expressions` | Nein | Ausdrücke bei der Ausführung nicht auswerten | - ---- - -## Unterformularverwaltung - -### Unterformulardaten abfragen - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## Erweiterte Verwendung - -### Abfragebedingungsformat - -Der `--search-json` Parameter akzeptiert ein Array-basiertes Abfrageformat. Der Wert muss gültiges JSON sein — die CLI validiert die Eingabe vor dem Senden der Anfrage. Jede Bedingung ist ein Objekt mit folgenden Feldern: - -| Feld | Beschreibung | -|------|-------------| -| `key` | Feld-ID (z.B. `field_xxx`) | -| `value` | Abzugleichender Wert | -| `type` | Datentyp: `TEXT`, `NUMBER`, `DATE`, etc. | -| `operator` | Operator: `eq`, `like`, `gt`, `gte`, `lt`, `lte`, `in`, `range` | -| `componentName` | Komponententyp: `TextField`, `NumberField`, `DateField`, etc. | - -Beispiel: - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### Batch-Operationsskriptbeispiel - -```bash -#!/bin/bash -# Batch-Export von Formulardaten - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # Aktuelle Seitendaten verarbeiten - echo "$RESULT" >> ./export.json - - # Prüfen, ob es eine nächste Seite gibt - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## Vorsichtsmaßnahmen - - - Datenoperationen sind dauerhaft, Aktualisierungsvorgänge können nicht rückgängig gemacht werden. Es wird empfohlen, vor der Ausführung von Batch-Operationen kleine Tests durchzuführen. - - - - Paginierte Abfragen geben standardmäßig 20 Ergebnisse pro Seite zurück, maximal 100. Für den Export großer Datenmengen wird die Verwendung von Schleifen-Pagination empfohlen. - diff --git a/docs.json b/docs.json index 822c598..a346533 100644 --- a/docs.json +++ b/docs.json @@ -29,7 +29,6 @@ "zh/features/skills", "zh/features/use-cases", "zh/features/connector", - "zh/features/data-management", "zh/features/report", "zh/features/doctor" ] @@ -76,7 +75,6 @@ "en/features/skills", "en/features/use-cases", "en/features/connector", - "en/features/data-management", "en/features/report", "en/features/doctor" ] @@ -123,7 +121,6 @@ "zh-Hant/features/skills", "zh-Hant/features/use-cases", "zh-Hant/features/connector", - "zh-Hant/features/data-management", "zh-Hant/features/report", "zh-Hant/features/doctor" ] @@ -170,7 +167,6 @@ "ja/features/skills", "ja/features/use-cases", "ja/features/connector", - "ja/features/data-management", "ja/features/report", "ja/features/doctor" ] @@ -217,7 +213,6 @@ "ko/features/skills", "ko/features/use-cases", "ko/features/connector", - "ko/features/data-management", "ko/features/report", "ko/features/doctor" ] @@ -264,7 +259,6 @@ "fr/features/skills", "fr/features/use-cases", "fr/features/connector", - "fr/features/data-management", "fr/features/report", "fr/features/doctor" ] @@ -311,7 +305,6 @@ "de/features/skills", "de/features/use-cases", "de/features/connector", - "de/features/data-management", "de/features/report", "de/features/doctor" ] @@ -358,7 +351,6 @@ "es/features/skills", "es/features/use-cases", "es/features/connector", - "es/features/data-management", "es/features/report", "es/features/doctor" ] @@ -405,7 +397,6 @@ "pt/features/skills", "pt/features/use-cases", "pt/features/connector", - "pt/features/data-management", "pt/features/report", "pt/features/doctor" ] @@ -452,7 +443,6 @@ "vi/features/skills", "vi/features/use-cases", "vi/features/connector", - "vi/features/data-management", "vi/features/report", "vi/features/doctor" ] @@ -499,7 +489,6 @@ "hi/features/skills", "hi/features/use-cases", "hi/features/connector", - "hi/features/data-management", "hi/features/report", "hi/features/doctor" ] @@ -546,7 +535,6 @@ "ar/features/skills", "ar/features/use-cases", "ar/features/connector", - "ar/features/data-management", "ar/features/report", "ar/features/doctor" ] diff --git a/es/features/data-management.mdx b/es/features/data-management.mdx deleted file mode 100644 index dbcc1cb..0000000 --- a/es/features/data-management.mdx +++ /dev/null @@ -1,248 +0,0 @@ ---- -title: "Gestión de datos" -description: "Interfaz unificada de gestión de datos, soporta operaciones de datos de formularios, flujos, tareas, subformularios, etc." -icon: "database" ---- - -OpenYida proporciona una CLI unificada de gestión de datos, soporta operaciones completas para datos de formularios, instancias de flujo, tareas, subformularios, etc. - ---- - -## Descripción general - - - - Consultar, crear, actualizar datos de instancias de formulario. - - - Gestionar instancias de flujo, registros de aprobación, estado de flujo. - - - Consultar tareas pendientes, completadas, enviadas por mí, CC a mí. - - - Consultar y gestionar datos de subformularios de forma independiente. - - - ---- - -## Formato de comando - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **resource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## Gestión de datos de formulario - -### Consultar datos de formulario - -```bash -# Consulta básica -openyida data query form - -# Consulta paginada -openyida data query form --page 1 --size 50 - -# Consulta condicional -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# Consultar instancia específica -openyida data query form --inst-id - -# Devolver solo IDs -openyida data query form --ids-only -``` - -### Obtener un solo registro - -```bash -openyida data get form --inst-id -``` - -### Crear datos - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### Actualizar datos - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## Gestión de datos de flujo - -### Consultar instancias de flujo - -```bash -# Consultar lista de flujos -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# Estados disponibles: RUNNING (en progreso), COMPLETED (completado), TERMINATED (terminado) - -# Devolver solo IDs -openyida data query process --ids-only -``` - -### Obtener detalles del flujo - -```bash -openyida data get process --process-inst-id -``` - -### Crear instancia de flujo - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### Actualizar instancia de flujo - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### Consultar registros de aprobación - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## Gestión de tareas - - - Para consultar los datos del centro de tareas global sin especificar un `appType`, use el comando `openyida task-center`. Consulte la [referencia CLI](/es/features/skills#centro-de-tareas-global). - - -### Consultar lista de tareas - -```bash -# Tareas pendientes -openyida data query tasks --type todo - -# Tareas completadas -openyida data query tasks --type done - -# Enviadas por mí -openyida data query tasks --type submitted - -# CC a mí -openyida data query tasks --type cc -``` - -### Ejecutar tarea - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "Aprobado, por favor continuar" \ - --data-json '{"comment": "Aprobación aprobada"}' -``` - -**Opciones de out-result:** -- `AGREE` - Aprobar -- `DISAGREE` - No aprobar - ---- - -## Gestión de subformularios - -### Consultar datos de subformulario - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## Uso avanzado - -### Formato de condiciones de consulta - -El parámetro `--search-json` acepta un formato de consulta basado en array. Cada condición es un objeto con los siguientes campos: - -| Campo | Descripción | -|-------|-------------| -| `key` | ID del campo (ej: `field_xxx`) | -| `value` | Valor a comparar | -| `type` | Tipo de datos: `TEXT`, `NUMBER`, `DATE`, etc. | -| `operator` | Operador: `eq`, `like`, `gt`, `gte`, `lt`, `lte`, `in`, `range` | -| `componentName` | Tipo de componente: `TextField`, `NumberField`, `DateField`, etc. | - -Ejemplo: - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### Ejemplo de script de operación por lotes - -```bash -#!/bin/bash -# Exportar datos de formulario por lotes - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # Procesar datos de la página actual - echo "$RESULT" >> ./export.json - - # Verificar si hay página siguiente - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## Notas - - - Las operaciones de datos son permanentes, las operaciones de actualización no se pueden deshacer. Se recomienda realizar pruebas a pequeña escala antes de ejecutar operaciones por lotes. - - - - La consulta paginada tiene un valor predeterminado de 20 registros por página, máximo 100. Para exportar grandes cantidades de datos, se recomienda usar bucle de paginación. - diff --git a/fr/features/data-management.mdx b/fr/features/data-management.mdx deleted file mode 100644 index 67ae0d8..0000000 --- a/fr/features/data-management.mdx +++ /dev/null @@ -1,248 +0,0 @@ ---- -title: "Gestion des données" -description: "Interface unifié de gestion des données, prenant en charge les opérations sur les formulaires, processus, tâches, sous-formulaires, etc." -icon: "database" ---- - -OpenYida fournit un CLI de gestion des données unifié, prenant en charge des opérations complètes sur les données de formulaire, les instances de processus, les tâches, les sous-formulaires, etc. - ---- - -## Vue d'ensemble des fonctionnalités - - - - Interroger, créer, mettre à jour les données d'instance de formulaire. - - - Gérer les instances de processus, les enregistrements d'approbation, les statuts de processus. - - - Interroger les tâches à faire, terminées, soumises par moi, en copie. - - - Interroger et gérer indépendamment les données de sous-formulaires. - - - ---- - -## Format de commande - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **ressource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## Gestion des données de formulaire - -### Interroger les données de formulaire - -```bash -# Requête de base -openyida data query form - -# Requête paginée -openyida data query form --page 1 --size 50 - -# Requête conditionnelle -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# Interroger une instance spécifique -openyida data query form --inst-id - -# Retourner uniquement les ID -openyida data query form --ids-only -``` - -### Obtenir une seule donnée - -```bash -openyida data get form --inst-id -``` - -### Créer des données - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### Mettre à jour les données - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## Gestion des données de processus - -### Interroger les instances de processus - -```bash -# Lister les processus -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# Statuts disponibles : RUNNING (en cours), COMPLETED (terminé), TERMINATED (terminé) - -# Retourner uniquement les ID -openyida data query process --ids-only -``` - -### Obtenir les détails du processus - -```bash -openyida data get process --process-inst-id -``` - -### Créer une instance de processus - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### Mettre à jour une instance de processus - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### Interroger les enregistrements d'approbation - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## Gestion des tâches - - - Pour interroger les données du centre de tâches global sans spécifier d'`appType`, utilisez la commande `openyida task-center`. Voir la [référence CLI](/fr/features/skills#centre-de-tâches-global). - - -### Interroger la liste des tâches - -```bash -# Tâches à faire -openyida data query tasks --type todo - -# Tâches terminées -openyida data query tasks --type done - -# Soumises par moi -openyida data query tasks --type submitted - -# En copie -openyida data query tasks --type cc -``` - -### Exécuter une tâche - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "D'accord, veuillez continuer" \ - --data-json '{"comment": "Approbation réussie"}' -``` - -**Options out-result :** -- `AGREE` - D'accord -- `DISAGREE` - Pas d'accord - ---- - -## Gestion des sous-formulaires - -### Interroger les données de sous-formulaire - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## Utilisation avancée - -### Format des conditions de requête - -Le paramètre `--search-json` accepte un format de requête basé sur un tableau. Chaque condition est un objet avec les champs suivants : - -| Champ | Description | -|-------|-------------| -| `key` | ID du champ (ex: `field_xxx`) | -| `value` | Valeur à comparer | -| `type` | Type de données : `TEXT`, `NUMBER`, `DATE`, etc. | -| `operator` | Opérateur : `eq`, `like`, `gt`, `gte`, `lt`, `lte`, `in`, `range` | -| `componentName` | Type de composant : `TextField`, `NumberField`, `DateField`, etc. | - -Exemple : - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### Exemple de script d'opérations par lots - -```bash -#!/bin/bash -# Export par lot des données de formulaire - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # Traiter les données de la page actuelle - echo "$RESULT" >> ./export.json - - # Vérifier s'il y a une page suivante - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## Précautions - - - Les opérations sur les données sont permanentes, les opérations de mise à jour ne peuvent pas être annulées. Il est recommandé d'effectuer des tests à petite échelle avant d'exécuter des opérations par lots. - - - - La requête paginée renvoie par défaut 20 résultats par page, avec un maximum de 100. Pour l'export de grandes quantités de données, il est recommandé d'utiliser la pagination en boucle. - diff --git a/hi/features/data-management.mdx b/hi/features/data-management.mdx deleted file mode 100644 index 316dfd4..0000000 --- a/hi/features/data-management.mdx +++ /dev/null @@ -1,248 +0,0 @@ ---- -title: "डेटा प्रबंधन" -description: "एकीकृत डेटा प्रबंधन इंटरफ़ेस, फॉर्म, प्रक्रिया, कार्य, उप-फॉर्म आदि डेटा संचालन का समर्थन करता है।" -icon: "database" ---- - -OpenYida एकीकृत डेटा प्रबंधन CLI प्रदान करता है, फॉर्म डेटा, प्रक्रिया इंस्टेंस, कार्य, उप-फॉर्म आदि के लिए पूर्ण संचालन का समर्थन करता है। - ---- - -## अवलोकन - - - - फॉर्म इंस्टेंस डेटा क्वेरी, बनाएं, अपडेट करें। - - - प्रक्रिया इंस्टेंस, अनुमोदन रिकॉर्ड, प्रक्रिया स्थिति प्रबंधित करें। - - - लंबित, पूर्ण, मेरे द्वारा सबमिट किए गए, मुझे CC किए गए कार्यों की क्वेरी करें। - - - उप-फॉर्म डेटा को स्वतंत्र रूप से क्वेरी और प्रबंधित करें। - - - ---- - -## कमांड प्रारूप - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **resource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## फॉर्म डेटा प्रबंधन - -### फॉर्म डेटा क्वेरी - -```bash -# बुनियादी क्वेरी -openyida data query form - -# पेजिनेशन क्वेरी -openyida data query form --page 1 --size 50 - -# सशर्त क्वेरी -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# विशिष्ट इंस्टेंस क्वेरी -openyida data query form --inst-id - -# केवल ID लौटाएं -openyida data query form --ids-only -``` - -### एकल रिकॉर्ड प्राप्त करें - -```bash -openyida data get form --inst-id -``` - -### डेटा बनाएं - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### डेटा अपडेट करें - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## प्रक्रिया डेटा प्रबंधन - -### प्रक्रिया इंस्टेंस क्वेरी - -```bash -# प्रक्रिया सूची क्वेरी -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# उपलब्ध स्थिति: RUNNING (चल रहा है), COMPLETED (पूर्ण), TERMINATED (समाप्त) - -# केवल ID लौटाएं -openyida data query process --ids-only -``` - -### प्रक्रिया विवरण प्राप्त करें - -```bash -openyida data get process --process-inst-id -``` - -### प्रक्रिया इंस्टेंस बनाएं - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### प्रक्रिया इंस्टेंस अपडेट करें - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### अनुमोदन रिकॉर्ड क्वेरी - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## कार्य प्रबंधन - - - `appType` निर्दिष्ट किए बिना सभी अनुप्रयोगों में वैश्विक कार्य केंद्र डेटा की क्वेरी करने के लिए, `openyida task-center` कमांड का उपयोग करें। [CLI संदर्भ](/hi/features/skills#वैश्विक-कार्य-केंद्र) देखें। - - -### कार्य सूची क्वेरी - -```bash -# लंबित कार्य -openyida data query tasks --type todo - -# पूर्ण कार्य -openyida data query tasks --type done - -# मेरे द्वारा सबमिट किए गए -openyida data query tasks --type submitted - -# मुझे CC किए गए -openyida data query tasks --type cc -``` - -### कार्य निष्पादित करें - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "सहमत, कृपया जारी रखें" \ - --data-json '{"comment": "अनुमोदन पारित"}' -``` - -**out-result विकल्प:** -- `AGREE` - सहमत -- `DISAGREE` - असहमत - ---- - -## उप-फॉर्म प्रबंधन - -### उप-फॉर्म डेटा क्वेरी - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## उन्नत उपयोग - -### क्वेरी शर्त प्रारूप - -`--search-json` पैरामीटर ऐरे-आधारित क्वेरी प्रारूप स्वीकार करता है। प्रत्येक शर्त निम्न फ़ील्ड वाली एक ऑब्जेक्ट है: - -| फ़ील्ड | विवरण | -|--------|--------| -| `key` | फ़ील्ड ID (जैसे: `field_xxx`) | -| `value` | मिलान करने का मान | -| `type` | डेटा प्रकार: `TEXT`, `NUMBER`, `DATE`, आदि | -| `operator` | ऑपरेटर: `eq`, `like`, `gt`, `gte`, `lt`, `lte`, `in`, `range` | -| `componentName` | कंपोनेंट प्रकार: `TextField`, `NumberField`, `DateField`, आदि | - -उदाहरण: - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### बैच ऑपरेशन स्क्रिप्ट उदाहरण - -```bash -#!/bin/bash -# फॉर्म डेटा बैच निर्यात - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # वर्तमान पृष्ठ डेटा प्रोसेस करें - echo "$RESULT" >> ./export.json - - # जांचें कि क्या अगला पृष्ठ है - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## ध्यान दें - - - डेटा संचालन स्थायी हैं, अपडेट संचालन पूर्ववत नहीं किए जा सकते। बैच संचालन निष्पादित करने से पहले छोटे पैमाने पर परीक्षण करने की अनुशंसा की जाती है। - - - - पेजिनेशन क्वेरी डिफ़ॉल्ट रूप से प्रति पृष्ठ 20 रिकॉर्ड, अधिकतम 100 का समर्थन करती है। बड़ी मात्रा में डेटा निर्यात के लिए पेजिनेशन लूप का उपयोग करने की अनुशंसा की जाती है। - diff --git a/index.mdx b/index.mdx index 4cf82f6..661c913 100644 --- a/index.mdx +++ b/index.mdx @@ -63,13 +63,6 @@ description: "AI 驱动的宜搭低代码平台 CLI 工具文档" > HTTP 连接器、API 集成、curl 导入 - - 表单数据、流程实例、任务管理 - - - フォームインスタンスデータのクエリ、作成、更新。 - - - プロセスインスタンス、承認記録、プロセス状態の管理。 - - - 未処理、完了、自分が提出した、自分にCCされたタスクのクエリ。 - - - サブフォームデータの独立したクエリと管理。 - - - ---- - -## コマンド形式 - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **resource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## フォームデータ管理 - -### フォームデータのクエリ - -```bash -# 基本クエリ -openyida data query form - -# ページネーションクエリ -openyida data query form --page 1 --size 50 - -# 条件クエリ -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# 指定インスタンスのクエリ -openyida data query form --inst-id - -# IDのみ返す -openyida data query form --ids-only -``` - -### 単一データの取得 - -```bash -openyida data get form --inst-id -``` - -### データの作成 - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### データの更新 - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## プロセスデータ管理 - -### プロセスインスタンスのクエリ - -```bash -# プロセスリストのクエリ -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# ステータスオプション：RUNNING（進行中）、COMPLETED（完了）、TERMINATED（終了） - -# IDのみ返す -openyida data query process --ids-only -``` - -### プロセス詳細の取得 - -```bash -openyida data get process --process-inst-id -``` - -### プロセスインスタンスの作成 - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### プロセスインスタンスの更新 - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### 承認記録のクエリ - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## タスク管理 - - - `appType` を指定せずにすべてのアプリケーションのグローバルタスクセンターデータを照会するには、`openyida task-center` コマンドを使用してください。[CLI リファレンス](/ja/features/skills#グローバルタスクセンター) を参照してください。 - - -### タスクリストのクエリ - -```bash -# 未処理タスク -openyida data query tasks --type todo - -# 完了タスク -openyida data query tasks --type done - -# 自分が提出した -openyida data query tasks --type submitted - -# 自分にCCされた -openyida data query tasks --type cc -``` - -### タスクの実行 - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "同意、続けて進めてください" \ - --data-json '{"comment": "承認済み"}' -``` - -**out-resultオプション：** -- `AGREE` - 同意 -- `DISAGREE` - 不同意 - ---- - -## サブフォーム管理 - -### サブフォームデータのクエリ - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## 高度な使用法 - -### クエリ条件形式 - -`--search-json` パラメータは配列ベースのクエリ形式を受け付けます。各条件は以下のフィールドを持つオブジェクトです： - -| フィールド | 説明 | -|------------|------| -| `key` | フィールドID（例：`field_xxx`） | -| `value` | マッチする値 | -| `type` | データ型：`TEXT`、`NUMBER`、`DATE` など | -| `operator` | 演算子：`eq`、`like`、`gt`、`gte`、`lt`、`lte`、`in`、`range` | -| `componentName` | コンポーネント型：`TextField`、`NumberField`、`DateField` など | - -例： - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### バッチ操作スクリプト例 - -```bash -#!/bin/bash -# フォームデータのバッチエクスポート - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # 現在のページのデータを処理 - echo "$RESULT" >> ./export.json - - # 次のページがあるか確認 - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## 注意事項 - - - データ操作は永続的であり、更新操作は取り消せません。バッチ操作を実行する前に、小規模なテストを行うことをお勧めします。 - - - - ページネーションクエリはデフォルトで1ページあたり20件、最大100件をサポートします。大量のデータをエクスポートする場合は、ループページネーションを使用して取得することをお勧めします。 - diff --git a/ko/features/data-management.mdx b/ko/features/data-management.mdx deleted file mode 100644 index 97836dd..0000000 --- a/ko/features/data-management.mdx +++ /dev/null @@ -1,248 +0,0 @@ ---- -title: "데이터 관리" -description: "통합 데이터 관리 인터페이스, 양식, 프로세스, 작업, 하위 양식 등 데이터 작업 지원." -icon: "database" ---- - -OpenYida는 통합 데이터 관리 CLI를 제공하며 양식 데이터, 프로세스 인스턴스, 작업, 하위 양식 등의 작업을 지원합니다. - ---- - -## 기능 개요 - - - - 양식 인스턴스 데이터 쿼리, 생성, 업데이트. - - - 프로세스 인스턴스, 승인 기록, 프로세스 상태 관리. - - - 할 일, 완료, 내가 제출한, 나에게 CC된 작업 쿼리. - - - 하위 양식 데이터의 독립적인 쿼리 및 관리. - - - ---- - -## 명령 형식 - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **resource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## 양식 데이터 관리 - -### 양식 데이터 쿼리 - -```bash -# 기본 쿼리 -openyida data query form - -# 페이지네이션 쿼리 -openyida data query form --page 1 --size 50 - -# 조건 쿼리 -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# 지정 인스턴스 쿼리 -openyida data query form --inst-id - -# ID만 반환 -openyida data query form --ids-only -``` - -### 단일 데이터 가져오기 - -```bash -openyida data get form --inst-id -``` - -### 데이터 생성 - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### 데이터 업데이트 - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## 프로세스 데이터 관리 - -### 프로세스 인스턴스 쿼리 - -```bash -# 프로세스 목록 쿼리 -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# 상태 옵션：RUNNING（진행 중）、COMPLETED（완료）、TERMINATED（종료） - -# ID만 반환 -openyida data query process --ids-only -``` - -### 프로세스 세부 정보 가져오기 - -```bash -openyida data get process --process-inst-id -``` - -### 프로세스 인스턴스 생성 - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### 프로세스 인스턴스 업데이트 - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### 승인 기록 쿼리 - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## 작업 관리 - - - `appType`을 지정하지 않고 모든 애플리케이션의 글로벌 작업 센터 데이터를 조회하려면 `openyida task-center` 명령을 사용하세요. [CLI 참조](/ko/features/skills#글로벌-작업-센터)를 확인하세요. - - -### 작업 목록 쿼리 - -```bash -# 할 일 작업 -openyida data query tasks --type todo - -# 완료 작업 -openyida data query tasks --type done - -# 내가 제출한 -openyida data query tasks --type submitted - -# 나에게 CC된 -openyida data query tasks --type cc -``` - -### 작업 실행 - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "동의, 계속 진행하세요" \ - --data-json '{"comment": "승인됨"}' -``` - -**out-result 옵션：** -- `AGREE` - 동의 -- `DISAGREE` - 거부 - ---- - -## 하위 양식 관리 - -### 하위 양식 데이터 쿼리 - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## 고급 사용법 - -### 쿼리 조건 형식 - -`--search-json` 매개변수는 배열 기반 쿼리 형식을 사용합니다. 각 조건은 다음 필드를 가진 객체입니다: - -| 필드 | 설명 | -|------|------| -| `key` | 필드 ID (예: `field_xxx`) | -| `value` | 매칭할 값 | -| `type` | 데이터 타입: `TEXT`, `NUMBER`, `DATE` 등 | -| `operator` | 연산자: `eq`, `like`, `gt`, `gte`, `lt`, `lte`, `in`, `range` | -| `componentName` | 컴포넌트 타입: `TextField`, `NumberField`, `DateField` 등 | - -예: - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### 배치 작업 스크립트 예 - -```bash -#!/bin/bash -# 양식 데이터 배치 내보내기 - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # 현재 페이지 데이터 처리 - echo "$RESULT" >> ./export.json - - # 다음 페이지 확인 - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## 주의사항 - - - 데이터 작업은 영구적이며 업데이트 작업은 취소할 수 없습니다. 배치 작업을 수행하기 전에 소규모 테스트를 수행하는 것이 좋습니다. - - - - 페이지네이션 쿼리는 기본적으로 페이지당 20개, 최대 100개를 지원합니다. 대량의 데이터를 내보낼 때는 루프 페이지네이션을 사용하여 가져오는 것이 좋습니다. - diff --git a/pt/features/data-management.mdx b/pt/features/data-management.mdx deleted file mode 100644 index e32cf02..0000000 --- a/pt/features/data-management.mdx +++ /dev/null @@ -1,248 +0,0 @@ ---- -title: "Gerenciamento de dados" -description: "Interface unificada de gerenciamento de dados, suporta operações de dados de formulários, fluxos, tarefas, subformulários, etc." -icon: "database" ---- - -O OpenYida fornece uma CLI unificada de gerenciamento de dados, suporta operações completas para dados de formulários, instâncias de fluxo, tarefas, subformulários, etc. - ---- - -## Visão geral - - - - Consultar, criar, atualizar dados de instâncias de formulário. - - - Gerenciar instâncias de fluxo, registros de aprovação, status do fluxo. - - - Consultar tarefas pendentes, concluídas, enviadas por mim, CC para mim. - - - Consultar e gerenciar dados de subformulários de forma independente. - - - ---- - -## Formato do comando - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **resource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## Gerenciamento de dados do formulário - -### Consultar dados do formulário - -```bash -# Consulta básica -openyida data query form - -# Consulta paginada -openyida data query form --page 1 --size 50 - -# Consulta condicional -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# Consultar instância específica -openyida data query form --inst-id - -# Retornar apenas IDs -openyida data query form --ids-only -``` - -### Obter um único registro - -```bash -openyida data get form --inst-id -``` - -### Criar dados - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### Atualizar dados - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## Gerenciamento de dados do fluxo - -### Consultar instâncias de fluxo - -```bash -# Consultar lista de fluxos -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# Status disponíveis: RUNNING (em andamento), COMPLETED (concluído), TERMINATED (encerrado) - -# Retornar apenas IDs -openyida data query process --ids-only -``` - -### Obter detalhes do fluxo - -```bash -openyida data get process --process-inst-id -``` - -### Criar instância de fluxo - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### Atualizar instância de fluxo - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### Consultar registros de aprovação - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## Gestão de tarefas - - - Para consultar dados do centro de tarefas global sem especificar um `appType`, use o comando `openyida task-center`. Veja a [referência CLI](/pt/features/skills#centro-de-tarefas-global). - - -### Consultar lista de tarefas - -```bash -# Tarefas pendentes -openyida data query tasks --type todo - -# Tarefas concluídas -openyida data query tasks --type done - -# Enviadas por mim -openyida data query tasks --type submitted - -# CC para mim -openyida data query tasks --type cc -``` - -### Executar tarefa - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "Aprovado, por favor continuar" \ - --data-json '{"comment": "Aprovação aprovada"}' -``` - -**Opções de out-result:** -- `AGREE` - Aprovar -- `DISAGREE` - Não aprovar - ---- - -## Gerenciamento de subformulários - -### Consultar dados do subformulário - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## Uso avançado - -### Formato de condições de consulta - -O parâmetro `--search-json` aceita um formato de consulta baseado em array. Cada condição é um objeto com os seguintes campos: - -| Campo | Descrição | -|-------|-----------| -| `key` | ID do campo (ex: `field_xxx`) | -| `value` | Valor a comparar | -| `type` | Tipo de dados: `TEXT`, `NUMBER`, `DATE`, etc. | -| `operator` | Operador: `eq`, `like`, `gt`, `gte`, `lt`, `lte`, `in`, `range` | -| `componentName` | Tipo de componente: `TextField`, `NumberField`, `DateField`, etc. | - -Exemplo: - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### Exemplo de script de operação em lote - -```bash -#!/bin/bash -# Exportar dados de formulário em lote - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # Processar dados da página atual - echo "$RESULT" >> ./export.json - - # Verificar se há próxima página - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## Notas - - - As operações de dados são permanentes, as operações de atualização não podem ser desfeitas. Recomenda-se realizar testes em pequena escala antes de executar operações em lote. - - - - A consulta paginada tem um valor padrão de 20 registros por página, máximo 100. Para exportar grandes quantidades de dados, recomenda-se usar loop de paginação. - diff --git a/vi/features/data-management.mdx b/vi/features/data-management.mdx deleted file mode 100644 index e08858e..0000000 --- a/vi/features/data-management.mdx +++ /dev/null @@ -1,248 +0,0 @@ ---- -title: "Quản lý dữ liệu" -description: "Giao diện quản lý dữ liệu thống nhất, hỗ trợ thao tác dữ liệu biểu mẫu, quy trình, tác vụ, biểu mẫu con, v.v." -icon: "database" ---- - -OpenYida cung cấp CLI quản lý dữ liệu thống nhất, hỗ trợ thao tác hoàn chỉnh cho dữ liệu biểu mẫu, phiên bản quy trình, tác vụ, biểu mẫu con, v.v. - ---- - -## Tổng quan - - - - Truy vấn, tạo, cập nhật dữ liệu phiên bản biểu mẫu. - - - Quản lý phiên bản quy trình, bản ghi phê duyệt, trạng thái quy trình. - - - Truy vấn tác vụ đang chờ, đã hoàn thành, do tôi gửi, CC cho tôi. - - - Truy vấn và quản lý dữ liệu biểu mẫu con độc lập. - - - ---- - -## Định dạng lệnh - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **resource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## Quản lý dữ liệu biểu mẫu - -### Truy vấn dữ liệu biểu mẫu - -```bash -# Truy vấn cơ bản -openyida data query form - -# Truy vấn phân trang -openyida data query form --page 1 --size 50 - -# Truy vấn có điều kiện -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# Truy vấn phiên bản cụ thể -openyida data query form --inst-id - -# Chỉ trả về ID -openyida data query form --ids-only -``` - -### Lấy một bản ghi - -```bash -openyida data get form --inst-id -``` - -### Tạo dữ liệu - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### Cập nhật dữ liệu - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## Quản lý dữ liệu quy trình - -### Truy vấn phiên bản quy trình - -```bash -# Truy vấn danh sách quy trình -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# Trạng thái khả dụng: RUNNING (đang chạy), COMPLETED (đã hoàn thành), TERMINATED (đã chấm dứt) - -# Chỉ trả về ID -openyida data query process --ids-only -``` - -### Lấy chi tiết quy trình - -```bash -openyida data get process --process-inst-id -``` - -### Tạo phiên bản quy trình - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### Cập nhật phiên bản quy trình - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### Truy vấn bản ghi phê duyệt - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## Quản lý tác vụ - - - Để truy vấn dữ liệu trung tâm tác vụ toàn cục mà không cần chỉ định `appType`, hãy sử dụng lệnh `openyida task-center`. Xem [tham chiếu CLI](/vi/features/skills#trung-tâm-tác-vụ-toàn-cục). - - -### Truy vấn danh sách tác vụ - -```bash -# Tác vụ đang chờ -openyida data query tasks --type todo - -# Tác vụ đã hoàn thành -openyida data query tasks --type done - -# Do tôi gửi -openyida data query tasks --type submitted - -# CC cho tôi -openyida data query tasks --type cc -``` - -### Thực thi tác vụ - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "Đã đồng ý, vui lòng tiếp tục" \ - --data-json '{"comment": "Phê duyệt đã thông qua"}' -``` - -**Tùy chọn out-result:** -- `AGREE` - Đồng ý -- `DISAGREE` - Không đồng ý - ---- - -## Quản lý biểu mẫu con - -### Truy vấn dữ liệu biểu mẫu con - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## Sử dụng nâng cao - -### Định dạng điều kiện truy vấn - -Tham số `--search-json` chấp nhận định dạng truy vấn dựa trên mảng. Mỗi điều kiện là một đối tượng với các trường sau: - -| Trường | Mô tả | -|--------|-------| -| `key` | ID trường (vd: `field_xxx`) | -| `value` | Giá trị để so khớp | -| `type` | Kiểu dữ liệu: `TEXT`, `NUMBER`, `DATE`, v.v. | -| `operator` | Toán tử: `eq`, `like`, `gt`, `gte`, `lt`, `lte`, `in`, `range` | -| `componentName` | Loại component: `TextField`, `NumberField`, `DateField`, v.v. | - -Ví dụ: - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### Ví dụ script thao tác hàng loạt - -```bash -#!/bin/bash -# Xuất dữ liệu biểu mẫu hàng loạt - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # Xử lý dữ liệu trang hiện tại - echo "$RESULT" >> ./export.json - - # Kiểm tra xem có trang tiếp theo không - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## Lưu ý - - - Thao tác dữ liệu là vĩnh viễn, thao tác cập nhật không thể hoàn tác. Khuyến nghị thực hiện thử nghiệm quy mô nhỏ trước khi thực hiện thao tác hàng loạt. - - - - Truy vấn phân trang mặc định 20 bản ghi mỗi trang, tối đa 100. Để xuất lượng lớn dữ liệu, khuyến nghị sử dụng vòng lặp phân trang. - diff --git a/zh-Hant/features/data-management.mdx b/zh-Hant/features/data-management.mdx deleted file mode 100644 index ca3aadf..0000000 --- a/zh-Hant/features/data-management.mdx +++ /dev/null @@ -1,248 +0,0 @@ ---- -title: "數據管理" -description: "統一的數據管理接口，支持表單、流程、任務、子表單等數據操作。" -icon: "database" ---- - -OpenYida 提供統一的數據管理 CLI，支持對錶單數據、流程實例、任務、子表單等進行完整的操作。 - ---- - -## 功能概述 - - - - 查詢、創建、更新表單實例數據。 - - - 管理流程實例、審批記錄、流程狀態。 - - - 查詢待辦、已辦、我提交的、抄送我的任務。 - - - 獨立查詢和管理子表單數據。 - - - ---- - -## 命令格式 - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **resource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## 表單數據管理 - -### 查詢表單數據 - -```bash -# 基本查詢 -openyida data query form - -# 分頁查詢 -openyida data query form --page 1 --size 50 - -# 條件查詢 -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# 查詢指定實例 -openyida data query form --inst-id - -# 僅返回實例 ID -openyida data query form --ids-only -``` - -### 獲取單條數據 - -```bash -openyida data get form --inst-id -``` - -### 創建數據 - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### 更新數據 - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## 流程數據管理 - -### 查詢流程實例 - -```bash -# 查詢流程列表 -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# 狀態可選：RUNNING（進行中）、COMPLETED（已完成）、TERMINATED（已終止） - -# 僅返回實例 ID -openyida data query process --ids-only -``` - -### 獲取流程詳情 - -```bash -openyida data get process --process-inst-id -``` - -### 創建流程實例 - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### 更新流程實例 - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### 查詢審批記錄 - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## 任務管理 - - - 如果你需要查詢跨應用的全域任務中心資料（無需指定 `appType`），請使用 `openyida task-center` 命令。詳見 [CLI 參考](/zh-Hant/features/skills#全域任務中心)。 - - -### 查詢任務列表 - -```bash -# 待辦任務 -openyida data query tasks --type todo - -# 已辦任務 -openyida data query tasks --type done - -# 我提交的 -openyida data query tasks --type submitted - -# 抄送我的 -openyida data query tasks --type cc -``` - -### 執行任務 - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "同意，請繼續推進" \ - --data-json '{"comment": "審批通過"}' -``` - -**out-result 選項：** -- `AGREE` - 同意 -- `DISAGREE` - 不同意 - ---- - -## 子表單管理 - -### 查詢子表單數據 - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## 高級用法 - -### 查詢條件格式 - -`--search-json` 參數接受數組格式的查詢條件。每個條件是一個包含以下欄位的物件： - -| 欄位 | 說明 | -|------|------| -| `key` | 欄位 ID（如 `field_xxx`） | -| `value` | 匹配值 | -| `type` | 數據類型：`TEXT`、`NUMBER`、`DATE` 等 | -| `operator` | 操作符：`eq`、`like`、`gt`、`gte`、`lt`、`lte`、`in`、`range` | -| `componentName` | 組件類型：`TextField`、`NumberField`、`DateField` 等 | - -示例： - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### 批量操作腳本示例 - -```bash -#!/bin/bash -# 批量導出表單數據 - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # 處理當前頁數據 - echo "$RESULT" >> ./export.json - - # 檢查是否還有下一頁 - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## 注意事項 - - - 數據操作具有永久性，更新操作不可撤銷。建議在執行批量操作前先進行小規模測試。 - - - - 分頁查詢默認每頁 20 條，最大支持 100 條。大量數據導出建議使用循環分頁獲取。 - diff --git a/zh/features/data-management.mdx b/zh/features/data-management.mdx deleted file mode 100644 index 219a1f8..0000000 --- a/zh/features/data-management.mdx +++ /dev/null @@ -1,248 +0,0 @@ ---- -title: "数据管理" -description: "统一的数据管理接口，支持表单、流程、任务、子表单等数据操作。" -icon: "database" ---- - -OpenYida 提供统一的数据管理 CLI，支持对表单数据、流程实例、任务、子表单等进行完整的操作。 - ---- - -## 功能概述 - - - - 查询、创建、更新表单实例数据。 - - - 管理流程实例、审批记录、流程状态。 - - - 查询待办、已办、我提交的、抄送我的任务。 - - - 独立查询和管理子表单数据。 - - - ---- - -## 命令格式 - -```bash -openyida data [args] -``` - -- **action**: `query` | `get` | `create` | `update` | `execute` -- **resource**: `form` | `process` | `task` | `subform` | `operation-records` - ---- - -## 表单数据管理 - -### 查询表单数据 - -```bash -# 基本查询 -openyida data query form - -# 分页查询 -openyida data query form --page 1 --size 50 - -# 条件查询 -openyida data query form \ - --search-json '[{"key":"field_xxx","value":"value","type":"TEXT","operator":"eq","componentName":"TextField"}]' - -# 查询指定实例 -openyida data query form --inst-id - -# 仅返回实例 ID -openyida data query form --ids-only -``` - -### 获取单条数据 - -```bash -openyida data get form --inst-id -``` - -### 创建数据 - -```bash -openyida data create form \ - --data-json '{"field_xxx": "value", "field_yyy": 123}' \ - --dept-id -``` - -### 更新数据 - -```bash -openyida data update form \ - --inst-id \ - --data-json '{"field_xxx": "new value"}' \ - --use-latest-version y -``` - ---- - -## 流程数据管理 - -### 查询流程实例 - -```bash -# 查询流程列表 -openyida data query process \ - --page 1 --size 20 \ - --instance-status RUNNING - -# 状态可选：RUNNING（进行中）、COMPLETED（已完成）、TERMINATED（已终止） - -# 仅返回实例 ID -openyida data query process --ids-only -``` - -### 获取流程详情 - -```bash -openyida data get process --process-inst-id -``` - -### 创建流程实例 - -```bash -openyida data create process \ - --process-code \ - --data-json '{"field_xxx": "value"}' \ - --dept-id -``` - -### 更新流程实例 - -```bash -openyida data update process \ - --process-inst-id \ - --data-json '{"field_xxx": "updated value"}' -``` - -### 查询审批记录 - -```bash -openyida data query operation-records \ - --process-inst-id -``` - ---- - -## 任务管理 - - - 如果你需要查询跨应用的全局任务中心数据（无需指定 `appType`），请使用 `openyida task-center` 命令。详见 [CLI 参考](/zh/features/skills#全局任务中心)。 - - -### 查询任务列表 - -```bash -# 待办任务 -openyida data query tasks --type todo - -# 已办任务 -openyida data query tasks --type done - -# 我提交的 -openyida data query tasks --type submitted - -# 抄送我的 -openyida data query tasks --type cc -``` - -### 执行任务 - -```bash -openyida data execute task \ - --task-id \ - --process-inst-id \ - --out-result AGREE \ - --remark "同意，请继续推进" \ - --data-json '{"comment": "审批通过"}' -``` - -**out-result 选项：** -- `AGREE` - 同意 -- `DISAGREE` - 不同意 - ---- - -## 子表单管理 - -### 查询子表单数据 - -```bash -openyida data query subform \ - --inst-id \ - --table-field-id \ - --page 1 --size 20 -``` - ---- - -## 高级用法 - -### 查询条件格式 - -`--search-json` 参数接受数组格式的查询条件。每个条件是一个包含以下字段的对象： - -| 字段 | 说明 | -|------|------| -| `key` | 字段 ID（如 `field_xxx`） | -| `value` | 匹配值 | -| `type` | 数据类型：`TEXT`、`NUMBER`、`DATE` 等 | -| `operator` | 操作符：`eq`、`like`、`gt`、`gte`、`lt`、`lte`、`in`、`range` | -| `componentName` | 组件类型：`TextField`、`NumberField`、`DateField` 等 | - -示例： - -```bash -openyida data query form \ - --search-json '[ - {"key":"field_status","value":"approved","type":"TEXT","operator":"eq","componentName":"TextField"}, - {"key":"field_amount","value":"1000","type":"NUMBER","operator":"gte","componentName":"NumberField"} - ]' -``` - -### 批量操作脚本示例 - -```bash -#!/bin/bash -# 批量导出表单数据 - -APP_TYPE="APP_XXXXXXXX" -FORM_UUID="FORM-XXXX-XXXX" -PAGE=1 - -while true; do - RESULT=$(openyida data query form $APP_TYPE $FORM_UUID --page $PAGE --size 100) - - # 处理当前页数据 - echo "$RESULT" >> ./export.json - - # 检查是否还有下一页 - HAS_MORE=$(echo "$RESULT" | jq '.hasMore') - if [ "$HAS_MORE" != "true" ]; then - break - fi - - PAGE=$((PAGE + 1)) -done -``` - ---- - -## 注意事项 - - - 数据操作具有永久性，更新操作不可撤销。建议在执行批量操作前先进行小规模测试。 - - - - 分页查询默认每页 20 条，最大支持 100 条。大量数据导出建议使用循环分页获取。 -