エビを使用したPDF生成

はじめに

このトピックでは、Ruby / Railsを使用してPDFドキュメントを作成、生成、サイトから直接ダウンロード、またはrakeタスクを介して作成し、メーラー経由で添付ファイルとして送信する機能を検討します。
Rails 3.0.9とPrawn gemを使用します。

エビのインストール

バンドラー

gem 'prawn', :git => "git://github.com/sandal/prawn.git", :submodules => true 

レール統合

レポートクラスのディレクトリを作成します。
$ mkdir app/reports

config / application.rbのこのディレクトリからクラスを自動ロードするには：

 config.autoload_paths << "#{Rails.root}/app/reports" 

そして、MIMEタイプを登録します（config / initializers / mime_types.rb）

 Mime::Type.register_alias "application/pdf", :pdf 

autoload（以前にファイルを作成した）config / initializers / prawn.rbにgemを含めます

 require "prawn" 

エビが動作するかどうかを確認する（RVMを使用）

 $ rails c Loading development environment (Rails 3.0.9) ruby-1.9.2-p180 :001 > Prawn::BASEDIR => "/home/kir/.rvm/gems/ruby-1.9.2-p180@pdfer/bundler/gems/prawn-1288242ddece" 

PDFを生成

Prawnがキリル文字をサポートするには、ロシア語のフォントを提供する必要があります。 それらをホームディレクトリに入れて、/ home / kir / prawn_fontsにします。 Prawnとの作業でテストされたVerdanがここに投稿しました 。

データを含むテーブルを作成するには、Customerモデルでスキャフォールドを作成します。

rails g scaffold customer name:string amount:float
rake db:migrate

テーブルにデータを入力します。

これで、レポートファイルジェネレーターを作成できます。 次のコードでapp / reports / customers_report.rbにします：

 # encoding: utf-8 class CustomersReport < Prawn::Document #   Widths = [200, 200, 120] #   Headers = [' ', '', ''] def row(date, customer_name, amount) row = [date, customer_name, amount] make_table([row]) do |t| t.column_widths = Widths t.cells.style :borders => [:left, :right], :padding => 2 end end def to_pdf #   font_families.update( "Verdana" => { :bold => "/home/kir/prawn_fonts/verdanab.ttf", :italic => "/home/kir/prawn_fonts/verdanai.ttf", :normal => "/home/kir/prawn_fonts/verdana.ttf" }) font "Verdana", :size => 10 text "  #{Time.zone.now.strftime('%b %Y')}", :size => 15, :style => :bold, :align => :center move_down(18) #   @customers = Customer.order('created_at') data = [] items = @customers.each do |item| data << row(item.created_at.strftime('%d/%m/%y %H:%M'), item.friendly_name, item.) end head = make_table([Headers], :column_widths => Widths) table([[head], *(data.map{|d| [d]})], :header => true, :row_colors => %w[cccccc ffffff]) do row(0).style :background_color => '000000', :text_color => 'ffffff' cells.style :borders => [] end #      creation_date = Time.zone.now.strftime("  %e %b %Y  %H:%M") go_to_page(page_count) move_down(710) text creation_date, :align => :right, :style => :italic, :size => 9 render end end 

PDFジェネレーターの準備ができました。 顧客アクションコントローラーに追加します。これは、PDFのダウンロードを担当します。

 def download_pdf output = CustomersReport.new.to_pdf send_data output, :type => 'application/pdf', :filename => "customers.pdf" end 

このアクションのルートを登録することを忘れないでください！ たとえば、次のように：

 resources :customers do collection do get 'download_pdf' end end 

/ customers / download_pdfに移動します 。 結果はそのような文書です。

すくいタスク

しかし、rakeタスクを介してPDFを生成したいとします。 実装を検討してください（lib / tasks / customers_report.rakeコード）：

 namespace :customers_report do desc 'Generates report with customers' task :generate_pdf => :environment do output = CustomersReport.new.to_pdf filename = "report.pdf" File.open(Rails.root.join('public', filename), 'wb') do |f| f.write(output) end puts "Report was written to #{filename}" end end 

実行中： rake customers_report:generate_pdf --trace
レポートは、public / report.pdfで生成されます。

熊手タスク+メーラー

別の状況：PDFは毎月電子メールで送信する必要があります。 これを行うには、メーラーと別のタスクを作成する必要があります。
メーラーの生成： rails g mailer customers_mailer report_emailおよびコードapp / rails g mailer customers_mailer report_email / customers_mailer.rbを変更します：

 class CustomersMailer < ActionMailer::Base default :from => "me@yandexteam.ru" #   ! def report_email(pdf_output, to) report_filename = Time.zone.now.strftime('Report %d-%m-%Y') attachments[report_filename] = { :mime_type => 'application/pdf', :content => pdf_output } mail(:to => to, :subject => report_filename.titleize) end end 

また、送信用のタスクも規定しています（同じlib / tasks / customers_report.rake）：

 namespace :customers_report do desc 'Generates report with customers' task :generate_pdf => :environment do #... end desc 'Send report by email' task :send_by_email => :environment do #    # recipient = ["vasya@gmail.com", "petya@gmail.com"] recipient = 'me@yandexteam.ru' #   ! output = CustomersReport.new.to_pdf CustomersMailer.report_email(output, recipient).deliver puts "Report was sent to #{recipient}" end end 

できた 環境パラメーターで実際のアドレスとaction_mailer設定を指定することを忘れないでください！
パフォーマンスの確認： rake customers_report:send_by_email --trace

参照：

Githubのエビリポジトリ： https : //github.com/sandal/prawn/
記事に記載されているデモアプリケーションを使用した私のリポジトリ： https : //github.com/kirs/pdfer
GithubへのPrawnのインストールについて： https : //github.com/sandal/prawn/wiki/Using-Prawn-in-Rails
PS Rails Clubでの4月のプレゼンテーションについて、evroneのDmitry Galinskyに感謝します！