Form API
A form document has exactly the same structure as a text document. The only difference is a new forms entity placed with other paragraph elements – text runs, inline text content controls and hyperlinks. There are seven form types: text field, combo box, dropdown list, checkbox, radio button, picture form, and complex field.
Creating a new form document
To create a form document, the CreateFile method with the "pdf" extension must be used.
To save the ready document as a form, you need to use the SaveFile method with the "pdf" extension.
The simplest example form document with a single text form containing the "John Smith" text can be built with the help of ONLYOFFICE Document Builder using the following code:
// create a form document file in the .pdf format with ONLYOFFICE Document Builder
builder.CreateFile("pdf")
// create a new 'oDocument' variable and get the created text document contents
const oDocument = Api.GetDocument()
// create an empty text form
const oTextForm = Api.CreateTextForm()
// get the first empty paragraph from the created document
const oParagraph = oDocument.GetElement(0)
// add the created text form to the first paragraph
oParagraph.AddElement(oTextForm)
// add the "John Smith" text to the text form
oTextForm.SetText("John Smith")
// save the resulting form document as a file in the .pdf format with the 'example.pdf' name
builder.SaveFile("pdf", "example.pdf")
// close the form document file and finish work with ONLYOFFICE Document Builder
builder.CloseFile()
Opening an existing form document
If you want to edit an already existing form document, you can open it using ONLYOFFICE Document Builder, get its elements and change them however you need. The only difference from a document editor in this case will be that you will not need this document editor. The document is opened the following way:
// use a path to an existing 'myformdocument.pdf' form document file to open it with ONLYOFFICE Document Builder
builder.OpenFile("https://example.com/myformdocument.pdf")
// create a new 'oDocument' variable and get the created text document contents
const oDocument = Api.GetDocument()
// create an empty text form
const oTextForm = Api.CreateTextForm()
// get the first empty paragraph from the created document
const oParagraph = oDocument.GetElement(0)
// add the created text form to the first paragraph
oParagraph.AddElement(oTextForm)
// add the "John Smith" text to the text form
oTextForm.SetText("John Smith")
// save the resulting form document as a file in the .pdf format with the 'example.pdf' name
builder.SaveFile("pdf", "example.pdf")
// close the form document file and finish work with ONLYOFFICE Document Builder
builder.CloseFile()
As you can see you just need to use the builder.OpenFile(); method of the CDocBuilder class with the path to the necessary form document as an argument to open it. In the above example we open myformdocument.pdf document, get its first paragraph and add the text form with the "John Smith" text to it. The same way any other form document element can be changed.
Use the appropriate API documentation sections to find out which methods allow you to change certain document and spreadsheet element formatting properties.