diff --git a/ar/features/skills.mdx b/ar/features/skills.mdx index 8abb53e..b640789 100644 --- a/ar/features/skills.mdx +++ b/ar/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process --rules --- +## التكامل والأتمتة + +إنشاء وإدارة تدفقات المنطق (التكامل والأتمتة) مع مشغلات أحداث النموذج والإشعارات وعمليات البيانات. + +```bash +# إنشاء تدفق منطقي +openyida integration create [خيارات] +``` + +### المعلمات + +| المعلمة | مطلوب | الوصف | +|---------|-------|-------| +| `appType` | نعم | معرف التطبيق (مثال: `APP_XXXX`) | +| `formUuid` | نعم | UUID نموذج المشغل (مثال: `FORM-XXXX`) | +| `flowName` | نعم | اسم تدفق المنطق | + +### الخيارات + +| الخيار | الافتراضي | الوصف | +|--------|-----------|-------| +| `--process-code ` | تلقائي | processCode موجود (`LPROC-xxx`) | +| `--receivers ` | فارغ | معرفات المستخدمين لإشعارات DingTalk (مفصولة بفواصل) | +| `--title ` | مثل flowName | عنوان الإشعار، يدعم `#{fieldId-ComponentType}#` | +| `--content <content>` | `"تم إرسال سجل جديد"` | محتوى الإشعار | +| `--events <insert,update>` | `insert` | أحداث المشغل: `insert`/`update`/`delete`/`comment` | +| `--add-data-form-uuid <formUuid>` | — | UUID النموذج المستهدف لعقدة إضافة البيانات | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | تعيين الحقل (قابل للتحديد عدة مرات). `valueType`: `processVar`/`literal`/`column` | +| `--publish` | غير منشور | النشر فوراً بعد الحفظ | + +### المخرجات + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "إشعار سجل جديد", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + يجب تسجيل الدخول قبل تنفيذ هذا الأمر. مع `--publish`، سيكون `published` هو `true`؛ في حالة الفشل، سيكون `published` هو `false` مع حقل `warning`. +</Info> + +--- + ## إدارة الأذونات ```bash diff --git a/ar/introduction/overview.mdx b/ar/introduction/overview.mdx index ca08f95..d574a9a 100644 --- a/ar/introduction/overview.mdx +++ b/ar/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **إدارة النماذج** | إنشاء/تحديث النماذج، الحصول على Schema، تكوين الأذونات | | **نشر الصفحات** | تطوير الصفحات المخصصة، تجميع Babel، نشر بضغطة واحدة | | **تكوين العمليات** | إنشاء نماذج العمليات، تكوين قواعد الموافقة | +| **التكامل والأتمتة** | إنشاء وإدارة تدفقات المنطق، مشغلات أحداث النماذج، الإشعارات، عمليات البيانات عبر النماذج | | **إدارة البيانات** | استعلام بيانات النماذج، مثيلات العمليات، إدارة المهام | | **الموصلات** | إنشاء موصل HTTP، تكامل API، استيراد ذكي لـ curl | | **التقارير والرسوم البيانية** | إنشاء تقارير Yida، إضافة الرسوم البيانية، تصور البيانات | diff --git a/de/features/skills.mdx b/de/features/skills.mdx index cf5fff1..ce39652 100644 --- a/de/features/skills.mdx +++ b/de/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process <appType> <formUuid> --rules <RegelnJSON> --- +## Integration und Automatisierung + +Erstellen und verwalten Sie Logikflows (Integration & Automatisierung) mit Formular-Event-Triggern, Benachrichtigungen und Datenoperationen. + +```bash +# Logikflow erstellen +openyida integration create <appType> <formUuid> <flowName> [Optionen] +``` + +### Parameter + +| Parameter | Erforderlich | Beschreibung | +|-----------|-------------|--------------| +| `appType` | Ja | App-ID (z.B. `APP_XXXX`) | +| `formUuid` | Ja | Trigger-Formular-UUID (z.B. `FORM-XXXX`) | +| `flowName` | Ja | Name des Logikflows | + +### Optionen + +| Option | Standard | Beschreibung | +|--------|----------|--------------| +| `--process-code <code>` | Automatisch generiert | Bestehender processCode (`LPROC-xxx`) | +| `--receivers <userId,...>` | Leer | Benutzer-IDs für DingTalk-Benachrichtigungen (kommagetrennt) | +| `--title <title>` | Gleich wie flowName | Benachrichtigungstitel, unterstützt `#{fieldId-ComponentType}#` | +| `--content <content>` | `"Neuer Datensatz eingereicht"` | Benachrichtigungsinhalt | +| `--events <insert,update>` | `insert` | Trigger-Ereignisse: `insert`/`update`/`delete`/`comment` | +| `--add-data-form-uuid <formUuid>` | — | Zielformular-UUID für Datenerstellungsknoten | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | Feldzuweisung (mehrfach angebbar). `valueType`: `processVar`/`literal`/`column` | +| `--publish` | Nicht veröffentlicht | Sofort nach Speichern veröffentlichen | + +### Ausgabe + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "Neue Datensatz-Benachrichtigung", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + Sie müssen angemeldet sein, bevor Sie diesen Befehl ausführen. Mit `--publish` wird `published` auf `true` gesetzt; bei Fehler wird `published` `false` mit einem `warning`-Feld. +</Info> + +--- + ## Berechtigungsverwaltung ```bash diff --git a/de/introduction/overview.mdx b/de/introduction/overview.mdx index 1747ca4..4cc82b7 100644 --- a/de/introduction/overview.mdx +++ b/de/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **Formularverwaltung** | Erstellung/Aktualisierung von Formularen, Schema-Abfrage, Berechtigungskonfiguration | | **Seitenveröffentlichung** | Entwicklung benutzerdefinierter Seiten, Babel-Kompilierung, Ein-Klick-Veröffentlichung | | **Prozesskonfiguration** | Erstellung von Prozessformularen, Konfiguration von Genehmigungsregeln | +| **Integration und Automatisierung** | Erstellung und Verwaltung von Logikflows, Formular-Event-Trigger, Benachrichtigungen, formularübergreifende Datenoperationen | | **Datenverwaltung** | Formulardatenabfragen, Prozessinstanzen, Aufgabenverwaltung | | **Konnektoren** | HTTP-Konnektor-Erstellung, API-Integration, intelligenter curl-Import | | **Berichte und Diagramme** | Yida-Berichtserstellung, Diagramm-Anfügung, Datenvisualisierung | diff --git a/en/features/skills.mdx b/en/features/skills.mdx index 897b5f1..04494bf 100644 --- a/en/features/skills.mdx +++ b/en/features/skills.mdx @@ -246,6 +246,90 @@ openyida configure-process <appType> <formUuid> --rules <rulesJSON> --- +## Integration & automation + +Create and manage logicflows (integration & automation) that support form event triggers, message notifications, data operations, and more. + +```bash +# Create a logicflow +openyida integration create <appType> <formUuid> <flowName> [options] +``` + +### Parameters + +| Parameter | Required | Description | +|-----------|----------|-------------| +| `appType` | Yes | Application ID, e.g. `APP_XXXX` | +| `formUuid` | Yes | Trigger form UUID, e.g. `FORM-XXXX` | +| `flowName` | Yes | Logicflow name | + +### Options + +| Option | Default | Description | +|--------|---------|-------------| +| `--process-code <code>` | Auto-generated | Existing logicflow processCode (`LPROC-xxx` format) | +| `--receivers <userId,...>` | Empty | User IDs for DingTalk work notifications, comma-separated | +| `--title <title>` | Same as flowName | Notification title, supports `#{fieldId-ComponentType}#` field references | +| `--content <content>` | `"New form record submitted"` | Notification content, supports field variable references | +| `--events <insert,update>` | `insert` | Trigger events: `insert`/`update`/`delete`/`comment`, comma-separated | +| `--data-form-uuid <formUuid>` | — | Target form UUID for the get-single-data node | +| `--data-condition <bFieldId:bFieldName:aFieldId[:componentType]>` | — | Filter condition for get-single-data, can be specified multiple times | +| `--add-data-form-uuid <formUuid>` | — | Target form UUID for the add-data node | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | Field assignment for add-data, can be specified multiple times. `valueType`: `processVar`/`literal`/`column` | +| `--publish` | Not published | Publish immediately after saving; otherwise saves as draft only | + +### Examples + +```bash +# Notify users when a form record is created +openyida integration create APP_XXX FORM-XXX "New record notification" \ + --receivers user123 \ + --title "New record submitted" \ + --content "A new form record has been submitted." + +# Reference form field variables, save and publish +openyida integration create APP_XXX FORM-XXX "Record change notification" \ + --receivers user123,user456 \ + --events insert,update,delete,comment \ + --publish + +# Sync data from form A to form B with an add-data node +openyida integration create APP_XXX FORM-A-XXX "Sync to form B" \ + --add-data-form-uuid FORM-B-XXX \ + --add-data-assignment "textField_b1:processVar:textField_a1" \ + --add-data-assignment "numberField_b2:literal:0" \ + --publish +``` + +### Field variable references + +Use `#{fieldId-ComponentType}#` in notification titles and content to reference trigger form field values: + +``` +#{textField_mmq4ldti-TextField}# +#{numberField_abc123-NumberField}# +``` + +### Output + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "New record notification", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + You must be logged in before running this command. When `--publish` is used, `published` will be `true`; if publishing fails, `published` will be `false` with a `warning` field. +</Info> + +--- + ## Permission management ```bash diff --git a/en/introduction/overview.mdx b/en/introduction/overview.mdx index 22965bb..bb89c86 100644 --- a/en/introduction/overview.mdx +++ b/en/introduction/overview.mdx @@ -99,6 +99,7 @@ The AI will use OpenYida commands to build it. - **Form Builders** — Generate complex forms with validation and workflows - **Landing Pages** — Build custom showcase pages with JSX - **Process Automation** — Design approval workflows and business processes +- **Integration & Automation** — Create logicflows with form event triggers, notifications, and cross-form data operations --- diff --git a/es/features/skills.mdx b/es/features/skills.mdx index c04e1ce..34bddc1 100644 --- a/es/features/skills.mdx +++ b/es/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process <appType> <formUuid> --rules <reglasJSON> --- +## Integración y automatización + +Cree y gestione flujos lógicos (integración y automatización) con disparadores de eventos de formulario, notificaciones y operaciones de datos. + +```bash +# Crear un flujo lógico +openyida integration create <appType> <formUuid> <flowName> [opciones] +``` + +### Parámetros + +| Parámetro | Obligatorio | Descripción | +|-----------|-------------|-------------| +| `appType` | Sí | ID de la aplicación (ej: `APP_XXXX`) | +| `formUuid` | Sí | UUID del formulario disparador (ej: `FORM-XXXX`) | +| `flowName` | Sí | Nombre del flujo lógico | + +### Opciones + +| Opción | Predeterminado | Descripción | +|--------|---------------|-------------| +| `--process-code <code>` | Autogenerado | processCode existente (`LPROC-xxx`) | +| `--receivers <userId,...>` | Vacío | IDs de usuario para notificaciones DingTalk (separados por comas) | +| `--title <title>` | Igual que flowName | Título de notificación, soporta `#{fieldId-ComponentType}#` | +| `--content <content>` | `"Nuevo registro enviado"` | Contenido de la notificación | +| `--events <insert,update>` | `insert` | Eventos disparadores: `insert`/`update`/`delete`/`comment` | +| `--add-data-form-uuid <formUuid>` | — | UUID del formulario destino para el nodo de agregar datos | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | Asignación de campo (especificable múltiples veces). `valueType`: `processVar`/`literal`/`column` | +| `--publish` | No publicado | Publicar inmediatamente después de guardar | + +### Salida + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "Notificación de nuevo registro", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + Debe iniciar sesión antes de ejecutar este comando. Con `--publish`, `published` será `true`; si falla, `published` será `false` con un campo `warning`. +</Info> + +--- + ## Gestión de permisos ```bash diff --git a/es/introduction/overview.mdx b/es/introduction/overview.mdx index 617313d..a86ba81 100644 --- a/es/introduction/overview.mdx +++ b/es/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **Gestión de formularios** | Creación/actualización de formularios, obtención de esquema, configuración de permisos | | **Publicación de páginas** | Desarrollo de páginas personalizadas, compilación Babel, publicación con un clic | | **Configuración de flujos** | Creación de formularios de flujo, configuración de reglas de aprobación | +| **Integración y automatización** | Creación y gestión de flujos lógicos, disparadores de eventos de formulario, notificaciones, operaciones de datos entre formularios | | **Gestión de datos** | Consulta de datos de formularios, instancias de flujo, gestión de tareas | | **Conectores** | Creación de conectores HTTP, integración de API, importación inteligente curl | | **Informes y gráficos** | Creación de informes Yida, adición de gráficos, visualización de datos | diff --git a/fr/features/skills.mdx b/fr/features/skills.mdx index 0444201..e8dc0f3 100644 --- a/fr/features/skills.mdx +++ b/fr/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process <appType> <formUuid> --rules <règlesJSON> --- +## Intégration et automatisation + +Créez et gérez des flux logiques (intégration et automatisation) prenant en charge les déclencheurs d'événements de formulaire, les notifications et les opérations de données. + +```bash +# Créer un flux logique +openyida integration create <appType> <formUuid> <flowName> [options] +``` + +### Paramètres + +| Paramètre | Obligatoire | Description | +|-----------|-------------|-------------| +| `appType` | Oui | ID de l'application (ex : `APP_XXXX`) | +| `formUuid` | Oui | UUID du formulaire déclencheur (ex : `FORM-XXXX`) | +| `flowName` | Oui | Nom du flux logique | + +### Options + +| Option | Défaut | Description | +|--------|--------|-------------| +| `--process-code <code>` | Auto-généré | processCode existant (`LPROC-xxx`) | +| `--receivers <userId,...>` | Vide | ID utilisateurs pour notifications DingTalk (séparés par virgules) | +| `--title <title>` | Identique à flowName | Titre de notification, supporte `#{fieldId-ComponentType}#` | +| `--content <content>` | `"Nouvel enregistrement soumis"` | Contenu de la notification | +| `--events <insert,update>` | `insert` | Événements déclencheurs : `insert`/`update`/`delete`/`comment` | +| `--add-data-form-uuid <formUuid>` | — | UUID du formulaire cible pour le nœud d'ajout de données | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | Attribution de champ (spécifiable plusieurs fois). `valueType` : `processVar`/`literal`/`column` | +| `--publish` | Non publié | Publier immédiatement après l'enregistrement | + +### Sortie + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "Notification de nouvel enregistrement", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + Vous devez être connecté avant d'exécuter cette commande. Avec `--publish`, `published` sera `true` ; en cas d'échec, `published` sera `false` avec un champ `warning`. +</Info> + +--- + ## Gestion des permissions ```bash diff --git a/fr/introduction/overview.mdx b/fr/introduction/overview.mdx index 561a8aa..d9ad552 100644 --- a/fr/introduction/overview.mdx +++ b/fr/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **Gestion des formulaires** | Création/mise à jour de formulaires, récupération du Schema, configuration des permissions | | **Publication de pages** | Développement de pages personnalisées, compilation Babel, publication en un clic | | **Configuration des processus** | Création de formulaires de processus, configuration des règles d'approbation | +| **Intégration et automatisation** | Création et gestion de flux logiques, déclencheurs d'événements de formulaire, notifications, opérations de données inter-formulaires | | **Gestion des données** | Requêtes de données de formulaire, instances de processus, gestion des tâches | | **Connecteurs** | Création de connecteurs HTTP, intégration API, import intelligent curl | | **Rapports et graphiques** | Création de rapports Yida, ajout de graphiques, visualisation des données | diff --git a/hi/features/skills.mdx b/hi/features/skills.mdx index 40f12d1..2da43e4 100644 --- a/hi/features/skills.mdx +++ b/hi/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process <appType> <formUuid> --rules <नियमJSON> --- +## एकीकरण और स्वचालन + +फॉर्म इवेंट ट्रिगर, सूचनाएं और डेटा ऑपरेशन के साथ लॉजिकफ्लो (एकीकरण और स्वचालन) बनाएं और प्रबंधित करें। + +```bash +# लॉजिकफ्लो बनाएं +openyida integration create <appType> <formUuid> <flowName> [विकल्प] +``` + +### पैरामीटर + +| पैरामीटर | आवश्यक | विवरण | +|---------|--------|-------| +| `appType` | हाँ | ऐप ID (उदा: `APP_XXXX`) | +| `formUuid` | हाँ | ट्रिगर फॉर्म UUID (उदा: `FORM-XXXX`) | +| `flowName` | हाँ | लॉजिकफ्लो नाम | + +### विकल्प + +| विकल्प | डिफ़ॉल्ट | विवरण | +|--------|---------|-------| +| `--process-code <code>` | स्वचालित | मौजूदा processCode (`LPROC-xxx`) | +| `--receivers <userId,...>` | खाली | DingTalk सूचना प्राप्तकर्ता उपयोगकर्ता ID (अल्पविराम से अलग) | +| `--title <title>` | flowName जैसा | सूचना शीर्षक, `#{fieldId-ComponentType}#` समर्थित | +| `--content <content>` | `"नया रिकॉर्ड सबमिट किया गया"` | सूचना सामग्री | +| `--events <insert,update>` | `insert` | ट्रिगर इवेंट: `insert`/`update`/`delete`/`comment` | +| `--add-data-form-uuid <formUuid>` | — | डेटा जोड़ने के नोड का लक्ष्य फॉर्म UUID | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | फ़ील्ड असाइनमेंट (कई बार निर्दिष्ट किया जा सकता है)। `valueType`: `processVar`/`literal`/`column` | +| `--publish` | प्रकाशित नहीं | सहेजने के बाद तुरंत प्रकाशित करें | + +### आउटपुट + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "नया रिकॉर्ड सूचना", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + इस कमांड को चलाने से पहले लॉगिन आवश्यक है। `--publish` के साथ `published` `true` होगा; विफलता पर `published` `false` होगा और `warning` फ़ील्ड शामिल होगा। +</Info> + +--- + ## अनुमति प्रबंधन ```bash diff --git a/hi/introduction/overview.mdx b/hi/introduction/overview.mdx index 47657ed..efc30da 100644 --- a/hi/introduction/overview.mdx +++ b/hi/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **फ़ॉर्म प्रबंधन** | फ़ॉर्म बनाना/अपडेट करना, Schema प्राप्त करना, अनुमति कॉन्फ़िगर करना | | **पेज प्रकाशित करना** | कस्टम पेज विकास, Babel संकलन, एक-क्लिक प्रकाशन | | **प्रक्रिया कॉन्फ़िगरेशन** | प्रक्रिया फ़ॉर्म बनाना, अनुमोदन नियम कॉन्फ़िगर करना | +| **एकीकरण और स्वचालन** | लॉजिकफ्लो बनाना और प्रबंधित करना, फ़ॉर्म इवेंट ट्रिगर, सूचनाएं, क्रॉस-फ़ॉर्म डेटा ऑपरेशन | | **डेटा प्रबंधन** | फ़ॉर्म डेटा क्वेरी, प्रक्रिया उदाहरण, कार्य प्रबंधन | | **कनेक्टर** | HTTP कनेक्टर बनाना, API एकीकरण, curl स्मार्ट आयात | | **रिपोर्ट और चार्ट** | Yida रिपोर्ट बनाना, चार्ट जोड़ना, डेटा विज़ुअलाइज़ेशन | diff --git a/ja/features/skills.mdx b/ja/features/skills.mdx index aec307f..8a95de0 100644 --- a/ja/features/skills.mdx +++ b/ja/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process <appType> <formUuid> --rules <rulesJSON> --- +## 統合と自動化 + +ロジックフロー（統合&自動化）を作成・管理します。フォームイベントトリガー、メッセージ通知、データ操作などをサポートします。 + +```bash +# ロジックフローを作成 +openyida integration create <appType> <formUuid> <flowName> [オプション] +``` + +### パラメータ + +| パラメータ | 必須 | 説明 | +|-----------|------|------| +| `appType` | はい | アプリID（例：`APP_XXXX`） | +| `formUuid` | はい | トリガーフォームUUID（例：`FORM-XXXX`） | +| `flowName` | はい | ロジックフロー名 | + +### オプション + +| オプション | デフォルト | 説明 | +|-----------|-----------|------| +| `--process-code <code>` | 自動生成 | 既存のロジックフローprocessCode（`LPROC-xxx`形式） | +| `--receivers <userId,...>` | 空 | DingTalk通知の受信者ユーザーID（カンマ区切り） | +| `--title <title>` | flowNameと同じ | 通知タイトル、`#{fieldId-ComponentType}#`でフィールド参照可能 | +| `--content <content>` | `"新しいレコードが送信されました"` | 通知内容、フィールド変数参照可能 | +| `--events <insert,update>` | `insert` | トリガーイベント：`insert`/`update`/`delete`/`comment`（カンマ区切り） | +| `--add-data-form-uuid <formUuid>` | — | データ追加ノードの対象フォームUUID | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | データ追加のフィールド代入（複数指定可）。`valueType`：`processVar`/`literal`/`column` | +| `--publish` | 未公開 | 保存後すぐに公開、指定しない場合は下書きのみ | + +### 出力 + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "新しいレコード通知", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + このコマンドを実行する前にログインが必要です。`--publish`使用時は`published`が`true`になります。公開に失敗した場合は`published`が`false`で`warning`フィールドが付与されます。 +</Info> + +--- + ## 権限管理 ```bash diff --git a/ja/introduction/overview.mdx b/ja/introduction/overview.mdx index f768d7d..96f3524 100644 --- a/ja/introduction/overview.mdx +++ b/ja/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **フォーム管理** | フォーム作成/更新、Schema取得、権限設定 | | **ページ公開** | カスタムページ開発、Babelコンパイル、ワンクリック公開 | | **プロセス設定** | プロセスフォーム作成、承認ルール設定 | +| **統合と自動化** | ロジックフローの作成と管理、フォームイベントトリガー、通知、クロスフォームデータ操作 | | **データ管理** | フォームデータクエリ、プロセスインスタンス、タスク管理 | | **コネクタ** | HTTPコネクタ作成、API統合、curlスマートインポート | | **レポート・チャート** | Yidaレポート作成、チャート追加、データ可視化 | diff --git a/ko/features/skills.mdx b/ko/features/skills.mdx index 0fea299..11f1d16 100644 --- a/ko/features/skills.mdx +++ b/ko/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process <appType> <formUuid> --rules <rulesJSON> --- +## 통합 및 자동화 + +로직플로우(통합 및 자동화)를 생성하고 관리합니다. 양식 이벤트 트리거, 메시지 알림, 데이터 작업 등을 지원합니다. + +```bash +# 로직플로우 생성 +openyida integration create <appType> <formUuid> <flowName> [옵션] +``` + +### 매개변수 + +| 매개변수 | 필수 | 설명 | +|---------|------|------| +| `appType` | 예 | 앱 ID (예: `APP_XXXX`) | +| `formUuid` | 예 | 트리거 양식 UUID (예: `FORM-XXXX`) | +| `flowName` | 예 | 로직플로우 이름 | + +### 옵션 + +| 옵션 | 기본값 | 설명 | +|------|--------|------| +| `--process-code <code>` | 자동 생성 | 기존 로직플로우의 processCode (`LPROC-xxx` 형식) | +| `--receivers <userId,...>` | 비어있음 | DingTalk 알림 수신자 사용자 ID (쉼표 구분) | +| `--title <title>` | flowName과 동일 | 알림 제목, `#{fieldId-ComponentType}#`으로 필드 참조 가능 | +| `--content <content>` | `"새 레코드가 제출되었습니다"` | 알림 내용, 필드 변수 참조 가능 | +| `--events <insert,update>` | `insert` | 트리거 이벤트: `insert`/`update`/`delete`/`comment` (쉼표 구분) | +| `--add-data-form-uuid <formUuid>` | — | 데이터 추가 노드의 대상 양식 UUID | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | 데이터 추가 필드 할당 (여러 번 지정 가능). `valueType`: `processVar`/`literal`/`column` | +| `--publish` | 게시 안 함 | 저장 후 즉시 게시, 그렇지 않으면 초안으로만 저장 | + +### 출력 + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "새 레코드 알림", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + 이 명령을 실행하기 전에 로그인이 필요합니다. `--publish` 사용 시 `published`가 `true`가 됩니다. 게시 실패 시 `published`가 `false`이며 `warning` 필드가 포함됩니다. +</Info> + +--- + ## 권한 관리 ```bash diff --git a/ko/introduction/overview.mdx b/ko/introduction/overview.mdx index 4279ff0..8daaba7 100644 --- a/ko/introduction/overview.mdx +++ b/ko/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **양식 관리** | 양식 생성/업데이트, Schema 가져오기, 권한 구성 | | **페이지 게시** | 사용자 정의 페이지 개발, Babel 컴파일, 원클릭 게시 | | **프로세스 구성** | 프로세스 양식 생성, 승인 규칙 구성 | +| **통합 및 자동화** | 로직플로우 생성 및 관리, 양식 이벤트 트리거, 알림, 교차 양식 데이터 작업 | | **데이터 관리** | 양식 데이터 쿼리, 프로세스 인스턴스, 작업 관리 | | **커넥터** | HTTP 커넥터 생성, API 통합, curl 스마트 가져오기 | | **보고서 및 차트** | Yida 보고서 생성, 차트 추가, 데이터 시각화 | diff --git a/pt/features/skills.mdx b/pt/features/skills.mdx index 939750b..78e031c 100644 --- a/pt/features/skills.mdx +++ b/pt/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process <appType> <formUuid> --rules <regrasJSON> --- +## Integração e automação + +Crie e gerencie fluxos lógicos (integração e automação) com gatilhos de eventos de formulário, notificações e operações de dados. + +```bash +# Criar um fluxo lógico +openyida integration create <appType> <formUuid> <flowName> [opções] +``` + +### Parâmetros + +| Parâmetro | Obrigatório | Descrição | +|-----------|-------------|-----------| +| `appType` | Sim | ID do aplicativo (ex: `APP_XXXX`) | +| `formUuid` | Sim | UUID do formulário gatilho (ex: `FORM-XXXX`) | +| `flowName` | Sim | Nome do fluxo lógico | + +### Opções + +| Opção | Padrão | Descrição | +|-------|--------|-----------| +| `--process-code <code>` | Autogerado | processCode existente (`LPROC-xxx`) | +| `--receivers <userId,...>` | Vazio | IDs de usuário para notificações DingTalk (separados por vírgulas) | +| `--title <title>` | Igual ao flowName | Título da notificação, suporta `#{fieldId-ComponentType}#` | +| `--content <content>` | `"Novo registro enviado"` | Conteúdo da notificação | +| `--events <insert,update>` | `insert` | Eventos gatilho: `insert`/`update`/`delete`/`comment` | +| `--add-data-form-uuid <formUuid>` | — | UUID do formulário destino para o nó de adição de dados | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | Atribuição de campo (especificável várias vezes). `valueType`: `processVar`/`literal`/`column` | +| `--publish` | Não publicado | Publicar imediatamente após salvar | + +### Saída + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "Notificação de novo registro", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + Você deve estar logado antes de executar este comando. Com `--publish`, `published` será `true`; em caso de falha, `published` será `false` com um campo `warning`. +</Info> + +--- + ## Gestão de permissões ```bash diff --git a/pt/introduction/overview.mdx b/pt/introduction/overview.mdx index 699cc22..5efe826 100644 --- a/pt/introduction/overview.mdx +++ b/pt/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **Gerenciamento de formulários** | Criação/atualização de formulários, obtenção de esquema, configuração de permissões | | **Publicação de páginas** | Desenvolvimento de páginas personalizadas, compilação Babel, publicação com um clique | | **Configuração de fluxos** | Criação de formulários de fluxo, configuração de regras de aprovação | +| **Integração e automação** | Criação e gestão de fluxos lógicos, gatilhos de eventos de formulário, notificações, operações de dados entre formulários | | **Gerenciamento de dados** | Consulta de dados de formulários, instâncias de fluxo, gerenciamento de tarefas | | **Conectores** | Criação de conectores HTTP, integração de API, importação inteligente curl | | **Relatórios e gráficos** | Criação de relatórios Yida, adição de gráficos, visualização de dados | diff --git a/vi/features/skills.mdx b/vi/features/skills.mdx index a1a8343..6f77d3d 100644 --- a/vi/features/skills.mdx +++ b/vi/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process <appType> <formUuid> --rules <quy_tắcJSON> --- +## Tích hợp và tự động hóa + +Tạo và quản lý luồng logic (tích hợp và tự động hóa) với trình kích hoạt sự kiện biểu mẫu, thông báo và thao tác dữ liệu. + +```bash +# Tạo luồng logic +openyida integration create <appType> <formUuid> <flowName> [tùy chọn] +``` + +### Tham số + +| Tham số | Bắt buộc | Mô tả | +|---------|----------|-------| +| `appType` | Có | ID ứng dụng (VD: `APP_XXXX`) | +| `formUuid` | Có | UUID biểu mẫu kích hoạt (VD: `FORM-XXXX`) | +| `flowName` | Có | Tên luồng logic | + +### Tùy chọn + +| Tùy chọn | Mặc định | Mô tả | +|----------|----------|-------| +| `--process-code <code>` | Tự động tạo | processCode hiện có (`LPROC-xxx`) | +| `--receivers <userId,...>` | Trống | ID người dùng nhận thông báo DingTalk (phân cách bằng dấu phẩy) | +| `--title <title>` | Giống flowName | Tiêu đề thông báo, hỗ trợ `#{fieldId-ComponentType}#` | +| `--content <content>` | `"Bản ghi mới đã được gửi"` | Nội dung thông báo | +| `--events <insert,update>` | `insert` | Sự kiện kích hoạt: `insert`/`update`/`delete`/`comment` | +| `--add-data-form-uuid <formUuid>` | — | UUID biểu mẫu đích cho nút thêm dữ liệu | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | Gán trường (có thể chỉ định nhiều lần). `valueType`: `processVar`/`literal`/`column` | +| `--publish` | Không xuất bản | Xuất bản ngay sau khi lưu | + +### Đầu ra + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "Thông báo bản ghi mới", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + Bạn phải đăng nhập trước khi chạy lệnh này. Với `--publish`, `published` sẽ là `true`; nếu thất bại, `published` sẽ là `false` kèm trường `warning`. +</Info> + +--- + ## Quản lý quyền hạn ```bash diff --git a/vi/introduction/overview.mdx b/vi/introduction/overview.mdx index c7224ed..3954784 100644 --- a/vi/introduction/overview.mdx +++ b/vi/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **Quản lý biểu mẫu** | Tạo/cập nhật biểu mẫu, lấy Schema, cấu hình quyền | | **Xuất bản trang** | Phát triển trang tùy chỉnh, biên dịch Babel, xuất bản bằng một cú nhấp chuột | | **Cấu hình quy trình** | Tạo biểu mẫu quy trình, cấu hình quy tắc phê duyệt | +| **Tích hợp và tự động hóa** | Tạo và quản lý luồng logic, trình kích hoạt sự kiện biểu mẫu, thông báo, thao tác dữ liệu giữa các biểu mẫu | | **Quản lý dữ liệu** | Truy vấn dữ liệu biểu mẫu, quy trình, quản lý tác vụ | | **Kết nối** | Tạo kết nối HTTP, tích hợp API, nhập thông minh curl | | **Báo cáo và biểu đồ** | Tạo báo cáo Yida, thêm biểu đồ, trực quan hóa dữ liệu | diff --git a/zh-Hant/features/skills.mdx b/zh-Hant/features/skills.mdx index 2fa1e7e..c85f4ee 100644 --- a/zh-Hant/features/skills.mdx +++ b/zh-Hant/features/skills.mdx @@ -246,6 +246,56 @@ openyida configure-process <appType> <formUuid> --rules <rulesJSON> --- +## 整合與自動化 + +建立和管理邏輯流（整合&自動化），支援表單事件觸發、訊息通知、資料操作等場景。 + +```bash +# 建立邏輯流 +openyida integration create <appType> <formUuid> <flowName> [選項] +``` + +### 參數 + +| 參數 | 必填 | 說明 | +|------|------|------| +| `appType` | 是 | 應用 ID（如 `APP_XXXX`） | +| `formUuid` | 是 | 觸發表單 UUID（如 `FORM-XXXX`） | +| `flowName` | 是 | 邏輯流名稱 | + +### 選項 + +| 選項 | 預設值 | 說明 | +|------|--------|------| +| `--process-code <code>` | 自動產生 | 已有邏輯流的 processCode（`LPROC-xxx` 格式） | +| `--receivers <userId,...>` | 空 | 接收釘釘工作通知的使用者 ID，多個用逗號分隔 | +| `--title <title>` | 同 flowName | 通知標題，支援 `#{fieldId-ComponentType}#` 引用表單欄位 | +| `--content <content>` | `"表單有新記錄提交，請及時查看。"` | 通知內容，支援欄位變數引用 | +| `--events <insert,update>` | `insert` | 觸發事件：`insert`/`update`/`delete`/`comment`，多個用逗號分隔 | +| `--add-data-form-uuid <formUuid>` | — | 新增資料節點的目標表單 UUID | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | 新增資料的欄位賦值，可多次傳入。`valueType` 可選 `processVar`/`literal`/`column` | +| `--publish` | 不發佈 | 儲存後立即發佈（開啟狀態），否則僅儲存為草稿 | + +### 輸出 + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "新增記錄通知", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + 執行此命令前需要先登入。使用 `--publish` 時 `published` 為 `true`；若發佈失敗，`published` 為 `false` 並附帶 `warning` 欄位。 +</Info> + +--- + ## 權限管理 ```bash diff --git a/zh-Hant/introduction/overview.mdx b/zh-Hant/introduction/overview.mdx index 79f4097..1a54a1a 100644 --- a/zh-Hant/introduction/overview.mdx +++ b/zh-Hant/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **表單管理** | 創建/更新表單、獲取 Schema、配置權限 | | **頁面發佈** | 自定義頁面開發、Babel 編譯、一鍵發佈 | | **流程配置** | 流程表單創建、審批規則配置 | +| **整合與自動化** | 邏輯流建立與管理，表單事件觸發、訊息通知、跨表資料操作 | | **數據管理** | 表單數據查詢、流程實例、任務管理 | | **連接器** | HTTP 連接器創建、API 集成、curl 智能導入 | | **報表圖表** | 宜搭報表創建、圖表追加、數據可視化 | diff --git a/zh/features/skills.mdx b/zh/features/skills.mdx index 69d3b5a..d15c20d 100644 --- a/zh/features/skills.mdx +++ b/zh/features/skills.mdx @@ -246,6 +246,90 @@ openyida configure-process <appType> <formUuid> --rules <rulesJSON> --- +## 集成与自动化 + +创建和管理逻辑流（集成&自动化），支持表单事件触发、消息通知、数据操作等场景。 + +```bash +# 创建逻辑流 +openyida integration create <appType> <formUuid> <flowName> [选项] +``` + +### 参数 + +| 参数 | 必填 | 说明 | +|------|------|------| +| `appType` | 是 | 应用 ID，如 `APP_XXXX` | +| `formUuid` | 是 | 触发表单 UUID，如 `FORM-XXXX` | +| `flowName` | 是 | 逻辑流名称 | + +### 选项 + +| 选项 | 默认值 | 说明 | +|------|--------|------| +| `--process-code <code>` | 自动生成 | 已有逻辑流的 processCode（`LPROC-xxx` 格式） | +| `--receivers <userId,...>` | 空 | 接收钉钉工作通知的用户 ID，多个用逗号分隔 | +| `--title <title>` | 同 flowName | 通知标题，支持 `#{fieldId-ComponentType}#` 引用表单字段 | +| `--content <content>` | `"表单有新记录提交，请及时查看。"` | 通知内容，支持字段变量引用 | +| `--events <insert,update>` | `insert` | 触发事件：`insert`/`update`/`delete`/`comment`，多个用逗号分隔 | +| `--data-form-uuid <formUuid>` | — | 获取单条数据节点的目标表单 UUID | +| `--data-condition <bFieldId:bFieldName:aFieldId[:componentType]>` | — | 获取单条数据的过滤条件，可多次传入 | +| `--add-data-form-uuid <formUuid>` | — | 新增数据节点的目标表单 UUID | +| `--add-data-assignment <targetFieldId:valueType:value>` | — | 新增数据的字段赋值，可多次传入。`valueType` 可选 `processVar`/`literal`/`column` | +| `--publish` | 不发布 | 保存后立即发布（开启状态），否则仅保存为草稿 | + +### 示例 + +```bash +# 表单新增时通知指定用户 +openyida integration create APP_XXX FORM-XXX "新增记录通知" \ + --receivers user123 \ + --title "有新记录提交" \ + --content "表单有新记录提交，请及时处理。" + +# 引用表单字段变量，保存并发布 +openyida integration create APP_XXX FORM-XXX "记录变更通知" \ + --receivers user123,user456 \ + --events insert,update,delete,comment \ + --publish + +# 带新增数据节点：将 A 表单数据同步到 B 表单 +openyida integration create APP_XXX FORM-A-XXX "同步到表单B" \ + --add-data-form-uuid FORM-B-XXX \ + --add-data-assignment "textField_b1:processVar:textField_a1" \ + --add-data-assignment "numberField_b2:literal:0" \ + --publish +``` + +### 字段变量引用 + +在通知标题和内容中使用 `#{fieldId-ComponentType}#` 格式引用触发表单的字段值： + +``` +#{textField_mmq4ldti-TextField}# +#{numberField_abc123-NumberField}# +``` + +### 输出 + +```json +{ + "success": true, + "published": false, + "processCode": "LPROC-XXXX", + "flowName": "新增记录通知", + "appType": "APP_XXX", + "formUuid": "FORM-XXX", + "formEventTypes": ["insert"] +} +``` + +<Info> + 运行此命令前需要先登录。使用 `--publish` 时 `published` 为 `true`；若发布失败，`published` 为 `false` 并附带 `warning` 字段。 +</Info> + +--- + ## 权限管理 ```bash diff --git a/zh/introduction/overview.mdx b/zh/introduction/overview.mdx index e69966f..a1b3203 100644 --- a/zh/introduction/overview.mdx +++ b/zh/introduction/overview.mdx @@ -56,6 +56,7 @@ icon: "rocket" | **表单管理** | 创建/更新表单、获取 Schema、配置权限 | | **页面发布** | 自定义页面开发、Babel 编译、一键发布 | | **流程配置** | 流程表单创建、审批规则配置 | +| **集成与自动化** | 逻辑流创建与管理，表单事件触发、消息通知、跨表数据操作 | | **数据管理** | 表单数据查询、流程实例、任务管理 | | **连接器** | HTTP 连接器创建、API 集成、curl 智能导入 | | **报表图表** | 宜搭报表创建、图表追加、数据可视化 |