diff --git a/ar/features/skills.mdx b/ar/features/skills.mdx index 803eb0a..70ba490 100644 --- a/ar/features/skills.mdx +++ b/ar/features/skills.mdx @@ -95,8 +95,53 @@ openyida get-schema # إلزامي قبل أي عملية # تحديث تكوين النموذج openyida update-form-config + +# عرض قائمة صفحات النماذج في التطبيق +openyida list-forms <appType> [--keyword <text>] +``` + +### عرض قائمة صفحات النماذج + +استعلام جميع إدخالات النماذج والصفحات داخل التطبيق. يتم إخراج النتائج بتنسيق JSON إلى المخرج القياسي. + +```bash +openyida list-forms <appType> [--keyword <text>] ``` +| المعامل | الوصف | +|---------|-------| +| `<appType>` | معرّف التطبيق (مثال: `APP_XXXXX`) | + +| الخيار | الوصف | +|--------|-------| +| `--keyword <text>` | تصفية النتائج بكلمة مفتاحية (تطابق اسم النموذج أو UUID أو النوع أو المسار) | + +**أمثلة:** + +```bash +# عرض جميع النماذج في التطبيق +openyida list-forms APP_XXXXX + +# التصفية بكلمة مفتاحية +openyida list-forms APP_XXXXX --keyword customer +``` + +يُخرج الأمر مصفوفة JSON من كائنات النماذج: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "تسجيل العملاء", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + يجب تسجيل الدخول قبل تشغيل هذا الأمر. قم بتشغيل `openyida login` أولاً إذا لم تكن قد قمت بالمصادقة بعد. +</Info> <Warning> معرّفات الحقول في Yida يتم إنشاؤها عشوائيًا بواسطة المنصة (مثال: `textField_eftt1aa5m`، `selectField_fix024y92`) ولا يمكن استنتاجها من أسماء الحقول. قبل أي عملية تستخدم معرّفات الحقول (إنشاء/تحديث البيانات، تكوين شروط الاستعلام، كتابة صفحات مخصصة)، **يجب** تشغيل `openyida get-schema` للحصول على المعرّفات الحقيقية. diff --git a/de/features/skills.mdx b/de/features/skills.mdx index 5b1276a..eb9d0a2 100644 --- a/de/features/skills.mdx +++ b/de/features/skills.mdx @@ -95,8 +95,53 @@ openyida get-schema <appType> <formUuid> # Pflicht vor jeder Operation mit Feld # Formularkonfiguration aktualisieren openyida update-form-config <appType> <formUuid> <isRenderNav> <title> + +# Formularseiten einer Anwendung auflisten +openyida list-forms <appType> [--keyword <text>] ``` +### Formularseiten auflisten + +Alle Formular- und Seiteneinträge innerhalb einer Anwendung abfragen. Die Ergebnisse werden als JSON auf der Standardausgabe ausgegeben. + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| Argument | Beschreibung | +|----------|-------------| +| `<appType>` | Anwendungs-ID (z.B. `APP_XXXXX`) | + +| Option | Beschreibung | +|--------|-------------| +| `--keyword <text>` | Ergebnisse nach Stichwort filtern (trifft auf Formularname, UUID, Typ oder Pfad zu) | + +**Beispiele:** + +```bash +# Alle Formulare einer Anwendung auflisten +openyida list-forms APP_XXXXX + +# Nach Stichwort filtern +openyida list-forms APP_XXXXX --keyword customer +``` + +Der Befehl gibt ein JSON-Array von Formularobjekten aus: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "Kundenregistrierung", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + Sie müssen angemeldet sein, bevor Sie diesen Befehl ausführen. Führen Sie zuerst `openyida login` aus, wenn Sie sich noch nicht authentifiziert haben. +</Info> <Warning> Yida-Feld-IDs werden zufällig von der Plattform generiert (z.B. `textField_eftt1aa5m`, `selectField_fix024y92`) und können nicht aus Feldnamen abgeleitet werden. Vor jeder Operation mit Feld-IDs (Daten erstellen/aktualisieren, Abfragebedingungen konfigurieren, benutzerdefinierte Seiten schreiben) **müssen** Sie `openyida get-schema` ausführen, um die echten Feld-IDs zu erhalten. diff --git a/en/features/skills.mdx b/en/features/skills.mdx index d284cd6..4775b0d 100644 --- a/en/features/skills.mdx +++ b/en/features/skills.mdx @@ -95,8 +95,54 @@ openyida get-schema <appType> <formUuid> # Update form config openyida update-form-config <appType> <formUuid> <isRenderNav> <title> + +# List form pages in an application +openyida list-forms <appType> [--keyword <text>] ``` +### List form pages + +Query all form and page entries within an application. Results are output as JSON to stdout. + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| Argument | Description | +|----------|-------------| +| `<appType>` | Application ID (e.g. `APP_XXXXX`) | + +| Option | Description | +|--------|-------------| +| `--keyword <text>` | Filter results by keyword (matches form name, UUID, type, or path) | + +**Examples:** + +```bash +# List all forms in an application +openyida list-forms APP_XXXXX + +# Filter by keyword +openyida list-forms APP_XXXXX --keyword customer +``` + +The command outputs a JSON array of form objects: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "Customer Registration", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + You must be logged in before running this command. Run `openyida login` first if you have not authenticated. +</Info> + <Warning> Field IDs in Yida are randomly generated by the platform (e.g. `textField_eftt1aa5m`, `selectField_fix024y92`) and cannot be inferred from field names. You **must** run `openyida get-schema` to obtain the real field IDs before performing any operation that references them — including creating or updating form data, configuring query conditions, and writing custom pages. </Warning> diff --git a/es/features/skills.mdx b/es/features/skills.mdx index 2221ffa..29c6e8d 100644 --- a/es/features/skills.mdx +++ b/es/features/skills.mdx @@ -95,8 +95,53 @@ openyida get-schema <appType> <formUuid> # Obligatorio antes de cualquier opera # Actualizar configuración del formulario openyida update-form-config <appType> <formUuid> <isRenderNav> <título> + +# Listar páginas de formulario de una aplicación +openyida list-forms <appType> [--keyword <text>] ``` +### Listar páginas de formulario + +Consulta todas las entradas de formularios y páginas dentro de una aplicación. Los resultados se envían como JSON a la salida estándar. + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| Argumento | Descripción | +|-----------|-------------| +| `<appType>` | ID de la aplicación (ej. `APP_XXXXX`) | + +| Opción | Descripción | +|--------|-------------| +| `--keyword <text>` | Filtrar resultados por palabra clave (coincide con nombre del formulario, UUID, tipo o ruta) | + +**Ejemplos:** + +```bash +# Listar todos los formularios de una aplicación +openyida list-forms APP_XXXXX + +# Filtrar por palabra clave +openyida list-forms APP_XXXXX --keyword customer +``` + +El comando devuelve un array JSON de objetos de formulario: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "Registro de clientes", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + Debe iniciar sesión antes de ejecutar este comando. Ejecute `openyida login` primero si aún no se ha autenticado. +</Info> <Warning> Los IDs de campo en Yida son generados aleatoriamente por la plataforma (ej: `textField_eftt1aa5m`, `selectField_fix024y92`) y no se pueden deducir de los nombres de campo. Antes de cualquier operación que use IDs de campo (crear/actualizar datos, configurar condiciones de consulta, escribir páginas personalizadas), **debe** ejecutar `openyida get-schema` para obtener los IDs reales. diff --git a/fr/features/skills.mdx b/fr/features/skills.mdx index 0443b09..d10242e 100644 --- a/fr/features/skills.mdx +++ b/fr/features/skills.mdx @@ -95,8 +95,54 @@ openyida get-schema <appType> <formUuid> # Obligatoire avant toute opération u # Mettre à jour la configuration du formulaire openyida update-form-config <appType> <formUuid> <isRenderNav> <title> + +# Lister les pages de formulaire d'une application +openyida list-forms <appType> [--keyword <text>] ``` +### Lister les pages de formulaire + +Interroge toutes les entrées de formulaires et de pages au sein d'une application. Les résultats sont affichés en JSON sur la sortie standard. + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| Argument | Description | +|----------|-------------| +| `<appType>` | ID de l'application (ex. `APP_XXXXX`) | + +| Option | Description | +|--------|-------------| +| `--keyword <text>` | Filtrer les résultats par mot-clé (correspond au nom du formulaire, UUID, type ou chemin) | + +**Exemples :** + +```bash +# Lister tous les formulaires d'une application +openyida list-forms APP_XXXXX + +# Filtrer par mot-clé +openyida list-forms APP_XXXXX --keyword customer +``` + +La commande renvoie un tableau JSON d'objets formulaire : + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "Inscription client", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + Vous devez être connecté avant d'exécuter cette commande. Exécutez `openyida login` d'abord si vous n'êtes pas encore authentifié. +</Info> + <Warning> Les ID de champs Yida sont générés aléatoirement par la plateforme (ex : `textField_eftt1aa5m`, `selectField_fix024y92`) et ne peuvent pas être déduits des noms de champs. Avant toute opération utilisant des ID de champs (création/mise à jour de données, configuration de conditions de requête, écriture de pages personnalisées), vous **devez** exécuter `openyida get-schema` pour obtenir les vrais ID de champs. </Warning> diff --git a/hi/features/skills.mdx b/hi/features/skills.mdx index e413e3e..585cec3 100644 --- a/hi/features/skills.mdx +++ b/hi/features/skills.mdx @@ -95,8 +95,53 @@ openyida get-schema <appType> <formUuid> # फ़ील्ड ID का उप # फॉर्म कॉन्फ़िगरेशन अपडेट करें openyida update-form-config <appType> <formUuid> <isRenderNav> <शीर्षक> + +# एप्लिकेशन में फॉर्म पेज सूचीबद्ध करें +openyida list-forms <appType> [--keyword <text>] +``` + +### फॉर्म पेज सूचीबद्ध करें + +किसी एप्लिकेशन के भीतर सभी फॉर्म और पेज एंट्री की क्वेरी करें। परिणाम JSON प्रारूप में मानक आउटपुट पर दिखाए जाते हैं। + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| आर्गुमेंट | विवरण | +|-----------|-------| +| `<appType>` | एप्लिकेशन ID (उदा. `APP_XXXXX`) | + +| विकल्प | विवरण | +|--------|-------| +| `--keyword <text>` | कीवर्ड द्वारा परिणाम फ़िल्टर करें (फॉर्म नाम, UUID, प्रकार या पथ से मिलान) | + +**उदाहरण:** + +```bash +# एप्लिकेशन में सभी फॉर्म सूचीबद्ध करें +openyida list-forms APP_XXXXX + +# कीवर्ड से फ़िल्टर करें +openyida list-forms APP_XXXXX --keyword customer ``` +कमांड फॉर्म ऑब्जेक्ट का एक JSON ऐरे आउटपुट करता है: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "ग्राहक पंजीकरण", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + इस कमांड को चलाने से पहले आपको लॉग इन होना चाहिए। यदि आपने अभी तक प्रमाणीकरण नहीं किया है तो पहले `openyida login` चलाएं। +</Info> <Warning> Yida फ़ील्ड ID प्लेटफ़ॉर्म द्वारा यादृच्छिक रूप से जनरेट किए जाते हैं (उदा: `textField_eftt1aa5m`, `selectField_fix024y92`) और फ़ील्ड नामों से अनुमान नहीं लगाया जा सकता। फ़ील्ड ID का उपयोग करने वाले किसी भी ऑपरेशन (डेटा बनाना/अपडेट करना, क्वेरी शर्तें कॉन्फ़िगर करना, कस्टम पेज लिखना) से पहले आपको **अवश्य** `openyida get-schema` चलाकर वास्तविक फ़ील्ड ID प्राप्त करना होगा। diff --git a/ja/features/skills.mdx b/ja/features/skills.mdx index 3c1b0d9..c2f8906 100644 --- a/ja/features/skills.mdx +++ b/ja/features/skills.mdx @@ -95,8 +95,53 @@ openyida get-schema <appType> <formUuid> # フィールドIDを使用する操 # フォーム設定更新 openyida update-form-config <appType> <formUuid> <isRenderNav> <title> + +# アプリケーション内のフォームページを一覧表示 +openyida list-forms <appType> [--keyword <text>] +``` + +### フォームページの一覧表示 + +アプリケーション内のすべてのフォームおよびページエントリを照会します。結果はJSON形式で標準出力に出力されます。 + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| 引数 | 説明 | +|------|------| +| `<appType>` | アプリケーションID(例: `APP_XXXXX`) | + +| オプション | 説明 | +|-----------|------| +| `--keyword <text>` | キーワードで結果をフィルタリング(フォーム名、UUID、タイプ、パスに一致) | + +**例:** + +```bash +# アプリケーション内のすべてのフォームを一覧表示 +openyida list-forms APP_XXXXX + +# キーワードでフィルタリング +openyida list-forms APP_XXXXX --keyword customer ``` +コマンドはフォームオブジェクトのJSON配列を出力します: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "顧客登録", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + このコマンドを実行する前にログインが必要です。認証がまだの場合は、先に `openyida login` を実行してください。 +</Info> <Warning> YidaのフィールドIDはプラットフォームによりランダムに生成されます(例: `textField_eftt1aa5m`、`selectField_fix024y92`)。フィールド名からは推測できません。フィールドIDを使用する操作(データの作成・更新、クエリ条件の設定、カスタムページの作成など)の前に、**必ず** `openyida get-schema` を実行して実際のフィールドIDを取得してください。 diff --git a/ko/features/skills.mdx b/ko/features/skills.mdx index add5f58..205daeb 100644 --- a/ko/features/skills.mdx +++ b/ko/features/skills.mdx @@ -95,8 +95,54 @@ openyida get-schema <appType> <formUuid> # 필드 ID를 사용하는 모든 작 # 양식 구성 업데이트 openyida update-form-config <appType> <formUuid> <isRenderNav> <title> + +# 애플리케이션의 양식 페이지 목록 조회 +openyida list-forms <appType> [--keyword <text>] ``` +### 양식 페이지 목록 조회 + +애플리케이션 내 모든 양식 및 페이지 항목을 조회합니다. 결과는 JSON 형식으로 표준 출력에 출력됩니다. + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| 인수 | 설명 | +|------|------| +| `<appType>` | 애플리케이션 ID (예: `APP_XXXXX`) | + +| 옵션 | 설명 | +|------|------| +| `--keyword <text>` | 키워드로 결과 필터링 (양식 이름, UUID, 유형 또는 경로 일치) | + +**예시:** + +```bash +# 애플리케이션의 모든 양식 목록 조회 +openyida list-forms APP_XXXXX + +# 키워드로 필터링 +openyida list-forms APP_XXXXX --keyword customer +``` + +명령은 양식 객체의 JSON 배열을 출력합니다: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "고객 등록", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + 이 명령을 실행하기 전에 로그인해야 합니다. 아직 인증하지 않은 경우 먼저 `openyida login`을 실행하세요. +</Info> + <Warning> Yida 필드 ID는 플랫폼에서 무작위로 생성됩니다(예: `textField_eftt1aa5m`, `selectField_fix024y92`). 필드 이름으로는 추측할 수 없습니다. 필드 ID를 사용하는 모든 작업(데이터 생성/수정, 쿼리 조건 설정, 커스텀 페이지 작성 등) 전에 **반드시** `openyida get-schema`를 실행하여 실제 필드 ID를 가져와야 합니다. </Warning> diff --git a/pt/features/skills.mdx b/pt/features/skills.mdx index 8b0f5fe..671b3d1 100644 --- a/pt/features/skills.mdx +++ b/pt/features/skills.mdx @@ -95,8 +95,53 @@ openyida get-schema <appType> <formUuid> # Obrigatório antes de qualquer opera # Atualizar configuração do formulário openyida update-form-config <appType> <formUuid> <isRenderNav> <título> + +# Listar páginas de formulário de uma aplicação +openyida list-forms <appType> [--keyword <text>] +``` + +### Listar páginas de formulário + +Consulta todas as entradas de formulários e páginas dentro de uma aplicação. Os resultados são exibidos como JSON na saída padrão. + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| Argumento | Descrição | +|-----------|-----------| +| `<appType>` | ID da aplicação (ex. `APP_XXXXX`) | + +| Opção | Descrição | +|-------|-----------| +| `--keyword <text>` | Filtrar resultados por palavra-chave (corresponde ao nome do formulário, UUID, tipo ou caminho) | + +**Exemplos:** + +```bash +# Listar todos os formulários de uma aplicação +openyida list-forms APP_XXXXX + +# Filtrar por palavra-chave +openyida list-forms APP_XXXXX --keyword customer +``` + +O comando retorna um array JSON de objetos de formulário: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "Cadastro de clientes", + "formType": "form", + "pathName": "customer-registration" + } +] ``` +<Info> + Você deve estar conectado antes de executar este comando. Execute `openyida login` primeiro se ainda não estiver autenticado. +</Info> <Warning> Os IDs de campo no Yida são gerados aleatoriamente pela plataforma (ex: `textField_eftt1aa5m`, `selectField_fix024y92`) e não podem ser deduzidos dos nomes dos campos. Antes de qualquer operação que use IDs de campo (criar/atualizar dados, configurar condições de consulta, escrever páginas personalizadas), você **deve** executar `openyida get-schema` para obter os IDs reais. diff --git a/vi/features/skills.mdx b/vi/features/skills.mdx index b6567ac..47979a7 100644 --- a/vi/features/skills.mdx +++ b/vi/features/skills.mdx @@ -95,8 +95,53 @@ openyida get-schema <appType> <formUuid> # Bắt buộc trước mọi thao tá # Cập nhật cấu hình biểu mẫu openyida update-form-config <appType> <formUuid> <isRenderNav> <tiêu_đề> + +# Liệt kê các trang biểu mẫu trong ứng dụng +openyida list-forms <appType> [--keyword <text>] +``` + +### Liệt kê các trang biểu mẫu + +Truy vấn tất cả các mục biểu mẫu và trang trong một ứng dụng. Kết quả được xuất dưới dạng JSON ra đầu ra tiêu chuẩn. + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| Tham số | Mô tả | +|---------|-------| +| `<appType>` | ID ứng dụng (ví dụ: `APP_XXXXX`) | + +| Tùy chọn | Mô tả | +|-----------|-------| +| `--keyword <text>` | Lọc kết quả theo từ khóa (khớp với tên biểu mẫu, UUID, loại hoặc đường dẫn) | + +**Ví dụ:** + +```bash +# Liệt kê tất cả biểu mẫu trong ứng dụng +openyida list-forms APP_XXXXX + +# Lọc theo từ khóa +openyida list-forms APP_XXXXX --keyword customer ``` +Lệnh xuất ra một mảng JSON các đối tượng biểu mẫu: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "Đăng ký khách hàng", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + Bạn phải đăng nhập trước khi chạy lệnh này. Chạy `openyida login` trước nếu bạn chưa xác thực. +</Info> <Warning> Field ID trong Yida được tạo ngẫu nhiên bởi nền tảng (ví dụ: `textField_eftt1aa5m`, `selectField_fix024y92`) và không thể suy ra từ tên trường. Trước mọi thao tác sử dụng field ID (tạo/cập nhật dữ liệu, cấu hình điều kiện truy vấn, viết trang tùy chỉnh), bạn **phải** chạy `openyida get-schema` để lấy field ID thực tế. diff --git a/zh-Hant/features/skills.mdx b/zh-Hant/features/skills.mdx index d497028..62a5b1f 100644 --- a/zh-Hant/features/skills.mdx +++ b/zh-Hant/features/skills.mdx @@ -95,8 +95,54 @@ openyida get-schema <appType> <formUuid> # 任何涉及欄位 ID 的操作前 # 更新表單配置 openyida update-form-config <appType> <formUuid> <isRenderNav> <title> + +# 列出應用程式中的表單頁面 +openyida list-forms <appType> [--keyword <text>] +``` + +### 列出表單頁面 + +查詢應用程式中所有表單和頁面項目,結果以 JSON 格式輸出到標準輸出。 + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| 參數 | 說明 | +|------|------| +| `<appType>` | 應用程式 ID(如 `APP_XXXXX`) | + +| 選項 | 說明 | +|------|------| +| `--keyword <text>` | 按關鍵字篩選結果(匹配表單名稱、UUID、類型或路徑) | + +**範例:** + +```bash +# 列出應用程式中的所有表單 +openyida list-forms APP_XXXXX + +# 按關鍵字篩選 +openyida list-forms APP_XXXXX --keyword customer ``` +命令輸出一個表單物件的 JSON 陣列: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "客戶登記", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + 執行此命令前必須先登入。如果尚未認證,請先執行 `openyida login`。 +</Info> + <Warning> 宜搭欄位 ID 由平台隨機生成(如 `textField_eftt1aa5m`、`selectField_fix024y92`),無法從欄位名稱推斷。在執行任何涉及欄位 ID 的操作前(包括建立/更新資料、設定查詢條件、撰寫自訂頁面),**必須**先執行 `openyida get-schema` 取得真實欄位 ID。 </Warning> diff --git a/zh/features/skills.mdx b/zh/features/skills.mdx index 3f439bd..f261e43 100644 --- a/zh/features/skills.mdx +++ b/zh/features/skills.mdx @@ -95,8 +95,53 @@ openyida get-schema <appType> <formUuid> # 任何涉及字段 ID 的操作前 # 更新表单配置 openyida update-form-config <appType> <formUuid> <isRenderNav> <title> + +# 列出应用中的表单页面 +openyida list-forms <appType> [--keyword <text>] ``` +### 列出表单页面 + +查询应用中所有表单和页面条目,结果以 JSON 格式输出到标准输出。 + +```bash +openyida list-forms <appType> [--keyword <text>] +``` + +| 参数 | 说明 | +|------|------| +| `<appType>` | 应用 ID(如 `APP_XXXXX`) | + +| 选项 | 说明 | +|------|------| +| `--keyword <text>` | 按关键词过滤结果(匹配表单名称、UUID、类型或路径) | + +**示例:** + +```bash +# 列出应用中的所有表单 +openyida list-forms APP_XXXXX + +# 按关键词过滤 +openyida list-forms APP_XXXXX --keyword customer +``` + +命令输出一个表单对象的 JSON 数组: + +```json +[ + { + "formUuid": "FORM-XXXXX", + "formName": "客户登记", + "formType": "form", + "pathName": "customer-registration" + } +] +``` + +<Info> + 运行此命令前必须先登录。如果尚未认证,请先运行 `openyida login`。 +</Info> <Warning> 宜搭字段 ID 由平台随机生成(如 `textField_eftt1aa5m`、`selectField_fix024y92`),无法从字段名称推断。在执行任何涉及字段 ID 的操作前(包括创建/更新数据、配置查询条件、编写自定义页面),**必须**先运行 `openyida get-schema` 获取真实字段 ID。