![\"Raymond](\"https:\/\/miro.medium.com\/v2\/resize:fill:88:88\/1*ldF-FsLonNyTUOmQ7cIV_g.jpeg\")
<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/a><\/p>\n <\/a><\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n We\u2019ve recently released two oft-requested APIs for Adobe Acrobat Services, the ability to both export and import form data from PDFs. These APIs are currently available to our beta program and not generally available, but read on for details on how these APIs work, and how you can sign up to help test them!<\/p>\n The Adobe Import\/Export Form Data APIs can be incredibly important for organizations looking to handle either incoming forms or improve the experience for their users when filling out forms. Some possible use cases include:<\/p>\n Before continuing, note that these APIs work with AcroForm\/Static XFA forms only. Currently, the APIs are not supported in the SDKs but once released, the SDKs will be updated to add support. As we\u2019ve covered the REST APIs many times in the past, we\u2019re going to skip demonstrating the authentication aspect as well as uploading. At the end, we\u2019ll share an entire script you can use in your testing.<\/p>\n Let\u2019s start with exporting form data, because even if you\u2019re use case is importing data, most likely you\u2019ll need to perform one export to get the \u2018shape\u2019 of the data. This will make more sense when we get to that section, but for now, imagine this simple form:<\/p>\n This form has 4 main questions:<\/p>\n After filling out, and saving the PDF, it could look like so:<\/p>\n Now let\u2019s look at how the service works. From the API reference<\/a>, we can see that this endpoint has no options specific to the functionality. You pass an asset ID, or an external URL from a supported cloud platform, and simply start the job. As we\u2019ve shared authentication and asset upload code before, we\u2019ll skip that here and simply show how easy it is to kick off a job:<\/p>\n This function takes an asset, access token, and client ID as attributes. It kicks off the job and returns the URL pointing to the status. That\u2019s it!<\/p>\n When the job is complete, the status includes information about how to access the result:<\/p>\n You can then fetch that result and work with it:<\/p>\n Given the sample shown above, the result looks like so:<\/p>\n Some things to note here:<\/p>\n Once you\u2019ve identified if you do need post processing and have added it, you can then take this data and insert it into your database, save as a file (CSV perhaps), or work with it in any way that makes sense. Here\u2019s a complete script making use of the API. In order to run this, you will need beta access (documented below) for your credentials.<\/p>\n The other half of our new form support allows you to set form data for a PDF. In order to use this API, you need a PDF with a form of course, and you need your data. If you remember, we mentioned above that getting form data can be useful here. Why? When you get form data, you see the \u2018shape\u2019 of the output. If you remember, our test PDF had a shape like this when output:<\/p>\n You can use this data to help you integrate the API. Your input data may be from a HTML form post, a database table, or an incoming REST call, and probably will not<\/em> match that shape. Your code will need to reshape it to match what is required.<\/p>\n Another important thing to note is that all values must be strings<\/strong>, even in the case of a numeric value like API wise this is very similar to the last call, with the only difference being the inclusion of the data you wish to set in the form. Here\u2019s an example method that shows how to do this:<\/p>\n As with every other API call, you\u2019ll get a job URL back, you\u2019ll ping that for status, and when done, you get an asset ID pointing to the PDF result. The We\u2019ve got three values (hard coded, but would be dynamic of course) each with different sets of key\/value pairs for the form. Our code begins (after authentication) by uploading the blank PDF with the form. It then uses that asset for each value in the array of inputs, waits for the job to finish, and then downloads it.<\/p>\n Here\u2019s one sample result:<\/p>\n Here\u2019s the complete script:<\/p>\n We\u2019ve emphasized the importance of getting the \u2018shape\u2019 right when importing data into forms. It\u2019s also important to get the values<\/em> right as well. In our sample PDF, we had a drop down with three values. If you attempt to set that field to a value not in the dropdown, the API will return an error. Here\u2019s an example:<\/p>\n When preparing your data to send to the API, it is important to keep this in mind, and ensure your code is using error handling to trap and log issues with your data.<\/p>\n If you want to try out the service while it\u2019s in beta, fill out the form<\/a> and you\u2019ll be contacted with details soon after. In the meantime, check the REST API<\/a> docs for more details on this, and our other, Acrobat APIs.<\/p>\n<\/div>\n![\"Adobe](\"https:\/\/miro.medium.com\/v2\/resize:fill:48:48\/1*riyFijvwTfGcWNf1guRNtg.png\")
<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n![\"\"](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*zZ8ZX3SCia5gWQJYTBblHQ.png)
\n
![\"A](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*qti0_rgwHBTvyjDxDchuDg.png)
\n
![\"The](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*86fymyLbi7iZ0m5dTE18cA.png)
\n
parseInt<\/code> probably) to a numeric value.<\/li>\nOff<\/code> or Yes. When a PDF form is edited in Acrobat, the developer can specify the ‘Export’ value. This defaults to ‘Yes’ but could be something else. Most likely you will want to post-process this as well, perhaps to boolean true or fale values.<\/li>\nage<\/code> from my PDF.<\/p>\ndata<\/code> attribute above maps to jsonFormFieldsData<\/code> sent to the API and represents the key\/value pairs of what you want to set in the form. Let’s look at an example:<\/p>\n![\"PDF](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*OV18po4CAYM88iZ20S8Ajw.png)