Strumenti per acquisire e convertire il Web

Converti pagine Web e HTML in PDF

API Ruby

Quando si convertono pagine Web o frammenti HTML direttamente in PDF API Ruby di GrabzIt fornisce le seguenti funzionalità che aiutano integrate GrabzIt into il tuo sistema il più facilmente possibile. Tuttavia, prima di iniziare, ricordare che dopo aver chiamato il set_pdf_options metodo il save or save_to è necessario chiamare il metodo per acquisire lo screenshot PDF.

Opzioni di base

Un'acquisizione PDF converte l'intera pagina Web into documento PDF di potenzialmente molte pagine. È richiesto un solo parametro per convertire una pagina Web into documento PDF o a converti HTML in PDF come mostrato negli esempi seguenti.

grabzItClient.url_to_pdf("https://www.tesla.com")
# Then call the save or save_to method
grabzItClient.html_to_pdf("<html><body><h1>Hello World!</h1></body></html>")
# Then call the save or save_to method
grabzItClient.file_to_pdf("example.html")
# Then call the save or save_to method

Identificatore personalizzato

È possibile passare un identificatore personalizzato a PDF metodi come mostrato di seguito, questo valore viene quindi restituito al gestore GrabzIt Ruby. Ad esempio, questo identificatore personalizzato potrebbe essere un identificatore del database, consentendo di associare uno screenshot a un particolare record del database.

grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.customId = "123456"

grabzItClient.url_to_pdf("https://www.tesla.com", options)
# Then call the save method
grabzItClient.save("http://www.example.com/handler/index")
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.customId = "123456"

grabzItClient.html_to_pdf("<html><body><h1>Hello World!</h1></body></html>", options)
# Then call the save method
grabzItClient.save("http://www.example.com/handler/index")
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.customId = "123456"

grabzItClient.file_to_pdf("example.html", options)
# Then call the save method
grabzItClient.save("http://www.example.com/handler/index")

Intestazioni e piè

Quando si crea uno screenshot PDF è possibile richiedere che si desidera applicare un particolare modello al PDF generato. Questo modello deve essere saved in anticipo e specificherà il contenuto dell'intestazione e del piè di pagina insieme a eventuali variabili speciali. Nell'esempio di codice riportato di seguito l'utente utilizza il proprio modello chiamato "modello personale".

Se non è presente un margine superiore o inferiore sufficientemente grande per l'intestazione o il piè di pagina, non verrà visualizzato nel PDF. Nell'esempio seguente abbiamo impostato i margini superiore e inferiore su 20 per fornire molto spazio.

grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.marginTop = 20
options.marginBottom = 20
options.templateId = "my template"

grabzItClient.url_to_pdf("https://www.tesla.com", options)
# Then call the save or save_to method
grabzItClient.save_to("result.pdf")
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.marginTop = 20
options.marginBottom = 20
options.templateId = "my template"

grabzItClient.html_to_pdf("<html><body><h1>Hello World!</h1></body></html>", options)
# Then call the save or save_to method
grabzItClient.save_to("result.pdf")
grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.marginTop = 20
options.marginBottom = 20
options.templateId = "my template"

grabzItClient.file_to_pdf("example.html", options)
# Then call the save or save_to method
grabzItClient.save_to("result.pdf")

Converti l'elemento HTML in PDF

Se vuoi semplicemente convertire direttamente un elemento HTML come div o span into un documento PDF che puoi con GrabzIt's Ruby Gem. Devi superare il Selettore CSS dell'elemento HTML che si desidera convertire in targetElement metodo.

...
<span id="Article">
<p>This is the content I am interested in.</p>
<img src="myimage.jpg">
</span>
...

In questo esempio, desideriamo acquisire tutto il contenuto nell'intervallo di cui ha l'ID Article, quindi lo passiamo a GrabzIt come mostrato di seguito.

grabzItClient = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")

options = GrabzIt::PDFOptions.new()
options.targetElement = "#Article"

grabzItClient.url_to_pdf("http://www.bbc.co.uk/news", options)
# Then call the save or save_to method
grabzItClient.save_to("result.pdf")

Come può essere ritagliato un PDF durante il targeting di un elemento HTML controllato usando queste tecniche.