com.veeva.vault.vapil.api.request

Class EDLRequest

java.lang.Object

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

com.veeva.vault.vapil.api.request.EDLRequest

public class EDLRequest
extends VaultRequest

Expected Document Lists (EDLs) help you to measure the completeness of projects.

Vault API Coverage:

https://developer.veevavault.com/api/21.1/#expected-document-lists

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EDLRequest.NodeType The tree object types available for selection

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
JobCreateResponse	createPlaceholderFromEDLItem(List<String> edlItemIds) Create a placeholder from an EDL item.
EDLResponse	retrieveAllRootNodes(EDLRequest.NodeType nodeType) Retrieves all root EDL nodes and node metadata
EDLResponse	retrieveNodeChildren(EDLRequest.NodeType nodeType, String parentNodeId) Given an EDL node ID, retrieves immediate children (not grandchildren) of that node.
EDLResponse	retrieveSpecificRootNodes(EDLRequest.NodeType nodeType, List<String> nodeRefIds) Retrieves the root node ID for the given EDL record IDs
EDLRequest	setAcceptCSV() Set the Header Accept to return CSV
EDLRequest	setAcceptJson() Set the Header Accept to return CSV
EDLRequest	setContentTypeCsv() Set the Header Content Type to CSV
EDLRequest	setContentTypeJson() Set the Header Content Type to JSON
EDLRequest	setInputPath(String inputPath) Specify source data in an input file
VaultResponse	updateNodeOrder(EDLRequest.NodeType nodeType, String parentNodeId) Given an EDL node ID, retrieves immediate children (not grandchildren) of that node.

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

createPlaceholderFromEDLItem

public JobCreateResponse createPlaceholderFromEDLItem(List<String> edlItemIds)

Create a placeholder from an EDL item.

Parameters:

edlItemIds - list of edl item ids on which to initiate the action

Returns:

JobCreateResponse

Vault API Endpoint:

 POST /api/{version}/vobjects/edl_item__v/actions/createplaceholder

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#create-a-placeholder-from-an-edl-item

Example Request:

 JobCreateResponse resp = vaultClient.newRequest(EDLRequest.class)
                 .createPlaceholderFromEDLItem(edlItemIds);

Example Response:

 System.out.println("Status = " + resp.getResponseStatus());
 if (resp.isSuccessful()) {
   System.out.println("JobId = " + resp.getJobId());
   System.out.println("Url = " + resp.getUrl());

   if (resp.getWarnings() != null) {
     for (JobCreateResponse.Warning warning : resp.getWarnings()) {
              System.out.println("Type = " + warning.getMessage() + ", Message = " + warning.getMessage());
     }
   }
 }

retrieveAllRootNodes

public EDLResponse retrieveAllRootNodes(EDLRequest.NodeType nodeType)

Retrieves all root EDL nodes and node metadata

Parameters:

nodeType - The tree object type to retrieve

Returns:

EDLResponse

Vault API Endpoint:

 GET /api/{version}/composites/trees/{edl_hierarchy_or_template}

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-all-root-nodes

Example Request:

 List<EDLNode> resp = vaultClient.newRequest(EDLRequest.class)
 .retrieveAllRootNodes(EDLRequest.NodeType.TEMPLATE)
 .getData();

Example Response:

 resp.forEach(node->System.out.println(node));

retrieveSpecificRootNodes

public EDLResponse retrieveSpecificRootNodes(EDLRequest.NodeType nodeType,
                                             List<String> nodeRefIds)

Retrieves the root node ID for the given EDL record IDs

Parameters:

nodeType - The tree object type to retrieve

nodeRefIds - list of EDL reference IDs to select root node IDs

Returns:

EDLResponse

Vault API Endpoint:

 GET /api/{version}/composites/trees/{edl_hierarchy_or_template}/actions/listnodes

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-specific-root-nodes

Example Request:

 List<EDLNode> resp = vaultClient.newRequest(EDLRequest.class)
 .retrieveSpecificRootNodes(EDLRequest.NodeType.TEMPLATE)
 .getData();

Example Response:

 resp.forEach(node->System.out.println(node));

retrieveNodeChildren

public EDLResponse retrieveNodeChildren(EDLRequest.NodeType nodeType,
                                        String parentNodeId)

Given an EDL node ID, retrieves immediate children (not grandchildren) of that node.

Parameters:

nodeType - The tree object type to retrieve

parentNodeId - The Id of the Parent Node

Returns:

EDLResponse

Vault API Endpoint:

 GET /api/{version}/composites/trees/edl_hierarchy__v/{parent_node_id}/children

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#retrieve-a-node-s-children

Example Request:

 List<EDLNode> resp = vaultClient.newRequest(EDLRequest.class)
 .retrieveNodeChildren(EDLRequest.NodeType.HIERARCHY, parent_node_id)
 .getData();

Example Response:

 resp.forEach(node->System.out.println(node));

updateNodeOrder

public VaultResponse updateNodeOrder(EDLRequest.NodeType nodeType,
                                     String parentNodeId)

Given an EDL node ID, retrieves immediate children (not grandchildren) of that node. Content-Type application/json (default) or text/csv

Parameters:

nodeType - The tree object type to retrieve

parentNodeId - The ID of a parent node in the hierarchy

Returns:

VaultResponse

Vault API Endpoint:

 PUT /api/{version}/composites/trees/edl_hierarchy__v/{parent_node_id}/children

Vault API Help Link:

https://developer.veevavault.com/api/21.1/#update-node-order

Example Request:

 VaultResponse resp = vaultClient.newRequest(EDLRequest.class)
     .setContentTypeJson() or .setContentTypeCSV()
     .setInputPath(inputFilePath)
     .updateNodeOrder(EDLRequest.NodeType.TEMPLATE, parentNodeId);

setContentTypeCsv

public EDLRequest setContentTypeCsv()

Set the Header Content Type to CSV

Returns:

The Request

setContentTypeJson

public EDLRequest setContentTypeJson()

Set the Header Content Type to JSON

Returns:

The Request

setAcceptCSV

public EDLRequest setAcceptCSV()

Set the Header Accept to return CSV

Returns:

The Request

setAcceptJson

public EDLRequest setAcceptJson()

Set the Header Accept to return CSV

Returns:

The Request

setInputPath

public EDLRequest setInputPath(String inputPath)

Specify source data in an input file

Parameters:

inputPath - Absolute path to the file for the request

Returns:

The Request