Javascriptを使用してBuildVuマイクロサービスにアクセスする
はじめに
以下のチュートリアルでは、ホストされたBuildVuクラウドAPIを使ってPDFファイルをHTMLやSVGに変換する方法を紹介します：
- IDRsolutionsのトライアルおよびクラウドサブスクリプションサービス
- あなた自身のセルフホストBuildVuマイクロサービス
上記のサービスはすべて、通常のHTTPリクエストでアクセスすることができますが、このチュートリアルでは、REST APIをシンプルなJavascriptラッパーとして提供する、オープンソースのJavascript IDRCloudClientを使用します。
前提条件
クライアントをプロジェクトに追加するには、idrcloudclient.jsファイルをプロジェクトに追加し、次の行をインクルードしてアクセスする必要があります：
<script src="path/to/idrcloudclient.js" type="text/javascript"></script>
サンプルコード
PDFファイルをHTMLやSVGに変換する基本的なコード例です。設定オプションと詳細機能は下記にあります。
var endpoint = 'https://cloud.idrsolutions.com/cloud/' + IDRCloudClient.<a href="https://www.intwk.co.jp/buildvu/" title="BuildVu(ビルドビュー)は様々なデザイン、図や表を含んだ複雑なレイアウトのPDF、Word、Excel、PowerPointドキュメントをH..." onover-preload="1">BUILDVU</a>;
var parameters = {
//token: 'Token', //Required only when connecting to the IDRsolutions trial and cloud subscription service
input: IDRCloudClient.UPLOAD,
file: '<a href="https://pub.dev/packages/path" target="_blank" title="A string-based path manipulation library. All of the path operations you know and love, with solid support for Windows, POSIX (Linux and Mac OS X), and the web." hreflang="en-us">path</a>/to/exampleFile.pdf'
}
function progressListener(e) {
console.log(JSON.stringify(e));
}
function failureListener(e) {
console.log(e);
console.log('Failed!');
}
function successListener(e) {
console.log(JSON.stringify(e));
console.log('Download URL: ' + e.downloadUrl);
}
IDRCloudClient.convert({
endpoint: endpoint,
parameters: parameters,
// The below are the available listeners
progress: progressListener,
success: successListener,
failure: failureListener
});
var parameters = {
//token: 'Token', //Required only when connecting to the IDRsolutions trial and cloud subscription service
input: IDRCloudClient.UPLOAD,
callbackUrl: 'http://listener.url',
file: 'path/to/exampleFile.pdf'
}
settings: '{"key":"value","key":"value"}'
URLによるアップロード
ローカルファイルをアップロードするだけでなく、BuildVu Microserviceがダウンロードして変換を実行するURLを指定することもできます。これを行うには、convertメソッドのinputとfileの値を以下のように置き換えます。
input: IDRCloudClient.DOWNLOAD
url: 'http://exampleURL/exampleFile.pdf'
認証を使用する
PDFファイルをHTMLまたはSVGに変換するためにユーザー名とパスワードを必要とする独自のBuildVu Microserviceをデプロイした場合、変換のたびにユーザー名とパスワードを提供する必要があります。これらは、以下のようにconvertメソッドにauthという変数を渡すことで提供されます。
username: 'username',
password: 'password',