Outils pour capturer et convertir le Web

Convertir des pages Web et HTML en PDF

API Ruby

Lors de la conversion de pages Web ou d'extraits HTML directement au format PDF API Ruby de GrabzIt fournit les fonctionnalités suivantes qui aident intégrener GrabzIt into votre système aussi facilement que possible. Cependant, avant de commencer, rappelez-vous qu'après avoir appelé le set_pdf_options méthode le save or save_to méthode doit être appelée pour prendre la capture d'écran PDF.

Options de base

Une capture PDF convertit la page Web entière into un document PDF de potentiellement plusieurs pages. Un seul paramètre est requis pour convertir une page Web into un document PDF ou à convertir HTML en PDF comme indiqué dans les exemples ci-dessous.

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

Identifiant personnalisé

Vous pouvez transmettre un identifiant personnalisé au PDF Comme indiqué ci-dessous, cette valeur est ensuite renvoyée à votre gestionnaire GrabzIt Ruby. Par exemple, cet identifiant personnalisé pourrait être un identifiant de base de données, permettant d'associer une capture d'écran à un enregistrement de base de données particulier.

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")

En-têtes et pieds de page

Lorsque vous créez une capture d'écran PDF, vous pouvez demander que vous souhaitiez appliquer un fichier particulier. modèle au PDF généré. Ce modèle doit être saved à l'avance et spécifiera le contenu de l'en-tête et du pied de page avec toutes les variables spéciales. Dans l'exemple de code ci-dessous, l'utilisateur utilise son modèle appelé "mon modèle".

S'il n'y a pas de marge supérieure ou inférieure suffisamment grande pour l'en-tête ou le pied de page, elle n'apparaîtra pas dans le PDF. Dans l'exemple ci-dessous, nous avons défini les marges supérieure et inférieure sur 20 pour fournir beaucoup d'espace.

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")

Convertir un élément HTML en PDF

Si vous voulez simplement convertir un élément HTML tel qu'un div ou un span directement into un document PDF que vous pouvez utiliser avec Ruby Gem de GrabzIt. Vous devez passer le Sélecteur CSS de l'élément HTML que vous souhaitez convertir en targetElement méthode.

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

Dans cet exemple, nous souhaitons capturer tout le contenu de la plage portant l’id de ArticlePar conséquent, nous passons ceci à GrabzIt comme indiqué ci-dessous.

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")

La façon dont un PDF est rogné lors du ciblage d'un élément HTML peut être contrôlé en utilisant ces techniques.