untitled article

Updated 1/11/24 by Katarzyna

Who can use this function?

This function is available to users of the CargoON product line who have access to the Dock Scheduler product and the Schedules module.

From this article you will learn:

  • how to import time slots into the Schedules module using a .csv, .xls or .xlsx file,
  • how to import bookings to the Schedules module using a .csv, .xls or .xlsx file,
  • how to map values,
  • how to prepare a match template.

Importing time slots and bookings with a file facilitates quick and easy creation of many bookings and time slots. This is a way to consistently transfer information from various sources to Dock Scheduler. With the importer, you can prepare your own templates as well, which will make your work more efficient.

Value mapping - tutorial

Before we move on to discussing import of time slots and bookings in detail, let's take a look at the Importer window when the loaded template is not automatically recognized.

17 STEPS

1. To import more than one time slot or booking using a file, click More

Step 1 image

2. Select an option from the drop-down list: Import time slots or bookings

Step 2 image

3. The first step is to prepare the file. You can use our template. Click Download the template

Step 3 image

4. After preparing the file, click the button Time slot

Step 4 image

5. If the template is recognized automatically, you will receive a message confirming the data has been correctly verified.

Step 5 image

6. If the file is not recognized automatically, you will have to go back to the File selection step from the Data matching step.

Step 6 image

7. After clicking on the selected column, choose a parameter from the list that will help you assign it to the appropriate parameter on the Dock Scheduler side.

Step 7 image

8. If the file is mapped according to the requirements, you will be able to save the template. Click Save as template

Step 8 image

9. Enter a template name and click Save

Step 9 image

10. You will find the saved template in the Match templates - this is where the Importer will attempt to automatically match the file to one of the templates.

Step 10 image

11. Click Next

Step 11 image

12. If the column scheme is recognized automatically but you want to change it, click Back

Step 12 image

13. Confirm your decision by clicking the button Go back anyway

Step 13 image

14. Make the change.

Step 14 image

15. When the time slot details are verified correctly, click the button Add time slots

Step 15 image

16. Import is in progress. After importing the time slots, you will receive a confirmation.

Step 16 image

17. The newly added time slots can be found on the Time slot list.

Step 17 image

** Best experienced in Full Screen (click the icon in the top right corner before you begin) **

https://www.iorad.com/player/2412337/Import-Help-DS-EN

Importing time slots

Detailed description of the fields is available in the file Importer data - time slots/bookings.​
  1. Go to the Schedules module and click More.

From the drop-down list, select Import time slots or bookings.

  1. You will see the import window with the following elements:
  • progress steps of the import (1),
  • templates for time slots and bookings that you can download (2),
  • buttons to create time slots or bookings (3),
  • Help icon - after clicking it you will be redirected to this article (4).

  1. Click Download the template for time slots. The file will be downloaded to your device. Prepare it by entering data.

Required data for importing time slots
- Date (you can provide a date range).
- Type of operation (loading/unloading).
- Operation time (make sure it is the same as in the warehouse settings).
- Carrier (tax identification number or Office-ID).
- Warehouse (warehouse name).
- Interval type
(refers to hourly intervals: Cycle- daily hours of bookings, Interval- time from the first to the last hour of the day, or Daily - bookings during dock’s working hours.
- Hours
for the time slot.

Range types
CYCLE (daily time interval of the booking) - it means that in a given warehouse, on selected days, bookings take place at the same hours. For example, Tuesday-Thursday, bookings at each dock take place from 9:00 to 17:00, and bookings can be made during these hours.
INTERVAL (time range from the specific hour on the first day to the specific hour on the last day) - For example, if we set the interval from Monday to Friday, and on the first day (Monday) the warehouse starts work at 8:00 and finishes on Friday at 16:00, bookings can be made within this time frame.
DAILY (bookings during working hours of the dock) - bookings can be made at any time during the day, but only during the working hours of the given dock. For example, if the dock operates from 7:00 to 19:00, bookings can be made during these hours.

If you do not specify the number of time slot, each item entered will be treated as 1 time slot.
  1. To import a file, click the Time slot button (File selection step).
  1. After uploading the file, the values included in the file will appear in the file import modal (Data matching step).

When you receive a notification that your data has been successfully verified, click Add time slots.

Example: unrecognized data

This message will appear when the data entered into the file is not correct.

You can correct the data directly on the Platform. After clicking on the field, you can edit it.

If you wish, you can also delete the selected time slot by clicking on the "x" icon on the left.

Example: partial data recognition

When some of the imported data is correct and some is not, you will see the following message:

To correct errors, click in the text field and edit it or delete the selected time slot.

If the data is entered correctly, click Add time slot.

  1. After clicking Add time slot, a progress bar will be displayed.

You can choose one of three actions: abort import, start a new import, or continue import in the background.

You will also receive notification that:

  • files are being imported
  • import of the files has been finished.

  1. Once the import is finished, you will see a summary. Click Close.

If the data from the file does not match the data in Dock Scheduler or the configuration of your Dock Scheduler (e.g. you create a time slot after warehouse working hours or on a holiday), you will receive a notification saying: Some records have been omitted due to the inability to create them.

  1. To check whether time slots have been imported, click Schedules and then Time slots.
  1. Mark the dates on the calendar for which you have created time slots. The imported time slots will be displayed in the list.

Importing bookings

  1. Go to the Schedules module and click More.

From the drop-down list, select Import time slots or bookings.

  1. In the import window, click Download template for booking. The file will be downloaded to your device. Prepare it by entering data.
Required data for importing bookings
- Date
- Operation time
(it has to be the same as in the warehouse settings)
- Operation type
(loading/unloading)
- Dock
- Warehouse
- Starting time
(start of operation)

  1. Click Bookings and attach the file.
  1. After uploading the file, the values you entered will appear in the file import window (Data matching step).

When you receive a notification that the data has been successfully verified, click Add bookings.

If the data is not verified correctly, you can edit it in the same way as in the case of time slots (check section 5. Import of time slots).
  1. After clicking Add bookings, a progress bar will be displayed.

You can choose from the following actions: abort import, start a new import, or continue import in the background.

You will also receive notification that:

  • files are being imported
  • import of the files has been finished.

  1. Once the import is finished, you will see a summary. Click Close.

  1. To check whether bookings have been imported, click Schedules and then Bookings.
  1. In the list of bookings you will see imported bookings.

Match templates

With mapping, you can specify where the data from the imported file should be assigned in Dock Scheduler. You can save your configuration as a match template. This will allow you to easily and quickly reuse your configuration.

If the column scheme has been recognized automatically, you can go back and change it.

  1. Import the file and select Back.

  1. Confirm by clicking Go back anyway.
  2. In this step you can map the columns. Click on the column and select the value you are interested in from the Time slot data drop-down list.

  1. You can make future data imports easier by saving your mapping configurations as templates.
    Click Save as template.

  1. Enter the name of the template and click Save.
  1. You will find the new template in the Match templates drop-down list.
The importer automatically recognizes previously defined mapping templates and automatically prepares the import according to them. For next file imports, the Importer automatically adjusts the template that best matches the file structure, ensuring consistency and efficiency in the data import process.


How did we do?

UP!
Powered by HelpDocs (opens in a new tab)