diff --git a/.github/aanpassing_documentatie.yml b/.github/ISSUE_TEMPLATE/aanpassing_documentatie.yml similarity index 100% rename from .github/aanpassing_documentatie.yml rename to .github/ISSUE_TEMPLATE/aanpassing_documentatie.yml diff --git a/.github/wijzigingsformulier.yml b/.github/ISSUE_TEMPLATE/wijzigingsformulier.yml similarity index 100% rename from .github/wijzigingsformulier.yml rename to .github/ISSUE_TEMPLATE/wijzigingsformulier.yml diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 0e4c908..6021113 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -1,44 +1,20 @@ -name: Build and Check -on: - workflow_dispatch: - pull_request: -jobs: - build: - name: Build - uses: Logius-standaarden/Automatisering/.github/workflows/build.yml@main - check: - needs: build - name: Check - uses: Logius-standaarden/Automatisering/.github/workflows/check.yml@main - - preview: - needs: build - name: Preview - runs-on: ubuntu-latest - if: ${{ github.event_name == 'pull_request' && !github.event.pull_request.head.repo.fork }} - steps: - - uses: actions/checkout@v2 - - name: Recover HTML - uses: actions/cache@v2 - with: - path: ~/static - key: ${{ github.run_id }} - - name: Gather files - run: | - rm index.html - mv ~/static/snapshot.html index.html - rm -f *.md *.pdf *.js snapshot.html - mkdir ~/content - mv ./* ~/content - git clone https://user:${{ secrets.BEHEER }}@github.com/Logius-standaarden/Publicatie-Preview.git - - name: Commit preview - run: | - cd Publicatie-Preview - rm -f -r ${{ github.event.repository.name }}/${{ github.head_ref }} - mkdir -p ${{ github.event.repository.name }}/${{ github.head_ref }} - mv ~/content/* ${{ github.event.repository.name }}/${{ github.head_ref }} - git add -A - git config user.name "GitHub Action" - git config user.email "api@logius.nl" - git commit -m "new preview build" - git push +name: Build and Check +on: + workflow_dispatch: + pull_request: + push: + branches: + - main +jobs: + build: + name: Build + uses: Logius-standaarden/Automatisering/.github/workflows/build.yml@main + check: + needs: build + name: Check + uses: Logius-standaarden/Automatisering/.github/workflows/check.yml@main + publish: + needs: build + name: Publish (Logius) + uses: Logius-standaarden/Automatisering/.github/workflows/publish.yml@main + secrets: inherit diff --git a/OIN-Stelsel.pdf b/OIN-Stelsel.pdf index 8cfa270..0644f3b 100644 Binary files a/OIN-Stelsel.pdf and b/OIN-Stelsel.pdf differ diff --git a/ch01_Inleiding.md b/ch01_Inleiding.md index d47ed43..a5a9931 100644 --- a/ch01_Inleiding.md +++ b/ch01_Inleiding.md @@ -4,14 +4,6 @@ In dit document beschrijven we het doel en de werking van het OIN Stelsel. Het OIN is gestart als een noodzakelijk onderdeel van de Digikoppeling Standaard en is inmiddels een veel gebruikt identificatienummer binnen en maar ook buíten Digikoppeling. De regels van uitgifte en gebruik van het OIN staan beschreven in de *Voorwaarden Digikoppeling* en de *Gebruiksvoorwaarden Digikoppeling*. Daarnaast geeft Logius OINs en SubOINs uit en slaat de informatie hiervan op in het OIN register en ontsluit die met de *[=COR=]*, de Centrale OIN Raadpleegvoorziening. Dit geheel van regels en uitvoering noemen we het *OIN stelsel*. - -Dit document is te raadplegen via: -- html (gepubliceerd): [https://publicatie.centrumvoorstandaarden.nl/dk/oin/](https://publicatie.centrumvoorstandaarden.nl/dk/oin/) -- html (werkversie): [https://Logius-standaarden.github.io/OIN-Stelsel](https://Logius-standaarden.github.io/OIN-Stelsel) -- html (snapshot): [https://Logius-standaarden.github.io/OIN-Stelsel/snapshot.html](https://Logius-standaarden.github.io/OIN-Stelsel/snapshot.html) -- pdf: [https://github.com/Logius-standaarden/OIN-Stelsel/blob/master/OIN-Stelsel.pdf](https://github.com/Logius-standaarden/OIN-Stelsel/blob/master/OIN-Stelsel.pdf) -- markdown (github): [https://github.com/Logius-standaarden/OIN-Stelsel](https://github.com/Logius-standaarden/OIN-Stelsel) - ## Waarom dit document De `Voorwaarden Digikoppeling` en de `Digikoppeling Gebruiksvoorwaarden` hebben een juridisch karakter en beantwoorden waarschijnlijk niet elke vraag van gebruikers van een OIN. In dit document proberen we daarom de werking van het OIN stelsel met al haar facetten nader te beschrijven in de hoop die vragen te beantwoorden. diff --git a/ch06_Data Architectuur.md b/ch06_Data Architectuur.md index eeb9761..109a381 100644 --- a/ch06_Data Architectuur.md +++ b/ch06_Data Architectuur.md @@ -82,15 +82,18 @@ De [=COR=] Website retourneert een relevante attributen van een OIN-registratie. ### [=COR=] API -Hieronder een voorbeeld van een REST-API call naar de [=COR=] API. In het voorbeeld wordt het OIN van de `Digilevering Integrator` opgevraagd, dit is een voorziening van Logius. Naast het OIN van de Digilevering Integrator, wordt ook een HAL referentie naar de SubOIN-Houder (in dit geval Logius) geretourneerd. Het valt op dat de [=COR=] API meer attributen vermeldt dan de [=COR=] website. +Hieronder een voorbeeld van een REST-API call naar de [=COR=] API. In het voorbeeld wordt het OIN van de `Digilevering Integrator` opgevraagd, dit is een voorziening van Logius. Naast het OIN van de Digilevering Integrator, wordt ook een HAL referentie naar de SubOIN-Houder (in dit geval Logius) geretourneerd. Het gebruik van de API staat verder beschreven op de [COR API website](https://portaal.digikoppeling.nl/registers/corApi/index). -Voorbeeldaanroep van de CORAPI + + + diff --git a/ch09_Bijlage B - Nuttige links.md b/ch09_Bijlage B - Nuttige links.md index 62f07ca..1f69cfe 100644 --- a/ch09_Bijlage B - Nuttige links.md +++ b/ch09_Bijlage B - Nuttige links.md @@ -12,6 +12,6 @@ | Voorziening | url | | ---- | --- | -| [=COR=] Web| [https://portaal.digikoppeling.nl/registers/](https://portaal.digikoppeling.nl/registers/)| -| [=COR=] API - handleiding| [https://portaal.digikoppeling.nl/registers/corApi/index](https://portaal.digikoppeling.nl/registers/corApi/index)| -| [=COR=] API - OpenAPI Specificatie| [https://portaal.digikoppeling.nl/registers/api/](https://portaal.digikoppeling.nl/registers/api/)| +| [=COR=] Web| https://oinregister.logius.nl/oin-register | +| [=COR=] API - handleiding| https://oinregister.logius.nl/documenten/api-documentatie | +| [=COR=] API - OpenAPI Specificatie| https://portaal.digikoppeling.nl/registers/api/ | diff --git a/index.html b/index.html index 21e27e8..5bd9ec4 100644 --- a/index.html +++ b/index.html @@ -1,48 +1,74 @@ - - - - - - OIN Stelsel - - - - - - - -
-
- -
-
- - -
-
-
-
-
-
-
-
-
-
-
-
-
- - - \ No newline at end of file + + + + + + +
+
+
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + diff --git a/js/config.js b/js/config.js index 829aa1a..dc864bb 100644 --- a/js/config.js +++ b/js/config.js @@ -1,166 +1,26 @@ var respecConfig = { - //voor specStatus mogelijkheden zie https://github.com/centrumvoorstandaarden/respec/wiki/specStatus - specStatus: "DEF", - //voor specType mogelijkheden zie https://github.com/centrumvoorstandaarden/respec/wiki/specType - specType: "HR", - - // The specification's publish domain, which is used to publish the specification - // the url in the header thisVersion is generated like `//--}-conf.publishDate>/` - pubDomain: "dk", - shortName: "oin", - - // Voor publishDate zie https://github.com/w3c/respec/wiki/publishDate - // Als er geen publishDate is opgegeven, genereert ReSpec de datum o.b.v. de laatste wijzigingen - // Belangrijk: als publishDate niet opgegeven is, wordt bij de link "Laatst gepubliceerde versie" "geen" gezet. Anders wordt een link opgebouwd voor de laatste versie, met het formaat: - // https://publicatie.centrumvoorstandaarden.nl/{pubDomain}/{shortName} - publishDate: "2020-03-31", - - // Vul in om een korte extra uitleg te weergeven op de docs.centrumvoorstandaarden.nl website. - // subExplanation: "", - addSectionLinks: true, - - publishVersion: "2.0.2", - previousPublishVersion: "2.0.1", - - // Als er een eerder gepubliceerde versie is, geef dan de datum daarvan op - //previousPublishDate: "2017-05-31", - // Zie https://github.com/w3c/respec/wiki/previousMaturity. Dit moet een - // Als previousMaturity niet opgegeven wprdt, maar previousPublishDate wel, dan wordt dezelfde status gebruikt als bij specStatus - //previousMaturity: "DK-VV", - // licentie. Kiezen uit: - license: 'cc-by-nd', - // logos: [], // Geef een lege array op als er geen Geonovum logo moet staan - doJsonLd: true, - editors: [ - { - name: "Pieter Hering", - company: "Logius", - companyURL: "http://www.logius.nl/", - }, - ], - authors: [ - { - name: "Pieter Hering", - company: "Logius", - companyURL: "http://www.logius.nl/", - }, - ], - // shortName = korte naam voor in de url van het document, gebruik alleen letters, cijfers en eventueel '-' - // url van de github repository waar je in werkt + alternateFormats: [ { + "label" : "pdf", + "uri" : "OIN-Stelsel.pdf" + } ], + authors: [ { + "company" : "Logius", + "companyURL" : "http://www.logius.nl/", + "name" : "Pieter Hering" + } ], + editors: [ { + "company" : "Logius", + "companyURL" : "http://www.logius.nl/", + "name" : "Pieter Hering" + } ], github: "https://github.com/Logius-standaarden/OIN-Stelsel", - - - alternateFormats: [ - { - label: "pdf", - uri: "OIN-Stelsel.pdf", - }, - ], - - - - // For Consultatieversies (specStatus="GN-CV") there is a default text in the section "Status of this document" that contains an emailaddress for feedback and comments on the document. - nl_emailComments: "digikoppeling@logius.nl", - - // this parameter will add the tag_name of the latest release to the document Title - // only set this parameter when a release has been set - nl_addReleaseTagTitle: true, - - // if you use a single document for your spec, which uses more than one markdown H1 header, e.g. '# inleiding' - // this configuration can be set to make sure that the alle H1 headers and navigation bars are preserved - nl_markdownSplitH1sections: true, - - // in some cases the Repository of a Specification document and the Issue- and PR bases are split - // thi scan be configured below - // if not set, the url's will be generated on the respecConfig.github automatically - nl_github: { - // issueBase: "https://github.com/Logius-standaarden/Digikoppeling-Wat-is-Digikoppeling/issues", - revision: "https://github.com/Logius-standaarden/OIN-Stelsel", - // pullrequests: "https://github.com/Logius-standaarden/Digikoppeling-Wat-is-Digikoppeling/pulls" - }, - - // nl_organisationName is used for some company specific values in the header (and Sotd) - // currently supported: Logius and Geonovum (default) - nl_organisationName: "Logius", - - // prefix for the names of company specific css, svg and ico prefixes - // defaults to "GN-" - nl_organisationPrefix: "LS-", - - // class style can be automatically insertd in generated markdown tables - // currently defaults to simple, but this may change - // options simple, data, - nl_markdownTableClass: "dkkvs", - nl_markdownCodeClass: "code", - - // if nl_markdownEmbedImageInFigure is set to true images in markdown generated content will be surrounded with element - // so that figures can be linked are be a part of table of figures - nl_markdownEmbedImageInFigure: true, - - // this url points to the folder where organsation specific css files are stored - // defaults to https://tools.geostandaarden.nl/respec/style/ if not set - nl_organisationStylesURL: "https://publicatie.centrumvoorstandaarden.nl/respec/style/", - // nl_organisationStylesURL: "http://localhost:8081/respec/style/", - - // nl_organisationPublishURL points to organisation specifica publication page, used in header - // defaults to https://docs.geostandaarden.nl/" - nl_organisationPublishURL: "https://publicatie.centrumvoorstandaarden.nl/", - - // nl_logo refers to company logo - // defaults to https://tools.geostandaarden.nl/respec/style/logos/Geonovum.svg - nl_logo: { - src: "https://publicatie.centrumvoorstandaarden.nl/respec/style/logos/figure-logius.svg", - alt: "Logius", - id: "Logius", - height: 77, - width: 44, - url: "https://www.logius.nl/standaarden", - }, - - - - // in localBiblio kun je bibliografische items opnemen. In de tekst kun je dan tussen blokhaken verwijzen naar de korte naam bv [NEN3610]. - localBiblio: { - NEN3610: { - href: "http://www.nen.nl/web/Normshop/Norm/NEN-36102011-nl.htm", - title: - "Basismodel Geo-informatie - Termen, definities, relaties en algemene regels voor de uitwisseling van informatie over aan de aarde gerelateerde ruimtelijke objecten", - authors: [""], - date: "Maart 2011", - publisher: "Nederlands Normalisatie-instituut", - }, - "Voorwaarden Digikoppeling": { - href: "https://www.logius.nl/diensten/digikoppeling/documentatie/voorwaarden-digikoppeling", - title: - "Voorwaarden Digikoppeling", - date: "1 januari 2021", - publisher: "Logius", - }, - "Gebruiksvoorwaarden Digikoppeling": { - href: "https://www.logius.nl/diensten/digikoppeling/documentatie/gebruiksvoorwaarden-digikoppeling", - title: - "Gebruiksvoorwaarden Digikoppeling", - date: "1 januari 2021", - publisher: "Logius", - }, - "Algemene Voorwaarden Logius": { - href: "https://www.logius.nl/onze-organisatie/zakendoen-met-logius/voorwaarden/algemene-voorwaarden-logius", - title: - "Algemene voorwaarden Logius", - date: "12 juni 2018", - publisher: "Logius", - }, - "Eisen Pkioverheid": { - href: "https://www.logius.nl/diensten/pkioverheid/aansluiten-als-tsp/pogramma-van-eisen", - title: "Programma van Eisen (PKIoverheid)", - publisher: "Logius", - }, - "PKI PvE": { - href: "https://www.logius.nl/sites/default/files/public/bestanden/diensten/PKIoverheid/PoR-2022/PKIoverheid%20Programme%20of%20Requirements%20v4.10%20-%20Part%203j%20Certificate%20Policy%20for%20Server%20certificates%20in%20Server%202020%20%28EV%20G1%29%20Domain.pdf", - title: "Programma van Eisen Pkioverheid, deel 3j", - publisher: "Logius", - } - } - //format: "markdown", + nl_markdownTableClass: "dkkvs", + previousPublishVersion: "2.0.2", + pubDomain: "dk", + publishDate: "2020-03-31", + publishVersion: "2.0.3", + shortName: "oin", + specStatus: "DEF", + specType: "HR" }; diff --git a/snapshot.html b/snapshot.html index 995fc7c..ba90863 100644 --- a/snapshot.html +++ b/snapshot.html @@ -1,7 +1,7 @@ - +