Per aggiungere intestazioni e/o piè di pagina ai documenti DOCX o PDF devi prima farlo creare un modello, con un identificatore specificato. In questo caso report
. Il modello può includere tutto il testo, le immagini e le tabelle che desideri visualizzare, insieme alle regole su quando mostrare intestazioni e piè di pagina.
Inoltre i modelli possono includere variabili integrate, come i numeri di pagina. Oppure variabili di modello personalizzate che possono contenere qualsiasi testo semplice. Non è possibile passare HTML utilizzando variabili di modello personalizzate, tuttavia eventuali caratteri /n o /r verranno convertiti in interruzioni di riga.
Nell'esempio seguente, una variabile personalizzata viene utilizzata nel testo per l'intestazione, were {number}
è una variabile personalizzata.
Report number: {number}
Puoi quindi passare questo identificatore di modello a GrabzIt per aggiungere l'intestazione specificata a qualsiasi documento DOCX o PDF. Negli esempi mostrati di seguito l'intestazione sopra viene visualizzata in ciascun documento PDF generato, per ogni linguaggio di programmazione supportato. Tuttavia, questo codice può essere facilmente adattato per aggiungere intestazioni e piè di pagina anche ai documenti DOCX.
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret"); PDFOptions options = new PDFOptions(); options.TemplateId = "report"; options.MarginTop = 50; options.MarginBottom = 50; options.AddTemplateParameter("number", "12345"); grabzIt.URLToPDF("http://www.spacex.com", options); grabzIt.Save("http://www.example.com/Home/Index");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret"); PDFOptions options = new PDFOptions(); options.setTemplateId("report"); options.setMarginTop(50); options.setMarginBottom(50); options.AddTemplateParameter("number", "12345"); grabzIt.URLToPDF("http://www.spacex.com", options); grabzIt.Save("http://www.example.com/handler");
<script src="https://cdn.jsdelivr.net/npm/@grabzit/js@3.5.2/grabzit.min.js"></script>
<script>
GrabzIt("Sign in to view your Application Key").AddTemplateVariable("number", "12345").ConvertURL("http://www.spacex.com",
{"format": "pdf",
"mtop":50,
"mbottom":50,
"templateid":"report"}).Create();
</script>
Per specificare più variabili del modello è sufficiente separare ciascuna coppia chiave-valore con a &
.
var grabzit = require('grabzit'); var client = new grabzit("Sign in to view your Application Key", "Sign in to view your Application Secret"); var options = {"marginTop":50,"marginBottom":50,"templateId":"report", "templateVariables":"number=12345"}; client.url_to_pdf("http://www.spacex.com", options); client.save("http://www.example.com/handler", function (error, id){ if (error != null){ throw error; } });
$grabzIt = GrabzItClient->new("Sign in to view your Application Key", "Sign in to view your Application Secret"); $options = GrabzItPDFOptions->new(); $options->marginTop(50); $options->marginBottom(50); $options->templateId("report"); $options->AddTemplateParameter("number","12345"); $grabzIt->URLToPDF("http://www.spacex.com", $options); $grabzIt->Save("http://www.example.com/handler.pl");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret"); $options = new \GrabzIt\GrabzItPDFOptions(); $options->setMarginTop(50); $options->setMarginBottom(50); $options->setTemplateId("report"); $options->AddTemplateParameter("number","12345"); $grabzIt->URLToPDF("http://www.spacex.com", $options); $grabzIt->Save("http://www.example.com/handler.php");
grabzIt = GrabzItClient.GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret") options = GrabzItPDFOptions.GrabzItPDFOptions() options.marginTop = 50 options.marginBottom = 50 options.templateId = "report" options.AddTemplateParameter("number","12345") grabzIt.URLToPDF("http://www.spacex.com", options) grabzIt.Save("http://www.example.com/handler.py")
Ricorda che quando fai richieste assicurati contro tutti i i valori dei parametri sono codificati URL. Tieni presente che ogni nome e valore POST dovrà essere prima codificato in URL. Per specificare più variabili del modello è sufficiente separare ciascuna coppia chiave-valore con a &
, quindi l'URL codifica il file tvars
parametro.
https://api.grabz.it/services/convert?key=Sign in to view your Application Key&format=pdf&tvars=number%3D12345&mtop=50&mbottom=50&templateid=report&url=https%3A%2F%2Fspacex.com%2F
grabzIt = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret") options = GrabzIt::PDFOptions.new() options.marginTop = 50 options.marginBottom = 50 options.templateId = "report" options.add_template_parameter("number","12345") grabzIt.url_to_pdf("http://www.spacex.com", options) grabzItClient.save("http://www.example.com/handler/index")
Quando generi documenti PDF devi assicurarti che ci sia spazio sufficiente per far apparire l'intestazione o il piè di pagina. A tale scopo, specificare un margine superiore sufficientemente ampio da consentire la visualizzazione dell'intestazione e un margine inferiore sufficientemente ampio da consentire la visualizzazione del piè di pagina. Per ottenere la giusta dimensione del margine potrebbero essere necessari alcuni tentativi ed errori.