Advanced search syntax can be used to search for documents with a particular digital signature.
Multiple digital signatures can be assigned to a single document, and each digital signature on the document will have different attributes (such as the date signed, the signer and the comment). You can perform a search for characteristics of a single signature, or a search for characteristics contained in any signature or combination of signatures in that document.To allow you to specify more than one search criteria within a single signature, we use a special digital signature search namespace. You can use wildcards or operators to determine the results returned.
The following digital signature searches can be used separately or combined:
Signed By:
- {LFSIG:SignedBy ="User Name"}
Show me an example.
The following will search for a document signed by the Windows domain user DOMAIN\JSmith.
- {LFSIG:SignedBy = "DOMAIN\JSmith"}
Certificate Subject:
Certificate subject searches are performed as non-indexed searches by default in Laserfiche client applications, but may also be performed as indexed searches by choosing the correct operator. The examples below show the operator for the default search, which for these search types is non-indexed search. You can perform these searches as indexed searches by replacing the non-indexed search operator (=) with the indexed search operator (~=). See Indexed and Non-Indexed Searches and Operators for more information.
- {LFSIG:CertSubject ="Certificate Name"}
Certificate Name is the name of the certificate subject (the user or organization specified in the signing certificate). It must be enclosed in quotes.
Note: The name of the certificate subject is not the Laserfiche trustee name. To search by trustee name, use the Signed By search syntax above.
Show me an example.
The following will search for documents that have been signed by a user whose signing certificate name is Jane Doe.
- {LFSIG:CertSubject= "Jane Doe"}
Signed Date:
- {LFSIG:SignedDate ="mm/dd/yy"}
mm/dd/yy is the date on which the document you are searching for was signed. It must be in the format mm/dd/yy, mm-dd-yy, mm/dd/yyyy, or mm-dd-yyyy, and must be enclosed in quotes.
Show me an example.
The following will search for documents signed since December 1, 2011.
- {LFSIG:SignedDate >= "12/1/2011"}
The following will search for documents signed by a user whose signing certificate name is Jane Doe in December of 2011.
- {LFSIG:CertSubject= "Jane Doe",SignedDate>="12/1/2011", SignedDate<="12/31/2011"}
Signing Reason:
Digital signature signing reason searches are performed as indexed searches by default in Laserfiche client applications, but may also be performed as non-indexed searches by choosing the correct operator. The examples below show the operator for the default search, which for these search types is indexed search. You can perform these searches as non-indexed searches by replacing the indexed search operator (~=) with the non-indexed search operator (=). See Indexed and Non-Indexed Searches and Operators for more information.
- {LFSIG:Comment ~="Comment"}
Comment is the signing or part of the signing reason on the signature you are searching for. It must be enclosed in quotes.
Show me an example.
The following will search for documents that have been signed by DOMAIN\JSmith where the signature included the comment Approval.
- {LFSIG:SignedBy = "DOMAIN\JSmith",Comment ~= "Approval"}
The following will search for documents that have been signed by anyone with a comment
Tip: To search for a document with a digital signature that it is signed by the user "John" with the comment "approve", the search syntax would be: {LFSIG:SignedBy="John", Comment~="approve"}.
LFSIG is the namespace for digital signatures, and SignedBy and Comment are the attributes of the digital signature that is being searched for.
Note: This search is different than {LFSIG:SignedBy="John"} & {LFSIG:Comment="approve"}. The former requires a single digital signature to match both criteria of the attributes while the later will find documents which have two digital signatures that, combined, meet the criteria.