Documentation

Box Integration

Alooma can read and replicate all of the data in files from a Box file path. This allows you to, for example, merge arbitrary data from Box with client usage data in your data destination.

Connecting to Box

Files in your Box file path can be packaged and compressed using Tar or GZip, and can contain a variety of different file formats.

  1. Add your Box input from Alooma's plumbing screen.

  2. Click the button to connect with your Box credentials.

  3. Give your input a name. The name will appear in the plumbing screen, and will name the events that the input emits.

  4. Define your Box input source. Specify the Folder Path or ID of the root folder you want to start pulling from:

    • Folder Path is the portion after "All Files/"

    • Folder ID can be found in the URL when you're on a particular folder, and is maintained even if the folder is moved.

  5. Define which files to import:

    • All files will pull all the data from your container (for a given prefix or regex, if defined above), and will continue to do so forever.

    • A date span pulls files written between the given dates, inclusive. If you select the date span option and don't specify dates, the input will only pull files written after the input was created.

  6. Define the format of the files in your Box account from the list of our available file formats.

Keep the mapping mode to the default of OneClick if you'd like Alooma to automatically map the Box file events directly to your data destination. Otherwise, they'll have to be mapped manually from the Mapper screen.

Note

If there are any null bytes in rows in your data, those rows will be discarded and will not appear in the Restream Queue.

That's it! You're ready to import your data from Box into Alooma!

Search results

    No results found