Skip to main content

一、機能概要

本マニュアルは、組織管理者または開発者を対象に、DingTalk OA システムの承認フローとページサードパーティ業務システム(ERP、CRM、財務システムなど)と統合 し、統一入口での操作、データ連携、フロー連携などの機能を実現する方法をご案内します。統合により、企業のオフィス自動化レベルを向上させ、重複入力を回避し、システム横断のコラボレーション効率を強化できます。

二、適用シナリオ

業務システムから承認を起票し、DingTalk 公式 OA 承認関連 API を呼び出して DingTalk OA 承認フローを作成し、DingTalk クライアントで承認詳細ページを開いてフローを処理できます。

三、業務フロー

業務システムと DingTalk クライアント間の全体的なインタラクションフローは以下のとおりです。
DingTalk OA 承認フローとページ統合の業務フロー図。業務システムから承認を起票し、DingTalk クライアントで公式詳細ページを開いて処理し、ステータスを取得する流れ

四、実現効果

1、業務システムから起票して OA 承認フローを作成

業務システムが DingTalk OA 承認 API を呼び出して承認を起票し、DingTalk OA 承認フローを自動作成します。
業務システムの起票ページから OA 承認 API を通じて経費精算承認フォームを作成する画面

2、DingTalk OA 承認リストから公式承認詳細ページを開いて承認

DingTalk OA 承認リストで承認フォームをクリックし、公式詳細ページを開いて処理します。
DingTalk OA 承認リストから公式承認詳細ページを開き、フォーム内容とフローレコードを表示する画面

3、DingTalk タスクから公式承認詳細ページを開いて承認

DingTalk タスクセンターでタスクをクリックし、同様に公式詳細ページを開いて処理します。
DingTalk タスクセンターから公式 OA 承認詳細ページを開き、承認操作を実行する画面

五、開発フロー

社内アプリと DingTalk OA 承認間の API インタラクションフローは以下のとおりです。
社内アプリと DingTalk OA 承認間の API インタラクションのシーケンス図。テンプレート作成、インスタンス起票、承認操作、コールバック通知を含む

統合フロー概要

本ドキュメントでは、社内アプリを作成し、公式 OA 承認関連 API(公式承認テンプレートの作成 / 更新、承認インスタンスの起票 / 元に戻す / コメント、承認タスクの承認 / 拒否 / 転送、承認添付のアップロード / ダウンロードなど)と、公式 OA 承認インスタンス / 承認タスクのコールバックイベントを利用して、業務システムから起票し、DingTalk クライアントで公式 OA 承認詳細ページを開いて統合するシナリオ事例を示します。
前提条件:アプリ作成 のフローを完了していること。 ステップ 1:アプリ詳細ページに移動し、クライアント ID と Client Secret を取得します。 ステップ 2:API 権限を申請し、「OA承認」に対応する権限を申請します。 ステップ 3:アプリのアクセス認証情報として、社内アプリのアクセストークンを取得 します。API を呼び出す際は、アクセストークンで呼び出し元の身元を認証します。 ステップ 4:OA承認関連 API を呼び出します。
  1. 公式 OA 承認テンプレートを作成: 管理者は OA 管理コンソールで手動作成できます。または業務システムから新版サーバー API - 承認フォームテンプレートの作成または更新 を呼び出し、テンプレートの一意コード processCode を取得します。テンプレートコード processCode を保存していない場合は、DingTalk 管理コンソールにログインして確認・取得できます。
承認テンプレートのコードは、管理コンソールのテンプレート設定画面で確認できます。
OA 管理コンソールの承認テンプレート設定ページで、テンプレートの一意コード processCode を確認できる画面
  1. 承認テンプレートの作成に成功した後、ユーザーは DingTalk OA 承認管理コンソールで、公式 OA 承認フォームテンプレートの確認 / 編集、テンプレートデータの確認 / 検索、テンプレートデータのエクスポート / 削除などを実行できます。
  2. 公式 OA 承認インスタンスを起票: ユーザーは OA 承認公式アプリから手動で承認を起票できます。または業務システムがテンプレートコード processCode に基づき、新版サーバー API - 承認インスタンスを起票 を呼び出して承認インスタンスを起票し、承認インスタンス instanceId を取得します。
  3. 承認インスタンスの起票に成功した後、ユーザーは DingTalk 承認センターに移動し、承認の 4 大リスト(未処理、処理済み、起票済み、受信済み)の確認、承認インスタンスデータの検索、承認の実行などの操作ができます。
  4. 承認コメントに添付を追加: 承認コメントに添付を追加する場合は、まずファイルを承認ドライブスペースにアップロードしてから、新版サーバー API - 承認コメントを追加 を呼び出す必要があります。詳しい使用方法は 承認フローのコメントと元に戻す を参照してください。
    1. まず新版サーバー API - 承認ドライブスペース情報を取得 を呼び出し、ドライブスペースのアップロード権限を取得し、承認ドライブスペースの spaceId を取得します。
    2. クライアントサイド JSAPI - ドライブへの添付アップロード / ドライブからファイルを選択 を呼び出し、ファイルの基本情報を取得します。本フロー例では JSAPI Explorer を使用して実装します。
    3. 承認ドライブスペースの spaceId を取得後、承認インスタンス instanceId に基づき、新版サーバー API - 承認コメントを追加 を呼び出すことで、承認フォームへのコメント追加操作を実現できます。
  1. 承認添付のプレビュー・ダウンロード: 添付をプレビュー・ダウンロードする場合は、サーバー API - 承認ドライブファイルのダウンロードを権限付与承認添付のプレビューを権限付与 を呼び出して承認ドライブファイルへの権限付与を実行し、続けてサーバー API - 添付ファイルをダウンロード を呼び出してファイルのリンク downloadUri を取得し、ダウンロードを実現します。詳しい使用方法は 承認添付の操作フロー を参照してください。
  2. 承認タスクを承認 / 拒否: 承認者は DingTalk 承認センターまたは DingTalk タスクセンターから承認タスクを手動で承認 / 拒否できます。または業務システムが承認インスタンス instanceId に基づき、新版サーバー API - 単一の承認インスタンス詳細を取得 を呼び出し、承認インスタンス詳細を取得して各タスクノードの情報 taskId を取得します。
  3. 承認インスタンス instanceId および対応するタスクノード taskId の情報に基づき、新版サーバー API - 承認タスクを承認または拒否 を呼び出すことで、承認タスクの操作を実現します。すべての承認ノードが承認すると、承認フォームは通過します。
  4. 公式 OA 承認インスタンスを元に戻す:承認確認後に、送信済みの承認フォームに誤りがあり、その承認インスタンスを元に戻す必要がある場合は、承認インスタンス instanceId に基づき、新版サーバー API - 承認インスタンスを元に戻す を呼び出し、承認フォームを元に戻す操作を実現できます。
  5. 承認フォームのステータスが変化した後、OA 承認は 承認タスクのステータス変化承認インスタンスのステータス変化 などのコールバックイベントを業務システム側にプッシュできます。これにより、企業アプリと DingTalk プラットフォームをより深く統合し、情報共有と業務連携を実現できます。詳しい使用方法は イベントサブスクリプション操作ガイド を参照してください。

六、使用 API

1、承認フォーム

2、承認インスタンス

3、承認ドライブスペースと添付

4、承認タスク

5、承認コールバックイベント

5.1 社内アプリタイプのコールバックイベント

5.2 サードパーティ社内アプリのコールバックイベント

七、関連ドキュメント

フローセンターオープンソリューション

企業業務システムを DingTalk OA 承認に接続する 4 つのソリューションの総覧

サードパーティフローページ統合

業務システムから起票し、DingTalk クライアントで業務システム詳細ページを開いて承認