Implementation process pipeline

This template repo helps with setting up a pipeline for an OSLO implementation process (implementatietraject).

• Application profile
• SHACL

Usage

Setting up this repository

You only have to do these steps once.

1. Create a new repository based on this repository.
2. Navigate to Settings > Actions > General > Workflow permissions and make sure that "Read and write permissions" is checked.
3. Set up GitHub pages and let it point to the docs directory on the main branch.
4. Set the link to the application profile at env.ap_url in the file .github/workflows/pipeline.yml.
5. Set the link to the SHACL at env.shacl_url in the file .github/workflows/pipeline.yml.
6. Read and, if necessary, update the license.
7. Commit and push your changes to GitHub. This will trigger the workflows, which will also add example data to the example-data directory.
8. Navigate to Actions and make sure that there are no errors in the workflows.
9. Copy the Excel files in the example-data directory to the data directory.
10. Once the workflows have finished, the dashboard is available via your GitHub pages.
11. If everything works, empty the data directory. You can now start adding data.
12. Configure the dashboard.

Configure the dashboard

You can configure the dashboard via the following steps:

1. Create a copy of this directory in the root of the repo and rename it to dashboard-config.
2. Update the content of dashboard-config. You find the options of the dasboard in dashboard-config/config.json. See this section for more information about the different options. You don't need to add the option comunicaContext, because the pipeline sets this automatically. You store queries in dashboard-config/public/queries.

Adding data via an Excel file

Note that adding data to this repository makes the data public and the data will have this license.

1. Download the Excel template called template.xlsx or an Excel file with example data:

   • Excel template:

     1. Browse to the template in the repository.

     2. Download the template by clicking on download icon (with the tooltip "Download raw file") on the right:

        

   • Excel file with example data:

     1. Navigate to the example-data directory.
     2. Click on one of the Excel files.
     3. Download the Excel file by clicking on download icon (with the tooltip "Download raw file") on the right:

     

2. Rename the Excel file to something meaningful like the name of your organisation, for example, ugent.xlsx for Ghent University.
3. Fill in your data in the Excel file.
4. Upload the Excel to the repository.

   1. Navigate to the data directory.

   2. Click on "Add file":

      

   3. Click on "Upload files":

      

   4. You get a page where you can upload the Excel file:

      

   5. Upload the Excel file at the top

      

   6. Add a message describing your changes under the header "Commit changes":

      

      This can be, for example, "Add data from UGent".

   7. Click on the button "Commit changes":

      

Updating data in an Excel file

Note that adding data to this repository makes the data public and the data will have this license.

1. Download the Excel file that you want to update:

   1. Browse to Excel file that you want to update.

   2. Download the template by clicking on download icon (with the tooltip "Download raw file") on the right:

      

2. Update the data in the Excel file.
3. Upload the Excel to the repository via the instructions in step 4 of the section on how to add data via an Excel file.

Execute queries via the dashboard

1. Browse to the GitHub pages of this repository.

2. Click on one of the queries on the left:

   

Extras

• You can reset the README.md via

  ./scripts/reset-readme.sh

• Delete in-shacl/shacl.ttl to download the SHACL again.

• Delete template.xlsx to regenerate the template Excel file and example data.

• You can reset the whole repo via

  ./scripts/reset-repo.sh

• Some example env values are

  env:
    ap_url: https://data.vlaanderen.be/doc/applicatieprofiel/leermiddelen/ontwerpstandaard/2025-03-21/
    shacl_url: https://data.vlaanderen.be/doc/applicatieprofiel/leermiddelen/kandidaatstandaard/2025-08-01/shacl/leermiddelen-SHACL.ttl