CSV import instructions for VSBA school projects

This page explains how to import CSV files for the VSBA website project pages.

This task can only be completed by people who have been assigned the roles of Approver/Data importer and have permission to the http://schoolbuildings.vic.gov.au

File type format

  • The file format must be CSV and encoded by UTF-8

  • File must not exceed 500 rows

  • File size limit is 100KB

  • If the number of rows OR file size limit need to be changed, please contact a Site Admin

How to create a CSV UTF-8 file correctly

  1. When you have finished working in the Excel (XLXS) spreadsheet, save a final XLXS copy.

  2. Use the example CSV files in the CMS to copy and paste your data - detailed instructions below.

Master environment

It is recommended that you test the CSV import Master environment first so that you can do a trial run before you import the CSV file into the Production environment. If this fails, please send us you CSV file so we can check if it’s correct.

If a pop-up window appears, you will need to type in the following:

Username: dpc
Password: sdp

BE - https://master.content.vic.gov.au - your login details are the same as Production

FE - https://www.master.schoolbuildings.vic.gov.au

New projects

New projects are for importing NEW parents and children projects

The file format is to match the following - with 17 fields

Note: Child records must be below Parent record in the CSV file

Steps

Description

Steps

Description

Step 1

Login to BE

Step 2

Go to Content → Feeds

This screen will display a history of feeds that have been added.

Step 3

Click on the +Feed button.

You will see the following screen with 2 options:

  • VSBA creation

  • VSBA update

Step 4

Click on VSBA creation

The following screen - Add VSBA creation - will be displayed and will allow you to upload a CVS file to create new projects for the VSBA website.

 

CSV file conversion

Before you upload your file, you need to convert your XLXS file into a CSV file. Follow these steps to convert the fie successfully.

  1. Click & Save the VSBA creation example file

  2. Open the CSV file (VSBA creation example) and delete the example data

  3. Open your XLXS file

  4. Copy and paste special (value) data from Columns A-Q from the XLXS file into the CSV example file.

  5. Under File → Save As… - select the following File format: CSV UTF-8 (Comma-delimited) (.csv)

File upload

You will see the following options:

  • Title* - a mandatory field - add a meaningful title for this feed eg. New projects February 2022

  • File* - Click on the Browse button to upload your CSV file

    • Once you upload a CSV file, a green success message will be displayed

  • Delimiter - will display , - do not change

  • Checkbox for No Headers - leave as is (do not check)

  • Uploading checklist:

    • CSV flle must be encoded by UTF-8 (link to How to)

    • The CSV example file option will have a downloadable VSBA creation example file

  • Save & Import button

Tip:

For funding types, if multiple values are present, add semi-colon and no spaces

Step 5

The blue button has 2 options:

Save and import - this will save the CSV file and import files immediately - see Steps 6-7

Save - this will save the CSV file and allow you to import at a later time - see Steps 8-10

Step 6

Clicking on Save and import will save the CSV file and import files immediately

 

The CSV file will be uploaded. Uploading a file will behave as expected:

  • new stand alone parent records - creates new pages for each parent with correct details

  • new stand alone child records (where parent id already exists in system) - adds child details to existing parent page with correct details

  • new parent with child records below the parent in file - creates a new page with parent and child details with correct details

  • new parent with child records above the parent in file - the parent will be created, but the child records will not be imported

    • new stand alone child records (where parent id does not already exist in system) - this row will be ignored.

 

Step 7

Your CSV file will be uploaded - you will see a Fetch page that will show the progress of the import. Once completed, a page will be displayed listing details of the CSV import.

 

Step 8

Clicking on Save will save the CSV file.

Once saved, the following screen will be displayed and you will have the + Import button will be displayed.

 

Step 9

Click on + Import

You will be asked whether you want to import the feed or not. You have the options of Import and Cancel.

 

Step 10

Click on Import - Your CSV data will be imported. You will receive a Success message.

If you click on Cancel - your CSV import will be cancelled and can be done at another time.

Updating existing projects

The CSV file format is to match the following - all 4 columns are mandatory:

  • VSBA number

  • School Name/Page title

  • Status

  • End date

Steps

Description

Steps

Description

Step 1

Login to BE

Step 2

Go to Content → Feeds

This screen will display a history of feeds that have been added.

Step 3

Click on the +Feed button.

You will see the following screen with 2 options:

  • VSBA creation

  • VSBA update

Step 4

Click on VSBA update

The following screen - Add VSBA update - will be displayed and will allow you to upload a CVS file to update existing projects for the VSBA website.

 

CSV file conversion

Before you upload your file, you need to convert your XLXS file into a CSV file. Follow these steps to convert the fie successfully.

  1. Click & Save the VSBA update example file

  2. Open the CSV file (VSBA update example) and delete the example data

  3. Open you XLXS file

  4. Copy and paste special (value) data from Columns A-D from the XLXS file into the CSV update example file.

  5. Under File → Save As… - select the following File format: CSV UTF-8 (Comma-delimited) (.csv)

File upload

You will see the following options:

  • Title* - a mandatory field - add a meaningful title for this feed eg. Project updates February 2022

  • File* - Click on the Browse button to upload your CSV file

    • Once you upload a CSV file, a green success message will be displayed

  • Delimiter - will display , - do not change

  • Checkbox for No Headers - leave as is (do not check)

  • Uploading checklist:

    • CSV flle must be encoded by UTF-8 (link to How to)

    • The CSV example file option will have a downloadable VSBA update example file

  • Save & Import button

Step 5

The blue button has 2 options:

Save and import - this will save the CSV file and import files immediately - see Steps 6-7

Save - this will save the CSV file and allow you to import at a later time - see Steps 8-10

Step 6

Clicking on Save and import will save the CSV file and import files immediately

 

The CSV file will be uploaded. Uploading a file will behave as expected:

  • new stand alone parent records - creates new pages for each parent with correct details

  • new stand alone child records (where parent id already exists in system) - adds child details to existing parent page with correct details

  • new parent with child records below the parent in file - creates a new page with parent and child details with correct details

  • new parent with child records above the parent in file - the parent will be created, but the child records will not be imported

    • new stand alone child records (where parent id does not already exist in system) - this row will be ignored.

 

Step 7

Your CSV file will be uploaded - you will see a Fetching page that will show the progress of the import. Once completed, a page will be displayed listing details of the CSV import

 

Step 8

Clicking on Save will save the CSV file.

Once saved, the following screen will be displayed and you will have the + Import button will be displayed.

 

Step 9

Click on + Import

You will be asked whether you want to import the feed or not. You have the options of Import and Cancel.

 

Step 10

Click on Import - Your CSV data will be imported.

If you click on Cancel - your CSV import will be cancelled and can be done at another time.

Tips

CMS Dashboard

You can clean up your dashboard. Deleting items from your dashboard will not delete the actual data in the CMS.

Taxonomy

If you need to add, edit or delete values from the VSBA taxonomies, please get in touch with us and we can easily edit the taxonomy. Note, any changes must be done before an import that has changed taxonomy values. Please also ensure that there are no blank spaces at the end of a taxonomy term in your XLXS spreadsheet - the term needs to be an exact match.

VSBA taxonomies and values include:

VSBA status

  • Land acquisition

  • Planning

  • Design

  • Construction

  • Complete

VSBA Funding type

  • Building Blocks Capacity Grant

  • Building Blocks Improvement Grant

  • Building Blocks Inclusion Grant

  • Building Blocks Planning Grant

  • Early Learning Facilities Upgrade

  • Early Learning Facility Upgrade

  • Education Plan

  • Inclusive Schools Fund

  • Integrated Children's Centre

  • Kindergarten

  • Kindergarten Modular Upgrade

  • Kindergarten on a School Site

  • Minor Capital Works Fund

  • New Academy

  • New Centre

  • New Early Learning Facility

  • New Integrated Children's Centre

  • New Integrated Early Learning Centre

  • New School

  • New School Campus

  • New Specialist School Campus

  • Non-Government Schools Capital Fund

  • Permanent Modular School Buildings Program

  • Planned Maintenance Program

  • Planning

  • School Improvement Fund

  • School Pride and Sports Fund

  • Shared Facilities Fund

  • Sporting Facility Upgrade

  • Tech Schools

  • Upgrade and Modernisation

Map pin type

  • Early childhood

  • New school

  • Non-governmet grant

  • Planning

  • School upgrade

  • Tech school