# AlegoPdf Gem responsável por juntar 1 ou mais PDF's no mesmo arquivo ## Instalação Adicione esta linha no seu Gemfile: ```ruby gem 'alego_pdf' ``` #### Desenvolvimento Para desenvolvimento, use no seu gemfile o seguinte código: ```ruby gem 'alego_shared', path: '../alego_shared' ``` E execute: $ bundle install Ou instale isto você mesmo usando o comando: $ gem install alego_pdf ## Uso A gem 'alego_pdf' depende da gem 'hexapdf' para fazer a juntada de arquivos. Veja mais sobre a gem 'hexapdf' no Github: https://github.com/gettalong/hexapdf. A gem 'alego_pdf' busca os objetos, faz a leitura dos arquivos via URI e Tempfile e a gem 'hexapdf' junta-os. Veja o exemplo na gem alego_pdf: ``` require 'hexapdf' require 'open-uri' module AlegoPdf class Merging attr_reader :ids, :model, :attribute, :filename, :urls, :orderize, :target def initialize(ids, model, attribute, filename = 'tmp/merge_files.pdf', urls = [], orderize = 'url') @ids = ids @model = model @attribute = attribute @filename = filename @urls = urls @orderize = orderize @target = HexaPDF::Document.new end def call if orderize == 'url' join_urls join_array else join_array join_urls end target.write(filename, optimize: true) end def join_urls urls.each do |filepath| next if filepath.blank? uri = URI.parse(filepath).open(&:read) tempfile = Tempfile.new tempfile.write(uri.force_encoding('UTF-8')) tempfile.close pdf = HexaPDF::Document.open(tempfile) pdf.pages.each { |page| target.pages << target.import(page) } end end def join_array array = model.is_a?(String) ? model.camelize.constantize.where(id: ids) : model.where(id: ids) array.each do |object| file = object[attribute] filepath = file.try(:url) || object.try(:arquivo_url) next if filepath.blank? uri = URI.parse(filepath).open(&:read) tempfile = Tempfile.new tempfile.write(uri.force_encoding('UTF-8')) tempfile.close pdf = HexaPDF::Document.open(tempfile) pdf.pages.each { |page| target.pages << target.import(page) } end end end end ``` Obs.: Os parâmetros 'ids', 'model' e 'attribute' são obrigatórios. O parâmetro 'filename' é por default 'tmp/merge_files.pdf', porém pode-se atribuir um caminho pré-definido. o atributo 'filename' será o local e nome onde será salvo o arquivo temporário. O parâmetro 'urls' é um array de url's e serve para ler PDF's a partir de url e juntá-los num mesmo arquivo. Default = []. Utilizar os 'ids' e as 'urls', serve para juntar arquivos além de um model apenas, como acontece no projeto 'emendas-rails' da Alego. Após instalar a gem 'alego_pdf', deve criar uma rota '/merge_arquivos' em seu projeto e deve buscar os ids dos arquivos e passá-los como parâmetro junto com o model, o atributo e as urls que onde é guardado os metadados dos arquivos. A gem procura também por um atributo chamado 'arquivo_url', caso não encontre a 'url' (ex.: attribute.try(:url)). Ainda no método call, com o atributo 'orderize' podemos ordenar por urls ou ids no arquivo PDF. Default = 'url'. Veja o exemplo a seguir: ``` # organogramas_controller.rb def merge_arquivos organograma_ids = ::Transparencia::Organograma.order('data desc').map(&:id) respond_to do |format| format.html format.pdf do url = 'https://teste.com/teste.pdf' # url precisa ser um PDF filename = 'tmp/organogramas.pdf' # nome e local onde será salvo o arquivo temporário AlegoPdf::Merging.new(organograma_ids, ::Transparencia::Organograma, :arquivo, filename, [url].compact).call pdf_filename = File.join(Rails.root, filename) send_file(pdf_filename, filename: 'organogramas.pdf', type: 'application/pdf') end end end ``` PS: caso não exista nenhum arquivo, é feito download de uma página em branco, portanto certifique-se que contenha ao menos 1 objeto com upload PDF antes de fazer a chamada AlegoPdf::Merging ou apresentar o botão na view que chama a rota e faz o download dos arquivos. Veja o exemplo: ``` // index.html.erb <% @organograma_pdf_any = ::Transparencia::Organograma.any?(&:arquivo_url) # verifica se existe ao menos 1 url do arquivo %> <% if @organograma_pdf_any %> Todos organogramas <% end %> ``` ## Contribuição Relatórios de bugs e pull requests são bem-vindos no GitLab em https://gitlab.al.go.leg.br/sistemas/gem/alego_pdf.