Pyle

How to Run an Import ​

What This Task Does ​

This task helps you upload a spreadsheet import, track its progress, and review any errors that block the import from finishing cleanly.

Before You Start ​

Make sure:

  • you have access to Tools > Excel
  • you chose the correct import template
  • your file is in the expected spreadsheet format
  • you know whether the selected template expects one sheet or multiple sheets

If the import supports multiple sheets, make sure the workbook tabs and column structure match the template you are using.

Steps ​

  1. Open Tools > Excel.
  2. Stay on the Import tab.
  3. Choose the import template you want.
  4. Upload the spreadsheet file.
  5. Set any template-specific options, such as selected sheets when the import supports them.
  6. Submit the import.
  7. Watch the row status in the table:
    • pending
    • processing
    • completed
    • failed
  8. If the import creates logs, open the logs view and review the failing rows.
  9. Correct the spreadsheet and run the import again if needed.

What Happens Next ​

After submission, the import runs asynchronously.

When it finishes, the shared package updates the run status and notifies the requesting user by email. Failed validations can also produce row-level error logs for review.

Common Mistakes ​

  • uploading the wrong template
  • forgetting required sheets in a multi-sheet workbook
  • assuming a queued import failed when it is still processing
  • re-running the same file without checking the row-level errors first

Sources ​

  • packages/admin/src/Livewire/Admin/Tools/Excel/Page.php
  • packages/admin/src/Livewire/Admin/Tools/Excel/DataTable.php
  • packages/admin/src/Livewire/Admin/Tools/Excel/ImportDialog.php
  • packages/admin/src/Livewire/Admin/Tools/Excel/ImportDialog/AbstractImport.php
  • packages/admin/src/Livewire/Admin/Tools/Excel/LogsDialog.php
  • packages/framework/src/Models/ExcelImport.php
  • packages/framework/src/Models/ExcelImportLog.php
  • packages/framework/src/Actions/Excel/ExcelImporter.php
  • packages/framework/src/Actions/Excel/SetImportStatus.php