FileMakerのソリューションで、コマンドラインによって、指定のURLからPDFを作成…という機能を実装する要望があったため、wkpdfをインストールした。

wkpdf の特徴

• HTMLレンダリングに WebKit を使用
• JavaScript も効くので、Safari の表示とほぼ近いレンダリング結果になる
• –username –password オプションを指定することで、Basic認証などにも対応
• 当然、出力結果のPDFファイルは、画像ではないので、テキスト検索が効く
• サムネイルとしては使いにくい
  ※ 画像ファイル形式での出力不可/サイズ指定切り出し不可

Install

MacRuby

wkpdf は MacRuby を使用する。

1. MacRuby の公式ダウンロードページから、Latest Stable Release の standalone binary installer のパッケージをダウンロードする。
   ※  2012/03/21 現在、MacRuby 0.10
2. 解凍してできるインストーラパッケージをダブルクリックして指示に従いインストールする。

wkpdf

通常の gem を使ったインストール

sudo gem update –system

sudo gem install wkpdf

※ 当然、インストール後の Update も…

gem update wkpdf

で、OK。

Usage

Basic Usage

基本的には…

wkpdf –source http://foo.com/ –output foo.pdf

というように、–source オプションで、取得元URL を、–output オプションで、出力先PDF名を指定する。
※ 出力先PDFパスと考えてOK

Other Usage

以下が、wkpdf –help の出力結果である。

–output, -o <s>: Output PDF filename
–source, -s <s>: URL or filename (supported protocols: http, https, ftp, file), if
not present read from stdin (default: /dev/stdin)
–paper, -p <s>: Paper size (folio | ledger | letterSmall | legal | a0 | a1 | a2 |
statement | quarto | b4 | a3 | b5 | a4 | executive | letter | a5 |
a4small | custom:WxH | 10×14 | tabloid) (default: a4)
–orientation, -r <s>: (landscape | portrait) (default: portrait)
–hcenter, -c: Center horizontally (default: true)
–vcenter, -e: Center vertically
–paginate, -a: Enable pagination (default: true)
–margins, -m <i+>: Paper margins in points (T R B L) (V H) or (M)
–caching, -i: Load from cache if possible (default: true)
–timeout, -t <f>: Set timeout to N seconds (default: 3600.0)
–stylesheet-media, -y <s>: Set the CSS media value (default: screen)
–user-stylesheet, -u <s>: URL or path of stylesheet to use
–user-script <s>: URL or path of script to use
–print-background, -n: Display background images
–ignore-http-errors, -g: Generate PDF despite, e.g., a 404 error
–username <s>: Authenticate with username
–password, -w <s>: Authenticate with password
–enable-plugins, -b: Enable plugins
–enable-javascript, -l: Enable javascript (default: true)
–save-delay <f>: Wait N seconds after loading to generate PDF (default: 0.0)
–version, -v: Print the version and exit
–help, -h: Show this message
–debug, -d: Print debug output

出力用紙サイズ (–paper) や用紙方向 (–orientation) 、ページネーション (–pagination) などの出力様式指定も一通り指定できるし、Basic認証の向こうのURL も対応するので、シンプルに必要最低限のことはできる。

Notice

URL中に、アンパサンドやクエスチョンが入る場合は、URL を シングル(or ダブル)クォーテーションで括ってやる必要がある。

※ もちろん、出力パスにスペースが入る場合なども同様。

URL中に、日本語が入っていると、その部分をUTF-8 URLエンコードしてやらないとエラーになる。

※ 対処策を勘案中 (2012/03/21 20:30:49)

対処策 (2012/03/22 13:03:09)

GetAsURLEncoded ( URL ) だと、スラッシュやコロンなどまでURLエンコードされてしまうので、「一文字ずつ改行区切りにして non-ASCII だけを…」とか
あほみたいに考えていたけど、ほぼ以下の通りで解決。

“‘” & URLDecode ( GetAsURLEncoded ( URL ) ) & “‘”

カスタム関数 URLDecode は、
http://www.briandunning.com/cf/528

————————————-

Ruby 側に対処するという手法だと、

Rubyで日本語を含むURLを扱う

な話なんだろね。
これをやっちまうと、Updateされたときに上書きされちまうだろうし、変更箇所などの詳細を覚えておく自信もないし、今回は FileMaker 側で対処することに。

某クライアント (不動産業) の案件で、『CSV を 吐き出して、FTPで (あらかじめ規定された) Webサーバ上のフォルダ にアップロードする』というものがありました。

そのクライアントは、社内業務に FileMaker を使っているので、FileMaker (Mac OS X) のスクリプトで実行したいわけです。

条件は、以下の通り。

1. CSVファイルの文字コードは、UTF-8 / 改行コードは、LF。
2. CSVファイル名は、YYYYMMDDhhmmss_テーブル識別子.csv の形式。
3. CSV出力と同時にFTPアップロードする。
4. FTPユーザ名/パスワードなどのFTP関連情報は、FileMakerアクセスからは隠す。
5. Macを少しだけ使えるスタッフが、Macで、FTPサーバアドレス/FTPユーザ名/パスワードなどのFTP関連情報 をいつでも修正できるように。

1 は、普通にCSV(UTF-8)書き出し後に (Mac OS X での出力なので 改行コードが CR なので LF に修正するために)

$ perl -p -e ‘s/\r/\n/g’ < CR.txt > LF.txt

とやってやればOKですし、なんなら、XML FMPRESULT 指定で…という方法もあります。

2 は、
テーブル識別子を $tableid というグローバル変数に格納しておいて、

Let ( [

$YYMMDD = GetAsText ( Year ( Get ( 日付 ) ) * 10000 + Month ( Get ( 日付 ) ) * 100 + Day ( Get ( 日付 ) ) ) ;
$hhmmss = Right (
"000000" & GetAsText ( Hour ( Get ( 時刻 ) ) ) * 10000 + Minute ( Get ( 時刻 ) ) * 100 + Seconds ( Get ( 時刻 ) ) ;
6
) // Right
] ;
$YYMMDD & $hhmmss & “_” & $tableid & “.csv”
) // Let

とかやってやればOKでしょう。

3 も、4 の条件がなければ、シェルコマンドを do shell script な AppleScript ではじいてやればOKのはずなのですが、この場合、AppleScript内に、FTPユーザ名/パスワードなどの情報を書き込むことになります。
では、FTP情報を埋め込んだ AppleScript をアプリケーション形式で保存しておいて、それを叩いてやれば良さそうなものですが、
5 の条件でいう『Macを少しだけ使えるスタッフ』には、AppleScript の編集は、少し荷が重すぎるようです。

…で、「どうやって、FTPアップロードすべ？」と悩んでいたわけです。

いっそのこと、Transmit 4 などの FTPクライアントソフトの AppleScript 機能を使って…という『一応の解』が出ていたわけですが…ふと「Automator でどーよ！？」と思いました。

「Automator なら Automator のフロー側に FTPユーザ名/パスワードなどをリテラルで格納すれば、FTP関連情報をFileMaker アクセスからは隠せるし、Automatorのワークフローの修正なら、『Macを少しだけ使えるスタッフ』にも修正可能！」

探したところ、Upload to FTPという Automator Action がありました。
これを使って、CSV書き出し用フォルダに、フォルダアクション として設定すれば、オールOK！

具体的な手順の説明は、また後日。