لإضافة رؤوس و/أو تذييلات إلى مستندات DOCX أو PDF، عليك أولاً القيام بذلك إنشاء قالب، مع معرف محدد. في هذه الحالة report
. يمكن أن يتضمن القالب كافة النصوص والصور والجداول التي تريد عرضها، بالإضافة إلى القواعد الخاصة بوقت إظهار الرؤوس والتذييلات.
بالإضافة إلى ذلك، يمكن أن تتضمن القوالب متغيرات مضمنة، مثل أرقام الصفحات. أو متغيرات القالب المخصصة التي يمكن أن تحتوي على أي نص عادي. ليس من الممكن تمرير HTML باستخدام متغيرات القالب المخصصة، ولكن سيتم تحويل أي أحرف /n أو /r إلى فواصل أسطر.
في المثال أدناه، يتم استخدام متغير مخصص في نص الرأس، are {number}
هو متغير مخصص.
Report number: {number}
يمكنك بعد ذلك تمرير معرف القالب هذا إلى GrabzIt لإضافة الرأس المحدد إلى أي مستند DOCX أو PDF. في الأمثلة الموضحة أدناه، يتم عرض الرأس أعلاه في كل مستند PDF يتم إنشاؤه، لكل لغة برمجة ندعمها. ومع ذلك، يمكن تعديل هذا الكود بسهولة لإضافة رؤوس وتذييلات إلى مستندات 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>
لتحديد متغيرات قالب متعددة، ما عليك سوى فصل كل زوج من قيم المفاتيح بعلامة &
.
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")
تذكر عند تقديم الطلبات يرجى التأكد من جميع يتم ترميز قيم المعلمات بعنوان URL. لاحظ أنه يجب أيضًا تشفير عنوان URL لكل اسم وقيمة POST أولاً. لتحديد متغيرات قالب متعددة، ما عليك سوى فصل كل زوج من قيم المفاتيح بعلامة &
، ثم يقوم عنوان URL بتشفير ملف tvars
المعلمة.
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")
عند إنشاء مستندات PDF، يجب عليك التأكد من وجود مساحة كافية لظهور رأس الصفحة أو تذييلها. للقيام بذلك، حدد هامشًا علويًا كبيرًا بما يكفي لظهور الرأس وهامشًا سفليًا كبيرًا بما يكفي لظهور التذييل. للحصول على حجم الهامش الصحيح قد يتطلب الأمر بعض التجربة والخطأ.