Welcome!

Microservices Expo Authors: Dalibor Siroky, Elizabeth White, Pat Romanski, John Katrick, Liz McMillan

Related Topics: Microservices Expo, Java IoT, Adobe Flex, Machine Learning

Microservices Expo: Article

Form(ing) Standards - Recycling Old Stuff Can Be Incredibly Painful

I am on my favorite soapbox - “standards” – standards around form filling

I am on my favorite soapbox - "standards" - standards around form filling. Generally speaking, no discussion of standards could be complete without an assessment of the state of play of the not so humble Adobe Portable Document Format or as most of us know it, PDF. I debated the merits of the PDF back in the late 1990s (an astonishing 14 years ago) and with the passage of time, a few things have changed but in some respects they are the same.

The reason this topic is quite focal for me at the moment, is the fact that I continue to see customers and prospects take a hard line in wanting to retain their existing PDF documents and at the same time, make them more technically relevant to the continuing trend of trying to eliminate paper forms and improve back office efficiency by avoiding the need for people to laboriously transcribe data from electronic forms into application screens of key record keeping systems like SAP ERP.  This is an area where Winshuttle has made some significant in-roads in helping customers eliminate transcription from Excel and InfoPath into back office ERP systems through an integration layer built around the Microsoft product suite.

Adobe has been around since the early 1980s and the idea of PDF was to create a document format that wouldn't require special processing by the computer, and could be viewed and printed regardless of the installed OS - first version was released in 1993. At the time there was the Macintosh, OS/2 from IBM, DOS and early versions of Windows.

By the mid 1990s, PDF documents were pretty ubiquitous for electronic documents. You needed a reader, which you could often get off a Bulletin Board or bundled with some of the many distributable software packages available at the time. A frustration experienced by many continued to be the fact that Microsoft didn't natively support generating PDF documents from spreadsheets, presentations and Word, and was fighting on several document writing fronts, including against the languishing WordPerfect.  Microsoft did however have Envoy, a program that allowed a reader to read Microsoft Office documents; the availability of this product meant that partners and customers that did not use Microsoft products could still view Microsoft documents.  In 2000, Microsoft released an initial version of an XML-based version of Excel which it incorporated into OfficeXP, later in 2002 Word followed and when Office2003 was released Office open XML was pretty much standard.

Adobe took a little longer than Microsoft to embrace some degree of openness and it was only in 2001 that the PDF specification was opened up for use. Officially, in 2008, it was released as an open standard. But, as Joel Geraci points out on Quora, an Acrobat 1.0 PDF still renders 100% correctly on Acrobat X, more than 15 years later.

This bit of history is important to understand why PDF has been so successful. Consider that despite our relative resistance to generating paper copies of documents, when we do need to reduce an electronic document to a hard copy, it needs to be pretty much pixel perfect. We want the images to appear where they should, we want the fields to line up vertically and we want the pagination to appear at the correct break points in the document. The combination of printers, supported font faces, paper sizes and margins can result in some very interesting outcomes and this too has driven the improvements in products like Microsoft Word to allow a true WYSIWYG experience.  Of course, I try to discourage printing as much as possible and then find myself very frustrated when I discover that the idle printer at home won't print anything because the ink cartridge is as parched as the Gobi desert or the rollers on the laser printer have become as hard as rocks and won't pick up the paper. The visual experience is nonetheless important, especially for form filling.

Many organizations provide online form entry, either regular HTML rendered forms or PDF documents.  PDF also supports embedding of JavaScript to help with the form behavior or data validation.

Some great perspectives on the pros and cons outlined by Quick PDF are:

  • PDF is supported across multiple platforms. This means you see a document exactly as it was created, regardless of what platform it was created on and regardless of the application environment you are viewing it on, whether it be a mobile phone, an Android tablet, an iPad, a Microsoft, Apple or Sun operating system .
  • There's imaging hardware independence too, you can print the same document on a cheap dot matrix printer as well as on a high-end publishing plotter.
  • The documents are relatively compact, the text only versions are compressed, though versions that have encryption or contain images or are scanned documents that have not been processed with an OCR engine can be large.
  • PDFs can contain multimedia elements, such as: graphics, video and audio files, hyperlinks, hotspots and multifaceted multimedia objects.
  • Even As already mentioned, PDF's can be protected. The author has several security options including locking the file so, that it would open only after entering a correct password as well as supporting annotation, or preventing editing, copying content or printing.
  • You can use PDF as many organizations do, on the Internet, but HTML files are much more efficient.
  • You can use PDF to exchange graphics, but most desktop publishing applications support  TIFF, PNG, EPS and JPEG.
  • The focus of PDF is visualization and presentation of the document.  As a consequence it often doesn't preserve the document's logical structure.
  • PDF files often prove hard to modify. It is extremely difficult or even impossible to add a text block or an image to an existing PDF file if you didn't originate that document.

Returning to my problem or frustration of the moment, I looked at the form that was presented to me recently and tried to figure out just how much effort was going to be involved in manipulating this document to work with a Winshuttle Web Service connecting it to SAP. As the support partner at another company stated, "The challenge we have with PDF forms is that the form filling functionality of PDF is much more advanced than the form creation capability of MS Office.  So for us to replicate a PDF form in MS Office, we need to work with imperfect tools to do so. It is essentially like trying to edit an image that has been created with Adobe Photoshop with Microsoft Paint. The advanced tools in one program are just not available in the other."

There had been some hopes that we could simply do a like conversion of PDF content to  MS Office formats, however, when a PDF form is converted to MS Office format, some features (i.e. table lines, boxes, etc) get converted as graphics, which sometimes makes it difficult to edit freely as you would with a simple text document.  Most automation conversion software cannot produce "fillable" forms per se. So don't pin any high hopes on PDF to MS Office converters.

The tricky thing with PDF forms is that they require quite a bit of work sometimes, depending on the nature and complexity of the form.

At face value, the task should have been fairly straightforward. The problem we concluded is that the method used to build the Adobe PDF form doesn't conform to any of the contemporary interactive form standards either for PDF or for MS Office. In addition, one of the characteristics that I discovered emerging in another installation is a seemingly random approach to naming technical objects. Developers have an uncanny ability to come up with some of the most curious names imaginable for technical objects, and although some of them are very descriptive, if there is missing information in either the name or in the documentation of the technical object then supporting them at some later stage will prove to be troublesome especially if the initial developer has moved on to another assignment.

My conclusions? If you're determined to recycle an existing Adobe form, make sure that it is one that has been developed against the backdrop of accepted fillable form standards. Don't be too optimistic about being able to integrate it with anything except itself. Even if the form will never be integrated with anything - it will just be used to gather data - be careful about the types of fillable fields that you use.

Secondly, when naming your technical objects, try to build some degree of intelligence into the naming convention and apply this consistently. Calling a form, for example,  applicationform.pdf is great if you only ever have one application type to support or if you have an overarching all singing all dancing application form. The same sense of standards should apply to your metadata as well.

Finally, be careful about your choice of an Adobe PDF. Do you really need the data to be entered into a pixel perfect document format? Will an Excel-based form, for example, get you to the same place? Even an InfoPath form may be a better proposition. Excel is pretty ubiquitous these days at least. You don't' have to set Excel, InfoPath or even PDF as the standard but you should understand some of the strengths and weaknesses of each of these document types.

Further Reading

PDF vs Markup Language - Clinton Jones

How did the PDF file format become the de facto standard for document publishing? - Quora discussion

Microsoft InfoPath or Adobe Forums? - Kristian Kalsing

More Stories By Clinton Jones

Clinton Jones is a Product Manager at Winshuttle. He is experienced in international technology and business process with a focus on integrated business technologies. Clinton also services a technical consultant on technology and quality management as it relates to data and process management and governance. Before coming to Winshuttle, Clinton served as a Technical Quality Manager at SAP. Twitter @winshuttle

@MicroservicesExpo Stories
How is DevOps going within your organization? If you need some help measuring just how well it is going, we have prepared a list of some key DevOps metrics to track. These metrics can help you understand how your team is doing over time. The word DevOps means different things to different people. Some say it a culture and every vendor in the industry claims that their tools help with DevOps. Depending on how you define DevOps, some of these metrics may matter more or less to you and your team.
For many of us laboring in the fields of digital transformation, 2017 was a year of high-intensity work and high-reward achievement. So we’re looking forward to a little breather over the end-of-year holiday season. But we’re going to have to get right back on the Continuous Delivery bullet train in 2018. Markets move too fast and customer expectations elevate too precipitously for businesses to rest on their laurels. Here’s a DevOps “to-do list” for 2018 that should be priorities for anyone w...
If testing environments are constantly unavailable and affected by outages, release timelines will be affected. You can use three metrics to measure stability events for specific environments and plan around events that will affect your critical path to release.
In a recent post, titled “10 Surprising Facts About Cloud Computing and What It Really Is”, Zac Johnson highlighted some interesting facts about cloud computing in the SMB marketplace: Cloud Computing is up to 40 times more cost-effective for an SMB, compared to running its own IT system. 94% of SMBs have experienced security benefits in the cloud that they didn’t have with their on-premises service
DevOps failure is a touchy subject with some, because DevOps is typically perceived as a way to avoid failure. As a result, when you fail in a DevOps practice, the situation can seem almost hopeless. However, just as a fail-fast business approach, or the “fail and adjust sooner” methodology of Agile often proves, DevOps failures are actually a step in the right direction. They’re the first step toward learning from failures and turning your DevOps practice into one that will lead you toward even...
DevOps is under attack because developers don’t want to mess with infrastructure. They will happily own their code into production, but want to use platforms instead of raw automation. That’s changing the landscape that we understand as DevOps with both architecture concepts (CloudNative) and process redefinition (SRE). Rob Hirschfeld’s recent work in Kubernetes operations has led to the conclusion that containers and related platforms have changed the way we should be thinking about DevOps and...
While walking around the office I happened upon a relatively new employee dragging emails from his inbox into folders. I asked why and was told, “I’m just answering emails and getting stuff off my desk.” An empty inbox may be emotionally satisfying to look at, but in practice, you should never do it. Here’s why. I recently wrote a piece arguing that from a mathematical perspective, Messy Desks Are Perfectly Optimized. While it validated the genius of my friends with messy desks, it also gener...
The goal of Microservices is to improve software delivery speed and increase system safety as scale increases. Microservices being modular these are faster to change and enables an evolutionary architecture where systems can change, as the business needs change. Microservices can scale elastically and by being service oriented can enable APIs natively. Microservices also reduce implementation and release cycle time and enables continuous delivery. This paper provides a logical overview of the Mi...
The next XaaS is CICDaaS. Why? Because CICD saves developers a huge amount of time. CD is an especially great option for projects that require multiple and frequent contributions to be integrated. But… securing CICD best practices is an emerging, essential, yet little understood practice for DevOps teams and their Cloud Service Providers. The only way to get CICD to work in a highly secure environment takes collaboration, patience and persistence. Building CICD in the cloud requires rigorous ar...
The enterprise data storage marketplace is poised to become a battlefield. No longer the quiet backwater of cloud computing services, the focus of this global transition is now going from compute to storage. An overview of recent storage market history is needed to understand why this transition is important. Before 2007 and the birth of the cloud computing market we are witnessing today, the on-premise model hosted in large local data centers dominated enterprise storage. Key marketplace play...
The cloud revolution in enterprises has very clearly crossed the phase of proof-of-concepts into a truly mainstream adoption. One of most popular enterprise-wide initiatives currently going on are “cloud migration” programs of some kind or another. Finding business value for these programs is not hard to fathom – they include hyperelasticity in infrastructure consumption, subscription based models, and agility derived from rapid speed of deployment of applications. These factors will continue to...
Some people are directors, managers, and administrators. Others are disrupters. Eddie Webb (@edwardawebb) is an IT Disrupter for Software Development Platforms at Liberty Mutual and was a presenter at the 2016 All Day DevOps conference. His talk, Organically DevOps: Building Quality and Security into the Software Supply Chain at Liberty Mutual, looked at Liberty Mutual's transformation to Continuous Integration, Continuous Delivery, and DevOps. For a large, heavily regulated industry, this task ...
Following a tradition dating back to 2002 at ZapThink and continuing at Intellyx since 2014, it’s time for Intellyx’s annual predictions for the coming year. If you’re a long-time fan, you know we have a twist to the typical annual prediction post: we actually critique our predictions from the previous year. To make things even more interesting, Charlie and I switch off, judging the other’s predictions. And now that he’s been with Intellyx for more than a year, this Cortex represents my first ...
"Grape Up leverages Cloud Native technologies and helps companies build software using microservices, and work the DevOps agile way. We've been doing digital innovation for the last 12 years," explained Daniel Heckman, of Grape Up in this SYS-CON.tv interview at 21st Cloud Expo, held Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA.
The Toyota Production System, a world-renowned production system is based on the "complete elimination of all waste". The "Toyota Way", grounded on continuous improvement dates to the 1860s. The methodology is widely proven to be successful yet there are still industries within and tangential to manufacturing struggling to adopt its core principles: Jidoka: a process should stop when an issue is identified prevents releasing defective products
We seem to run this cycle with every new technology that comes along. A good idea with practical applications is born, then both marketers and over-excited users start to declare it is the solution for all or our problems. Compliments of Gartner, we know it generally as “The Hype Cycle”, but each iteration is a little different. 2018’s flavor will be serverless computing, and by 2018, I mean starting now, but going most of next year, you’ll be sick of it. We are already seeing people write such...
Defining the term ‘monitoring’ is a difficult task considering the performance space has evolved significantly over the years. Lately, there has been a shift in the monitoring world, sparking a healthy debate regarding the definition and purpose of monitoring, through which a new term has emerged: observability. Some of that debate can be found in blogs by Charity Majors and Cindy Sridharan.
It’s “time to move on from DevOps and continuous delivery.” This was the provocative title of a recent article in ZDNet, in which Kelsey Hightower, staff developer advocate at Google Cloud Platform, suggested that “software shops should have put these concepts into action years ago.” Reading articles like this or listening to talks at most DevOps conferences might make you think that we’re entering a post-DevOps world. But vast numbers of organizations still struggle to start and drive transfo...
Let's do a visualization exercise. Imagine it's December 31, 2018, and you're ringing in the New Year with your friends and family. You think back on everything that you accomplished in the last year: your company's revenue is through the roof thanks to the success of your product, and you were promoted to Lead Developer. 2019 is poised to be an even bigger year for your company because you have the tools and insight to scale as quickly as demand requires. You're a happy human, and it's not just...
"Opsani helps the enterprise adopt containers, help them move their infrastructure into this modern world of DevOps, accelerate the delivery of new features into production, and really get them going on the container path," explained Ross Schibler, CEO of Opsani, and Peter Nickolov, CTO of Opsani, in this SYS-CON.tv interview at DevOps Summit at 21st Cloud Expo, held Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA.