Signature Placement for PDF Documents ​

For any Task that is of the Signature or Initial task type, you have three different methods in which to place the element on the PDF document. You can also use these three methods to place the Acknowledgement task type, however, the Acknowledgement task type does not stamp any visible text or markings on the final PDF. With the Signature and Initial task types, you have the option of including Additional Signature Block Data along with the signature placement and these data can be placed using the exact same methods.

For PDF documents, placement of all text by AlphaTrust e-Sign™ is specified in standard PDF page coordinates, which are points from the bottom left corner of a page. Standard letter sized pages (8.5" x 11.0") have an X, Y coordinate system from (0, 0) in the bottom left corner to (612, 792) in the top right. A4 pages have an X, Y coordinate system to (595, 842). US Legal pages have an X, Y coordinate system to (612, 1008).

AlphaTrust e-Sign™ supports two methods of specifying placement relative to elements in the PDF and one absolute method. These three placement methods, specifically are as follows:

• Placement relative to the location a PDF form field
• Placement relative to a searched-for string of text
• Placement based on absolute Page and X,Y coordinates

Form Field Placement ​

There are times when you do not know the exact page and X, Y location for signature data. AlphaTrust e-Sign™ provides two element-relative placement methods to use in this case, Form Field and Search Text methods. Below explains a method to place the signature data relative to a named PDF form field location.

Using the PDF Form Fields setup show below, if you want to place the signature at the location of the form field named Signature (it could be named anything you wish), you would simply need to set the FormField_FieldName="Signature".

task = new TaskInsertModel()
        {
            Type = TaskInsertModel.TypeEnum.Signature,
            SignatureBlock = new SignatureBlockModel()
            {
                Signature = new SignatureModel()
                {
                    ApplicationType = SignatureModel.ApplicationTypeEnum.FontStamped,
                    PdfPlacement = new PdfSignaturePlacementModel()
                    {
                        FormFieldFieldName = "Signature",
                        FormFieldInstanceOfField = 1,
                        XOffset = 0,
                        YOffset = 0
                    }
                }
            }
        }

Search Text Placement ​

There are times when you do not know the exact page and X, Y location for signature data. AlphaTrust e-Sign™ provides two element-relative placement methods to use in this case, Search Text and Form Field methods. Below explains a method to place the signature data relative to a string of text that AlphaTrust e-Sign™ searches for and finds inside the PDF document.

Using the PDF document text show below, if you want to place the signature next to the SIGNATURE: text (it could be next to any text that you wish), you would simply need to set the SearchText_TextToSearch="SIGNATURE:".

task = new TaskInsertModel()
       {
           Type = TaskInsertModel.TypeEnum.Signature,
           SignatureBlock = new SignatureBlockModel()
           {
               Signature = new SignatureModel()
               {
                   ApplicationType = SignatureModel.ApplicationTypeEnum.FontStamped,
                   PdfPlacement = new PdfSignaturePlacementModel()
                   {
                       SearchTextTextToSearch = "SIGNATURE:",
                       SearchTextInstanceOfText = 1,
                       SearchTextSpecificPageNumberToSearch = 0,
                       SearchTextOffsetStartPosition = PdfSignaturePlacementModel.SearchTextOffsetStartPositionEnum.Right,
                       XOffset = 0,
                       YOffset = 1
                   }
               }
           }
       }

Page Coordinates Placement ​

When using the absolute method of placement, you specify the exact page, X and Y coordinate for each placement.

Using the PDF document page shown below, if you want to place the signature next to the SIGNATURE: location using absolute page coordinates, you would simply need to set the PageCoordinates_PageNumber=2. as well as the XOffset=172 and YOffset=413 coordinates.

task = new TaskInsertModel()
        {
            Type = TaskInsertModel.TypeEnum.Signature,
            SignatureBlock = new SignatureBlockModel()
            {
                Signature = new SignatureModel()
                {
                    ApplicationType = SignatureModel.ApplicationTypeEnum.FontStamped,
                    PdfPlacement = new PdfSignaturePlacementModel()
                    {
                        PageCoordinatesPageNumber = 2,
                        XOffset = 172,
                        YOffset = 413
                    }
                }
            }
        }