Come aggiungere intestazioni e piè di pagina ai documenti DOCX e PDF?
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")
L'intestazione o il piè di pagina non vengono visualizzati nel PDF
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.