Uploading & Deleting Documents

To download the full code sample see our Code Share site.

This topic includes the following:

• How to upload a document

• How to replace an existing document

• How to update the metadata in a document

• How to delete a document after you have created a package

Uploading Documents

To add a document to an existing package, you must first create the Document object. The following code will create a Document object:

Document document = DocumentBuilder.newDocumentWithName("Example Document")
				.fromFile("DOC_FILE_PATH")
				//.fromStream( documentStream, DocumentType.PDF );
				.withId("document1")
				.withDescription("Sample Document Description")
			.build();

Once the Document object has been created, find the PackageId you wish to add the document to and then use the OneSpan Sign client to upload that document. The following code will do this:

eslClient.uploadDocument(document, packageId);

You can also upload multiple documents within one call. To do this, build multiple Document objects locally and pass them as variable arguments or as a list into the following code:

eslClient.uploadDocuments(packageId, doc1, doc2, doc3);
eslClient.uploadDocuments(packageId, Arrays.asList(doc1, doc2, doc3));

Replacing an Existing Document

Replacing an existing document in a transaction can also be done using the Upload function. This is useful, for example, if you would like to replace the document but still keep the layout of the fields and signatures.

To do this, build a Document object that carries the same Document ID as the document you want to replace, and then use the OneSpan Sign client to upload it. The following code will do this:

Document document = DocumentBuilder.newDocumentWithName("Document1")
				.fromFile("path_to_your_file")
				.withId("keep_the_same_document_id")
				.build();
				eslClient.uploadDocument(document, new PackageId("the_package_id"));

Similarly, you can replace multiple documents within a call.

Document document = DocumentBuilder.newDocumentWithName("Updated Document1")
				.fromFile("path_to_your_file ")
				.withId("1dda69f88b10f2e0e6bd846aae9fca0a961aba793bf655b0")
				.build();
				Document document2 = DocumentBuilder.newDocumentWithName("Updated Document2")
				.fromFile("path_to_your_file ")
				.withId("c4a6128b646f50c650779d652e5951097663a1de16c4ce72")
				.build();
				eslClient.uploadDocuments(new PackageId("package_id"),Arrays.asList(document,document2));	

Updating Document Metadata

To update the metadata for a document, simply create a Document object with the updates you want to make. For example:

Document document = DocumentBuilder.newDocumentWithName("Example Document")
				.withName("Updated document name")
				.withDescription("Updated document description")
			.build();

Then, grab the DocumentPackage you wish to change this document in and then use the OneSpan Sign client to update the document metadata. The following code will do this:

eslClient.getPackageService().updateDocumentMetadata(documentPackage, document);

Deleting a Document

To delete a document, call the deleteDocument function with the packageId and documentId string:

eslClient.getPackageService().deleteDocument(packageId, document.getId().toString());

Results

After running your code, if you login to OneSpan Sign and navigate to your transaction, you will be able to log into your OneSpan Sign account and view the documents you just added.

To download the full code sample see our Code Share site.

This topic includes the following:

• How to upload a document

• How to replace an existing document

• How to update the metadata in a document

• How to delete a document after you have created a package

Uploading Documents

To add a document to an existing package, you must first create the Document object. The following code will create a Document object:

Document document = DocumentBuilder.NewDocumentNamed("Example Document")
				.FromFile("DOC_FILE_PATH")
				//.fromStream( documentStream, DocumentType.PDF );
				.WithId("document1")
				.WithDescription("Sample Document Description")
			.Build();

Once the Document object has been created, find the PackageId you wish to add the document to and then use the OneSpan Sign client to upload that document. The following code will do this:

eslClient.UploadDocument(document, packageId);

You can also upload multiple documents within one call. To do this, build multiple Document objects locally and pass them as variable arguments or as a list into the following code:

eslClient.UploadDocuments(packageId, doc1, doc2, doc3);
eslClient.UploadDocuments(packageId, new List<Document>(){doc1,doc2,doc3});			

Replacing an Existing Document

Replacing an existing document in a transaction can also be done using the Upload function. This is useful, for example, if you would like to replace the document, but still keep the layout of the fields and signatures.

To do this, build a Document object that carries the same Document ID as the document you want to replace, and then use the OneSpan Sign client to upload it. The following code will do this:

Document document = DocumentBuilder.NewDocumentWithName("Document1")
				.FromFile("path_to_your_file")
				.WithId("keep_the_same_document_id")
				.Build();
				eslClient.UploadDocument(document, new PackageId("the_package_id"));

Similarly, you can replace multiple documents within a call.

Document document = DocumentBuilder.NewDocumentWithName("Updated Document1")
				.FromFile("path_to_your_file ")
				.WithId("1dda69f88b10f2e0e6bd846aae9fca0a961aba793bf655b0")
				.Build();
				Document document2 = DocumentBuilder.NewDocumentWithName("Updated Document2")
				.FromFile("path_to_your_file ")
				.WithId("c4a6128b646f50c650779d652e5951097663a1de16c4ce72")
				.Build();
				eslClient.UploadDocuments(new PackageId("package_id"), new List<Document>(){document,document2});		

Updating Document Metadata

To update the metadata for a document, simply create a Document object with the updates you want to make. For example:

Document document = DocumentBuilder.NewDocumentNamed("Example Document")
				.WithName("Updated document name")
				.WithDescription("Updated document description")
			.Build();

Then, grab the DocumentPackage you wish to change this document in and then use the OneSpan Sign client to update the document metadata. The following code will do this:

eslClient.PackageService.UpdateDocumentMetadata(documentPackage, document);

Deleting a Document

To delete a document, call the deleteDocument function with the packageId and documentId string:

eslClient.PackageService.DeleteDocument(packageId, document.Id.ToString());

Results

After running your code, if you login to OneSpan Sign and navigate to your transaction, you will be able to log into your OneSpan Sign account and view the documents you just added.

To download the full code sample see our Code Share site.

This topic includes the following:

• How to upload a document

• How to replace an existing document

• How to update the metadata in a document

• How to delete a document after you have created a package

Uploading Documents

To add a document to an existing package, you must first create the Document object. The following code will create a Document object:

        StaticResource sr = [SELECT Id, Body FROM StaticResource WHERE Name = 'testdoc1' LIMIT 1];
				Map<String,Blob> doc = new Map<String,Blob>();
				doc.put('Sample Document', sr.Body);
         
				ESignLiveAPIObjects.Document document = new ESignLiveAPIObjects.Document();
				document.name = 'Sample Contract';
			document.id = 'document1';

Once the Document object has been created, find the PackageId you wish to add the document to and then use the OneSpan Sign client to upload that document. The following code will do this:

        String documentResponse = sdk.createDocuments(packageId, document, doc);
			document = (ESignLiveAPIObjects.Document)JSON.deserialize(documentResponse, ESignLiveAPIObjects.Document.class);

Replacing an Existing Document

Replacing an existing document in a transaction can also be done using the Upload function. This is useful, for example, if you would like to replace the document, but still keep the layout of the fields and signatures.

To do this, build a Document object that carries the same Document ID as the document you want to replace, and then use the OneSpan Sign client to upload it. The following code will do this:

StaticResource sr = [SELECT Id, Body FROM StaticResource WHERE Name = 'testdoc1' LIMIT 1];
				Map<String,Blob> doc = new Map<String,Blob>();
				doc.put('Sample Document', sr.Body);
         
				ESignLiveAPIObjects.Document document = new ESignLiveAPIObjects.Document();
				document.name = 'Updated Document';
				document.id = ‘keep_the_document_id_same’;
				String documentResponse = sdk.createDocuments(packageId, document, doc);	

Updating Document Metadata

To update the metadata for a document, simply create a Document object with the updates you want to make. For example:

    	ESignLiveAPIObjects.Document document_updated = new ESignLiveAPIObjects.Document();
				document_updated.name = 'updated document name';
			document_updated.description = 'updated document description';

Then, use below function to update the document metadata by passing in the package ID, document ID and updated Document object.

    	sdk.updateDocument(packageId, document.id, document_updated);

Deleting a Document

To delete a document, call the deleteDocument function with the packageId and documentId string:

    	sdk.deleteDocument(packageId, document.id);

Results

After running your code, if you login to OneSpan Sign and navigate to your transaction, you will be able to log into your OneSpan Sign account and view the documents you just added.