How to populate additional test data on the FOLIO dev Rancher environment

How to populate additional test data on the FOLIO dev Rancher environment

This guide provides step-by-step instructions for importing additional MARC test data into a FOLIO development environment deployed on Rancher. It is intended for developers who need to populate the Inventory with bibliographic test records.

📦 1. Download a MARC File from the Registry

Visit the public MARC registry and download the specific .marc file needed for your testing scenario.

Registry URL: https://folio-marc-test-data.ci.folio.org/

image-20250602-150231.png

 

Save the file locally on your machine.

🔐 2. Log in to the FOLIO Dev Environment

  1. Navigate to your assigned development environment in a browser.

  2. Authenticate using your credentials via the Keycloak login page.

Example:

https://folio-edev-<team_name>-diku.ci.folio.org

image-20250602-150544.png

📥 3. Open the Data import App

Once logged in:

  • From the top navigation bar, select the Data import app.

image-20250602-151022.png

📂 4. Upload the MARC File

  1. Drag and drop the previously downloaded .marc file into the upload area.

  2. Alternatively, click or choose files and select the file manually.

📝 5. Select the Appropriate Job Profile

After uploading the file, choose the job profile:

Default - Create instance and SRS MARC Bib (This profile creates both the SRS MARC record and a corresponding Inventory instance.)

image-20250602-151134.png

▶️ 6. Start the Import Job

  1. Click the Actions button in the top-right corner.

  2. Select Run to begin the import.

image-20250602-151407.png

⏳ 7. Monitor the Job Progress

A progress bar will appear under Running jobs.

Wait for the job status to reach Completed.

You may check job logs for more details if needed.

image-20250602-151510.png

📚 8. Verify in Inventory

Once the job is completed:

  1. Open the Inventory app.

  2. Search or browse for the imported records.

  3. Confirm that instances from the MARC file are now available in the system.

image-20250602-151621.png

 

 Summary

By following this process, you can quickly populate the FOLIO development environment with additional MARC-based test data, facilitating more effective testing and development workflows.