Data Exchange
The execution of scheduled data import and export jobs has been enabled. You can specify the data source and destination, as well as the frequency of the transfer. The scheduler will execute the job automatically at the designated time, with the ability to monitor job progress via a Job Log and receive notifications in case of errors or failures as you continue to use Mosaic.
Access to an ftp site is required in order to use Data Exchange.
Select +Add
In the Add Data Exchange Job screen, select your desired Job Action and Job Type.
Note: If you are choosing Import, you can review the corresponding Import in Admin menu (download sample CSV) to ensure you are adding all the necessary fields. See below for links to field definition documents. All fields must be in the file but non-required fields can be left blank.
For Export, review Transaction Search within Reports to see what fields you can be expecting to see.
Enter the Job Name and Job Description.
Under Transport Method, select ftp or sftp. Enter the ftp address, port, user name, and password. Enter the file name and directory. If this is an import, this is the name the job will look for in the specified directory on the ftp server. If this is an export, this is what Mosaic will name the file and where it will place it on the ftp server. For exports, select whether or not to append the date and time on the file’s name. When toggled on, exported files will have the following filename format: {{[File Name]-YYYYMMDD-HHMMSS}}, with the timestamp based on local store time.
When filling out the job scheduler, one thing to consider is what time of day you will be scheduling this for. If it is an export, and you are doing daily transactions, you may want to schedule it for 11:59pm, or the next morning and have it show Yesterdays transactions.
Select Save.
After Save, you can select “Run Now” to test how the export looks and make adjustments as needed. See below for links to field definition documents.
Field | Definition | Field | Definition |
---|---|---|---|
Job Action | Export or Import | FTP Address | The address of the FTP server |
Job Type | Select from dropdown list | FTP Port | The port through which the FTP server will be accessed |
Job Name | 50 character limit. Alphanumeric characters only | FTP Username | The FTP username |
Job Description | 200 character limit | FTP Password | The password for the FTP username |
Transport Method | FTP, SFTP, or File Upload. The File Upload option appears after a data exchange import has been created and saved. | File Name | Imports - the name of the file the data exchange will look for Exports - What you want the file named when data exchange creates it |
|
| FTP Directory | The directory where the file resides on the FTP server. An import will look for a file there, an export will place a file there. |
|
|
|
|
Imports
Mosaic - Customers Import File - Field Definitions
Mosaic - Customer AR Accounts Import File - Field Definitions
Exports
Mosaic - Transactions Export File - Field Definitions
Mosaic - Transaction Details Export File - Field Definitions
EDITED 09/15/2023
© 2021 PrismRBS All rights reserved.