GroupDocs.Signature for .NET 20.1 Release Notes

Major Features

Below is the list of most notable changes in release of GroupDocs.Signature for .NET 20.1:

  • Legacy API was removed from product
  • Introduced new digital signature XML Advanced Electronic Signatures type for Spreadsheet documents
  • Added new type of annotation

Full List of Issues Covering all Changes in this Release

KeySummaryIssue Type
SIGNATURENET-2509  Implement support XAdES signatures for Spreadsheet documentsFeature
SIGNATURENET-2530SignResult does not have information about added PDF Form Field signaturesBug
SIGNATURENET-2449Word Processing document Sign Text Watermark creates signatures only on last page for doc filesBug
SIGNATURENET-2448Word Processing document Text Form Field - creation and search process gives no rectangle coordinatesBug
SIGNATURENET-2447Word Processing document Sign Text Form field with empty Options.FormTextFieldTitle sign all form fieldsBug
SIGNATURENET-1794Getting exception while signing document without setting output pathBug

Public API and Backward Incompatible Changes

  1. GroupDocs.Signature.Domain.XAdESType

    New public enumeration type XAdESType was added. This type describes possible values of XML Advanced Electronic Signatures types.

    At this moment enumeration contains two options None and XAdES.

    Enumeration of XML Advanced Electronic Signatures types

    /// <summary>
    /// Type of XML Advanced Electronic Signature (XAdES).
    /// </summary>
    public enum XAdESType
    {
        /// <summary>
        /// XAdES is off.
        /// </summary>
        None = 0,
        /// <summary>
        /// Basic XAdES.
        /// </summary>
        XAdES = 1
    }
    
  2. GroupDocs.Signature.Options.DigitalSignOptions
    Public class DigitalSignOptions was extended with new enumeration property XAdESType to specify if digital signature should be XAdES type. See enumeration type XAdESType.

    XAdESType property

    /// <summary>
    /// XAdES type <see cref="XAdESType"/>. Defaule value is None (XAdES is off).
    /// At this moment XAdES signature type is supported only for Spreadsheet documents.
    /// </summary>
    public XAdESType XAdESType { get; set; } = XAdESType.None;
    

    This new property is supported only for Spreadsheets documents. For any other document types this field value will be ignored.

    Example:

    Following example demonstrates creating XAdES Digital signature for Spreadsheet document.

    Signing Spreadsheet document with XAdES signature

    using (Signature signature = new Signature("sample.xlsx"))
    {
        DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
        {
            // set XAdES type
            XAdESType = XAdESType.XAdES,
            // certificate password
            Password = "1234567890",
            // digital certificate details
            Reason = "Sign",
            Contact = "JohnSmith",
            Location = "Office1"
        };
        SignResult signResult = signature.Sign("output.xlsx", options);
        Console.WriteLine($"Document was signed successfully with {signResult.Succeeded.Count} signature(s).\nFile saved at {outputFilePath}.");    
    }