VaultLifecycle

Workspace Tabs Reference

Detailed reference for every tab in the VaultLifecycle workspace: search and filters, Timeline, Signing, Delivery, Workflow, and Configuration.

The VaultLifecycle workspace is organised into a document list view with search and filters, plus a detail panel that opens when you select a document. The detail panel contains the following tabs.


Search & Filters

The search bar and filter panel appear above the document list and apply across all records loaded from the SharePoint Activity List.

Full-text search runs substringof across the following indexed SharePoint columns:

ColumnDescription
TitleDocument name / display title
CorrelationIdUnique render correlation ID
DocumentIdBusiness document identifier (e.g. invoice number, contract ID)
ReferenceIDBatch ID — links child documents back to their parent batch
RecipientEmailRecipient email address for eSign and delivery documents

Filters

FilterDescription
StatusFilters by the document's current VPDFStatus value (e.g. Success, pending-approval, signed).
Activity TypeFilters by VPDFActivityType (e.g. Delivery, Workflow, eSignature).
Source SystemFilters by the SourceSystem column — the identifier of the system that submitted the render request (e.g. D365_FO, BC, PowerAutomate).
Date From / ToFilters by the document's Created date in the Activity List.

Saved Searches

Filter combinations can be saved and recalled by name. Saved searches persist across sessions per user. Use the save icon in the filter bar to store a filter set and load it from the saved searches menu.

VaultLifecycle supports deep links — SharePoint page URLs with query parameters that pre-populate the search and automatically open the workspace. This is useful for source systems (Dynamics 365, Business Central, Power Automate) to provide one-click navigation to a specific document's lifecycle view.

ParameterEffect
?correlationId=<guid>Pre-populates search with the Correlation ID — opens workspace directly to that document
?batchId=<guid>Pre-populates search with the Batch ID (searches the ReferenceID column)
?q=<text>Pre-populates the search field with arbitrary text
?sourceSystem=<value>Pre-populates the Source System filter (e.g. ?sourceSystem=D365_FO)

Parameters can be combined: ?batchId=<guid>&sourceSystem=D365_FO

Supported entry points:

  • Home.aspx (dashboard web part): https://your-site/SitePages/Home.aspx?batchId=082ab853-...
  • List-view pages with the VaultLifecycle command set extension installed

CorrelationId and BatchId are globally unique UUIDs — no sourceSystem qualifier is needed to identify a specific record via GUID.

Deep links do not bypass access control

SharePoint authentication, list permissions, admin role resolution, and item-level visibility (VPDFRestrictionMap) all apply identically whether the workspace opens via a button click or a deep link. A user who cannot see a document normally will see zero results from a deep link for that document. See the Security page for the full enforcement model.


Timeline Tab

The Timeline tab shows a chronological, expandable event log for the selected document. Events are loaded from the immutable VaultAudit JSONL blob for the document's correlationId.

Timeline Views

The timeline supports four filtered views based on event severity. Select a view from the toolbar above the event list.

ViewSeverities ShownAudience
Executiveinformation, complianceSenior leadership, document owners
Compliancecompliance, securityCompliance officers, auditors
Securitysecurity, failureSecurity teams, risk reviewers
FullAll severitiesAdministrators, support

Level 1 Timeline Events

Level 1 events are the business and compliance milestones shown in the timeline. Each event displays a product label, severity badge, and timestamp. Only Level 1 events appear in the filtered views above.

Render Events — VaultPDF

Event TypeDisplay TitleSeverity
generatedDocument Generatedinformation
failedRender Failedfailure

Audit Events — VaultAudit

Event TypeDisplay TitleSeverity
integrity-validatedIntegrity Verifiedcompliance
accessibility-checkedAccessibility Verifiedcompliance
archivedArchived to Immutable Storagecompliance
verifiedIntegrity Re-verifiedcompliance
reproducedDocument Reproducedcompliance
evidence-exportedEvidence Exportedcompliance
revokedAccess Revokedsecurity

Workflow Events — VaultWorkflow

Event TypeDisplay TitleSeverity
workflow-initiatedSubmitted for Reviewgovernance
workflow-approval-requestedSent for Approvalgovernance
workflow-changes-requestedChanges Requestedgovernance
workflow-resubmittedResubmittedgovernance
workflow-approvedApprovedgovernance
workflow-rejectedWorkflow Rejectedfailure
workflow-cancelledWorkflow Cancelledgovernance
workflow-sealedDocument Sealedcompliance

Signing Events — VaultESign

Event TypeDisplay TitleSeverity
sent-for-signatureSent for Signatureinformation
otp-verifiedIdentity Verifiedsecurity
document-signedDocument Signedcompliance

Delivery Events — VaultDelivery

Event TypeDisplay TitleSeverity
delivery-createdDocument Deliveredinformation

Redact Events — VaultRedact

Event TypeDisplay TitleSeverity
document-protectedDocument Protectedcompliance

Level 2 Sub-Event Trails

Two Level 1 events carry expandable sub-event trails that surface the full operational detail of the underlying session. Sub-events are always written to the audit log but do not appear in Executive or Compliance filtered views — they are accessible only by expanding the parent event.

Document Signed — eSign trail

Expanding a document-signed event reveals the complete eSign session trail for that signer slot:

StepSub-Event
1Session Created
2Invitation Sent
3Signer Opened Portal
4OTP Challenge Issued
5OTP Verified
6Document Signed
7Evidence Package Generated
8Session Closed

Document Delivered — Delivery trail

Expanding a delivery-created event reveals the complete delivery session trail for the recipient:

StepSub-Event
1Session Created
2Notification Sent
3Delivery Link Opened
4Identity Verified
5Document Downloaded
6Session Completed

Workflow detail

Workflow operational events (Step Submitted, Step Advanced, Approver Opened Task, Seal Initiated) appear as sub-events of the preceding workflow milestone in the Full view rather than as standalone Level 1 entries.

Expanding Event Details

Every Level 1 event can be expanded to show extendedDetails — a key-value panel with additional context such as file size, hash values, engine version, hashed IP addresses, slot index, and signing mode. Sub-event trails expand within the same panel.


Signing Tab

The Signing tab shows the VaultESign session for the selected document, if one exists.

Session Overview Panel

FieldDescription
Session ID (groupId)Unique signing group identifier.
Signing Modesingle, sequential, or parallel.
StateCurrent session state (see Session States).
Total SignersNumber of signing slots in the session.
Completed SignersNumber of slots in signed state.
CreatedSession creation timestamp.
ExpiresSession expiry timestamp.
Sealed AtTimestamp when the final signed PDF was produced (if complete).

Signer Slot Table

Each slot in the session is shown as a row:

ColumnDescription
SlotZero-based slot index.
RoleSlot role from the PDF template (e.g. vendor, manager).
StateCurrent slot state.
ActivatedWhen the signer first opened the portal.
SignedWhen the signer completed their slot.
IPHashed signer IP (shown as last 4 chars for identification only).

Actions

  • Resend Invitation: Resends the signing invitation email to a pending slot. Subject to rate limiting (one resend per slot per 10 minutes).
  • Revoke Session: Cancels the entire signing session. Pending slots become inaccessible.

Delivery Tab

The Delivery tab shows all VaultDelivery sessions associated with the selected document.

Session List

Each delivery session is shown as a card with:

FieldDescription
Delivery IDUnique session identifier.
RecipientRecipient display name and role. Email is not displayed (privacy).
Modesecure-email, sharepoint, or both.
StateCurrent session state (pending, opened, downloaded, expired, revoked).
CreatedSession creation timestamp.
ExpiresSession expiry timestamp.
Opened AtWhen the recipient first opened the delivery portal.
Downloaded AtWhen the recipient first downloaded the document.

Actions

  • Revoke Session: Immediately revokes a delivery session. The recipient's access link becomes invalid.
  • New Delivery: Opens a form to create a new delivery session for the current document. Requires the document's pdfBlobPath.

Workflow Tab

The Workflow tab shows the VaultWorkflow instance associated with the selected document, if one exists.

Instance Overview

FieldDescription
Workflow IDUnique workflow instance identifier.
TitleWorkflow title (e.g. document or reference number).
StateCurrent workflow state (see Workflow Lifecycle States).
Steps{completedSteps} / {totalSteps} steps submitted.
Approval Stage{currentStage} / {totalStages} approval stages completed (multi-stage routing).
ValidationOutcome of the most recent validation run (passed / failed).
CreatedWorkflow creation timestamp.
Last UpdatedTimestamp of the most recent state change.
Completed AtTimestamp when the workflow reached complete or was cancelled.

Validation Results Panel

When validation has run, the Workflow tab shows each rule result:

ColumnDescription
Rule IDStable identifier from the schema.
DescriptionHuman-readable rule description.
Statuspassed or failed.
Severityerror or warning.
MessageFailure message shown to participant/approver.
FieldAssociated field key (if declared in the schema).

For numericTolerance rules with expandableDetails: true, the panel shows an expandable comparison row with left/right values, variance, and tolerance threshold.

Change Requests Panel

When the workflow is in changes-requested state, each change request raised by the reviewer is listed:

ColumnDescription
MessageCorrection instruction from the reviewer.
FieldAssociated field key (for portal highlighting).
Severityinfo, warning, or error.
CategoryOptional grouping label.
Due DateOptional date by which the correction should be made.
Resolved AtTimestamp when the participant addressed this item.

Configuration Tab

The Configuration tab provides technical metadata and operational configuration for the selected document.

Technical Details Panel

FieldDescription
Correlation IDUnique render correlation ID.
Engine VersionVaultPDF engine version used to render the document.
Template PathBlob Storage path of the .vpdf template.
Payload PathBlob Storage path of the JSON render payload.
Render QueueQueue used for this render (priority, standard, or low).
Render Modereal-time or async.

Trust Status

The Trust panel shows the computed trust posture for the document:

StatusDescription
trustedSHA-256 hash verified, no tamper indicators, immutable archive present.
verifiedHash verified but immutable archive not enabled.
unverifiedHash not yet verified since last status update.
tamperedHash verification failed; document content does not match the stored hash.
pendingVerification in progress.

Links to all artefacts associated with the document:

File TypeDescription
final-pdfThe rendered (and optionally signed) PDF document.
certificateVaultESign evidence certificate (if signing completed).
accessibility-reportSection 508 accessibility trace report (if enabled).
evidence-bundleVaultAudit .vpdf immutable archive package.
reproduced-originalRe-rendered PDF from the .vpdf archive (if a reproduction has been run).

Operational Actions

ActionDescription
Verify IntegrityTriggers an on-demand SHA-256 verification against the stored hash.
Archive DocumentAppends an archived event to the audit log for this document.
Export EvidenceExports the full audit JSONL event stream as a downloadable JSON file.
Reproduce DocumentRe-renders the document from the .vpdf archive and compares the output hash to the original.

Back to VaultLifecycle Overview

Learn about data sources, document status values, and the SharePoint Activity List.

On this page