Skip to content

Data Box - Administration Guide

This section covers the configuration and maintenance of the Data Box module.

Configuration

1. Setting up a Data Box Account

To enable sending and receiving, you must configure a DataBoxAccount entity.

  1. Navigate to Data Box Accounts.
  2. Click Create.
  3. Fields:
    • Name: Internal name for this account (e.g., "Main Company Box").
    • Login: The User ID for the ISDS account (e.g., six354).
    • Password: The password for the ISDS account.
      • Security Note: Passwords are encrypted in the database.
    • Dev Mode: Check this if using the ISDS Testing Environment (czebox.cz). Uncheck for Production (mojedatovaschranka.cz).
  4. Access Control:
    • Assign Teams or Users who are allowed to view and send from this account.

2. Testing Connection

After saving the account: 1. Open the DataBoxAccount detail view. 2. Click the Test Connection button (if available) or wait for the first sync. 3. Check the logs for any authentication errors.

Automation (Cron Jobs)

The system uses a Scheduled Job to synchronize messages.

  • Job Name: CheckDataBoxAccount
  • Class: Espo\Modules\DataBox\Classes\Jobs\CheckDataBoxAccount
  • Schedule: Recommended every 15 minutes (*/15 * * * *).
  • Function:
    • Iterates through all active DataBoxAccount records.
    • Downloads new Received messages.
    • Updates the status of Sent messages (e.g., Sent -> Delivered).

Troubleshooting

Common Issues

  • Authentication Failed:
    • Check if the password has expired (ISDS passwords expire every 90 days unless configured otherwise).
    • Verify Dev Mode setting matches the credentials.
  • Messages Not Linking:
    • Ensure the ParentFinder logic is correctly identifying the related entity (usually by matching Company ID/IČO).
  • "Forbidden" when Sending:
    • The user does not have permission to manage the selected DataBoxAccount. Check Team assignments.