Skip to end of metadata
Go to start of metadata

This page contains release notes for GroupDocs.Signature for Java 19.1

Major Features

There are about 10 improvements, new features and fixes in this regular release. Most features are related to introduced Metadata Signature type implementation for signing and searching for Cells,Slides and Words Documents, also introducing new Form-Field Signature type implementation for signing. There are few improvements with search signature results. Summary the most notable changes are:

  • Introduced Metadata Signature singing features for Cells Documents
  • Implemented Search for Metadata Signatures in Cells Documents
  • Added support of Metadata Signature singing features for Words Documents
  • Implemented Search for Metadata Signatures in Words Documents
  • Introduced ability to search for embedded built-in Metadata Signatures in Words and Cells Documents
  • Implemented support of password protected open-documents-spreadsheet file types of Cells Documents
  • Provided ability to obtain typed list of signatures from search result data
  • Implement Form-field Search features for PDF Documents
  • Introduced Form-field Signature features for PDF Documents
  • Added support of built-in metadata search for Slides/Presentation Documents
  • Implement Metadata Signatures Search for Slides Documents
  • Introduced Metadata Signature features for Slides Documents
  • Extend Digital Signatures verification with Subject and Issuer criteria for Words Documents
  • Improved Form-field Signature naming for multi page Documents
  • Fixed Form-fields search bug for empty named controls for PDF Documents
  • Improved Output file setup, fixed issue for absolute output file path
  • Improve error handling with extended messages

Full List of Issues Covering all Changes in this Release

Key
Summary
Issue Type
SIGNATURENET-1694Implement support of built-in metadata search for Words DocumentsNew Feature
SIGNATURENET-1690Implement support of built-in metadata search for Cells DocumentsNew Feature
SIGNATURENET-1685Implement Metadata Signatures Search for Cells DocumentsNew Feature
SIGNATURENET-1681Implement Metadata Signatures Search for Words DocumentsNew Feature
SIGNATURENET-1677Implement Metadata Signature features for Cells DocumentsNew Feature
SIGNATURENET-1672Implement Metadata Signature features for Words DocumentsNew Feature
SIGNATURENET-1582Implement additional verification criteria for Digital Signatures of Words DocumentsNew Feature
SIGNATURENET-1701Implement support of password protected Open-Documents-Spreadsheet ODS file formatsImprovement
SIGNATURENET-1695Implement Search results conversion to typed list of signaturesImprovement
SIGNATURENET-1467Implement global Exception handler to catch all not handled exceptionsImprovement
SIGNATURENET-1760Implement Form-Field Search features for PDF DocumentsNew Feature
SIGNATURENET-1751Implement Form-Field Signature features for PDF DocumentsNew Feature
SIGNATURENET-1715Implement support of built-in metadata search for Slides/Presentation DocumentsNew Feature
SIGNATURENET-1711Implement Metadata Signatures Search for Slides DocumentsNew Feature
SIGNATURENET-1707Implement Metadata Signature features for Slides DocumentsNew Feature
SIGNATURENET-1797Skip Output folder when SaveOptions.OutputFileName is set as absolute pathBug
SIGNATURENET-1782Exception is fired when searching in PDF documents for Form-fields that were setup without nameBug
SIGNATURENET-1785Implement standard Image Metadata SignaturesNew Feature
SIGNATURENET-1756Extend Form-Field signature name automatically with number prefix for multiple-pages optionsImprovement
SIGNATURENET-1581Improve handling exceptions with proper details and exception typeImprovement

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in GroupDocs.Signature for Java 19.1. It includes not only new and obsoleted public methods, but also a description of any changes in the behavior behind the scenes in GroupDocs.Signature which may affect existing code. Any behavior introduced that could be seen as a regression and modifies existing behavior is especially important and is documented here.

  1. New public class CellsMetadataSignature was added to implement Metadata signature features for Cells Documents. This class derives base MetadataSignature, overloads virtual methods (IClonable implementation).

    Cells Metadata Signature class properties

    Cells Metadata Signature properties:

    Cells Metadata Signature derives all base class properties.
    Cells Metadata Signature methods:

    PDF metadata Signature derives all base class methods.

    Method name

    Return type

    Description / Remarks

    toBoolean()booleanReturns the Metadata signature value as Boolean. Throws an exception if the Metadata value could not be converted. If value is integer type all non zero values will be interpreted as True. 
    toInteger()integerReturns the Metadata Signature value as integer. Throws an exception if the Metadata value could not be converted. Boolean value will be converted to 1 in case of logical true value, otherwise 0. Double value will be truncated. String value will be tries to parse into integer.
    toDouble()doubleOverload method with ability to specify IDataFormatProvider for string based values conversion. Returns the Metadata Signature value as double. Throws an exception if the Metadata value could not be converted. Boolean value will be converted to 1 in case of logical true value, otherwise 0. String value will be tries to parse into double based on passed IDataFormatProvider or default provider from SignatureConfig.DefaultCulture property.
    toDateTime()DateOverload method with ability to specify IDataFormatProvider for string based values conversion. Returns the Metadata Signature value as java.util.Date. Throws an exception if the Metadata value could not be converted. String value will be tries to parse into Date based on passed IDataFormatProvider or default provider from SignatureConfig.DefaultCulture property.
    toString()stringOverload method with ability to specify IDataFormatProvider to data type convertions. Returns the Metadata Signature value as string representation based on passed format and IDataFormatProvider or default provider from SignatureConfig.DefaultCulture property.

    Following example demonstrates using CellsMetadataSignature to compose Metadata Signature options for Cells Document.

    Compose Cells Metadata Signature Options


  2. New public class WordsMetadataSignature was added to implement Metadata signature features for Words Documents. This class derives base MetadataSignature, overloads virtual methods (IClonable implementation).

    Words Metadata Signature class properties

    Words Metadata Signature properties:

    Words Metadata Signature derives all base class properties.
    Words Metadata Signature methods:

    PDF metadata Signature derives all base class methods.

     

    Method name

    Return type

    Description / Remarks

    toBoolean()booleanReturns the Metadata signature value as Boolean. Throws an exception if the Metadata value could not be converted. If value is integer type all non zero values will be interpreted as True. 
    toInteger()integerReturns the Metadata Signature value as integer. Throws an exception if the Metadata value could not be converted. Boolean value will be converted to 1 in case of logical true value, otherwise 0. Double value will be truncated. String value will be tries to parse into integer.
    toDouble()doubleOverload method with ability to specify IDataFormatProvider for string based values conversion. Returns the Metadata Signature value as double. Throws an exception if the Metadata value could not be converted. Boolean value will be converted to 1 in case of logical true value, otherwise 0. String value will be tries to parse into double based on passed IDataFormatProvider or default provider from SignatureConfig.DefaultCulture property.
    toDateTime()DateOverload method with ability to specify IDataFormatProvider for string based values conversion. Returns the Metadata Signature value as java.util.Date. Throws an exception if the Metadata value could not be converted. String value will be tries to parse into Date based on passed IDataFormatProvider or default provider from SignatureConfig.DefaultCulture property.
    toString()stringOverload method with ability to specify IDataFormatProvider to data type convertions. Returns the Metadata Signature value as string representation based on passed format and IDataFormatProvider or default provider from SignatureConfig.DefaultCulture property.

    Following example demonstrates using WordsMetadataSignature to compose Metadata Signature options for Words Document.

    Compose Words Metadata Signature Options


  3. New public class CellsSearchMetadataOptions was added to provide options to search for Cells Metadata signatures within the Cells Documents. This class derives base SearchMetadataOptions.

    Cells Metadata Search Options properties

    Following example demonstrates using SearchMetadataOptions to search for Cells Metadata signatures in the Cells Documents.

    Search for Metadata signatures in Cells Documents
  4. New public class WordsSearchMetadataOptions was added to provide options to search for Words Metadata signatures within the Words Documents. This class derives base SearchMetadataOptions.

    Words Metadata Search Options properties

    Following example demonstrates using SearchMetadataOptions to search for Words Metadata signatures in the Words Documents.

    Search for Metadata signatures in Words Documents
  5. Public class SearchResult was updated with generic method <T> toList(Class<T> typeOfT)  to provide ability for typed list conversion.

  6. New Form-Field type of signature is the abstract class FormFieldSignature and enumeration FormFieldType.
    Many documents support special elements Form Fields that allow user to input data into standard form elements like text input, extended multi line text, check box, radio buttons, digital certificate holders etc. This version we implemented support of these signatures for PDF documents. New enumeration type FormFieldType specifies type of form-field element like Text, CheckBox, Signature.

    FormFieldType

    New public abstract class FormFieldSignature was added to implement Form Field signature features for documents. The Form Field Signature is a input control which is placed on a document page. Some types of documents supports various input controls like Check-box or Text.

    This type of Signature allows users to place input controls on document pages.

    FormFieldSignature

    FormField Signature properties:

    Name

    Type

    Description

    NamestringSpecifies name of FormField Signature.
    TypeFormFieldTypeSpecifies type of form field.
    ValueobjectSpecifies value of FormField  Signature. This property could be different type.
  7. New classes to represent different Form-Field Signatures of PDF documents.
    New scope of classes that are derived from base FormFieldSignature implement following PDF document form-fields.

    1. New public class PdfTextFormFieldSignature was added to implement simple input Text Form Field signatures for PDF documents. The Form Field Signature is a input control which is placed on a document page. Some types of documents supports various input controls like Check-box or Text.

    This type of Signature allows users to place input controls on document pages.

    PdfTextFormFieldSignature

    PDF Text FormField Signature properties:

    Name

    Type

    Description

    TextstringSpecifies text of input Form Field Signature.

    2. New public class PdfCheckboxFormFieldSignature was added to implement simple Check Box Form Field signatures for PDF documents.

    PdfCheckboxFormFieldSignature

    PDF Text FormField Signature properties:

    Name

    Type

    Description

    TextstringSpecifies text of input Form Field Signature.

     

    3. New public class PdfDigitalFormFieldSignature was added to implement Digital Signature input Form Field for PDF documents.

    PdfDigitalFormFieldSignature

    PDF Text FormField Signature properties:

    Name

    Type

    Description

    SignedboolSpecifies if Form Field Signature was signed.
  8. New static class PdfFormFieldSignOptions represent options to put Form-field signature on PDF document. Class is derived from base TextSignOptions class that allows to specify positioning of signature area, alignment etc. Class keeps property of FormFieldSignature to be posted on document.

    PdfFormFieldSignOptions

    Following example demonstrates using PdfFormFieldSignOptions to add form field signature on PDF document page:

    Signing with form field in PDF document
  9. New abstract class SearchFormFieldOptions represents base class to specify search options for form field signatures.

    SearchFormFieldOptions class properties

    Nullable property Type allows optionally specify type of form-field to search, string property Name allows to specify regular expression pattern for form-field name, property Value allows to specify optionally value of control.

  10. New public abstract class PdfSearchFormFieldOptions  was added to implement form field signature search for PDF documents.

    This type of Signature allows users to search for form field signatures like TextBox, CheckBox or Digital.

    PdfSearchFormFieldOptions class properties

    Following example demonstrates using SearchFormFieldOptions to search for form field signatures on PDF document page:

    Searching for form field in PDF document
  11. New public class SlidesMetadataSignature was added to implement Metadata signature features for Slides documents. This class derives base MetadataSignature , overloads virtual methods (IClonable implementation).

    Slides Metadata Signature class properties

    Slides Metadata Signature properties:
    Slides Metadata Signature derives all base class properties.
    Slides Metadata Signature methods:

    Slides metadata Signature derives all base class methods.

    Method name

    Return type

    Description / Remarks

    ToBoolean()booleanReturns the Metadata signature value as Boolean. Throws an exception if the Metadata value could not be converted. If value is integer type all non zero values will be interpreted as True. 
    ToInteger()integerReturns the Metadata Signature value as integer. Throws an exception if the Metadata value could not be converted. Boolean value will be converted to 1 in case of logical true value, otherwise 0. Double value will be truncated. String value will be tries to parse into integer.
    ToDouble()doubleOverload method with ability to specify IDataFormatProvider for string based values conversion. Returns the Metadata Signature value as double. Throws an exception if the Metadata value could not be converted. Boolean value will be converted to 1 in case of logical true value, otherwise 0. String value will be tries to parse into double based on passed IDataFormatProvider or default provider from SignatureConfig.DefaultCulture property.
    ToDateTime()DateTimeOverload method with ability to specify IDataFormatProvider for string based values conversion. Returns the Metadata Signature value as DateTime. Throws an exception if the Metadata value could not be converted. String value will be tries to parse into Datetime based on passed IDataFormatProvider or default provider from SignatureConfig.DefaultCulture property.
    ToString()stringOverload method with ability to specify IDataFormatProvider to data type convertions. Returns the Metadata Signature value as string representation based on passed format and IDataFormatProvider or default provider from SignatureConfig.DefaultCulture property.

    Following example demonstrates using SlidesMetadataSignature to compose Metadata Signature options for Words document.

    Compose Slides Metadata Signature Options
  12. New public class SlidesMetadataSignOptions was added to provide options to support Metadata signature features for Slides/Presentation documents. This class derives base MetadataSignOptions.

    Slides Metadata Sign Options properties

    Following example demonstrates using SlidesMetadataSignOptions to add Metadata signatures to Slides document:

    Sign Slides document with Metadata Signature
  13. New public class SlidesSearchMetadataOptions was added to provide options to search for Metadata Signatures within the Slides/Presentation documents. This class derives base SearchMetadataOptions.

    Slides Metadata Search Options properties

    Following example demonstrates using SlidesSearchMetadataOptions to search for Slides Metadata signatures in the Slides/Presentation documents:

    Search for Slides Metadata Signatures in documents
  14. Public class WordsVerifyDigitalOptions was updated with new string properties SubjectName and IssuerName. These fields could be used as additional criteria to verify Digital Signatures of Words documents. If these properties are specified verification process will check for Digital Signature properties (SubjectName, IssuerName) to be equal or contain passed strings. These values are case sensitive.

    WordsVerifyDigitalOptions

    Following example demonstrates using these properties to verify Digital signatures in the Words documents:

    Verify Digital signatures in the Words documents
Labels
  • No labels