— IM-Sign 利用ガイド 第7版 2024-04-01
Copyright © 2021 NTT DATA INTRAMART CORPORATION

↑Top

1

— IM-Sign 利用ガイド 第7版 2024-04-01

目次
1. 改訂情報
2. はじめに2.1. 本書の目的
2.2. 対象読者
2.3. 本書の構成
3. IM-Sign for Accel Platformとは
3.1. 概要
3.2. クラウドサイン
3.3. Adobe Acrobat Sign
4. intra-mart Accel Platformとの連携
4.1. intra-mart Accel Platformの製品群と各電子サインサービスとの連携について
4.1.1. 全体図
4.2. 連携フロー概要
5. クラウドサイン連携
5.1. セットアップ
5.1.1. IM-Juggling プロジェクトの編集
5.1.2. ライセンスコードの登録
5.2. 設定ファイル
5.2.1. 概要
5.2.2. リファレンス
5.3. 外部システムユーザ識別子による設定
5.3.1. 概要
5.3.2. 外部システムユーザ識別子設定
5.4. IM-LogicDesigner タスク説明
5.4.1. クラウドサインタスクの一覧
5.5. IM-LogicDesigner サンプルフロー
5.5.1. クラウドサインサンプルフロー
5.6. Webhookをトリガーとした処理
5.6.1. クラウドサイン上のWebhook設定
5.6.2. クラウドサインから intra-mart Accel Platformへの連携概要
5.6.3. WebhookをトリガーとしたIM-LogicDesignerの実行
6. Acrobat Sign連携
6.1. セットアップ
6.1.1. Acrobat Signアプリケーション設定
6.1.2. IM-Juggling プロジェクトの編集
6.1.3. ライセンスコードの登録
6.1.4. 外部連携アプリケーションの登録
6.2. 設定ファイル
6.2.1. 概要
6.2.2. リファレンス
6.3. Acrobat Signタスクの一覧
6.3.1. タスク一覧
6.4. IM-LogicDesigner サンプルフロー
6.4.1. Acrobat Signサンプルフロー
6.5. Webhookをトリガーとした処理
6.5.1. Acrobat Sign上のWebhook設定
6.5.2. Acrobat Signから intra-mart Accel Platformへの連携概要
6.5.3. WebhookをトリガーとしたIM-LogicDesignerの実行
7. 著作権および特記事項2

— IM-Sign 利用ガイド 第7版 2024-04-01
改訂情報
変更年月日

変更内容

2021-04-01

初版

2021-05-31

第2版 以下を追加・変更しました。
「外部システムユーザ識別子による設定」を追加「セットアップ」 にクライアントIDの解決順を追加「設定ファイル」 にクライアントIDの解決順を追加「IM-LogicDesigner タスク説明」 にユーザ切り替えタスクを追加

2021-08-31

第3版 以下を追加・変更しました。
「Webhookをトリガーとした処理」にクラウドサインのWebhook連携用URL設定方法を追加「セットアップ」にAcrobat Signへのアプリケーション設定方法を追加「Webhookをトリガーとした処理」にAcrobat SignのWebhook連携用URL設定方法を追加

2021-12-01

第4版 以下を追加・変更しました。
クラウドサインのWeb API対応バージョンを0.15.0から0.17.0に更新

2022-06-01

第5版 以下を追加・変更しました。
「セットアップ」の「Acrobat Sign開発者ガイド」へのリンク先URLを変更

2022-12-01

第6版 以下を追加・変更しました。
「設定ファイル」のOAuth認証エンドポイントURLを変更「Adobe Sign」の製品名の変更に伴い、ドキュメント内の製品名記載を「Acrobat Sign」に変更

2024-04-01

第7版 以下を追加・変更しました。
「はじめに」の説明にコラムを追加「IM-Sign for Accel Platformとは」のAdobe Acrobat Signの説明を変更「設定ファイル」のdefault-clientタグにbase-url属性の説明を追加「設定ファイル」の説明を変更「Webhookをトリガーとした処理」にクラウドサインの送信元IPアドレスについてのコラムを追加「セットアップ」の説明を変更「Webhookをトリガーとした処理」にAcrobat Signの送信元IPアドレスについてのコラムを追加

3

— IM-Sign 利用ガイド 第7版 2024-04-01
はじめに
本書の目的
本書は、IM-Sign for Accel Platform連携を利用するユーザのみなさまの支援を目的としたドキュメントです。

対象読者
本書では以下のユーザを対象としています。
クラウドサイン連携を利用し、電子契約サービスを呼び出したい
Acrobat Sign連携を利用し、電子サインサービスを呼び出したいコラム
本書では、電子契約サービスと電子サインサービスを区別せず、統一して「電子サイン」と表記します。

本書の構成
本書は以下のように構成されています。
IM-Sign for Accel Platformとは本書、および、IM-Sign for Accel Platform連携の概要について説明します。

クラウドサイン連携
クラウドサイン連携のセットアップ手順、およびIM-LogicDesignerタスクの仕様を説明します。
Acrobat Sign連携
Acrobat Sign連携のセットアップ手順、およびIM-LogicDesignerタスクの仕様を説明します。

著作権および特記事項
著作権および特記事項について記載します。

4

— IM-Sign 利用ガイド 第7版 2024-04-01
IM-Sign for Accel Platformとは項目
概要
クラウドサイン
Adobe Acrobat Sign

概要
IM-Signは、クラウドサイン, Acrobat Signとの接続を容易に行うための IM-LogicDesignerタスクを提供します。
IM-LogicDesignerを介す事により、IM-Workflowや、IM-BPMといった機能との連携を容易にします。
IM-Signを利用することにより、業務プロセス中に電子契約・電子サインサービスを組み込み業務のデジタル化を推進します。

クラウドサインクラウドサインは、弁護士ドットコム株式会社の提供する電子契約サービスです。
日本の法律に特化した弁護士監修のサービスで、ペーパーレスで契約を完了可能です。

Adobe Acrobat Sign
Adobe Acrobat Signは、アドビ（Adobe Inc.）の提供する電子サインサービスです。
PDFソリューションと電子契約ソリューションで書類や契約業務のオンライン化を実現します。

5

— IM-Sign 利用ガイド 第7版 2024-04-01
intra-mart Accel Platformとの連携
項目
intra-mart Accel Platformの製品群と各電子サインサービスとの連携について
全体図
連携フロー概要

intra-mart Accel Platformの製品群と各電子サインサービスとの連携について
IM-Sign for Accel Platform では、IM-LogicDesignerの「電子サイン連携タスク」を使用して、各電子サインサービスを利用することが可能です。
intra-mart Accel Platformの製品群には、BPMやワークフローを簡単に作成・実行できるIM-BPM、IM-Workflow、ローコード画面開発ツールIM-BloomMaker、コミュ
ニケーションツールのIMBox、その他グループウェア、帳票作成、文書管理、ポータルなど様々なラインナップがあり、そのほぼすべてがIM-LogicDesignerのロジック
フローを呼び出すことが可能です。
すなわち、 intra-mart Accel Platformの製品群は全て、IM-Sign for Accel Platformを利用することで、各電子サインサービスと連携できるということです。
さらに、 IM-LogicDesignerは柔軟で堅牢な権限管理機能「認証認可機能」を持ち、これにより適切な権限で電子サインサービスを利用可能です。

全体図
以下は、intra-mart Accel Platform製品群から各電子サインサービスへの連携の全体図です。

図：連携の全体図

連携フロー概要「電子サイン連携タスク」は、以下のようにIM-LogicDesignerを経由して利用します。
「電子サイン連携タスク」には、利用する電子サインサービスの機能によって様々なタスクがあり、複数のタスクを組み合わせることも可能です。
実際の設定方法については、後述する各電子サインサービスとの連携章を参照してください。

図：電子サインサービスの実行シーケンス

6

— IM-Sign 利用ガイド 第7版 2024-04-01
クラウドサイン連携
ここでは、クラウドサイン連携のセットアップ手順、およびIM-LogicDesignerタスクの仕様を説明します。

セットアップ
項目
IM-Juggling プロジェクトの編集ライセンスコードの登録

IM-Juggling プロジェクトの編集クラウドサイン連携は、IM-Sign for Accel Platformモジュールを使用します。
以下の手順で設定を行ってください。
1. IM-Jugglingにて、プロジェクトにIM-Sign for Accel Platformモジュールを追加してください。
以下のドキュメントを参照してください。
「 intra-mart Accel Platform セットアップガイド 」-「 プロジェクトの作成とモジュールの選択 」

注意
IM-Sign for Accel Platformモジュールのご利用には、エンタープライズ版の構成、およびライセンスが必要です。
2. 「ProjectNavigator」内の「 <（プロジェクト名）/conf/cloudsign-config.xml> ファイル」をダブルクリックで開き、「ソース」を選択します。

図：設定ファイルの編集画面
3. 設定ファイルの説明 に従って、設定を記述してください。

コラム
cloudsign-config.xmlの設定にあたっては、事前に クラウドサイン側で クライアントID を発行する必要があります。
詳細は、「クラウドサイン 外部連携-クライアントIDを発行する」を参照してください。
4. 「クラウドサインクライアント設定ファイル」を保存します。

コラム
クラウドサイン連携における クライアントID の解決は以下の順にて行われます。
それぞれの設定は、各章を参照してください。
1. ユーザ切り替えタスク による指定
2. 外部システムユーザ識別子による設定 による指定
3. 設定ファイル による指定
2020 Summer(Zephirine)以前では、 設定ファイルに記載のクライアントIDのみ設定可能です。
5. IM-JugglingでWARファイルを出力し、アプリケーションサーバへデプロイを行ってください。

7

— IM-Sign 利用ガイド 第7版 2024-04-01
ライセンスコードの登録
IM-Sign for Accel Platformを利用するためには、テナント環境セットアップ後、製品ライセンスコードの登録が必要です。
テナント環境セットアップについては、「intra-mart Accel Platform セットアップガイド」-「テナント環境セットアップ」を参照してください。
1. IM-Sign for Accel Platformのライセンス登録を行います。
詳細は「ライセンスの登録」を参照してください。

設定ファイル項目
概要
リファレンス
デフォルトクライアント設定
クライアント設定
クライアント個別設定

概要
クラウドサイン連携 に関する設定です。
モジュール

クラウドサイン連携

フォーマットファイル(xsd) WEB-INF/schema/cloudsign-config.xsd
WEB-INF/conf/cloudsign-config.xml

設定場所<?xml version="1.0" encoding="UTF-8"?><cloudsign-config
xmlns="http://intra-mart.co.jp/cloudsign/cloudsign-config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://intra-mart.co.jp/cloudsign/cloudsign-config ../schema/cloudsign-config.xsd"><default-client id="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"/><clients><client tenant="default" id="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" /><!-<client tenant="sandbox" id="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" base-url="https://api-sandbox.cloudsign.jp" />--></clients></cloudsign-config>

リファレンス
デフォルトクライアント設定
タグ名 default-client
デフォルトとなるクライアント設定です。
操作を行っているユーザのテナント名と一致したclientタグが存在しない場合に利用されます。
【設定項目】<cloudsign-config><default-client>：</default-client></cloudsign-config>

必須項目

×

複数設定

×

設定値・設定する内容 cloudsign-config タグを親とするタグ
単位・型

なし

省略時のデフォルト値 なし
cloudsign-config

親タグ
【属性】
属性名

説明

必須

8

デフォルト値

— IM-Sign 利用ガイド 第7版 2024-04-01
属性名

説明

必須

デフォルト値id

クラウドサインのクライアントID○

なし

base-url

ベースURL×なし

クライアント設定
タグ名 clients
クライアントに関する設定です。
【設定項目】<cloudsign-config><clients>：</clients></cloudsign-config>

必須項目

○

複数設定

×

設定値・設定する内容 clients タグを親とするタグ
単位・型

なし

省略時のデフォルト値 なし
cloudsign-config

親タグ

クライアント個別設定
タグ名 client
クライアント一つに関する設定です。
【設定項目】<cloudsign-config><clients><client tenant="default" id="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX">：</client><client tenant="sandbox" id="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" base-url="https://api-sandbox.cloudsign.jp" /></clients></cloudsign-config>

必須項目

○

複数設定

○

設定値・設定する内容 client タグを親とするタグ
単位・型

なし

省略時のデフォルト値 なし
clients

親タグ
【属性】
属性名

説明

必須

デフォルト値

tenant

テナント名

○

なし

id

クラウドサインのクライアントID○

なし

base-url

ベースURL×なし

9

— IM-Sign 利用ガイド 第7版 2024-04-01
コラム
クラウドサイン連携における クライアントID の解決は以下の順にて行われます。
1. ユーザ切り替えタスクによる指定
2. 外部システムユーザ識別子による指定
3. 設定ファイルによる指定（当該設定）

外部システムユーザ識別子による設定
項目
概要
外部システムユーザ識別子設定

概要
2020 Winter(Azalea)以降では、 外部システムユーザ識別子による クライアントID の設定が可能となりました。
これにより、クラウドサイン連携を行う際、ユーザごとにクラウドサインのアカウントを設定することが可能です。
詳細は、「一般ユーザ操作ガイド」-「外部システムユーザ識別子を設定する」を参照してください。

コラム
クラウドサイン連携における クライアントID の解決は以下の順にて行われます。
1. ユーザ切り替えタスクによる指定
2. 外部システムユーザ識別子による指定（当該設定）
3. 設定ファイルによる指定

コラム2020 Summer(Zephirine)以前では、当該画面はご利用できません。
2020 Summer(Zephirine)以前では、 クライアントID は設定ファイルでのみ指定可能です。

外部システムユーザ識別子設定
1. 「サイトマップ」→「個人設定」→「プロファイル」をクリックします。
2. ツールバーの「外部システムユーザ識別子設定」をクリックします。
3. 「外部システム名」 CloudSign の「ユーザ識別子」に クライアントID を設定します。

図：外部システムユーザ識別子設定画面

IM-LogicDesigner タスク説明項目
クラウドサインタスクの一覧
タスク一覧
ユーザ切り替えタスク
入力値
出力値

クラウドサインタスクの一覧
クラウドサインタスクは、下記一覧に記載の26個を利用することが可能です。

10

— IM-Sign 利用ガイド 第7版 2024-04-01
IM-LogicDesignerの各タスクにおける入力値、および出力値については、クラウドサインの入出力値と一致します。
「クラウドサイン Web API」を参照してください。
APIのバージョンは 0.17.0 に対応しています。

コラム
ロジックフロー定義編集画面にて、クラウドサインのカテゴリおよびタスクのアイコンが表示されない場合、アイコンのリカバリを実行することで表示されるようになる場合があります。
詳細は、「IM-LogicDesigner ユーザ操作ガイド」 - 「ユーザアイコンをリカバリする」を参照してください。

タスク一覧
LDタスク名

説明

メソッド

URI

im_cloudsignGetToken

アクセストークンの取得

POST/tokenim_cloudsignSwitchUser

ユーザ切り替え

（後述）

（後述）

im_cloudsignCreateDocument

書類の作成

POST

/documents

im_cloudsignGetDocuments

書類一覧の取得

GET/documents

im_cloudsignGetDocument

書類データの取得

GET/documents/{documentID}

im_cloudsignUpdateDocument

書類データの更新

PUT/documents/{documentID}

im_cloudsignDeleteDocument

書類データの削除

DELETE/documents/{documentID}

im_cloudsignSendOrRemind

送信またはリマインド

POST/documents/{documentID}

im_cloudsignGetAttribute

書類情報の取得

GET/documents/{documentID}/attribute

PUT/documents/{documentID}/attribute

im_cloudsignCreateOrUpdateAttribute 書類情報の作成はまたは更新
im_cloudsignGetCertificate

合意締結証明書の取得

GET/documents/{documentID}/certificate

im_cloudsignDecline

確認中の書類を却下する

PUT/documents/{documentID}/decline

im_cloudsignAttachFile

ファイルの添付

POST/documents/{documentID}/files

im_cloudsignGetAttachmentFile

ファイルの取得

GET/documents/{documentID}/files/{fileID}im_cloudsignDeleteAttachmentFile

添付ファイルの削除

DELETE/documents/{documentID}/files/{fileID}im_cloudsignAddParticipant

宛先の追加

POST

/documents/{documentID}/participants

im_cloudsignUpdateParticipant

宛先の更新

PUT

/documents/{documentID}/participants/{participantID}

im_cloudsignDeleteParticipant

宛先の削除

DELETE/documents/{documentID}/participants/{participantID}

im_cloudsignAddWidget

入力項目の追加

POST/documents/{documentID}/files/{fileID}/widgets

im_cloudsignUpdateWidget

入力項目の内容変更

PUT/documents/{documentID}/files/{fileID}/widgets/{widgetID}

im_cloudsignDeleteWidget

入力項目の削除DELETE/documents/{documentID}/files/{fileID}/widgets/{widgetID}

im_cloudsignGetTeamDocuments

チームドキュメントの取得

GET/team_documents

im_cloudsignGetMe

ユーザ情報及びチーム情報

GET

/me

取得
im_cloudsignAddReportee

共有先の追加POST/documents/{documentID}/reportees

im_cloudsignUpdateReportee

共有先の更新PUT​/documents​/{documentID}​/reportees​/{reporteeID}

im_cloudsignDeleteReportee

共有先の削除DELETE/documents/{documentID}/reportees/{reporteeID}

ユーザ切り替えタスク
タスク一覧に記載の im_cloudsignSwitchUser （ユーザ切り替え）タスクは特殊タスクです。
データマッピングでクライアントIDを受け渡すと、以降のクラウドサイン関連のタスクではクライアントIDが切り替わって処理が行われます。
このタスクを配置したロジックフローにおいて、このタスク以降のクラウドサインタスクに影響します。

コラム
本タスクは 2020 Winter(Azalea)以降で利用可能です。

11

— IM-Sign 利用ガイド 第7版 2024-04-01
コラム
クラウドサイン連携における クライアントID の解決は以下の順にて行われます。
1. ユーザ切り替えタスクによる指定（当該設定）
2. 外部システムユーザ識別子による指定
3. 設定ファイルによる指定

入力値
im_cloudsignSwitchUser <object>└─ clientId <string> *

必須/任意

型

配列/リスト説明

im_cloudsignSwitchUser 任意

objectなし-

clientId

stringなし

クラウドサインのクライアントIDです。

項目名

必須

出力値
im_cloudsignSwitchUser <any>

項目名型

im_cloudsignSwitchUser object

配列/リスト

説明なし

出力値として利用可能な値はありません。

IM-LogicDesigner サンプルフロー
項目
クラウドサインサンプルフロー
書類の作成、ファイルの添付、送信フロー
フロー概要
入力値
出力値
クラウドサインステータスチェック〜リマインダー送付フロー
フロー概要
入力値
出力値
クラウドサイン合意締結済み書類に含まれる添付ファイルのダウンロードフロー
フロー概要
入力値
出力値

クラウドサインサンプルフロー
クラウドサイン連携で行うための IM-LogicDesignerサンプルフローを紹介します。
下記よりサンプルの IM-LogicDesignerフローをダウンロードし、開発用のintra-mart環境等にインポートしてご利用ください。
サンプルフローのダウンロード

コラム
本サンプルはクラウドサイン連携の理解を早期に行うためのサンプルフローです。
実運用にあたっては要件を十分に確認して、必要に応じてフローを変更してください。

コラム
本サンプルは2021 Spring(Bergamot)以降のIM-LogicDesignerでインポートしてご利用頂けます。

書類の作成、ファイルの添付、送信フロー
フロー概要
クラウドサイン 連携における契約ファイルのアップロード、契約の作成を行うサンプルフローです12

— IM-Sign 利用ガイド 第7版 2024-04-01

図：書類の作成、ファイルの添付、送信フロー

入力値$input <object>├─ title <string>├─ participants <string>└─ storageFilePath <string>

項目名型

配列/リスト

設定例

説明

title

stringなし

XXXにおける秘密保持契約

契約名participants

string配列

target@example.org

送信先メールアドレス

storageFilePathstringなし

IM-Sign/秘密保持契約書.pdf

添付ファイルのストレージファイル
パス

コラム[1] クラウドサイン側が利用する各パラメータについては、タスク一覧より、 IM-LogicDesignerタスクと対象のAPIをご確認の頂き、「クラウドサ
イン Web API」を参照してください。
[2] 記載の内容はオブジェクトの一部で、サンプルに必要な部分のみを抜粋しております。
オブジェクトの全ての変数については、「クラウドサイン Web API」を参照してください。

出力値$output <object>└─ documentId <string>

項目名型

配列/リスト 説明agreementId

stringなし

書類作成時に発行された書類ID

クラウドサインステータスチェック〜リマインダー送付フロー
フロー概要
クラウドサイン 連携において、書類のステータスをチェックし、未署名のメンバーにリマインダーを送付するサンプルフローです。

13

— IM-Sign 利用ガイド 第7版 2024-04-01

図：ステータスチェック〜リマインダー送付フロー

入力値$input <object>└─ documentId <string>

項目名型

配列/リスト

設定例

説明

documentId

stringなし

書類の作成時に発行された書類ID

書類作成時に発行される契約ID

コラム
各タスク間のパラメータ連携については、インポートしたフローのデータマッピングを参照してください。

出力値
出力値はありません

クラウドサイン合意締結済み書類に含まれる添付ファイルのダウンロードフロー
フロー概要
クラウドサイン 連携において、締結済み書類の添付ファイルをダウンロードし、ストレージに保存するサンプルフローです。
文書は「添付ファイル名」+「yyyyMMddHH」+「.pdf」でストレージ直下に保存します。

14

— IM-Sign 利用ガイド 第7版 2024-04-01

図：合意締結済み書類に含まれる添付ファイルのダウンロードフロー

入力値$input <object>└─ documentId <string>

項目名型

配列/リスト

設定例

説明

documentId

stringなし

書類を作成した際に発行されたID

書類作成時に発行される書類ID

コラム
各タスク間のパラメータ連携については、インポートしたフローのデータマッピングを参照してください。

出力値
出力値はありません

Webhookをトリガーとした処理
項目
クラウドサイン上のWebhook設定
クラウドサインから intra-mart Accel Platformへの連携概要
WebhookをトリガーとしたIM-LogicDesignerの実行

クラウドサイン上のWebhook設定
クラウドサインから intra-mart Accel Platformへの連携を行うにあたり、クラウドサインの管理画面よりWebhook連携設定を行う必要があります。
クラウドサインの管理画面より、「チーム / チーム設定」メニュー内の「WEB API (Hook URL)」を入力する項目に、 intra-mart Accel Platform のWebhook用URLとして、以下のいずれかを設定してください。
<%intra-martのベースURL%>/cloudsign/webhook

http(s)://<%ホスト名%>:<%ポート番号%>/<%コンテキストパス%>/cloudsign/webhook

intra-mart Accel Platform側では、テナントの自動解決が行われます。
特定のバーチャルテナントを指定する場合には下記のようにURLの末尾にテナントIDを付与します。
<%intra-martのベースURL%>/cloudsign/webhook/<%テナントID%>

http(s)://<%ホスト名%>:<%ポート番号%>/<%コンテキストパス%>/cloudsign/webhook/<%テナントID%>

15

— IM-Sign 利用ガイド 第7版 2024-04-01
コラム
Webhookの通信がクラウドサインサーバから行われる際、送信元のIPアドレスの範囲は以下のいずれかです。
（2023年10月1日現在）
本番環境の場合52.68.17.229/32
52.198.144.82/32
3.112.114.42
sandbox環境の場合
52.197.119.179/32
ご利用されるWebサーバやクラウドサービスの設定において、IPアドレスによるアクセス制限を有効にしている場合は、上記の送信元IPアドレスからのアクセスを許可してください。
最新の情報については、クラウドサインの「Webhook 機能」を参照してください。

クラウドサインから intra-mart Accel Platformへの連携概要
クラウドサインからのWebhook通知先をintra-mart Accel Platformにすることで、契約完了時にintra-mart Accel Platformのコミュニケーションツールに通知した
り、ワークフローを連動することが可能です。
本連携については、IM-LogicDesignerの「トリガ定義」を使用して実現します。

図：クラウドサインから intra-mart Accel Platformへの連携概要

WebhookをトリガーとしたIM-LogicDesignerの実行
下記のようにIM-LogicDesignerの「トリガ定義」を設定し、任意のIM-LogicDesignerフローを実行します。
詳細は、「IM-LogicDesigner ユーザ操作ガイド」 - 「トリガー定義」を参照してください。

16

— IM-Sign 利用ガイド 第7版 2024-04-01

図：WebhookをトリガーとしたIM-LogicDesignerの設定例

17

— IM-Sign 利用ガイド 第7版 2024-04-01
Acrobat Sign連携
ここでは、Acrobat Sign連携のセットアップ手順、およびIM-LogicDesignerタスクの仕様を説明します。

セットアップ
項目
Acrobat Signアプリケーション設定
IM-Juggling プロジェクトの編集ライセンスコードの登録
外部連携アプリケーションの登録

Acrobat Signアプリケーション設定
IM-Juggling プロジェクトを編集する前に、 Acrobat Signへアプリケーションとしてintra-mart Accel Platformを登録します。
1. Acrobat Signサイトにログインし、「Acrobat Sign API」 > 「APIアプリケーション」を開きます。
「+」ボタンをクリックして、新しくアプリケーションを登録します。

2. 「名前」と「表示名」に任意の文字列を入力し、 「ドメイン」は「顧客」を選択して、保存します。

3. 登録したアプリケーションの「表示/編集」をクリックし、記載されている「アプリケーションID」、「クライアントシークレット」の文字列を別途控えておいてください。
これらの文字列は、この後の手順で使用します。

18

— IM-Sign 利用ガイド 第7版 2024-04-01

4. 登録したアプリケーションの「アプリケーション向けに OAuth を設定」をクリックします。
リダイレクトURIとして以下のいずれかのアドレスを設定します。
<%intra-martのベースURL%>/oauth/redirect

https://<%intra-martのホスト名%>:<%ポート%>/<%コンテキストパス%>/oauth/redirect

また、有効な範囲として以下を有効化してください。
user_read:accountuser_write:accountuser_login:accountagreement_read:accountagreement_write:accountwidget_read:accountwidget_write:accountlibrary_read:accountlibrary_write:accountworkflow_read:accountwebhook_read:accountwebhook_write:accountwebhook_retention:account19

— IM-Sign 利用ガイド 第7版 2024-04-01

コラム
Acrobat Sign画面の操作の詳細については、「Acrobat Sign開発者ガイド（英語）」を参照してください。

IM-Juggling プロジェクトの編集
Acrobat Sign連携は、IM-Sign for Accel Platformモジュールを使用します。
以下の手順で設定を行ってください。
1. IM-Jugglingにて、プロジェクトにIM-Sign for Accel Platformモジュールを追加してください。
以下のドキュメントを参照してください。
「 intra-mart Accel Platform セットアップガイド 」-「 プロジェクトの作成とモジュールの選択 」

注意
IM-Sign for Accel Platformモジュールのご利用には、エンタープライズ版の構成、およびライセンスが必要です。
2. 「ProjectNavigator」内の「 <（プロジェクト名）/conf/oauth-provider-config/im_adobesign.xml> ファイル」をダブルクリックで開き、「ソース」を選択
します。

20

— IM-Sign 利用ガイド 第7版 2024-04-01

図：設定ファイルの編集画面
3. Acrobat Sign画面 で取得した「アプリケーションID」と「クライアントシークレット」を利用します。
<client-id> に「アプリケーションID」を 、<client-secret> に「クライアントシークレット」を記述してください。

設定ファイルの説明 も参照してください。
4. 「Acrobat Signクライアント設定ファイル」を保存します。
5. IM-JugglingでWARファイルを出力し、アプリケーションサーバへデプロイを行ってください。

ライセンスコードの登録
IM-Sign for Accel Platformを利用するためには、テナント環境セットアップ後、製品ライセンスコードの登録が必要です。
テナント環境セットアップについては、「intra-mart Accel Platform セットアップガイド」-「テナント環境セットアップ」を参照してください。
1. IM-Sign for Accel Platformのライセンス登録を行います。
詳細は「ライセンスの登録」を参照してください。

外部連携アプリケーションの登録
IM-Sign for Accel PlatformでAcrobat Signを利用するためには、Acrobat SignAPIの許可設定が必要です。

図：外部連携アプリケーションの登録画面
1. 「ポータル」→「個人設定」→「外部連携アプリケーション」をクリックして、「利用可能なアプリケーション」よりAcrobat SignAPIアイコンをクリックします。

コラム
利用可能なアプリケーションに Acrobat SignAPI が表示されない場合、いずれかの手順が抜けている可能性があります。
デプロイから作業を再実施してください。

21

— IM-Sign 利用ガイド 第7版 2024-04-01
コラム
外部連携アプリケーションとしてAcrobat Signと連携を行う場合、intra-mart Accel Platformの通信プロトコルは https による連携が必須です。
ご利用されるWebサーバで https プロトコルを有効にしてください。
開発中の場合、デバッグサーバ（Resin）を利用されている場合には、<resin.properties>ファイルに含まれる app.https: 8443 の項目を有効に（アンコメント）する事により8443ポートでのhttps通信が行えます。
（例: https://example.org:8443/imart/login）
2. Acrobat Signサイトに移動してログイン、および認証を行ってください。
3. Acrobat Signサイトで認証後、外部連携アプリケーションの登録画面の「利用中のアプリケーション」にAcrobat SignAPIアイコンが表示されることを確認してください。

設定ファイル項目
概要
リファレンス

概要
Acrobat Sign連携 に関する設定です。
モジュール

Acrobat Sign連携

フォーマットファイル(xsd) WEB-INF/schema/oauth-provider-config.xsd
設定場所

WEB-INF/conf/oauth-provider-config/im_adobesign.xml<?xml version="1.0" encoding="UTF-8"?><oauth-provider-config xmlns="http://www.intra-mart.jp/system/oauth/client/config/oauth-provider-config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.intra-mart.jp/system/oauth/client/config/oauth-provider-config ../schema/oauth-provider-config.xsd "><oauth-providers><oauth-provider id="adobesign"><provider-type>adobesign</provider-type><name message-cd="CAP.Z.IWP.ADOBESIGN.OAUTH.PROVIDER.NAME">Adobe Acrobat Sign API</name><description message-cd="CAP.Z.IWP.ADOBESIGN.OAUTH.PROVIDER.DESCRIPTION">Allows you to use the Adobe Acrobat Sign API.
Use the AdobeSign API to perform signature integration.</description><icon-path>im_adobesign/images/im_adobesign.png</icon-path><oauth-config><authz-end-point>https://secure.jp1.echosign.com/public/oauth/v2</authz-end-point><token-end-point>https://api.jp1.echosign.com/oauth/v2/token</token-end-point><client-id>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</client-id><client-secret>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</client-secret><scope>user_read:account user_write:account user_login:account agreement_read:account agreement_write:account widget_read:accountwidget_write:account library_read:account library_write:account workflow_read:account webhook_read:account webhook_write:accountwebhook_retention:account</scope></oauth-config><extra-config><!-- 以下は通常変更する必要はありません --><parameter name="web_client_id">UB7E5BXCXY</parameter></extra-config></oauth-provider></oauth-providers></oauth-provider-config>

リファレンスリファレンスは、「設定ファイルリファレンス」 - 「プロバイダ設定」を参照してください。
当設定ファイルで編集が必要な箇所は、通常、client-id 、client-secret のみです。各設定値については、Acrobat Signより取得してください。

コラム
国外の環境でAcrobat Signとの連携を行う場合は、authz-end-point、token-end-point を設定する必要があります。

Acrobat Signタスクの一覧
Acrobat Signタスクは、下記一覧に記載の130個を利用することが可能です。
IM-LogicDesignerの各タスクにおける入力値、および出力値については、Acrobat Signの入出力値と一致します。
「Acrobat Sign REST API Version 6 Methods」を参照してください。

22

— IM-Sign 利用ガイド 第7版 2024-04-01
コラム
ロジックフロー定義編集画面にて、Acrobat Signのカテゴリおよびタスクのアイコンが表示されない場合、アイコンのリカバリを実行することで表示されるようになる場合があります。
詳細は、「IM-LogicDesigner ユーザ操作ガイド」 - 「ユーザアイコンをリカバリする」を参照してください。

タスク一覧
Acrobat Signタスクは、IM-LogicDesignerのカテゴリを以下の6つに分けて格納しています。

契約カテゴリ
メソッ
LDタスク名説明

im_adobesignTransientDocuments

ファイ POSTド

URI/transientDocuments

ルの
アップ
ロード
im_adobesignCreateAgreement

契約を POST/agreements

作成
im_adobesignAddTemplateFieldsToAgreement

契約に POST/agreements/{agreementId}/formFields

テンプ
レート
フィー
ルドを
追加
im_adobesignCreateDelegatedParticipantSets

契約の POST/agreements/{agreementId}/members/participantSets/{participantSetId}/delega

受信者
セット
を登録
im_adobesignCreateShareOnAgreement

契約を POST/agreements/{agreementId}/members/share共有
im_adobesignCreateReminderOnParticipant

契約の POST/agreements/{agreementId}/reminders

リマイ
ンダー
を登録
im_adobesignCreateAgreementViews

契約の POST/agreements/{agreementId}/views

参照
URLを
取得
im_adobesignGetAgreements

契約の GET/agreements

検索
im_adobesignGetAgreementInfo

契約情 GET/agreements/{agreementId}

報を取得
im_adobesignGetAgreementAuditTrail

契約の GET/agreements/{agreementId}/auditTrail

監査レ
ポート
を取得
im_adobesignGetAgreementCombinedDocument

契約の GET/agreements/{agreementId}/combinedDocument

PDFを取得
im_adobesignGetCombinedDocumentPagesInfo

契約の GET/agreements/{agreementId}/combinedDocument/pagesInfo

PDF情
報を取
得
im_adobesignGetAgreementCombinedDocumentUrl

契約の GET/agreements/{agreementId}/combinedDocument/url

PDFの
ダウン
ロード
URLを
取得
im_adobesignGetAgreementAllDocuments

契約の GET
ファイ
ルを取
得

23

/agreements/{agreementId}/documents

— IM-Sign 利用ガイド 第7版 2024-04-01
メソッ
LDタスク名説明

im_adobesignGetAgreementDocument

契約の GETド

URI/agreements/{agreementId}/documents/{documentId}

個別
ファイ
ルを取
得
im_adobesignGetAgreementDocumentImageUrls

契約の GET/agreements/{agreementId}/documents/{documentId}/imageUrls

個別
ファイ
ルイ
メージ
URLを
取得
im_adobesignGetAgreementAllDocumentsImageUrls

契約の GET/agreements/{agreementId}/documents/imageUrls

ファイ
ルイ
メージ
URLを
取得
im_adobesignGetAgreementEvents

契約の GET/agreements/{agreementId}/events

アク
ティビ
ティを
取得
im_adobesignGetAgreementFormData

契約の GET/agreements/{agreementId}/formData

フォー
ムデー
タを取
得
im_adobesignGetAgreementFormFields

契約の GET/agreements/{agreementId}/formFields

フィー
ルドを
取得
im_adobesignGetAgreementMergeInfo

契約の GET/agreements/{agreementId}/formFields/mergeInfo

マージ
情報を
更新
im_adobesignGetAgreementNoteForApiUser

契約の GET/agreements/{agreementId}/me/note

メモを取得
im_adobesignGetAllAgreementMembers

契約の GET/agreements/{agreementId}/members

参加者を取得
im_adobesignGetAgreementParticipantSet

契約の GET/agreements/{agreementId}/members/participantSets/{participantSetId}

受信者
セット
を取得
im_adobesignGetAgreementSecurityOptionsForParticipation

契約の GET/agreements/{agreementId}/members/participantSets/{participantSetId}/partic

受信者
のセ
キュリ
ティオ
プショ
ンを取
得
im_adobesignGetAgreementReminders

契約の GET/agreements/{agreementId}/reminders

リマイ
ンダー
の検索
im_adobesignGetAgreementReminder

契約の GET
リマイ
ンダー
情報を
取得

24

/agreements/{agreementId}/reminders/{reminderId}

— IM-Sign 利用ガイド 第7版 2024-04-01
メソッ
LDタスク名説明

im_adobesignGetAgreementSigningUrls

契約の GET

URI

ド/agreements/{agreementId}/signingUrls

署名
URLを
取得
im_adobesignGetAgreementInfoForUser

契約の GET/agreements/{agreementId}/me

アカウ
ント共
有情報
を取得
im_adobesignUpdateAgreement

契約を PUT/agreements/{agreementId}

更新
im_adobesignUpdateAgreementFormFields

契約の PUT/agreements/{agreementId}/formFields

フィー
ルドを
更新
im_adobesignUpdateAgreementMergeInfo

契約の PUT/agreements/{agreementId}/formFields/mergeInfo

マージ
情報を
更新
im_adobesignUpdateAgreementVisibility

契約の PUT/agreements/{agreementId}/me/visibility

可視性を更新
im_adobesignUpdateAgreementVaulted

ヴォー PUT/agreements/{agreementId}/vaulted

ルト
サービ
ス契約
情報更
新
im_adobesignUpdateAgreementParticipantSet

契約の PUT/agreements/{agreementId}/members/participantSets/{participantSetId}

受信者
セット
を更新
im_adobesignRejectAgreementForParticipation

契約を PUT/agreements/{agreementId}/members/participantSets/{participantSetId}/partic

拒否
im_adobesignUpdateAgreementSecurityOptionsForParticipation 契約の PUT/agreements/{agreementId}/members/participantSets/{participantSetId}/partic

受信者
のセ
キュリ
ティオ
プショ
ンを更
新
im_adobesignUpdateAgreementReminder

契約の PUT/agreements/{agreementId}/reminders/{reminderId}

リマイ
ンダー
を更新
im_adobesignUpdateAgreementState

契約の PUT/agreements/{agreementId}/state

ステー
タスを
更新
im_adobesignUpdateAgreementNoteForApiUser

契約の PUT/agreements/{agreementId}/me/note

メモを更新
im_adobesignDeleteAgreementDocuments

契約の DELETE /agreements/{agreementId}/documents
ファイ
ルを削
除

ユーザ/グループカテゴリ
LDタスク名

説明

メソッド

URI

im_adobesignGetUserViews

ユーザの参照URLを取得

POST/users/{userId}/views

im_adobesignGetUsers

ユーザを検索GET/users25

— IM-Sign 利用ガイド 第7版 2024-04-01
LDタスク名

説明

メソッド

URI

im_adobesignGetUserDetail

ユーザ情報を取得

GET/users/{userId}

im_adobesignGetGroupsOfUser

ユーザの所属グループを取得

GET/users/{userId}/groups

im_adobesignUpdateUser

ユーザを更新PUT/users/{userId}

im_adobesignUpdateGroupsOfUser ユーザの所属グループを更新

PUT/users/{userId}/groups

im_adobesignUpdateUserState

ユーザのステータス更新

PUT/users/{userId}/state

im_adobesignCreateGroup

グループを登録

POST/groups

im_adobesignGetGroups

グループを検索

GET/groups

im_adobesignGetGroupDetail

グループ情報を取得

GET/groups/{groupId}

im_adobesignGetUsersInGroup

グループに所属するユーザを取得

GET/groups/{groupId}/users

im_adobesignUpdateGroup

グループを更新

PUT/groups/{groupId}

im_adobesignDeleteGroup

グループを削除DELETE/groups/{groupId}

ライブラリテンプレートカテゴリ
メ
ソッ
LDタスク名説明

im_adobesignCreateLibraryDocument

ライブ POST /libraryDocuments

ド

URI

ラリテ
ンプ
レート
を登録
im_adobesignCreateLibraryDocumentViews

ライブ POST /libraryDocuments/{libraryDocumentId}/views
ラリテ
ンプ
レート
の参照
URLを
取得

im_adobesignGetLibraryDocuments

ライブ GET/libraryDocuments

ラリテ
ンプ
レート
を検索
im_adobesignGetLibraryDocumentInfo

ライブ GET/libraryDocuments/{libraryDocumentId}

ラリテ
ンプ
レート
情報を
取得
im_adobesignGetLibraryDocumentAuditTrail

ライブ GET/libraryDocuments/{libraryDocumentId}/auditTrail

ラリテ
ンプ
レート
の監査
レポー
トを取
得
im_adobesignGetLibraryDocumentCombinedDocument

ライブ GET/libraryDocuments/{libraryDocumentId}/combinedDocument

ラリテ
ンプ
レート
のPDF
を取得
im_adobesignGetLibraryDocumentCombinedDocumentUrl ライブ GET/libraryDocuments/{libraryDocumentId}/combinedDocument/url

ラリテ
ンプ
レート
のPDF
のダウ
ンロー
ドURL
を取得

26

— IM-Sign 利用ガイド 第7版 2024-04-01
メ
ソッ
LDタスク名説明

im_adobesignGetLibraryDocumentDocuments

ライブ GETド

URI/libraryDocuments/{libraryDocumentId}/documents

ラリテ
ンプ
レート
のファ
イルを
取得
im_adobesignGetLibraryDocumentDocument

ライブ GET/libraryDocuments/{libraryDocumentId}/documents/{documentId}

ラリテ
ンプ
レート
の個別
ファイ
ルを取
得
im_adobesignGetLibraryDocumentImageUrls

ライブ GET/libraryDocuments/{libraryDocumentId}/documents/{documentId}/imageUrls

ラリテ
ンプ
レート
の個別
ファイ
ルイ
メージ
URLを
取得
im_adobesignGetLibraryDocumentFormData

ライブ GET/libraryDocuments/{libraryDocumentId}/formData

ラリテ
ンプ
レート
の
フォー
ムデー
タを取
得
im_adobesignGetLibraryDocumentFormFields

ライブ GET/libraryDocuments/{libraryDocumentId}/formFields

ラリテ
ンプ
レート
の
フィー
ルドを
取得
im_adobesignGetAllLibraryDocumentMembers

ライブ GET/libraryDocuments/{libraryDocumentId}/members

ラリテ
ンプ
レート
の参加
者を取
得
im_adobesignGetLibraryDocumentInfoForUser

ライブ GET/libraryDocuments/{libraryDocumentId}/me

ラリテ
ンプ
レート
のアカ
ウント
共有情
報を取
得
im_adobesignGetLibraryDocumentEvents

ライブ GET/libraryDocuments/{libraryDocumentId}/events

ラリテ
ンプ
レート
のアク
ティビ
ティを
取得

27

— IM-Sign 利用ガイド 第7版 2024-04-01
メ
ソッ
LDタスク名説明

im_adobesignGetLibraryDocumentNoteForApiUser

ライブ GET

URI

ド/libraryDocuments/{libraryDocumentId}/me/note

ラリテ
ンプ
レート
のメモ
を取得
im_adobesignUpdateLibraryDocumentFormFields

ライブ PUT/libraryDocuments/{libraryDocumentId}/formFields

ラリテ
ンプ
レート
の
フィー
ルドを
更新
im_adobesignUpdateLibraryDocumentNoteForApiUser

ライブ PUT/libraryDocuments/{libraryDocumentId}/me/note

ラリテ
ンプ
レート
のメモ
を更新
im_adobesignUpdateLibraryDocument

ライブ PUT/libraryDocuments/{libraryDocumentId}

ラリテ
ンプ
レート
を更新
im_adobesignUpdateLibraryDocumentVisibility

ライブ PUT/libraryDocuments/{libraryDocumentId}/me/visibility

ラリテ
ンプ
レート
の可視
性を更
新
im_adobesignUpdateLibraryDocumentState

ライブ PUT/libraryDocuments/{libraryDocumentId}/state

ラリテ
ンプ
レート
のス
テータ
ス更新

Webフォームカテゴリ
メソッ
LDタスク名説明

ド

URI

im_adobesignCreateWidget

Web

POST /widgets

フォー
ムを登
録
im_adobesignCreateShareOnWidget

Web

POST /widgets/{widgetId}/members/share

フォー
ムを共
有
im_adobesignGetWidgetViews

Web

POST /widgets/{widgetId}/views

フォー
ムの参
照URL
を取得
im_adobesignGetWidgets

Web

GET

/widgets

フォー
ムを検
索

28

— IM-Sign 利用ガイド 第7版 2024-04-01
メ
ソッ
LDタスク名説明

ド

URI

im_adobesignGetWidgetInfo

Web

GET

/widgets/{widgetId}

GET/widgets/{widgetId}/agreements

GET/widgets/{widgetId}/auditTrail

GET/widgets/{widgetId}/combinedDocument

GET/widgets/{widgetId}/combinedDocument/url

GET/widgets/{widgetId}/documents

GET/widgets/{widgetId}/documents/{documentId}

GET/widgets/{widgetId}/events

GET/widgets/{widgetId}/formFields

GET/widgets/{widgetId}/documents/imageUrls

フォー
ム情報
の取得
im_adobesignGetWidgetAgreements

Web
フォー
ムに紐
づく子
契約の
取得

im_adobesignGetWidgetAuditTrail

Web
フォー
ムの監
査レ
ポート
を取得

im_adobesignGetWidgetCombinedDocument

Web
フォー
ムの
PDFを
取得

im_adobesignGetWidgetCombinedDocumentUrl

Web
フォー
ムの
PDFの
ダウン
ロード
URLを
取得

im_adobesignGetWidgetDocuments

Web
フォー
ムの
ファイ
ルを取
得

im_adobesignGetWidgetDocument

Web
フォー
ムの個
別ファ
イルを
取得

im_adobesignGetWidgetEvents

Web
フォー
ムのア
クティ
ビティ
を取得

im_adobesignGetWidgetFormFields

Web
フォー
ムの
フィー
ルドを
取得

im_adobesignGetWidgetAllDocumentsImageUrls

Web
フォー
ムの
ファイ
ルイ
メージ
URLを
取得

29

— IM-Sign 利用ガイド 第7版 2024-04-01
メ
ソッ
LDタスク名説明

ド

URI

im_adobesignGetWidgetFormData

Web

GET

/widgets/{widgetId}/formData

GET/widgets/{widgetId}/me/note

GET/widgets/{widgetId}/members

GET/widgets/{widgetId}/members/participantSets/{participantSetId}

GET/widgets/{widgetId}/members/participantSets/{participantSetId}/participants/{particip

GET/widgets/{widgetId}/me

PUT/widgets/{widgetId}

PUT/widgets/{widgetId}/formFields

PUT/widgets/{widgetId}/me/visibility

PUT/widgets/{widgetId}/state

PUT/widgets/{widgetId}/me/note

フォー
ムの
フォー
ムデー
タを取
得
im_adobesignGetWidgetNoteForApiUser

Web
フォー
ムのメ
モを取
得

im_adobesignGetAllWidgetMembers

Web
フォー
ムの参
加者を
取得

im_adobesignGetWidgetParticipantSet

Web
フォー
ムの受
信者
セット
を取得

im_adobesignGetWidgetSecurityOptionsForParticipation

Web
フォー
ムの受
信者の
セキュ
リティ
オプ
ション
を取得

im_adobesignGetWidgetInfoForUser

Web
フォー
ムのア
カウン
ト共有
情報を
取得

im_adobesignUpdateWidget

Web
フォー
ムを更
新

im_adobesignUpdateWidgetFormFields

Web
フォー
ムの
フィー
ルドを
更新

im_adobesignUpdateWidgetVisibility

Web
フォー
ムの可
視性を
更新

im_adobesignUpdateWidgetState

Web
フォー
ムのス
テータ
ス更新

im_adobesignUpdateWidgetNoteForApiUser

Web
フォー
ムのメ
モを更
新

30

— IM-Sign 利用ガイド 第7版 2024-04-01
メ
ソッ
LDタスク名説明

im_adobesignUpdateWidgetSecurityOptionsForParticipation Web

ド

URI

PUT

/widgets/{widgetId}/members/participantSets/{participantSetId}/participants/{particip

フォー
ムの受
信者の
セキュ
リティ
オプ
ション
を更新

Megaサインカテゴリ
メソッ
LDタスク名説明

im_adobesignCreateMegaSign

Megaサ POSTド

URI
/megaSigns

インを登録
im_adobesignCreateShareOnMegaSign

Megaサ POST

/megaSigns/{megaSignId}/members/share

インを共有
im_adobesignCreateReminderOnMegaSign

Megaサ POST

/megaSigns/{megaSignId}/reminders

インの
リマイ
ンダー
を登録
im_adobesignGetMegaSignViews

Megaサ POST

/megaSigns/{megaSignId}/views

インの
参照
URLを
取得
im_adobesignGetMegaSigns

Megaサ GET

/megaSigns

インを検索
im_adobesignGetMegaSignInfo

Megaサ GET

/megaSigns/{megaSignId}

イン情
報を取
得
im_adobesignGetMegaSignChildAgreements

Megaサ GET

/megaSigns/{megaSignId}/agreements

インに
紐づく
契約を
取得
im_adobesignGetMegaSignChildAgreementsInfoFile Megaサ GET/megaSigns/{megaSignId}/childAgreementsInfo/{childAgreementsInfoFileId}

インに
紐づく
契約情
報ファ
イルを
取得
im_adobesignGetMegaSignCombinedDocument

Megaサ GET

/megaSigns/{megaSignId}/combinedDocument

インの
PDFを
取得
im_adobesignGetMegaSignCombinedDocumentUrl

Megaサ GET

/megaSigns/{megaSignId}/combinedDocument/url

インの
PDFの
ダウン
ロード
URLを
取得

31

— IM-Sign 利用ガイド 第7版 2024-04-01
メソッ
LDタスク名説明

im_adobesignGetMegaSignEvents

Megaサ GETド

URI/megaSigns/{megaSignId}/events

インの
アク
ティビ
ティを
取得
im_adobesignGetMegaSignFormData

Megaサ GET

/megaSigns/{megaSignId}/formData

インの
フォー
ムデー
タを取
得
im_adobesignGetAllMegaSignMembers

Megaサ GET

/megaSigns/{megaSignId}/members

インの
参加者
を取得
im_adobesignGetMegaSignNoteForApiUser

Megaサ GET

/megaSigns/{megaSignId}/me/note

インの
メモを
取得
im_adobesignGetMegaSignAllDocumentsImageUrls Megaサ GET/megaSigns/{megaSignId}/documents/imageUrls

インの
ファイ
ルイ
メージ
URLを
取得
im_adobesignGetMegaSignAllDocuments

Megaサ GET

/megaSigns/{megaSignId}/documents

インの
ファイ
ルを取
得
im_adobesignGetMegaSignDocument

Megaサ GET

/megaSigns/{megaSignId}/documents/{documentId}

インの
個別
ファイ
ルを取
得
im_adobesignGetMegaSignInfoForUser

Megaサ GET

/megaSigns/{megaSignId}/me

インの
アカウ
ント共
有情報
を取得
im_adobesignGetMegaSignRemindersTask

Megaサ GET

/megaSigns/{megaSignId}/reminders

インの
リマイ
ンダー
を検索
im_adobesignGetMegaSignReminderTask

Megaサ GET

/megaSigns/{megaSignId}/reminders/{reminderId}

インの
リマイ
ンダー
情報を
取得
im_adobesignUpdateMegaSign

Megaサ PUT

/megaSigns/{megaSignId}

インを更新
im_adobesignUpdateMegaSignReminder

Megaサ PUT

/megaSigns/{megaSignId}/reminders/{reminderId}

インの
リマイ
ンダー
を更新

32

— IM-Sign 利用ガイド 第7版 2024-04-01
メソッ
LDタスク名説明

im_adobesignUpdateMegaSignNoteForApiUser

Megaサ PUTド

URI
/megaSigns/{megaSignId}/me/note

インの
メモを
更新
im_adobesignUpdateMegaSignState

Megaサ PUT

/megaSigns/{megaSignId}/state

インの
ステー
タス更
新
im_adobesignUpdateMegaSignVisibility

Megaサ PUT

/megaSigns/{megaSignId}/me/visibility

インの
可視性
を更新

共通カテゴリLDタスク名

説明

メソッド

URI

im_adobesignGetAccountInfo

アカウント情報を取得

GET/accounts/{accountId}

im_adobesignGetWorkflows

ワークフローを検索

GET/workflows

im_adobesignGetWorkflowInfo

ワークフロー情報を取得

GET/workflows/{workflowId}

GET/messageTemplates

im_adobesignGetMessageTemplates メッセージテンプレートを検索

IM-LogicDesigner サンプルフロー
項目
Acrobat Signサンプルフロー
契約ファイルのアップロード、契約作成フロー
フロー概要
入力値
出力値
Acrobat Signステータスチェック〜リマインダー送付フロー
フロー概要
入力値
出力値
Acrobat Sign締結済み文書のダウンロードフロー
フロー概要
入力値
出力値

Acrobat Signサンプルフロー
Acrobat Sign連携で行うための IM-LogicDesignerサンプルフローを紹介します。
下記よりサンプルの IM-LogicDesignerフローをダウンロードし、開発用のintra-mart環境等にインポートしてご利用ください。
サンプルフローのダウンロード

コラム
本サンプルはAcrobat Sign連携の理解を早期に行うためのサンプルフローです。
実運用にあたっては要件を十分に確認して、必要に応じてフローを変更してください。

コラム
本サンプルは2021 Spring(Bergamot)以降のIM-LogicDesignerでインポートしてご利用頂けます。

契約ファイルのアップロード、契約作成フロー
フロー概要
Acrobat Sign 連携における契約ファイルのアップロード、契約の作成を行うサンプルフローです33

— IM-Sign 利用ガイド 第7版 2024-04-01

図：契約ファイルのアップロード、契約作成フロー

入力値$input <object>├─ storageFilePath <string>├─ fileName <string>├─ mimeType <string>└─ AgreementInfo <object>├─ name <string>├─ signatureType <string>├─ state <string>└─ participantSetsInfo <object>├─ order <string>├─ role <string>└─ memberInfos <object>└─ email <string>

項目名型

配列/リスト

設定例

説明

storageFilePathstringなし

IM-Sign/秘密保持契約書.pdf

契約ファイルのストレージファイル
パス

fileName

stringなし

秘密保持契約書.pdf

契約ファイル名

mimeType

stringなし

application/pdf

契約ファイルのMIMEタイプ [1]AgreementInfo

objectリスト

リスト

契約オブジェクト [1] [2]namestringなし

XXXにおける秘密保持契約

契約名signatureTypestring

なし

ESIGN

署名タイプ

state

stringなし

IN_PROCESS

ステータス

participantSetsInfo

objectリスト

リスト

契約者セットオブジェクト

order

string

なし

1

順序

role

stringなし

SIGNERロール

memberInfos

objectリスト

リスト

メンバーオブジェクト

email

stringなし

XXXX@XXX.co.jp

メールアドレス

コラム[1] (1, 2)
Acrobat Sign側が利用する各パラメータについては、タスク一覧より IM-LogicDesignerタスクと対象のAPIをご確認の頂き、 Acrobat Sign
REST API Version 6 Methods を参照してください。
[2] 記載の内容はオブジェクトの一部で、サンプルに必要な部分のみを抜粋しております。
オブジェクトの全ての変数については、 Acrobat Sign REST API Version 6 Methods を参照してくださ
い。

出力値

34

— IM-Sign 利用ガイド 第7版 2024-04-01$output <object>└─ agreementId <string>

項目名型

配列/リスト 説明agreementId

stringなし

契約作成時に発行される契約ID

Acrobat Signステータスチェック〜リマインダー送付フロー
フロー概要
Acrobat Sign 連携において、契約のステータスをチェックし、未署名のメンバーにリマインダーを送付するサンプルフローです。

図：ステータスチェック〜リマインダー送付フロー

入力値$input <object>├─ agreementId <string>└─ note <string>

項目名型

配列/リスト

設定例

説明

agreementId

stringなし

契約ファイルのアップロード、契約作成フローで出力さ

契約作成時に発行される契約ID

れたID
note

stringなし

ご対応のほど、よろしくお願いいたします。

コラム
各タスク間のパラメータ連携については、インポートしたフローのデータマッピングを参照してください。

出力値
出力値はありません

Acrobat Sign締結済み文書のダウンロードフロー
フロー概要
Acrobat Sign 連携において、締結済み文書をダウンロードし、ストレージに保存するサンプルフローです。
文書は「契約名」+「yyyyMMddHH」+「契約文書タイトル」+「.pdf」でストレージ直下に保存します。

35

付記文章

— IM-Sign 利用ガイド 第7版 2024-04-01

図：締結済み文書のダウンロードフロー

入力値$input <object>└─ agreementId <string>

項目名型

配列/リスト

設定例

説明

agreementId

stringなし

契約ファイルのアップロード、契約作成フローで出力さ

契約作成時に発行される契約ID

れたID

コラム
各タスク間のパラメータ連携については、インポートしたフローのデータマッピングを参照してください。

出力値
出力値はありません

Webhookをトリガーとした処理
項目
Acrobat Sign上のWebhook設定
Acrobat Signから intra-mart Accel Platformへの連携概要
WebhookをトリガーとしたIM-LogicDesignerの実行

Acrobat Sign上のWebhook設定
Acrobat Signから intra-mart Accel Platformへの連携を行うにあたり、Acrobat Signサイトの管理画面よりWebhook連携設定を行う必要があります。
Acrobat Signサイトの「Webhooks」より、Webhookを登録し、URLとして以下のいずれかの intra-mart Accel Platform のWebhook用URLを設定してください。

36

— IM-Sign 利用ガイド 第7版 2024-04-01<%intra-martのベースURL%>/adobesign/webhook

http(s)://<%ホスト名%>:<%ポート番号%>/<%コンテキストパス%>/adobesign/webhook

また、「イベント」に、通知を行いたいAcrobat Signのイベントを指定し、選択可能な通知パラメータをすべて選択してください。
例えば、契約が完了した際に通知を行いたい場合は「契約書ワークフローが完了しました」を指定します。

コラム
Webhookの通信がAcrobat Signサーバから行われる際、送信元のIPアドレスの範囲は「52.196.191.224/27」です。
（2023年10月1日現在、日本サーバの場合）ご利用されるWebサーバやクラウドサービスの設定において、IPアドレスによるアクセス制限を有効にしている場合は、上記の送信元IPアドレスからのアクセスを許可してください。
最新の情報については、「Adobe Acrobat Sign の必要システム構成」を参照してください。

Acrobat Signから intra-mart Accel Platformへの連携概要
Acrobat SignからのWebhook通知先をintra-mart Accel Platformにすることで、契約完了時にintra-mart Accel Platformのコミュニケーションツールに通知した
り、ワークフローを連動することが可能です。
本連携については、IM-LogicDesignerの「トリガ定義」を使用して実現します。

図：Acrobat Signから intra-mart Accel Platformへの連携概要

WebhookをトリガーとしたIM-LogicDesignerの実行
下記のようにIM-LogicDesignerの「トリガ定義」を設定し、任意のIM-LogicDesignerフローを実行します。
詳細は、「IM-LogicDesigner ユーザ操作ガイド」 - 「トリガー定義」を参照してください。

37

— IM-Sign 利用ガイド 第7版 2024-04-01

図：WebhookをトリガーとしたIM-LogicDesignerの設定例

38

— IM-Sign 利用ガイド 第7版 2024-04-01
著作権および特記事項
intra-mart は株式会社エヌ・ティ・ティ・データイントラマートの登録商標です。
Oracle と Javaは、Oracle Corporation およびその子会社、関連会社の米国およびその他の国における登録商標です。
Acrobat Sign は、アドビ（Adobe Inc.）のクラウドサービスです。
クラウドサイン (CloudSign) は弁護士ドットコム株式会社の登録商標です。
文中の社名、商品名等は各社の商標または登録商標である場合があります。
他の会社名、製品名およびサービス名などはそれぞれ各社の商標または登録商標です。
本製品を使用する場合は、本製品に含まれる各ソフトウェアのライセンスについても同意したものとします。
以上

39