Package com.veeva.vault.vapil.api.request

Class DirectDataRequest

java.lang.Object

com.veeva.vault.vapil.api.request.VaultRequest<DirectDataRequest>

com.veeva.vault.vapil.api.request.DirectDataRequest

public class DirectDataRequest
extends VaultRequest<DirectDataRequest>

Direct Data Requests

• Retrieve Available Direct Data Files
• Download Direct Data File

Vault API Coverage:

https://developer.veevavault.com/api/25.3/#direct-data

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	DirectDataRequest.ExtractType	Enum ExtractType represents the types of extracts.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	EXTRACT_TYPE
static final String	START_TIME_PARAMETER
static final String	STOP_TIME_PARAMETER

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

HTTP_HEADER_AUTHORIZATION, HTTP_HEADER_REFERENCE_ID, HTTP_HEADER_VAULT_CLIENT_ID, referenceId, requestClientId, vaultClient

Method Summary

Modifier and Type	Method	Description
VaultResponse	downloadDirectDataFile(String name)	Download Direct Data File
DirectDataResponse	retrieveAvailableDirectDataFiles()	Retrieve Available Direct Data Files
DirectDataRequest	setExtractType(DirectDataRequest.ExtractType extractType)	Set the Direct Data file type to retrieve.
DirectDataRequest	setStartTime(ZonedDateTime startTime)	Specify a start date and time to retrieve direct data files.
DirectDataRequest	setStopTime(ZonedDateTime stopTime)	Specify a stop date and time to retrieve direct data files.

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

getBaseObjectMapper, send, send, sendReturnBinary, sendReturnBinary, sendToFile, sendToFile, setHeaderClientId, setHeaderReferenceId, setVaultClient

Methods inherited from class java.lang.Object

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

Field Details

EXTRACT_TYPE

public static final String EXTRACT_TYPE

See Also:

• Constant Field Values

START_TIME_PARAMETER

public static final String START_TIME_PARAMETER

See Also:

• Constant Field Values

STOP_TIME_PARAMETER

public static final String STOP_TIME_PARAMETER

See Also:

• Constant Field Values

Method Details

retrieveAvailableDirectDataFiles

public DirectDataResponse retrieveAvailableDirectDataFiles()

Retrieve Available Direct Data Files

Retrieve a list of all Direct Data files available for download.

Returns:

DirectDataResponse

Vault API Endpoint:

 GET /api/{version}/services/directdata/files 

Vault API Help Link:

https://developer.veevavault.com/api/25.3/#retrieve-available-direct-data-files

Example Request:

 ZonedDateTime currentDateTime = ZonedDateTime.now(ZoneId.of("UTC"));
 ZonedDateTime stopTime = currentDateTime.toLocalDate().atStartOfDay(ZoneId.of("UTC"));
 ZonedDateTime startTime = stopTime.minusDays(1);

 DirectDataResponse response = vaultClient.newRequest(DirectDataRequest.class)
      .setExtractType(DirectDataRequest.ExtractType.INCREMENTAL)
      .setStartTime(startTime)
      .setStopTime(stopTime)
      .retrieveAvailableDirectDataFiles();
 

Example Response:

 System.out.println("Total Direct Data Files: " + response.getResponseDetails().getTotal());
 System.out.println("-----------------------");
 List<DirectDataResponse.DirectDataItem> data = response.getData();
 for (DirectDataResponse.DirectDataItem item : data) {
      System.out.println("Name: " + item.getName());
      System.out.println("Filename: " + item.getFilename());
      System.out.println("Extract Type: " + item.getExtractType());
      System.out.println("Record Count: " + item.getRecordCount());
      System.out.println("Size: " + item.getSize());
      System.out.println("File parts: " + item.getFileparts());
      System.out.println("-----------------------");
 }
 

downloadDirectDataFile

public VaultResponse downloadDirectDataFile(String name)

Download Direct Data File

Download a Direct Data file.

Parameters:

name - The name of the Direct Data file to download.

Returns:

VaultResponse

Vault API Endpoint:

 GET /api/{version}/services/directdata/files/{name} 

Vault API Help Link:

https://developer.veevavault.com/api/25.3/#download-direct-data-file

Example Request:

 VaultResponse response = vaultClient.newRequest(DirectDataRequest.class)
      .downloadDirectDataFile(fileName);
 

Example Response:

 System.out.println("Content-Type: " + response.getHeaderContentType());
 System.out.println("Content-Disposition: " + response.getHttpHeaderContentDisposition());
 

setExtractType

public DirectDataRequest setExtractType(DirectDataRequest.ExtractType extractType)

Set the Direct Data file type to retrieve. Options are FULL, INCREMENTAL, and LOG.

Parameters:

extractType - ExtractType enum value

Returns:

DirectDataRequest

setStartTime

public DirectDataRequest setStartTime(ZonedDateTime startTime)

Specify a start date and time to retrieve direct data files.

Parameters:

startTime - Start date and time for retrieving direct data file requests.

Returns:

DirectDataRequest

setStopTime

public DirectDataRequest setStopTime(ZonedDateTime stopTime)

Specify a stop date and time to retrieve direct data files.

Parameters:

stopTime - Stop date and time for retrieving direct data file requests.

Returns:

DirectDataRequest