public class ObjectRecordAttachmentRequest extends VaultRequest
Modifier and Type | Field and Description |
---|---|
static String |
ID_PARAM
If you’re identifying object records in your input by a unique field, add idParam={fieldname} to the request endpoint.
|
HTTP_HEADER_AUTHORIZATION, HTTP_HEADER_VAULT_CLIENT_ID, vaultClient
Modifier and Type | Method and Description |
---|---|
Boolean |
attachmentsEnabled(String objectName)
Determine if Attachments are Enabled on an Object
|
ObjectRecordAttachmentResponse |
createMultipleObjectRecordAttachments(String objectName)
You can create object record attachments in bulk with a JSON or CSV input file.
|
ObjectRecordAttachmentResponse |
createObjectRecordAttachment(String objectName,
String recordId)
Create Object Record Attachment
Create a single object record attachment. |
ObjectRecordAttachmentResponse |
deleteMultipleObjectRecordAttachments(String objectName)
Delete object record attachments in bulk with a JSON or CSV input file.
|
ObjectRecordAttachmentResponse |
deleteObjectRecordAttachment(String objectName,
String recordId,
int attachmentId)
Delete Object Record Attachment
|
ObjectRecordAttachmentResponse |
deleteObjectRecordAttachmentVersion(String objectName,
String recordId,
int attachmentId,
int versionId)
Delete Object Record Attachment Version
|
VaultResponse |
downloadAllObjectRecordAttachmentFiles(String objectName,
String recordId)
Download All Object Record Attachment Files
|
VaultResponse |
downloadObjectRecordAttachmentFile(String objectName,
String recordId,
int attachmentId)
Download Object Record Attachment File
|
VaultResponse |
downloadObjectRecordAttachmentVersionFile(String objectName,
String recordId,
int attachmentId,
int versionId)
Download Object Record Attachment Version File
|
ObjectRecordAttachmentResponse |
restoreObjectRecordAttachmentVersion(String objectName,
String recordId,
int attachmentId,
int versionId)
Restore Object Record Attachment Version
|
ObjectRecordAttachmentResponse |
retrieveObjectRecordAttachmentMetadata(String objectName,
String recordId,
int attachmentId)
Retrieve Object Record Attachment Metadata
|
ObjectRecordAttachmentResponse |
retrieveObjectRecordAttachments(String objectName,
String recordId)
Retrieve Object Record Attachments
|
ObjectRecordAttachmentResponse |
retrieveObjectRecordAttachmentVersionMetadata(String objectName,
String recordId,
int attachmentId,
int versionId)
Retrieve Object Record Attachment Version Metadata
|
ObjectRecordAttachmentResponse |
retrieveObjectRecordAttachmentVersions(String objectName,
String recordId,
int attachmentId)
Retrieve Object Record Attachment Versions
|
ObjectRecordAttachmentRequest |
setAcceptCSV()
Set the Header Accept to return CSV
|
ObjectRecordAttachmentRequest |
setBinaryFile(String filename,
byte[] binaryContent)
Specify source data in an input file
|
ObjectRecordAttachmentRequest |
setContentTypeCsv()
Set the Header Content Type to CSV
|
ObjectRecordAttachmentRequest |
setContentTypeJson()
Set the Header Content Type to JSON
|
ObjectRecordAttachmentRequest |
setIdParam(String idParam)
Specify a value for the idParam (if not using id)
|
ObjectRecordAttachmentRequest |
setInputPath(String inputPath)
Specify source data in an input file
|
ObjectRecordAttachmentRequest |
setOutputPath(String outputPath)
Specify source data in an output file
|
ObjectRecordAttachmentRequest |
setRequestString(String requestString)
Specify source data in an input string, such as a JSON request
|
ObjectRecordAttachmentResponse |
updateMultipleObjectRecordAttachments(String objectName)
Update object record attachments in bulk with a JSON or CSV input file.
|
ObjectRecordAttachmentResponse |
updateObjectRecordAttachmentDescription(String objectName,
String recordId,
int attachmentId,
String description)
Update Object Record Attachment Description
|
getBaseObjectMapper, send, send, sendReturnBinary, sendReturnBinary, sendToFile, sendToFile, setVaultClient
public static final String ID_PARAM
public Boolean attachmentsEnabled(String objectName)
objectName
- Object name for the attachmentGET /api/{version}/metadata/vobjects/{object_name}
Boolean attachmentsEnabled = vaultClient.newRequest(ObjectRecordAttachmentRequest.class).attachmentsEnabled(objectName);
System.out.println("attachmentsEnabled = " + attachmentsEnabled); }
public ObjectRecordAttachmentResponse retrieveObjectRecordAttachments(String objectName, String recordId)
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentGET /api/{version}/vobjects/{object_name}/{object_record_id}/attachments
ObjectRecordAttachmentResponse attachmentResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .retrieveObjectRecordAttachments(objectName,recordId);
if (attachmentResponse.getData() != null) { for (ObjectAttachment attachment : attachmentResponse.getData()) { System.out.println("------------------------------"); System.out.println("CreatedDate " + attachment.getCreatedBy()); System.out.println("Filename " + attachment.getFilename()); System.out.println("Format " + attachment.getFormat()); System.out.println("Id " + attachment.getId()); System.out.println("Md5checksum " + attachment.getMd5checksum()); System.out.println("Size " + attachment.getSize()); System.out.println("Version " + attachment.getVersion()); if (attachment.getVersions() != null) { for (ObjectAttachment.Version version : attachment.getVersions()) { System.out.println("Url " + version.getUrl()); System.out.println("Version " + version.getVersion()); System.out.println(""); } } } }
public ObjectRecordAttachmentResponse retrieveObjectRecordAttachmentMetadata(String objectName, String recordId, int attachmentId)
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentattachmentId
- attachment idGET /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}
ObjectRecordAttachmentResponse metadataResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .retrieveObjectRecordAttachmentMetadata(objectName,recordId,attachmentId);
if (metadataResponse.getData() != null) { for (ObjectAttachment attachment : metadataResponse.getData()) { System.out.println("------------------------------"); System.out.println("CreatedDate " + attachment.getCreatedBy()); System.out.println("Filename " + attachment.getFilename()); System.out.println("Format " + attachment.getFormat()); System.out.println("Id " + attachment.getId()); System.out.println("Md5checksum " + attachment.getMd5checksum()); System.out.println("Size " + attachment.getSize()); System.out.println("Version " + attachment.getVersion()); if (attachment.getVersions() != null) { for (ObjectAttachment.Version version : attachment.getVersions()) { System.out.println("Url " + version.getUrl()); System.out.println("Version " + version.getVersion()); System.out.println(""); } } } }
public ObjectRecordAttachmentResponse retrieveObjectRecordAttachmentVersions(String objectName, String recordId, int attachmentId)
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentattachmentId
- attachment idGET /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}/versions
ObjectRecordAttachmentResponse versionsResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .retrieveObjectRecordAttachmentVersions(objectName,recordId,attachmentId);
if (versionsResponse.getData() != null) { for (ObjectAttachment attachment : versionsResponse.getData()) { System.out.println("------------------------------"); System.out.println("CreatedDate " + attachment.getCreatedBy()); System.out.println("Filename " + attachment.getFilename()); System.out.println("Format " + attachment.getFormat()); System.out.println("Id " + attachment.getId()); System.out.println("Md5checksum " + attachment.getMd5checksum()); System.out.println("Size " + attachment.getSize()); System.out.println("Version " + attachment.getVersion()); if (attachment.getVersions() != null) { for (ObjectAttachment.Version version : attachment.getVersions()) { System.out.println("Url " + version.getUrl()); System.out.println("Version " + version.getVersion()); System.out.println(""); } } } }
public ObjectRecordAttachmentResponse retrieveObjectRecordAttachmentVersionMetadata(String objectName, String recordId, int attachmentId, int versionId)
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentattachmentId
- attachment idversionId
- version of the attachmentGET /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}/version/{attachment_version}
ObjectRecordAttachmentResponse versionMetadataResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .retrieveObjectRecordAttachmentVersionMetadata(objectName,recordId,attachmentId,versionId);
if (versionMetadataResponse.getData() != null) { for (ObjectAttachment attachment : versionMetadataResponse.getData()) { System.out.println("------------------------------"); System.out.println("CreatedDate " + attachment.getCreatedBy()); System.out.println("Filename " + attachment.getFilename()); System.out.println("Format " + attachment.getFormat()); System.out.println("Id " + attachment.getId()); System.out.println("Md5checksum " + attachment.getMd5checksum()); System.out.println("Size " + attachment.getSize()); System.out.println("Version " + attachment.getVersion()); if (attachment.getVersions() != null) { for (ObjectAttachment.Version version : attachment.getVersions()) { System.out.println("Url " + version.getUrl()); System.out.println("Version " + version.getVersion()); System.out.println(""); } } } }
public VaultResponse downloadObjectRecordAttachmentFile(String objectName, String recordId, int attachmentId)
Download the attachment and write the output to the buffer, which can be retrieved via the VaultResponse.
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentattachmentId
- The attachment idGET /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}/file
VaultResponse VaultResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class).downloadObjectRecordAttachmentFile( objectName, recordId, attachmentId);,
VaultResponse VaultResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .setOutputPath(testDir + "retrieveObjectRecordAttachmentFile_localfile.pdf") .downloadObjectRecordAttachmentFile(objectName,recordId,attachmentId);
System.out.println(VaultResponse.getResponseStatus()); if (VaultResponse.getResponseStatus().equals(VaultResponse.HTTP_RESPONSE_SUCCESS)) { OutputStream os = new FileOutputStream(testDir + "retrieveObjectRecordAttachmentFile_bytearray.pdf"); os.write(VaultResponse.getBinaryContent()); os.close(); } else { System.out.println(VaultResponse.getResponseJSON()); },
System.out.println(VaultResponse.getResponseStatus()); if (VaultResponse.getResponseStatus().equals(VaultResponse.HTTP_RESPONSE_SUCCESS)) { String filePath = VaultResponse.getOutputFilePath(); System.out.println(filePath); } else { System.out.println(VaultResponse.getResponseJSON()); }
public VaultResponse downloadObjectRecordAttachmentVersionFile(String objectName, String recordId, int attachmentId, int versionId)
Download the attachment and write the output to the buffer, which can be retrieved via the VaultResponse.
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentattachmentId
- The attachment idversionId
- version id of the attachmentGET /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}/versions/{attachment_version}/file
VaultResponse VaultResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .downloadObjectRecordAttachmentVersionFile(objectName,recordId,attachmentId,versionId);, Example 2
VaultResponse VaultResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .setOutputPath(testDir + "retrieveObjectRecordAttachmentVersionFile_localfile.pdf") .downloadObjectRecordAttachmentVersionFile( objectName, recordId, attachmentId, versionId);
Example 1 System.out.println(VaultResponse.getResponseStatus()); if (VaultResponse.getResponseStatus().equals(VaultResponse.HTTP_RESPONSE_SUCCESS)) { OutputStream os = new FileOutputStream(testDir + "retrieveObjectRecordAttachmentVersionFile_bytearray.pdf"); os.write(VaultResponse.getBinaryContent()); os.close(); } else { System.out.println(VaultResponse.getResponseJSON()); },
Example 2 System.out.println(VaultResponse.getResponseStatus()); if (VaultResponse.getResponseStatus().equals(VaultResponse.HTTP_RESPONSE_SUCCESS)) { String filePath = VaultResponse.getOutputFilePath(); System.out.println(filePath); } else { System.out.println(VaultResponse.getResponseJSON()); }
public VaultResponse downloadAllObjectRecordAttachmentFiles(String objectName, String recordId)
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentGET /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/file
VaultResponse VaultResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class).downloadAllObjectRecordAttachmentFiles( objectName, recordId);, Example 2
VaultResponse VaultResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .setOutputPath(testDir + "downloadAllObjectRecordAttachmentFiles_localfile.zip") .downloadAllObjectRecordAttachmentFiles( objectName, recordId);
System.out.println(VaultResponse.getResponseStatus()); if (VaultResponse.getResponseStatus().equals(VaultResponse.HTTP_RESPONSE_SUCCESS)) { OutputStream os = new FileOutputStream(testDir + "downloadAllObjectRecordAttachmentFiles_bytearray.zip"); os.write(VaultResponse.getBinaryContent()); os.close(); } else { System.out.println(VaultResponse.getResponseJSON()); },
System.out.println(VaultResponse.getResponseStatus()); if (VaultResponse.getResponseStatus().equals(VaultResponse.HTTP_RESPONSE_SUCCESS)) { String filePath = VaultResponse.getOutputFilePath(); System.out.println(filePath); } else { System.out.println(VaultResponse.getResponseJSON()); }
public ObjectRecordAttachmentResponse createObjectRecordAttachment(String objectName, String recordId)
This method sends a local file for the attachment.
objectName
- Object name for the attachmentrecordId
- Object record id for the attachment Object record id for the attachmentPOST /api/{version}/vobjects/{object_name}/{object_record_id}/attachments
ObjectRecordAttachmentResponse createResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .setInputPath(testFile.getAbsolutePath()) .createObjectRecordAttachment( objectName, recordId);
System.out.println(createResponse.toString());
public ObjectRecordAttachmentResponse createMultipleObjectRecordAttachments(String objectName)
objectName
- The object name for the operationPOST /api/{version}/vobjects/{object_name}/attachments/batch
public ObjectRecordAttachmentResponse restoreObjectRecordAttachmentVersion(String objectName, String recordId, int attachmentId, int versionId)
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentattachmentId
- The attachment idversionId
- Document version idPOST /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}/versions/{attachment_version}?restore=true
ObjectRecordAttachmentResponse restoreResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .restoreObjectRecordAttachmentVersion(objectName,recordId,attachmentId,versionId);
System.out.println(restoreResponse.getResponseJSON());
public ObjectRecordAttachmentResponse updateObjectRecordAttachmentDescription(String objectName, String recordId, int attachmentId, String description)
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentattachmentId
- The attachment iddescription
- Attachment descriptionPUT /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}
public ObjectRecordAttachmentResponse updateMultipleObjectRecordAttachments(String objectName)
objectName
- The object name for the operationPUT /api/{version}/vobjects/{object_name}/attachments/batch
public ObjectRecordAttachmentResponse deleteObjectRecordAttachment(String objectName, String recordId, int attachmentId)
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentattachmentId
- The attachment idDELETE /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}
ObjectRecordAttachmentResponse deleteResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .deleteObjectRecordAttachment(objectName,recordId,attachmentId);
System.out.println(deleteResponse.getResponseJSON());
public ObjectRecordAttachmentResponse deleteMultipleObjectRecordAttachments(String objectName)
objectName
- The object name for the operationDELETE /api/{version}/vobjects/{object_name}/attachments/batch
public ObjectRecordAttachmentResponse deleteObjectRecordAttachmentVersion(String objectName, String recordId, int attachmentId, int versionId)
objectName
- Object name for the attachmentrecordId
- Object record id for the attachmentattachmentId
- The attachment idversionId
- Attachment versionDELETE /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}versions/{attachment_version}
ObjectRecordAttachmentResponse deleteResponse = vaultClient.newRequest(ObjectRecordAttachmentRequest.class) .deleteObjectRecordAttachmentVersion(objectName,recordId,attachmentId,versionId);
System.out.println(deleteResponse.getResponseJSON());
public ObjectRecordAttachmentRequest setAcceptCSV()
public ObjectRecordAttachmentRequest setBinaryFile(String filename, byte[] binaryContent)
filename
- file name (no path)binaryContent
- byte array of the file contentpublic ObjectRecordAttachmentRequest setContentTypeCsv()
public ObjectRecordAttachmentRequest setContentTypeJson()
public ObjectRecordAttachmentRequest setIdParam(String idParam)
idParam
- External Id field API name for the UPDATE and DELETEpublic ObjectRecordAttachmentRequest setInputPath(String inputPath)
inputPath
- Absolute path to the file for the requestpublic ObjectRecordAttachmentRequest setOutputPath(String outputPath)
outputPath
- Absolute path to the file for the responsepublic ObjectRecordAttachmentRequest setRequestString(String requestString)
requestString
- The source request as a stringCopyright © 2021. All rights reserved.