SameGoal Special Programs
search
SameGoal Special Programs

Bulk Import PDFs




Support > Online Guides > Technical Guide > Bulk Import PDFs
download

Overview link

During implementation, PDFs from your prior system may be imported into SameGoal, giving staff access to historic documents authored in your previous system even after converting to SameGoal.

Imported PDFs will not bootstrap program participation, deadlines or reports. In order to bootstrap your SameGoal environment in year one, use the Data Import tool in addition to the PDF Import tool.

The PDF Import tool associates an unlimited number of documents per student going back arbitrarily many years. Documents are associated by attaching them to existing student records in SameGoal. Because this tool does not create student records, either run a demographics integration or use the Bulk Loader to create student records prior to import.

Extract PDFs from your prior system link

In order to import PDFs into SameGoal, you must first extract the PDFs from your prior system. Check with your prior vendor to see if they have a PDF export available. If no PDF export is available, SameGoal has tools and streamlined processes to extract PDFs from some systems. Check with your account representative to see what tool or process is best for your particular system.

Directory and file naming conventions:

lightbulb Tip
To ensure that the directory being uploaded into an environment is for the desired district, the top directory must be the district's SameGoal domain (eg applegrove.org/...). When initiating a new import, the district's domain will be listed at the top in the blue bar.

Import PDFs into SameGoal link

The PDF Import Tool bulk imports PDFs in 2 stages. First, files are uploaded into SameGoal by an administrator, then they are automatically associated with the corresponding student.

Steps
To bulk import PDFs:

  1. Log in to SameGoal as an administrator.
  2. Visit Settings > PDF Import.
  3. Click the New PDF Import button.
  4. Select the folder on your local computer that contains PDFs from your prior system below.
    • Once a folder is selected, the tool will automatically begin uploading the PDFs to SameGoal servers (Stage 1: Upload).
    • A progress table will show the upload status of each document.
    • While PDFs are being uploaded, do not interrupt the process (eg close the tab, close the browser, hit the back button, log out of SameGoal, etc). Doing so will interrupt this stage and require you to restart.
  5. A summary of the number of uploaded documents for processing and any upload errors will appear on screen after Stage 1 is complete.
  6. Once PDFs have been uploaded to SameGoal servers, they are automatically inspected and associated with the corresponding student in SameGoal when possible (Stage 2: Associate). Because this phase happens server-side, you may close the tab, browser, work on something else in SameGoal or even log out while PDFs are being associated.
  7. Once Stage 2 is complete, you will receive a notification email with a link to review results. Follow this link to see a summary report.

lightbulb Tip
This tool may be re-run multiple times for any folder. PDFs that have already been associated will not be re-associated.

Reviewing an import link

After the PDF Import tool is run, review the report to ensure all of the desired PDFs were associated to the correct student record. If you find PDFs that should have been associated but were not, address any issues and re-run the PDF Import tool. This can be done as many times as necessary to get the desired results. You can also manually attach PDFs if you wish.

Steps
To view the results of a PDF import:

  1. Log in to SameGoal as an administrative user.
  2. Go to Settings > PDF Import.
  3. Select the import summary you'd like to view.
    • Summaries are sorted by the date and time the import tool was run.
  4. Use the Result and Note columns to review. You may filter on these columns in-app if you're on the Plus or Pro edition of SameGoal. Otherwise, you may download the report and filter the results locally.
    • Result: This column shows whether or not the document was associated. Potential results include:
      • Associated: The PDF has been associated to the student listed in the Student column.
      • Previously Associated / Duplicate: The PDF was already associated to a student in a previous import.
      • Not Associated: The PDF was not associated and is less than 3 years old.
      • Not Associated (older than 3 fiscal years): The PDF was not associated and is more than 3 years old. The document's age is not the reason it did not associate. However, this note is included since if a PDF is older than 3 fiscal years, it is likely less relevant to current document and might not need to be reimported.
    • Note: If the document was not associated, this column lists the reason why. (See the common errors below.)

lightbulb Tip
SameGoal does not store PDFs that were not associated with a student record. It is the responsibility of the district to save and store these documents.

Common issues link

The most common reasons a document is not associated to a student record include:



info