Information for: DEVELOPERS   PARTNERS

File: Read adaptor

The File read adaptor allows you to download data from your cloud provider’s storage service for incorporation into a subscriber journey. The data is saved to your schema location depending on its type:

  • If the file is a single JSON object, the file is parsed and saved as a child record at the schema location you specify.

  • If the file contains several JSON objects or non-JSON data, the file is saved as a text string to the schema location.

    Important

    If the file contains several JSON objects, use caution loading large files as the method is designed to load small objects.

    Note

    Acquia Journey supports the Amazon Web Services Simple Storage System, an object-based storage scheme presenting a file-system view of the objects it stores. Folders are buckets, and files are objects. Acquia Journey has no way to list all files in a bucket.

Creating the adaptor

To create a File read adaptor, complete the following steps:

  1. Sign in to your Acquia Journey admin interface.
  2. Create an adaptor of the type File.
  3. In the configuration panel, configure the following settings for the adaptor:
    • Under Adaptor Action, click the select box, and select Read.
    • Under File Name, click the Data Schema panel. Identify the schema location mapping to the file name, click its name, and then click the left arrow icon. The file name must include any necessary path component.
    • Under File Contents Destination, click the select box. In the Data Schema panel, identify the schema location storing the contents of the file, click its name, and then click the left arrow icon.
  4. Acquia Journey saves each configuration change as you complete it. To close the adaptor configuration page, click the X next to the title of the file adaptor in the tab bar.

Validation warnings

Invalid Warning Note
Adaptor(s) do not have connection set Adaptor does not have connection configured Create a connection, and choose it from the Adaptor Connection list
Adaptor's configuration requires a data source to be set Missing data contents No source for the file write (file contents to write) is specified
File adaptors need a file name Missing file name No file name provided for file to write