GMO サイン: タイムスタンプ付与済ファイルURL取得

GMO サイン: タイムスタンプ付与済ファイルURL取得

GMO Sign: Retrieve Timestamped File URL

この工程は GMO サイン からタイムスタンプ依頼ステータスおよび付与済ファイルURLを取得します。

Auto Step icon
Configs for this Auto Step
conf_OAuth2
C1: シークレットキー *
cusId
C2: 顧客ID *#{EL}
accessUrl
C3: アクセス先URL(例 api.gmosign.com) *#{EL}
confirmationId
C4: 予約IDが保存されている文字型データ項目 *
status
C5: タイムスタンプ依頼ステータス を保存する選択型データ項目 *
documentsUrl
C6: タイムスタンプ付与済文書ダウンロードURL を保存する文字型データ項目 *
Script (click to open)


/*
JSON例


・アクセストークン生成 AccessToken_Generate_Post
{
  "secret_key": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "cus_id": "XXXXXXXXXX"
}

・タイムスタンプ付与済PDF取得 Timestamp_Retrieve_Post
{
  "secret_key": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "cus_id": "XXXXXXXXXX",
  "access_token": "(取得したトークン)",
  "confirmation_id": "(取得した予約ID)",
  "download_type": "2"
}

・タイムスタンプstatus一覧
accepted: 処理待ち
applied: タイムスタンプ付与完了
declined: タイムスタンプ付与失敗
*/


main();

function main() {

    //// == 工程コンフィグの参照 / Config Retrieving ==
    //シークレットキーはHTTP認証設定のトークン直接指定に入れてもらう
    const key = configs.getObject("conf_OAuth2").getToken() + "";
    const cusId = configs.get("cusId") + "";
    const accessUrl = configs.get("accessUrl") + "";

    const dataId_status = configs.get("status");
    const dataId_documentsUrl = configs.get("documentsUrl");

    //// == ワークフローデータの参照 / Data Retrieving ==
    const confirmationId = engine.findData(configs.getObject("confirmationId")) + "";


    //// == 演算 / Calculating ==

    //アクセストークン取得
    let accessToken = getAccessToken(key, cusId, accessUrl);

    //ステータス・ファイルURL取得
    let json = retrieveTimestampedFileURL(key, cusId, accessUrl, accessToken, confirmationId);

    //// == ワークフローデータへの代入 / Data Updating ==
    engine.setDataByNumber( dataId_status, json['result']['status'] );
    engine.setDataByNumber( dataId_documentsUrl, json['result']['documents_url'] );


/* アクセスログがあれば
    if ( dataId_log !== "" ) {
        engine.setDataByNumber( dataId_log, accessLog );
    }
*/

}


/**
  * アクセストークン取得
  * @param {String} key  シークレットキー
  * @param {String} cusId  顧客ID
  * @param {String} accessUrl  接続先URL
  * @returns {String} アクセストークン
  */
function getAccessToken(key, cusId, accessUrl) {

    //JSON準備
    let requestObj = {};
    requestObj.secret_key = key;
    requestObj.cus_id = cusId;
    requestObj.download_type = 2;


    //HTTPリクエスト送付
    const url = "https://" + accessUrl + "/agree-api/v0/api/accesstoken/generate";
    const response = httpClient.begin()
        .body( JSON.stringify(requestObj), "application/json" )
        .post(url);
    const status = response.getStatusCode();
    const responseStr = response.getResponseAsString();
    if (status !== 200) {
        engine.log(responseStr);
        throw `Failed to get access token. status: ${status}`;
    }

    engine.log("responseStr:" + responseStr);//検証用
    const json = JSON.parse(responseStr);
    return json['result']['access_token'];
}


/**
  * タイムスタンプ付与済ファイルURL取得
  * @param {String} key  シークレットキー
  * @param {String} cusId  顧客ID
  * @param {String} accessUrl  接続先URL
  * @param {String} accessToken  アクセストークン
  * @param {object} files  ファイル
  * @returns {String} レスポンスJSON
  */
function retrieveTimestampedFileURL(key, cusId, accessUrl, accessToken, confirmationId) {

    //JSON準備
    let requestObj = {};
    requestObj.secret_key = key;
    requestObj.cus_id = cusId;
    requestObj.access_token = accessToken;
    requestObj.confirmation_id = confirmationId;
    requestObj.download_type = 2;

    engine.log("requestObj:" + JSON.stringify(requestObj));//検証用


    //HTTPリクエスト送付
    const url = "https://" + accessUrl + "/agree-api/v0/api/ts/retrieve";
    const response = httpClient.begin()
        .body( JSON.stringify(requestObj), "application/json" )
        .post(url);
    const status = response.getStatusCode();
    const responseStr = response.getResponseAsString();
    if (status !== 200) {
        engine.log(responseStr);
        throw `Failed to retrieve. status: ${status}`;
    }

    engine.log("responseStr:" + responseStr);//検証用
    const json = JSON.parse(responseStr);
    return json;//複数項目取得したいのでjsonのまま返す
}

  
    

Download

warning 自由改変可能な JavaScript (ECMAScript) コードです。いかなる保証もありません。
(アドオン自動工程のインストールは Professional editionでのみ可能です)

Notes

  • GMO サイン」はGMOグローバルサイン・ホールディングス株式会社のサービスです。
  • GMO サインのタイムスタンプ付与にはオプション契約が必要です。詳細は提供元に確認してください。
  • GMO サインでタイムスタンプ付与させる場合には、「GMO サイン: タイムスタンプ付与依頼」・「GMO サイン: タイムスタンプ付与済ファイルURL取得」を組み合わせて使う必要があります。
  • 「シークレットキー」・「顧客ID」・「アクセス先URL」はGMOグローバルサイン・ホールディングス株式会社より指定された値を指定してください。「シークレットキー」は「HTTP認証設定」の「トークン直接指定」で指定してください。
  • 「タイムスタンプ依頼ステータス」は以下の設定で選択型データを準備して、指定してください。
選択肢ID表示ラベル
accepted処理待ち
appliedタイムスタンプ付与完了
declinedタイムスタンプ付与失敗

Capture

See Also

上部へスクロール

Questetra Supportをもっと見る

今すぐ購読し、続きを読んで、すべてのアーカイブにアクセスしましょう。

続きを読む