public class ObjectRecordAttachmentRequest extends VaultRequest<ObjectRecordAttachmentRequest>
| 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_REFERENCE_ID, HTTP_HEADER_VAULT_CLIENT_ID, referenceId, 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, setHeaderReferenceId, setVaultClientpublic static final String ID_PARAM
public Boolean attachmentsEnabled(String objectName)
objectName - Object name for the attachment
GET /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 attachment
GET /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 id
GET /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 id
GET /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 attachment
GET /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 id
GET /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 attachment
GET /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 attachment
GET /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 attachment
POST /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 operation
POST /api/{version}/vobjects/{object_name}/attachments/batchpublic 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 id
POST /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 description
PUT /api/{version}/vobjects/{object_name}/{object_record_id}/attachments/{attachment_id}public ObjectRecordAttachmentResponse updateMultipleObjectRecordAttachments(String objectName)
objectName - The object name for the operation
PUT /api/{version}/vobjects/{object_name}/attachments/batchpublic ObjectRecordAttachmentResponse deleteObjectRecordAttachment(String objectName, String recordId, int attachmentId)
objectName - Object name for the attachmentrecordId - Object record id for the attachmentattachmentId - The attachment id
DELETE /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 operation
DELETE /api/{version}/vobjects/{object_name}/attachments/batchpublic 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 version
DELETE /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 © 2024. All rights reserved.