Search for Metadata e-Signatures

GroupDocs.Signature provides the ability to search for metadata electronic signatures in documents. Metadata signatures allow you to add custom metadata properties to your documents, which can be used to store additional information about the document or its signatures.

How to Search for Metadata Signatures

The Signature class provides the Search method which allows you to search for metadata signatures in documents. Here’s how to use it:

  1. Create a new instance of the Signature class and pass the source document path as a parameter.
  2. Create an instance of MetadataSearchOptions class.
  3. Call the Search method of the Signature class instance and pass the search options to it.
  4. Process the search results.

Here’s an example of how to search for metadata signatures in a document:

from groupdocs.signature import Signature
from groupdocs.signature.options import MetadataSearchOptions
from groupdocs.signature.domain import MetadataSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = MetadataSearchOptions()
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} metadata signatures")
    for metadata_signature in result:
        print(f"Name: {metadata_signature.name}")
        print(f"Value: {metadata_signature.value}")

Advanced Search Options

You can customize the search process by setting specific options:

from groupdocs.signature import Signature
from groupdocs.signature.options import MetadataSearchOptions
from groupdocs.signature.domain import MetadataSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = MetadataSearchOptions()
    
    # Set search criteria
    search_options.name = "Author"  # Search for specific metadata name
    search_options.value = "John Doe"  # Search for specific metadata value
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} metadata signatures")
    for metadata_signature in result:
        print(f"Name: {metadata_signature.name}")
        print(f"Value: {metadata_signature.value}")

Additional Resources

GitHub Examples

You may easily run the code above and see the feature in action in our examples:

Free Online Apps

Along with full Python library we provide simple but powerful free Apps.

You are welcome to search for metadata signatures in documents with our free online apps: