すべてのプロダクト
Search

このプロダクト

    Dataphin:承認設定

    ドキュメントセンター

    Dataphin:承認設定

    最終更新日:Aug 01, 2026

    Dataphin は、DingTalk OA を含む社内の承認ワークフローとの統合をサポートしています。これにより、統一された IT 管理と使い慣れた企業プロセスシステムが提供され、ユーザーは既存のシステムと一貫した承認体験を得ることができます。また、承認ルールをカスタマイズすることも可能です。例えば、機密度の低い資産に対する権限リクエストには自動承認を設定し、機密度の高い資産には指定された承認者を要求することができます。このドキュメントでは、外部承認システムとの統合方法について説明します。

    関連ドキュメント

    [承認システムの選択] 設定で [サードパーティ承認] を選択すると、サードパーティの承認ワークフローを使用できます。詳細については、「カスタム承認システム統合インターフェース」をご参照ください。

    背景情報

    Dataphin を外部の承認システムと統合する場合、Dataphin API と承認システムの API を接続するためのプロキシアプリケーションを開発する必要があります。これは、システム間でユーザーアカウントをマッピングする必要があること、承認システムごとに固有の API があること、データ形式の変換が必要になる場合があるためです。承認システム SDK は、このプロキシアプリケーションの開発を簡素化し、基本的なワークフローを迅速に確立できるように設計されています。

    image

    制限事項

    スーパー管理者またはシステム管理者のロールを持つユーザーのみが承認設定を構成できます。

    注意事項

    承認ワークフローの設定を変更する場合、すでに進行中の承認リクエストに以下の影響があることにご注意ください。

    • Dataphin の組み込み承認ワークフローから外部のワークフローに切り替えた場合でも、処理中 (開始されたがまだ完了していない) の承認リクエストは Dataphin 内で処理できます。

    • ある外部承認ワークフローから別のワークフローに切り替えるか、ワークフローのパラメーターを変更した場合、処理中の承認リクエストは新しいプロセスに従います。コールバック URL またはその認証情報が変更されると、コールバックが失敗する可能性があります。これにより、承認ステータスが Dataphin と同期されなくなります。この場合、新しい承認リクエストを送信する必要があります。元のリクエストは、取り下げる (または強制取り下げを使用する) ことでクローズできます。

    • 外部承認ワークフローから組み込みのワークフローに切り替えた場合、Dataphin は外部システムからの処理中の承認結果を同期できません。元の承認リクエストは、取り下げる (または強制取り下げを使用する) ことでクローズできます。

    承認設定の構成

    1. スーパー管理者またはシステム管理者として Dataphin テナントにログインします。

    2. Dataphin のホームページで、上部のメニューバーから [管理センター] > [システム設定] を選択します。

    3. 左側のナビゲーションウィンドウで、[システム設定] > [承認設定] を選択して、[承認設定] ページを開きます。

    4. [デフォルトの承認システム] を構成します。

      [外部承認システム] トグルがオフの場合、デフォルトは [組み込み承認システム] です。[外部承認システム] トグルがオンの場合、デフォルトとして [組み込み承認システム] または [サードパーティ承認システム] を選択できます。外部システムを有効にする場合は、外部承認システムとその承認サービスも設定する必要があります。

      説明

      ここで選択したデフォルトの承認システムは、[承認テンプレート] の [承認システム] 設定でデフォルトで選択されます。

    5. [外部承認システム構成] と [承認サービス構成] を構成します。

      • [承認システム名]：承認システムのカスタム名を入力します。すべての文字がサポートされています。名前は最大 128 文字です。

      • [承認システムの選択]：[DingTalk OA] または [その他] を選択できます。システムによって必要な承認サービス構成が異なります。

        DingTalk OA

        パラメーター

        説明

        API アドレス

        DingTalk OA の API アドレスを入力します。

        AppKey

        DingTalk OA の AppKey を入力します。

        AppSecret

        DingTalk OA の AppSecret を入力します。

        Dataphin と外部承認システム間の接続をテストするには、[接続テスト] をクリックします。テストが失敗した場合は、画面に表示されるエラーメッセージに従って問題をトラブルシューティングします。

        DingTalk アカウントマッピング

        DingTalk UID が設定されていないユーザーの場合、Dataphin は自動的に Source_UID (シングルサインオン (SSO) からのユーザー UID) とのマッチングを試みます。マッチングに失敗した場合、Dataphin はエラーを報告します。一括更新機能を使用する以外に、[管理センター] > [メンバー管理] で個々のメンバーの DingTalk UID を管理することもできます。

        [一括更新] をクリックします。[一括更新] ダイアログボックスで、構成ステップに従ってインポートします。

        1. データをダウンロード: Dataphin の最初の 10,000 ユーザーのデータをエクスポートします。エクスポートされたファイルには、ユーザー名、Dataphin_UID、Source_UID、電話番号、メールアドレス、および DingTalk ユーザー ID が含まれます。

        2. Excel ファイルをアップロード: 最大 10,000 行の .xlsx ファイルのみがサポートされます。

        3. インポート構成: アップロードされたファイル内のユーザーが存在しない場合は無視します。値が指定されている場合は DingTalk UID を更新しますが、メールアドレスや携帯電話番号は更新しません。

        コールバック URL

        システムは、Dataphin が DingTalk OA から結果を受信するために使用するコールバック URL を自動的に生成します。次のフォーマットで URL をカスタマイズすることもできます: https://{Dataphin deployment domain}/task/callback。

        エンコーディング AES キー

        暗号化と復号のためのキーを入力します。

        icon アイコンをクリックすると、エンコーディング AES キーが自動的に生成されます。

        トークン

        DingTalk OA クライアントでの認証に使用するトークンを入力します。

        icon アイコンをクリックすると、トークンが自動的に生成されます。

        AgentId

        DingTalk OA の AgentId を入力します。

        その他

        外部承認システムのパラメーターが Dataphin でどのように表示されるかについては、「外部承認システムの値のマッピング」をご参照ください。

        パラメーター

        説明

        統合メソッド

        [最終承認結果のみ表示] または [サードパーティ承認のすべてのノードを表示] のいずれかを選択します。デフォルトは [最終承認結果のみ表示] です。

        • [最終承認結果のみ表示]：外部承認システムは最終結果のみを返し、Dataphin はワークフローの開始ノードと終了ノードのみを表示します。

        • [サードパーティ承認のすべてのノードを表示]：外部システムは承認プロセスのすべてのノードから詳細を返し、Dataphin は同期されたすべての承認ノードを表示します。

        [承認申請 URL の送信]

        Dataphin がユーザーから送信された承認リクエストを送信する外部承認システムの URL。

        アクセストークン

        アクセストークンは、外部承認システムで認証するために使用される認証情報です。Dataphin は、承認リクエストを送信する際にこのトークンを含めます。

        [接続テスト] をクリックして、Dataphin と外部承認システム間の接続をテストします。テストに失敗した場合は、画面のエラーメッセージに従って問題をトラブルシューティングしてください。

        コールバック URL

        Dataphin が外部承認システムからコールバック結果を受信するための URL。システムはコールバック URL を自動的に生成します。URL はカスタマイズできます。フォーマットは https://<Dataphin deployment domain>/api/oa/bpms/integration/thirdparty/callback です。

        AES キーのエンコーディング

        暗号化と復号のためのキーを入力します。

        icon アイコンをクリックすると、Encoding AES Key が自動的に生成されます。

        外部システムの値のマッピング

        フィールド名

        条件

        値

        操作

        特定の条件なし

        node_name の値。

        結果

        "node_status": "PENDING"

        承認待ち

        "node_status": "APPROVED"

        承認済み

        "node_status": "REJECTED"

        却下

        "node_status": "DELEGATED"

        承認者 ${UserName} を追加

        "node_status": "TRANSFERRED"

        ${UserName} に転送

        オペレーター

        "node_status": "PENDING"

        "approverRelation": "or"

        pending_approvers の user_name からすべての保留中の承認者が取得されます。

        "node_status": "PENDING"

        "approverRelation": "and"

        承認待ち：${approver01}, ${approver02}, ${approver03}

        承認者：${Approver01}, ${Approver02}, ${Approver03}

        その他のケース

        オペレーター

        操作の説明

        "node_status": "PENDING"

        "approverRelation": "or"

        いずれか一人の承認者の承認で十分です。

        "node_status": "PENDING"

        "approverRelation": "and"

        "operator" が空

        すべての承認者の承認が必要です。

        "node_status": "PENDING"

        "approverRelation": "and"

        "operator" が空ではない

        一部の承認者が承認済み：${承認ユーザー}(${理由})、${承認ユーザー}(${理由})...

        例：一部の承認者が承認済み：田中一郎 (同意)、鈴木花子 (要件は合理的、リリースを承認)。

        その他のケース

        オペレーターの reason。

    6. パラメーターを設定した後、[保存] をクリックします。