#概要
この記事は、@daichiiiiiiiさんの下記記事を参考にNode.jsで実装したものです。
リスペクト記事
box上のオフィスファイルをPCにダウンロードせずにPDF変換する
https://qiita.com/daichiiiiiii/items/12c2bb163fe013f400a9
#3/21 更新
チームに見せたところ、
「ファイル上書きじゃなくて、別ファイルとしてアップロードするようにしてほしい」
と言われたので、別ファイルとしてアップロードする方法に編集しました。
#環境構築
##Box
###Box Developer Account作成
1. https://developer.box.com/へアクセスし、右上のメニューからSignUpする。
2. 確認メールが送られます。
3. メールの確認をします。
4. Boxのログイン画面が表示されるので、ログインします。
5. 設定が完了したら、Developerコンソールへアクセスします。
https://app.box.com/developers/console
###新規アプリケーションの作成
1. [アプリの新規作成]をクリックします。
2.[カスタムアプリ]を選択して、[次へ]をクリックします。
3.認証方法では、[標準OAuth2.0(ユーザー認証)]を選択して、[次へ]をクリックします。
４.アプリケーションに適当な名前をつけて[アプリの作成]をクリックします。
５.DeveloperTokenが発行されますが、ここでは使わないので、[アプリの表示]をクリックします。
###Web App Integrationの作成
1.作成したアプリケーションを開きます。
2.左のメニュー[統合]をクリックし、[新しいWebアプリ統合を作成]をクリックします。
必要な情報を入力していきます。
詳細な情報はBoxのドキュメントを参照してください。
Box Developers > Docs > Web Application Integrations
https://developer.box.com/docs/box-web-application-integrations
-
アプリ情報
-
コールバック設定
[クライアントコールバックのURL]は後に作成するHerokuのURLを入れるため、ここではダミーでhttps://localhostなどとダミーの値を入れておきます。
-
コールバックパラメータ
-
認証
-
統合ステータス
全て設定が終わったら右上の[変更を保存]をクリックし保存します。
##Heroku
###Heroku環境構築
Herokuは日本語の資料がありましたので、こちらのサイトを参考にして環境構築をしてください。
この時点では、「ステップ 3: ログイン」まで実施すれば大丈夫です。
###Herokuアプリケーション作成
1.HerokuCLIを使ってHerokuにログインします。
$ heroku login
Enter your Heroku credentials.
Email: <your email address>
Password (typing will be hidden):
Logged in as <your email address>
2.Herokuでアプリケーションを作成します。
アプリケーション名は、Herokuの中で一意である必要があります。
$ heroku apps:create <アプリケーション名>
Creating ⬢ <アプリケーション名>... done
https://<アプリケーション名>.herokuapp.com/ | https://git.heroku.com/<アプリケーション名>.git
3.Gitリポジトリを初期化します。
$ git init
4.リモートリポジトリとしてHerokuを追加します。
$ git remote add heroku https://git.heroku.com/<アプリケーション名>.git
5.Git管理対象外ファイル(.gitignore)を作成します。
.DS_Store
.gitignore
npm-debug.log
node_modules
6.Herokuがプログラム起動する際に実行するファイル(Procfile)を作成します。
web: node server.js
Herokuアプリケーションへ環境変数をセット
Boxの認証情報をHeroku環境変数としてセットしておきます。
セットする資格情報は下記の通りです。
| KEY | 補足 |
|---|---|
| BOX_CLIENT_ID | アプリのClient ID |
| BOX_CLIENT_SECRET | アプリのClient Secret |
Herokuへ環境変数を登録するコマンドは下記です。
$ heroku config:set <KEY>="<VALUE>"
#プログラミング
次は、server.jsへコードを書き、デプロイします。
##コーディング
BoxのNode.js SDKを利用します。
以下はサンプルプログラムです。
（あくまで動作を確認するためのサンプルなので、業務で使う場合はセキュリティ等の検討を十分に行ってください。
実稼働環境におけるベスト・プラクティス: セキュリティー)
//Import Modules
var restify = require('restify');
var expressSession = require('express-session');
var BOX_CLIENT_ID = process.env.BOX_CLIENT_ID;
var BOX_CLIENT_SECRET = process.env.BOX_CLIENT_SECRET;
var Promise = require('bluebird');
var fs = require('fs');
var BoxSDK = require('box-node-sdk');
var async = require('async');
var bodyParser = require('body-parser');
var basicAuth = require('basic-auth-connect');
var helmet = require('helmet');
// Setup Restify Server
var server = restify.createServer();
server.use(bodyParser.urlencoded({ extended: true }));
server.use(expressSession({ secret: 'keyboard cat', resave: true, saveUninitialized: false }));
server.use(helmet());
server.listen(process.env.port || process.env.PORT || 3978, function () {
console.log('%s listening to %s', server.name, server.url);
});
server.post('/api/box', function(req, res){
var msg = 'PDFファイルに変換しています。変換が完了したら、新しいバージョンとして上書きします。' ;
res.header('Content-Type', 'text/plain;charset=utf-8');
res.send(msg);
// Boxからのリクエストを受け取る
// Boxで[PDF変換]メニューをクリックすると、BoxからPOSTで下記のパラメータが渡されます。
var authCode = req.body.auth_code;
var fileId = req.body.file_id;
var fileExtension = req.body.file_extension;
var fileName = req.body.file_name;
var pdffilename = (fileName).replace('.' + fileExtension, '.pdf');
var sdk = new BoxSDK({
clientID: BOX_CLIENT_ID,
clientSecret: BOX_CLIENT_SECRET
});
var tokenInfo = {};
var pdfurl = "";
var promise = new Promise(function(resolve, reject){
// コールバックパラメーターのauth_codeを使ってAccessTokenを取得
sdk.getTokensAuthorizationCodeGrant(authCode, null, function(err, res) {
if(err){
reject(err);
}
tokenInfo = res;
console.log(tokenInfo);
resolve();
});
});
promise.then(function(){
// Representations APIを使って、PDFファイルをダウンロード
// https://developer.box.com/v2.0/reference#get-representations
var client = sdk.getBasicClient(tokenInfo.accessToken);
client.files.getRepresentationContent(fileId, client.files.representation.PDF)
.then(function(stream) {
// Boxからダウンロードしたファイルを一時的にHerokuサーバーの/tmp配下にダウンロード
var output = fs.createWriteStream("/tmp/" + fileName);
stream.pipe(output);
output.on('close', function(){
//ファイル情報から親フォルダIDを取得
client.files.get(fileId, null, function(err, res){
if(err){
reject(err);
}
var folderId = res.parent.id;
//新しいファイルをアップロード
client.files.uploadFile(folderId, pdffilename, fs.createReadStream("/tmp/" + fileName), function(err, res){
if(err){
reject(err);
}
});
});
});
});
}).catch((err) => { // エラーハンドリング
console.error(err);
});
});
デプロイ
Herokuへデプロイします。
$ git add . && git commit -m "<your message>" && git push heroku master
ログを確認する場合は、下記コマンドです。
$ heroku logs --tail
Boxへ[クライアントコールバックのURL]をセット
- BoxのDeveloperコンソールを開き、作成したアプリを開きます。
- [統合]メニューの[コールバック設定]の[クライアントコールバックのURL]に、HerokuのアプリケーションURL+エンドポイント(https://<アプリケーション名>.herokuapp.com/api/box)を入力し、[変更を保存]します。
テスト
[・・・]→[統合]→[PDF変換]をクリック！
PDFファイルがアップロードされたようです！
新しいファイルとしてPDFに変換されたファイルがアップロードされています！
無事、PDF変換に成功しました！
この機能、業務で使えたら便利ですね。