Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

The Import Wizard menu in Paradigm is a powerful tool that will help you import data or information saved or recorded in another file or application to Paradigm. This is very helpful in speeding up the process of data migration. Due to the complexity of this feature, we strongly advise that you seek advice from the Silverband Support Team prior to using this part of the system.

Complexity:

Status
colourRed
titleexpert

...

Warning

NOTE:

Please take note of the following requirements of your source data file to be imported:

WARNING:

The Import Wizard is a complex feature with the potential to perform high-impact updates to data records. For this reason, we strongly advise that you seek advice from the Silverband Support Team prior to using this part of Paradigm.

Workflow

Before you start following the instructions below, your data source file to be uploaded should meet the following requirements:

  • File must be in CSV (Comma delimited) (*.csv) format

...

  • All fields in your source file must be present in any future import attempts

...

  • All fields in the source file must be in the exact same order (correctly structured: headers are consistent or the same as the fields in Paradigm)

...

  • All fields must have a value (with the exception of census date, min/max participants)

...

...

WARNING:

The Import Wizard is a complex feature with the potential to performing high-impact updates to data records. For this reason, we strongly advise that you seek advice from the Silverband Support Team prior to using this part of Paradigm.

...

Workflow

Expand
titleHow to use the Import Wizard menu in Paradigm WITHOUT an existing Profile
Status
colourYellow
title1
How to use the Import Wizard menu in Paradigm WITHOUT anexisting
Create a New Import Profile

Create a New Import Profile

NOTE:

The instructions below assume that your data source files have meet met all the requirements as mentioned above under the Implications section.

Status
colourBlue
titlestep 1
Upload the data source file


Status
colourGreen
title1
,
Status
colourGreen
title2
Choose System > Import Wizard menus on the side.

Status
colourGreen
title3
On the Import Wizard page, click the NEW PROFILE button.

Image RemovedImage Added

Status
colourGreen
title4
Enter the required information on the fields which are highlighted in RED (as shown in the screenshot below).

Image RemovedImage Added

1. Import Name – the name that describes the import profile, what it will do, e.g. “Update Course Enrolment Status”

2. Description – you have the option to copy the Import Name to this field.

3. Import Type – you can set this as “csv

4. File Description – set this the same as the Import Type as “csv

5. Upload File – click the Browse button to upload the file you have prepared, see the section above for the requirements

NOTE:

The fields Import Type and File Description must match exactly. Once the profile has been saved, changes to these fields are not possible, and if they are not the same, the profile will not work.

Additional field validations added:

  • Import Type - maximum field length set to 20 characters

  • Import Type and File Description fields - marked as read-only on existing import profile meaning the field can only be edited once when first creating an import profile

Status
colourGreen
title5
Put a checkmark ☑ on the Import Multiple Rows field as required.

Image RemovedImage Added

Status
colourGreen
title6
After you have filled out the required fields and uploaded the file, click the UPLOAD FILE button to proceed to the mapping stage.

Status
colourBlue
titlestep 2
Map Source Data Fields to Paradigm Fields


Status
colourGreen
title1
After uploading the data source file from the
Status
colourBlue
titlestep 1
instructions, click the Select Object dropdown menu to choose the exact group data/table in Paradigm that will match your source file. e.g. choose Program if the data that you want to import are courses data, Student if the source file contains student data or information, etc.

Status
colourGreen
title2
After selecting an object, proceed with the data mapping.

Note

BE ADVISED:

This step must be taken with the highest level of care and accuracy as this will determine how and where your data are saved in the system.

Image Removed

.

Image Added

NOTE:

If you are only doing updates on selected fields, only set the Paradigm Field column of the equivalent column name in your file that you want to be updated.

In the example below, only the Status column is mapped to a Paradigm Field if the intention is to only update the student status.

Image Added

Status
colourGreen
title3
After you’ve mapped all the fields, click the SAVE COLUMN BINDINGS button to proceed to the next step.

Image RemovedImage Added

Status
colourBlue
titlestep 3
Match External Values to Paradigm Values


Status
colourGreen
title1
After mapping the fields to match with the Paradigm fields, some values of the fields being mapped needs also to be matched with Paradigm values. e.g. the languages spoken at home, in your source file it has a value of “Tagalog” while in Paradigm, it should be “Filipino”; another example would be from Course Level, some source value would be entered as “UNDERGRAD” while in Paradigm it’s “Undergraduate”.

Info

INFO:

Paradigm will detect values which are entered differently (in small or capital letters) from Paradigm’s default (defined) or existing values.

Image RemovedImage Added

Status
colourGreen
title2
After mapping all the values, click the SAVE MAPPING button to proceed to the next step.

Image RemovedImage Added

Status
colourBlue
titlestep 4
Save Import and Process Files


Status
colourGreen
title1
In the EXISTING RECORD SEARCH section, match the primary keys from your source file to Paradigm’s equivalent primary key. Start with choosing clicking the ➕ (plus sign), choose the Paradigm field, select the Import File name (your data source file), and the Import File field. By setting this section, Paradigm will search and compare the records based on the primary keys you’ve set and will take action based on how you want the system to handle matching records (see step
Status
colourGreen
title2
instructions below).

Image RemovedImage Added

OPTIONAL Steps


Status
colourPurple
title2
Click the ➕ to add more primary keys to match

Status
colourPurple
title3
Click the Add Group button to add another primary key found in another data table or group

Status
colourPurple
title4
Change the AND or OR logical operator as required (depending on how you want the primary keys to behave), given that you have added more than one or more primary keys or more than one group.


Status
colourGreen
title2
After setting up the primary keys proceed to the DATA MAPPING section.

Refer to the description of each section and options below:

How do you want to handle matching records in Paradigm?

🔘 Do not Import (Only Create) – only create or add a new record when a matching record cannot be found in Paradigm, it won’t edit or update existing records if it has found one

🔘 Update Records (Create and Update) – ((lightbulb) Commonly used option) when a matching record is found, the system will update the record, and when it’s not found, the system will add or create a new one

🔘 Only Update Records – only update the system when a matching record is found, it won’t create a new record if it can’t find any matching records in Paradigm

Run import in debug Mode (Show query output to find existing records, but disable save)

☑ Enable Debug Mode

Image Removed


Image Added

This button will take you back to the page where you are allowed to change the field mappings. In this workflow section, it’s under the

Status
colourBlue
titlestep 3
section.

Image RemovedImage Added

The save import button will save your import profile. This will serve as your reference when you will import the same data group in the future.

This button will do the import of your file into Paradigm. After it finishes, you will get a new section with success messages and error messages, and you can download either or both files (as shown in the screenshot below).

back to top

Expand
titleHow to use the Import Wizard menu in Paradigm WITH an existing Profile
Status
colourYellow
title2
How to use the Import Wizard menu in Paradigm WITH an existing
Load an Existing Import Profile

Load an Existing Import Profile

Status
colourBlue
titlestep 1
Choose an Existing

Load

Import Profile


Status
colourGreen
title1
,
Status
colourGreen
title2
Choose System > Import Wizard menus on the side.

Status
colourGreen
title3
On the Import Wizard page, select the Import Profile Id that you want to use.

Status
colourGreen
title4
Click the LOAD PROFILE button.

Image RemovedImage Added

Status
colourGreen
title5
After clicking the LOAD PROFILE button, it will auto-populate the fields, settings or information you’ve set in your last import. You have the option to LOAD LAST IMPORT RUN or UPLOAD FILE. In the above section of the page, you also have the option to DOWNLOAD ERROR FILES, LOAD ERROR LOG, and DELETE PROFILE.

Image RemovedImage Added

Image RemovedImage Added

Status
colourGreen
title6
Select either of these two buttons or options:

  • The LOAD LAST IMPORT RUN will let you load all the data, information, field mappings, settings, and technically everything that you’ve set in your last import activity. This is very useful if you want to correct or change some of the details you’ve set from your previous run.

  • The UPLOAD FILE button will let you upload a new data source file and use the same format and structure as your selected import profile.

Status
colourGreen
title7
After selecting either the LOAD LAST IMPORT RUN or the UPLOAD FILE button, refer to the instructions above under Workflow “
Status
colourYellow
title1
How to use the Import Wizard menu in Paradigm WITHOUT an existing Profile” starting from the in the above workflow: Create a New Import Profile starting from
Status
colourBlue
titlestep 2
Map Source Data Fields to Paradigm Fields section for the rest of the instructions on how to import a file.

NOTE:

If the intention of using an existing profile is to follow and do the same exact type of import with the same type of data and format as your last import, you need not change any of the mappings, only change the matching section if there are new external values detected, and most importantly – do not change any of the conditions in the EXISTING RECORD SEARCH section, the last page of the Import Wizard.

back to top

Related Pages

Filter by label (Content by label)
showLabelsfalse
max5
showSpacefalse
cqllabel = "report-builder"

...