2022.04.21バージョン更新-openapiの新規アップグレード
版本范围: すべてのバージョンが利用可能です新規作成アプリに依存しない 已全量发布ホッチキスのオープンプラットフォームに公開されました
1.アップグレードの概要
Isvや開発者の強いニーズをよりよくサポートするために、openapiを通じてサービス業者の潜在力を大幅に解放し、より多くのオープンインタフェース能力を提供することが望ましい。
アップグレード目標:
- Openapiによるすべての標準コンポーネントのサポートを実現
- ユーザーによく使われるデータcrudインタフェースのパフォーマンス向上 (タイムアウト/失敗率の高い問題を解決)
- Apiの可用性/使いやすさの向上
- ホッチキスオープンプラットフォームopenapiドキュメント可読性の向上 (インタフェースパラメータの説明の追加、インタフェース命名の最適化など)
- フォームcrud一括操作のインタフェースサポート
- 一部の高周波シーンはopen apiを開放してサポートします。
ホッチキス開放プラットフォーム【適合】に次のインタフェースが追加されました
- 新規追加高度なクエリ条件によるフォームインスタンスデータの取得 (サブフォームコンポーネントのデータは除く)インタフェースは、高度な検索条件を使用してフォームインスタンスのデータを照会するのに適していますが、フォーム内のサブフォームインスタンスデータは返さない (フォーム内のサブフォームが多すぎることによるapiタイムアウトの問題を解決する)。
- 新規追加フォームインスタンスデータの一括取得適切なフォームインスタンスのデータ情報を一括取得するためのインタフェース。
- 新規追加フォームインスタンスの一括削除適切なフォームインスタンスを一括削除するためのインタフェース。
- 新規追加フォームインスタンスの一括作成適切なフォームインスタンスを一括作成するためのインタフェース。
- 新規追加フォームインスタンス内のコンポーネント値の一括更新適切なフォームインスタンスを一括更新するためのインタフェース。
- 新規追加フォームコンポーネントデータによるフォームインスタンスの一括更新インタフェース。指定したコンポーネント値を変更してフォームインスタンスを更新します。
- 新規追加フォームインスタンスの新規追加または更新フィルタ条件に基づいてフォームインスタンスをフィルタリングし、フィルタ条件を満たすと、指定されたフォーム値に基づいてクエリ条件を満たすフォームインスタンスが更新され、フィルタ条件を満たすフォームインスタンスが存在しない場合指定したフォーム値に基づいてフォームインスタンスが追加されます。
- 新規追加検索は応用リストに合うべきです。インタフェースは、企業の適切なアプリケーションリストを取得するために使用されます。
- 新規追加高度な検索条件によるフォームインスタンスの照会高度な検索条件を使用して承認インスタンスをフィルタリングするためのインタフェース。
- 新規追加フォームサービス呼び出し実行記録を照会する必要がありますインタフェース。フォームインスタンスに適したサービス呼び出しレコードを照会します。
2. 能力紹介
2.1 openapi高周波シーン明細アップグレードリスト
モジュール | インタフェース名 | 機能説明 (ユーザーフィードバック原音) | ホッチキスオープンプラットフォームインタフェース文書 | 備考説明 |
プラットフォーム | サービス呼出記録の照会 | サービスコールバックログオープンインタフェース | ||
組織の下のアプリケーションリストを取得します | 組織のすべてのapp詳細リストを取得するインタフェースを追加します | https://open.dingtalk.com/document/orgapp-server/query-the-application-list | ||
データの照会または操作 | 高度な検索条件によるフォームインスタンスの照会 フォームインスタンスデータの照会 プロセスインスタンスの取得 | オープンインタフェースを介して一度に5000件以上のデータを照会し、3w件をサポートすることが望ましい | https://open.dingtalk.com/document/orgapp-server/querying-form-instance-data https://open.dingtalk.com/document/orgapp-server/obtain-process-instance | 新しい検索ストレージ構造に切り替え、リストクエリの上限を5000から3wに引き上げた |
高度な検索条件によるフォームインスタンスの照会 プロセスインスタンスの取得 フォームインスタンスデータの照会 | 1行のテキストがapiインタフェースを介してクエリされた、あいまいな検索者を選択して正確に検索できます | https://open.dingtalk.com/document/orgapp-server/obtain-process-instance https://open.dingtalk.com/document/orgapp-server/querying-form-instance-data | Before: あいまい検索。オペレータのデフォルトはcontainsです After: 正確/ファジー検索をサポート すべてのクエリクラスインタフェースに対して、入力パラメータがある場合、その入力パラメータは「データ管理」で使用されるクエリ条件をサポートするようになりました詳細は参考にしてくださいフォーム「データ管理」のフィルタ条件で条件検索を行います | |
プロセスインスタンスの取得 | 外部呼び出し【検索条件に基づいてインスタンスの詳細を取得】インタフェースと承認ノードのフィルタ機能 | https://open.dingtalk.com/document/orgapp-server/obtain-process-instance | Searchフィールドjson入力パラメータは「データ管理」で使用される照会条件をサポートするようになりました詳細は参考にしてくださいフォーム「データ管理」のフィルタ条件で条件検索を行います | |
プロセスインスタンスの取得 | 条件に基づいてインスタンス詳細リストのパラメータにソートフィールドを追加することを推奨します | https://open.dingtalk.com/document/orgapp-server/obtain-process-instance | 新規追加Orderconfigjson入力パラメータ。ソートルールを指定できます このパラメータの入力方法は参考にしてください検索結果のソートに参加できる組み込みフィールド。 | |
子テーブルコンポーネントデータの取得 | 個別クエリサブテーブルのインタフェースを追加します | https://open.dingtalk.com/document/orgapp-server/obtain-child-table-component-data | ||
マスタデータの取得 | 個別クエリメインテーブルのインタフェースを追加します | |||
フォームインスタンスの新規追加または更新 | Upsertインターフェイスの新規追加 | https://open.dingtalk.com/document/orgapp-server/add-or-update-form-instances | 適用:Openapi (オープンプラットフォームでもフロントエンド・インタフェースでも) は、文書番号の一意の値を検証するなど、ビジネス関連ルールの制約を受ける必要があります。 (現在、重複しているのは気づきにくく、直接透視できない。例えば、現在、この一意の値フィールドが存在するかどうかを照会し、1つのデータが2つ以上のインタフェースを呼び出す)。 | |
一括操作 | フォームインスタンスデータの一括作成 | 一括新規インタフェースの追加 | https://open.dingtalk.com/document/orgapp-server/create-multiple-form-instances |
|
指定した複数のフォームインスタンスidに対応するフォームインスタンスデータを一括削除します | 一括削除インタフェースの追加 | https://open.dingtalk.com/document/orgapp-server/delete-multiple-form-instances |
| |
複数のフォームインスタンスの指定フォームコンポーネント値を指定値に更新します
| 一括修正インタフェースの追加 | https://open.dingtalk.com/document/orgapp-server/batch-update-of-component-values-in-form-instances |
| |
フォームインスタンスデータの一括取得 | 一括照会インタフェースを追加 | https://open.dingtalk.com/document/orgapp-server/obtain-multiple-form-instance-data | ||
コンポーネント | (一括) フォームインスタンスの作成 | Openapiによるすべての標準コンポーネントのサポートを実現し、画像アップロードコンポーネントを追加サポートします | 【一括作成】https://open.dingtalk.com/document/orgapp-server/create-multiple-form-instances 【単一作成】 https://open.dingtalk.com/document/orgapp-server/save-form-data | |
その他 | プラットフォームに乗るべき自己呼び出しインタフェースが不安定である | Searchfieldjson.jsonは偶発的に長時間データを検出できず、特にloadingを追加した後は明らかになった (更新後でよい)。 | 解決策: ユーザーは/dingtalk/web/app_pr185lwg5xwycpitz58c/query/formprocinstdata/getinstancedataslight.jsonを使用して、クエリごとのサブテーブルデータ量のサイズを設定できます。 |
2.2ホッチキスオープンプラットフォームopen api変更内容:
- ユーザーが使用できない、または一時的に不要なインタフェースドキュメントは、次の図のように削除されました
- インタフェース分類の再要約調整
- 「タスク」分類の一部のインタフェースは、「フォーム/プロセス」分類に調整されます。
3.意見フィードバック
使っているなら【Openapiに乗るべきです】に問題があったり、フィードバックがあったりしたら、下の二次元コードをスキャンして、「体験センターに参加して意見フィードバックを行うことができます。
-------------------- 最新情報を入手して、私たちに注目してください -------------------- ----
