# SFTP (SSH File Transfer Protocol)

## About

SFTP is a network protocol that allows users to execute file transfer, file access, and file management on any reliable data stream over the Internet.

## Setup Guide

Stepwise guide to connecting SFTP to your Daton account.

#### **Prerequisites** <a href="#prerequisites" id="prerequisites"></a>

* An existing Daton account.
* An SFTP server with valid files (CSV, and TXT).

#### Stepwise Instructions to Integrate SFTP with Daton <a href="#stepwise-instructions-to-integrate-shopify-with-daton" id="stepwise-instructions-to-integrate-shopify-with-daton"></a>

#### Integrate SFTP in Daton

1. [Sign in](https://daton.sarasanalytics.com/login) to your existing Daton account.&#x20;
2. Search for SFTP in the list of Connectors and click on the **'Configure'** button.\\

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FTUsDAdkhbisRz9VZmWRM%2F1.png?alt=media&#x26;token=fc9a11b2-85eb-4cc0-8013-5ea4f1623473" alt=""><figcaption></figcaption></figure>
3. Provide the necessary **Integration Name** and **Replication Frequency** data and click on the **'Authenticate'** button.\
   \&#xNAN;*Please Note, the **Integration Name** would be used in creating tables for the integration and cannot be changed later.* \\

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FXFqrUyT1xR1tXHCvssji%2F2.png?alt=media&#x26;token=4aedd3f7-c020-403d-a282-3759448efc71" alt=""><figcaption></figcaption></figure>
4. Provide an accurate **Hostname, Port number, Username,** and **Password** of the location where the file is stored on your server, then click on the **'Next'** button.

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FxjKr7hvh6eI03Z0LywPo%2F3.png?alt=media&#x26;token=84d2bd69-353c-4c81-911d-4fdc97896cba" alt=""><figcaption></figcaption></figure>
5. In the next step, provide your **Folder Name** (File path), **File Type** (CSV/TXT) and define the row number for the **Header** and click on the 'Submit' button.

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FrZr1h4frpoADdx9NQvFg%2F4.png?alt=media&#x26;token=6f52e4f0-f944-411e-818e-cfa19bd2e71c" alt=""><figcaption></figcaption></figure>
6. You will receive a prompt saying your Integration was successful.

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FZwwBhAerDrMKu6myJGl8%2F5.png?alt=media&#x26;token=3734e9e5-0f78-4834-8555-8b5cf846447c" alt=""><figcaption></figcaption></figure>

   Congrats! Your SFTP file has been integrated with Daton.

### Workflow

1. Integrations would be in the Pending state initially and will be moved to the **Active state as soon as the first job loads data** successfully onto the configured warehouse.
2. Users can **Re-Authenticate, Edit, Clone, Pause or Delete** the integration at any given time by clicking on the settings. Users can also edit the integration to **change frequency and history.**
3. Users can **view job status and process logs** from the integration details page by clicking on the integration name from the active list.
4. Files to be processed would be identified with the modified dates of files. \
   \&#xNAN;*If a few records in an existing file get updated, then the entire file would be processed again.*
5. Files present in subfolders from the selected location would not be processed.
6. If new fields are to be added to the files, users must append them to the file, and edit the existing integration in Daton by appending the additional fields for the integration. \
   \&#xNAN;*Daton doesn't support intermittent field additions to a file.*
