Data-flo Docs
  • About Data-flo
    • Data-flo Major Update in April 2024
      • Migrating your workflows into the latest version of Data-flo
        • Streamlined adaptors
        • Deprecated adaptors
        • New and retained adaptors
    • Change Log
    • Privacy and Terms of Service
    • Open source software used by Data-flo
  • Data-flo Basics
    • Account
    • Navigation
    • Terminology
    • Interface Icons
    • Data-flo's building blocks: Adaptors
      • Using adaptors to import data
      • Using adaptors to process data
      • Using adaptors to export data
    • Combining adaptors to create workflows
      • Creating a workflow
        • Building a workflow from scratch
        • Cloning an existing workflow
        • Importing a .dataflo file
      • Testing your workflows
      • Running your workflows
      • Accessing your workflows
  • Adaptor reference guide
    • add-column
    • add-jittering
    • add-value-to-dictionary
    • aggregate-rows
    • append-datatables
    • append-lists
    • append-to-list
    • apply-force-directed-layout
    • calculate-column
    • calculate-time-difference
    • change-column-case
    • compare-columns
    • concatenate-columns
    • concatenate-text
    • convert-date-to-text
    • convert-list-to-datatable
    • convert-text-to-datatable
    • convert-text-to-list
    • create-dictionary-from-datatable
    • create-google-drive-folder
    • create-graph-from-datatable
    • create-graph-from-dot
    • create-list-from-datatable
    • create-text-from-template
    • duplicate-column
    • export-file-to-google-drive
    • export-file-to-smb-share
    • export-graph-to-dot-file
    • export-text-to-file
    • export-to-csv-file
    • export-to-dbf-file
    • export-to-google-sheet
    • export-to-microreact-project
    • export-to-sqlite-file
    • filter-list
    • filter-rows
    • find-value-in-dictionary
    • find-value-in-list
    • format-date-column
    • format-time-column
    • geocoding
    • import-file-from-dropbox
    • import-file-from-figshare
    • import-file-from-google-drive
    • import-file-from-http-request
    • import-file-from-s3
    • import-file-from-smb-share
    • import-file-from-url
    • import-from-csv-file
    • import-from-dbf-file
    • import-from-epicollect-project
    • import-from-excel-file
    • import-from-google-sheet
    • import-from-json-file
    • import-from-microreact-project
    • import-from-mysql
    • import-from-oracle
    • import-from-postgres
    • import-from-spreadsheet-file
    • import-from-sql-server
    • import-from-sqlite
    • import-list-from-text-file
    • import-text-from-file
    • join-datatables
    • list-datatable-columns
    • list-newick-leaf-labels
    • map-column-values
    • prepend-to-list
    • query-datatable
    • remove-columns
    • remove-duplicate-list-values
    • remove-duplicate-rows
    • rename-columns
    • rename-newick-leaf-labels
    • replace-blank-values
    • replace-values-in-columns
    • replace-values-in-list
    • replace-values-in-text
    • reshape-long-to-wide
    • reshape-wide-to-long
    • reverse-geocoding
    • run-openai-model
    • run-replicate-model
    • run-workflow
    • sample-datatable
    • select-columns
    • select-list-values
    • select-rows
    • send-email-message
    • sort-datatable
    • sort-list
    • split-column
    • split-geographical-coordinates
    • split-list
    • summarise-datatable
    • transform-columns
    • workflow-repeater
  • Applying Data-flo
    • Basics in Minutes!
      • Quick Workflow
        • Step 1: Configure a solo adapter to view data.
        • Step 2: Add and link a second adaptor.
        • Step 3: Add a value.
        • Step 4: Complete the workflow.
        • Step 5: Run the workflow.
        • Step 6: Share the workflow.
  • API
    • Data-flo API
    • API Access Tokens
  • Support
    • Contact and Feedback
    • Private Installations
Powered by GitBook
On this page
  • What is an adaptor?
  • How do adaptors work?
  • Adaptor arguments
  • Accessing support/ guidance on how to use adaptors
  1. Data-flo Basics

Data-flo's building blocks: Adaptors

PreviousInterface IconsNextUsing adaptors to import data

Last updated 1 year ago

What is an adaptor?

An adaptor is a step in a workflow that performs a specific task such as reformatting a date column, adding jittering for statistical analysis, importing datasets, geocoding places, or sampling data from a datatable.

In the Data-flo canvas, an adaptor is represented by a card. Behind the scenes, an adaptor consists of a JavaScript function and a metadata manifest, wrapped up and presented as a card in the Data-flo interface.

There are three categories of adaptor. Follow the links below to read more about each type:

How do adaptors work?

Adaptors come pre-programmed. Using the side bar menu on the canvas, you may add adaptors to your canvas to start importing and transforming your data.

Simply add an adaptor to your canvas and specify the input arguments to transform the data into your desired format. Once you are happy with your transformed data, you will add an export adaptor to the canvas to transfer your data to another platform or file format.

Adaptor arguments

An adaptor's arguments are variables that affect the adaptor's outcome. They define the specifics of the Javascript function underlying the adaptor, allowing the adaptor to transform data. Each argument is listed on the adaptor card.

Each adaptor requires input arguments from the user in order for it to function in a tailored or customised way. These inputs are called input arguments and may include the column name, original + new format, sampling method, etc. These input arguments allow users to parameterize how the adaptor works for their unique needs and data structure.

The adaptor’s output(s) appear on the right side column of each adaptor card. Clicking the output button will show the user how the adaptor transformed the dataset.

Accessing support/ guidance on how to use adaptors

: to bring data into Data-flo from external data sources or uploaded data files

: to perform all necessary manipulations on the data

: to make data available outside of Data-flo

Input arguments appear on the left side column of every adaptor. Select in the side bar menu to specify a custom format or value.

Before adding an adaptor to your canvas, select the question mark icon to review detailed guidance for using that adaptor.

Alternatively see our comprehensive for a complete list of all adaptors along with details on their input arguments, examples, and recommended use cases.

Import adaptors
Transformation adaptors
Export adaptors
Adaptor Reference Guide
Format-date-column adaptor card
A screenshot of the Data-flo canvas with a close up of the side bar menu that allows users to view all available adaptors. The image also shows a depiction of an adaptor once added to the canvas. Each adaptor is represented by a card with inputs listed on the left and outputs listed on the right..
A screen shot of an example input option for the reformat date adaptor. The input option is to select the desired format of the year, month and day in the date column of a data table.