com.veeva.vault.vapil.api.request

Class MetaDataRequest

java.lang.Object

com.veeva.vault.vapil.api.request.VaultRequest

com.veeva.vault.vapil.api.request.MetaDataRequest

public class MetaDataRequest
extends VaultRequest

MetaData Requests

Coverage for all endpoints containing:

• "/metadata/"
• "/configuration/"
• "/mdl/"

MetaData endpoints include all components and object specific components that reside in the Object section of the API documentation. The response formats vary for each meta-data components properties (there are over 35 metadata components). Common/Shared properties are included in the response. Additional properties are parsed in developers reading of JSON/POJO properties.

Vault API Coverage:

• https://developer.veevavault.com/api/21.1/retrieve-component-type-metadata
• https://developer.veevavault.com/api/21.1/#retrieve-object-metadata
• https://developer.veevavault.com/api/21.1/#retrieve-object-field-metadata

Field Summary

Fields inherited from class com.veeva.vault.vapil.api.request.VaultRequest

HTTP_HEADER_AUTHORIZATION, HTTP_HEADER_VAULT_CLIENT_ID, vaultClient

Method Summary

Modifier and Type	Method and Description
VaultResponse	executeMDLScript() Execute MDL Script
JobCreateResponse	executeMDLScriptAsynchronously() Execute MDL Script Asynchronously
MdlResponse	retrieveComponentRecordMdl(String componentType, String recordName) Retrieve Component Record MDL
MetaDataComponentTypeBulkResponse	retrieveComponentRecords(String component) Retrieve Component Type Metadata
MetaDataComponentRecordResponse	retrieveComponentRecordXmlJson(String componentType, String recordName) Retrieve Component Record XML/JSON
MetaDataComponentTypeResponse	retrieveComponentTypeMetadata(String component) Retrieve Component Type Metadata
MetaDataComponentTypeBulkResponse	retrieveComponentTypes() Retrieve Component Types
ComponentContentResponse	retrieveContentFile(String componentType, String recordName) Retrieve Content File
MetaDataObjectBulkResponse	retrieveObjectCollection() Retrieve Object Collection
MetaDataObjectFieldResponse	retrieveObjectFieldMetaData(String objectName, String fieldName) Retrieve Object Field Metadata
MetaDataObjectResponse	retrieveObjectMetadata(String objectName) Retrieve Object Metadata
MetaDataRequest	setAcceptJSON() Set the Header Accept to return CSV
MetaDataRequest	setBinaryFile(String filename, byte[] binaryContent) Specify source data in an input file
MetaDataRequest	setInputPath(String inputPath) Specify source data in an input file
MetaDataRequest	setLocalized(Boolean localized) Set to true to retrieve localized (translated) strings for the label, label_plural, and help_content object fields.
MetaDataRequest	setRequestString(String requestString) Specify source data in an input string, such as a JSON request
ComponentContentResponse	uploadContentFile() Upload Content File

Methods inherited from class com.veeva.vault.vapil.api.request.VaultRequest

getBaseObjectMapper, send, send, sendReturnBinary, sendReturnBinary, sendToFile, sendToFile, setVaultClient

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

executeMDLScript

public VaultResponse executeMDLScript()

Execute MDL Script

This endpoint executes the given MDL script on a vault.

Returns:

VaultResponse

Vault API Endpoint:

 POST /api/mdl/execute

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#execute-mdl-script

Example Request:

 VaultResponse resp = vaultClient.newRequest(MetaDataRequest.class)
                                .setRequestString(mdl)
                                .executeMDLScript();

Example Response:

System.out.println(resp.getResponseStatus());

executeMDLScriptAsynchronously

public JobCreateResponse executeMDLScriptAsynchronously()

Execute MDL Script Asynchronously

This asynchronous endpoint executes the given MDL script on a vault.

While you can execute any MDL script asynchronously, this endpoint is required if you’re operating on 10,000+ high volume object records and executing one of the following operations:

Enabling lifecycles Enabling object types Adding or removing a field Updating the max length of a text field Adding or removing an Index Changing the fields that compose an Index

Returns:

JobCreateResponse

Vault API Endpoint:

 POST /api/mdl/execute_asyc

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#execute-mdl-script-asynchronously

Example Request:

 JobCreateResponse resp = vaultClient.newRequest(MetaDataRequest.class)
                                .setRequestString(mdl)
                                .executeMDLScriptAsynchronously();

Example Response:

System.out.println(resp.getResponseStatus());

retrieveComponentTypes

public MetaDataComponentTypeBulkResponse retrieveComponentTypes()

Retrieve Component Types

Get a list of all metadata component types in the Vault

Returns:

MetaDataComponentTypeBulkResponse

Vault API Endpoint:

 GET /api/{version}/metadata/components

Example Request:

 MetaDataComponentTypeBulkResponse resp = vaultClient.newRequest(MetaDataRequest.class)
                                .retrieveComponentTypes();

Example Response:

 for (ComponentType c : resp.getData())
   System.out.println(c.getName() + " s" + c.getLabel());

retrieveComponentTypeMetadata

public MetaDataComponentTypeResponse retrieveComponentTypeMetadata(String component)

Retrieve Component Type Metadata

Retrieve metadata of a specific component type.

Parameters:

component - to retrieve

Returns:

MetaDataComponentTypeResponse

Vault API Endpoint:

 GET /api/{version}/metadata/components/{component_type}

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-component-type-metadata

Example Request:

 MetaDataComponentTypeResponse resp = vaultClient.newRequest(MetaDataRequest.class)
                                .retrieveComponentTypeMetadata(componentName);

Example Response:

 MetaDataComponent comp = resp.getData();

 System.out.println("\nName = " + comp.getName());
 System.out.println("Class = " + comp.getClassName());
 System.out.println("Abbreviation = " + comp.getAbbreviation());
 System.out.println("Active = " + comp.getActive());

 System.out.println("\nAdditional Properties");
 System.out.println("------------------------");
 for (String s : comp.getProperties().keySet())
 System.out.println(s + " = " + comp.getProperties().get(s));

 System.out.println("\nAttributes");
 System.out.println("------------------------");
 for (Attribute attr : comp.getAttributes()) {
   System.out.println(attr.getName() +  " " + attr.getType());

   for (String s : attr.getProperties().keySet())
   System.out.println(s + " = " + attr.getProperties().get(s));
 }

 System.out.println("\nSubcomponents");
 System.out.println("------------------------");
 for (SubComponentType subcomp : comp.getSubComponents()) {
   System.out.println("\n" + subcomp.getName());
   System.out.println(" ");
   for (Attribute attr : subcomp.getAttributes()) {
     System.out.println(attr.getName() +  " " + attr.getType());

     for (String s : attr.getProperties().keySet())
     System.out.println(s + " = " + attr.getProperties().get(s));
   }
 }

retrieveObjectMetadata

public MetaDataObjectResponse retrieveObjectMetadata(String objectName)

Retrieve Object Metadata

Retrieve all metadata configured on a standard or custom Vault Object. Localized strings can be included via the "setLocalized" method in the builder.

Parameters:

objectName - Object name to retrieve

Returns:

MetaDataObjectResponse for single object

Vault API Endpoint:

 GET /api/{version}/metadata/vobjects/{object_name}

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-object-metadata

Example Request:

 MetaDataObjectResponse resp = vaultClient.newRequest(MetaDataRequest.class)
                                .retrieveObjectMetadata(objectName);

Example Response:

Object objectMetaData = resp.getObject();

 System.out.println("Name = " + objectMetaData.getName());
 System.out.println("Help = " + objectMetaData.getHelpContent());
 System.out.println("Label = " + objectMetaData.getLabel());
 System.out.println("URL Field = " + objectMetaData.getUrls().getField());
 System.out.println("URL Record = " + objectMetaData.getUrls().getRecord());
 System.out.println("URL List = " + objectMetaData.getUrls().getList());
 System.out.println("UserRoleSetupObject = " + objectMetaData.getUserRoleSetupObject());


 if (objectMetaData.getAvailableLifecycles() != null) {
   for (String s : objectMetaData.getAvailableLifecycles())
   System.out.println("Lifecycle = " + s);
   }

 if (objectMetaData.getRelationships() != null) {
   for (Object.Relationship relationship : objectMetaData.getRelationships())
   System.out.println("Relationship = " + relationship.getRelationshipName() + " " + relationship.getField() + " " + relationship.getObjectReference().getName());
   }

 if (objectMetaData.getUserRoleSetupObject() != null) {
   System.out.println("UserRoleSetupObject URL " + objectMetaData.getUserRoleSetupObject().getUrl());
   System.out.println("UserRoleSetupObject Name " + objectMetaData.getUserRoleSetupObject().getName());
   System.out.println("UserRoleSetupObject Label " + objectMetaData.getUserRoleSetupObject().getLabel());
 }

retrieveObjectFieldMetaData

public MetaDataObjectFieldResponse retrieveObjectFieldMetaData(String objectName,
                                                               String fieldName)

Retrieve Object Field Metadata

Localized strings can be included via the "setLocalized" method in the builder

Parameters:

objectName - Object name to retrieve

fieldName - Field name to retrieve

Returns:

MetaDataObjectFieldResponse

Vault API Endpoint:

 GET /api/{version}/metadata/vobjects/{object_name}/fields/{object_field_name}

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-object-field-metadata

Example Request:

 MetaDataObjectFieldResponse resp = vaultClient.newRequest(MetaDataRequest.class)
                                .retrieveObjectFieldMetaData(objectName, fieldName);

Example Response:

ObjectField fieldMetaData = resp.getField();

 System.out.println("Name = " + fieldMetaData.getName());
 System.out.println("Label = " + fieldMetaData.getLabel());
 System.out.println("Required = " + fieldMetaData.getRequired());
 System.out.println("Help = " + fieldMetaData.getHelpContent());
 System.out.println("Relationship Name = " + fieldMetaData.getLookupRelationshipName());

 if (fieldMetaData.getObjectReference() != null) {
   System.out.println("Object referencer URL " + fieldMetaData.getObjectReference().getUrl());
   System.out.println("Object referencer Name " + fieldMetaData.getObjectReference().getName());
   System.out.println("Object referencer Label " + fieldMetaData.getObjectReference().getLabel());
 }

retrieveObjectCollection

public MetaDataObjectBulkResponse retrieveObjectCollection()

Retrieve Object Collection

Localized strings can be included via the "setLocalized" method in the builder

Returns:

MetaDataObjectBulkResponse for all objects

Vault API Endpoint:

 GET /api/{version}/metadata/vobjects

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-object-collection

Example Request:

 MetaDataObjectBulkResponse resp = vaultClient.newRequest(MetaDataRequest.class).retrieveObjectCollection();

Example Response:

 for (Object c : resp.getObjects()) {
   System.out.println(c.getName() + " " + c.getLabel() + " " + c.getUrl());
 }

retrieveComponentRecords

public MetaDataComponentTypeBulkResponse retrieveComponentRecords(String component)

Retrieve Component Type Metadata

Retrieve all records for a specific component type.

Parameters:

component - to retrieve

Returns:

MetaDataComponentTypeBulkResponse

Vault API Endpoint:

 GET /api/{version}/configuration/{component_type}

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#component-record-collection

Example Request:

 MetaDataComponentTypeBulkResponse resp = vaultClient.newRequest(MetaDataRequest.class)
                                .retrieveComponentRecords(componentType);

Example Response:

 if (resp.isSuccessful()) {
   for (ComponentType componentType : resp.getData()) {
     System.out.println(component.getName());
     }
 }

retrieveComponentRecordXmlJson

public MetaDataComponentRecordResponse retrieveComponentRecordXmlJson(String componentType,
                                                                      String recordName)

Retrieve Component Record XML/JSON

Parameters:

componentType - The component type name (Picklist, Docfield, Doctype, etc.)

recordName - The name of the record to retrieve metadata

Returns:

MetaDataComponentRecordResponse

Vault API Endpoint:

 GET /api/{version}/configuration/{component_type}.{record_name}

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-component-record-xml-json

Example Request:

 MetaDataComponentRecordResponse resp = vaultClient.newRequest(MetaDataRequest.class)
                                .retrieveComponentRecordXmlJson(componentType, recordName);

Example Response:

 if (resp.isSuccessful()) {
   System.out.println(resp.getData().getName());
 }

retrieveComponentRecordMdl

public MdlResponse retrieveComponentRecordMdl(String componentType,
                                              String recordName)

Retrieve Component Record MDL

Parameters:

componentType - The component type name (Picklist, Docfield, Doctype, etc.)

recordName - The name of the record to retrieve metadata

Returns:

MdlResponse

Vault API Endpoint:

 GET /api/mdl/components/{component_type}.{record_name}

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-component-record-mdl

Example Request:

 MdlResponse resp = vaultClient.newRequest(MetaDataRequest.class)
                                .retrieveComponentRecordMdl("Picklist","test__c");

Example Response:

 if (resp.isSuccessful()) {
   System.out.println(new String(resp.getBinaryContent()));
 }

uploadContentFile

public ComponentContentResponse uploadContentFile()

Upload Content File

This endpoint allows you to upload a content file to be referenced by a component.

Once uploaded, Vault stores the file in a generic files staging area where they will remain until referenced by a component. Once referenced, Vault cannot access the named file from the staging area.

Returns:

ComponentContentResponse

Vault API Endpoint:

 POST /api/mdl/files

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#upload-content-file

retrieveContentFile

public ComponentContentResponse retrieveContentFile(String componentType,
                                                    String recordName)

Retrieve Content File

Parameters:

componentType - vault component type

recordName - api name of component

Returns:

ComponentContentResponse

Vault API Endpoint:

 GET /api/mdl/components/{component_type}.{record_name}/files

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-content-file

setAcceptJSON

public MetaDataRequest setAcceptJSON()

Set the Header Accept to return CSV

Returns:

The Request

setBinaryFile

public MetaDataRequest setBinaryFile(String filename,
                                     byte[] binaryContent)

Specify source data in an input file

Parameters:

filename - file name (no path)

binaryContent - byte array of the file content

Returns:

The Request

setLocalized

public MetaDataRequest setLocalized(Boolean localized)

Set to true to retrieve localized (translated) strings for the label, label_plural, and help_content object fields.

Parameters:

localized - True for localized strings

Returns:

The request

setInputPath

public MetaDataRequest setInputPath(String inputPath)

Specify source data in an input file

Parameters:

inputPath - Absolute path to the file for the request

Returns:

The Request

setRequestString

public MetaDataRequest setRequestString(String requestString)

Specify source data in an input string, such as a JSON request

Parameters:

requestString - The source request as a string

Returns:

The Request