Verschillen
Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.
| Volgende revisie | Vorige revisie | ||
| openwave:1.31:applicatiebeheer:instellen_inrichten:rest_flexfuncties [2024/11/07 14:53] – aangemaakt - Externe bewerking 127.0.0.1 | openwave:1.31:applicatiebeheer:instellen_inrichten:rest_flexfuncties [Ongeldige datum] (huidige) – Externe bewerking (Ongeldige datum) 127.0.0.1 | ||
|---|---|---|---|
| Regel 1: | Regel 1: | ||
| + | ====== REST Flexfuncties ====== | ||
| + | Portal beheerportaal-Nieuw. Tegel //Rest Flexfuncties// | ||
| + | |||
| + | Screenidentifiers (beheertegel // | ||
| + | * MDLC_getRestflexfunctiesList.xml | ||
| + | * MDDC_getRestflexfunctiesDetail.xml | ||
| + | * MDWC_insertTbRestflexfuncties.xml | ||
| + | |||
| + | Tabel: tbrestflexfuncties. | ||
| + | |||
| + | ===== Omschrijving ===== | ||
| + | In deze tabel kunnen bestaande API's van lijst- en detailschermen en wizards worden benoemd die via de OpenWave REST-service door een derde partij - veilig - kunnen worden aangeroepen. | ||
| + | |||
| + | ==== Aanroep van REST-service door derde partij ==== | ||
| + | Bijvoorbeeld: | ||
| + | REST-rommeldam.open-wave.nl/ | ||
| + | |||
| + | Hierbij is // | ||
| + | De OpenWave REST-service moet apart geïnstalleerd worden naast de OpenWave-applicatie. | ||
| + | |||
| + | ==== REST-service -> API translateRestCall ==== | ||
| + | De tabel tbrestflexfuncties wordt geraadpleegd door de OpenWave API: // | ||
| + | |||
| + | Deze API wordt door de OpenWave REST-service aangeroepen met de REST-functienaam (paramcode) en een of meer argumenten (paramparameters). Deze functienaam en argumenten komen uit de aanroep waarmee de OpenWave REST-service door een derde partij wordt benaderd, zoals in bovenstaand aanroepvoorbeeld. | ||
| + | |||
| + | De API zoekt op basis van die argumenten een kaart in de tabel tbrestflexfuncties alwaar verwezen wordt naar een bepaalde flexlijst of flexdetail of flexwizard van OpenWave, waarbij de substrings {arg1}, (arg2), {argn} vervangen worden door de argumenten van de API-aanroep. | ||
| + | |||
| + | De API retourneert deze aanroep naar de gevonden flexdetail, flexwizard of flexlijst - met de juiste parameters - als string naar de OpenWave REST-service. De REST-service roept vervolgens de betreffende flexlist-API, | ||
| + | |||
| + | Deze derde partij moet de xml met scherm- en data-informatie zelf renderen naar een webpagina. | ||
| + | |||
| + | ==== Rendering door derde partij naar webpagina ==== | ||
| + | De OpenWave REST-functies retourneren een xml met daarin de gevraagde data, maar waarin ook een representatie van een lijst, of van een detailscherm of een wizardscherm. Voor elke wizard, lijst of detail is de opbouw van de xml gelijk. Er is in elk geval een blok metadata met de gewenste schermopbouwinformatie, | ||
| + | |||
| + | |||
| + | ==== Authenticatie ==== | ||
| + | Bij de installatie van de OpenWave REST-service wordt naam en pass afgesproken waarmee de REST-service de OpenWave API's kan aanroepen. | ||
| + | De naam en het wachtwoord zullen ook in de medewerkerstabel moeten zijn opgenomen en de vereiste rechten zullen aan die robotmedewerker moeten worden toegekend. | ||
| + | |||
| + | Voor de buitenwereld is het wachtwoord dat de REST-service gebruikt NIET zichtbaar. | ||
| + | |||
| + | ==== Parameters ==== | ||
| + | De API translateRestCall wordt door OpenWave REST-service aangeroepen met de volgende parameters: | ||
| + | * paramsessie (deze wordt verkregen door de aanroep van getauthenticatie (door de REST-service) op basis van afgesproken naam en wachtwoord) | ||
| + | * paramretourformaat (XML) | ||
| + | * paramcode. Dit is de REST-functienaam. De waarde van deze parameter wordt opgezocht in de tabel tbrestflexfuncties in de kolom dvcode | ||
| + | * paramparameters. Dit is een string van een of meer argumenten. De substrings {arg1}, {arg2} {argn} die voorkomen in de kolom dvaanroep van de gevonden kaart in tbrestflexfuncties worden vervangen met de waarde van de argumenten ({arg1} met het eerste, {arg2} met de tweede enz.). | ||
| + | |||
| + | Het kan zijn dat een of meer argumenten gecrypt zijn doorgegeven. In dat geval moet in de kolom dvaanroep van tbrestflexfuncties het betreffende argument worden genoteerd als {strdecrypt(argn)}. | ||
| + | Een voorbeeld is het gecrypt uitgeven van een identifier van de omgevingszaak in een ontvangstbevestiging wanneer in het sjabloon de tekst //< | ||
| + | |||
| + | ===== Uitgewerkt voorbeeld Track and Trace ===== | ||
| + | Een aanvrager kan via een ontvangstbevestiging een track and trace link krijgen. Deze link zal uit drie delen bestaan: | ||
| + | * De URL van de derde partij. Bijvoorbeeld: | ||
| + | * Als het om een omgevingsvergunning gaat, de code: TrackNTraceOmgBasis/ | ||
| + | * De geëncrypte key van de gevraagde omgevingszaak (zie [[openwave: | ||
| + | Dit maakt dat de link die bijgeleverd wordt in de brief naar de aanvrager er als volgt uit zal zien: | ||
| + | REST-rommeldam.open-wave.nl/ | ||
| + | |||
| + | Een derde partij maakt een webpagina waarmee op basis van deze link de stand van zaken met betrekking tot de behandeling van deze zaak getoond wordt. | ||
| + | |||
| + | Deze derde partij moet informatie halen uit de OpenWave database en wel: informatie van de basiskaart (detailscherm informatie), | ||
| + | |||
| + | Zij roept daartoe DRIE maal de OpenWave REST-service aan: | ||
| + | * REST-rommeldam.open-wave.nl/ | ||
| + | * REST-rommeldam.open-wave.nl/ | ||
| + | * REST-rommeldam.open-wave.nl/ | ||
| + | |||
| + | In de JSON-resultaat set van de eerste detail-aanroep is de plek opgenomen waar de twee lijsten op de webpagina geplaatst moeten worden (zie verderop). | ||
| + | |||
| + | Bij de installatie van de REST-service is afgesproken onder welke naam en wachtwoord de OpenWave API's door de REST-Service worden aangeroepen. | ||
| + | |||
| + | De applicatiebeheerder van OpenWave moet nu het volgende doen: | ||
| + | * een robotmedewerker aanmaken met een afgesproken naam en wachtwoord en deze net voldoende functionele rechten geven om de gevraagde informatie te lezen. De robot in dit voorbeeld zal daartoe deel uit moeten maken van een rechtengroep (bijv. Robots) die de module kijkrechten heeft op Omgevingszaken en daarbinnen de vinkjes // | ||
| + | Verder moet deze robotmedewerker in de medewerkerstabel: | ||
| + | * een interne medewerker zijn; | ||
| + | * EN toegang moet hebben tot de browserversie | ||
| + | * EN //Voor deze medewerker is geen 2-factor authentication nodig// is aangevinkt; | ||
| + | * EN //Het password van deze medewerker verloopt nooit// is aangevinkt; | ||
| + | * EN //Deze medewerker hoeft geen loginverklaring af te vinken// is aangevinkt. | ||
| + | Vervolgens moet de applicatiebeheerder: | ||
| + | * in de tabel tbrestflexfuncties drie kaarten aanmaken met de gevraagde REST-functies (de namen van die functies zijn vrij voor de applicatiebeheerder in zoverre dat zij overeen moeten komen met de REST aanroepen van de derde partij) | ||
| + | * een kaart met dvcode = // | ||
| + | * een kaart met dvcode = // | ||
| + | * een kaart met dvcode = // | ||
| + | |||
| + | In bovenstaand voorbeeld wordt met getflexdetail(sysstandardetail, | ||
| + | En zo wordt ook verwezen naar een kaart in tbsysstandardtable met dvcode = // | ||
| + | En zo wordt ook verwezen naar een kaart in tbsysstandardtable met dvcode = // | ||
| + | |||
| + | De applicatiebeheerder gaat in sysstandardtable zelf bepalen welke track en trace data worden opgehaald. En de applicatiebeheerder gaat ook de schermlayout definiëren waarin deze track and trace kunnen worden getoond. | ||
| + | |||
| + | ==== Detailgegevens van de omgevingszaak ===== | ||
| + | De applicatiebeheerder zal als volgt een sysstandardtable kaart aanmaken voor tonen van de detailgegevens van de omgevingszaak: | ||
| + | * **Code**: | ||
| + | * **Hoofdtabel of viewnaam**: vwfrmomgvergunningen | ||
| + | * **Kolomnaam van de primary key**: dnkeyomgvergunning | ||
| + | * **Tabelnaam waarop hoofdtabel/ | ||
| + | * **Schermidentifier voor detail**: MDDC_getTrackNTrace_OmgDetail.xml | ||
| + | * **Tbqueries.dvcode voor kijkrechten**: | ||
| + | De overige kolommen van deze kaart kunnen leeg blijven. | ||
| + | |||
| + | De API getflexdetail zal de data van de kaart ophalen uit vwfrmomgvergunningen where dnkeyomgvergunning = strdecrypt(arg1)} (dus in ons voorbeeld strdecrypt(02_RT125678J)). | ||
| + | |||
| + | Daartoe wordt eerst een rechtencheck gedaan door het statement uit tbqueries (beheerportaal-Nieuw) met dvcode = // | ||
| + | |||
| + | <code sql> | ||
| + | select case when a.dlaomgvsb = ' | ||
| + | then ' | ||
| + | from tbomgrechten b inner join tbrechten a | ||
| + | on (a.dnkey = b.dnkeyrechten) | ||
| + | where b.dnkeyrechten = | ||
| + | (select dnkeyrechten from tbmedewerkers where trim(dvcode) = trim(: | ||
| + | </ | ||
| + | De (robot)loginnaam die de REST-service gebruikt moet dus zowel het kijkrecht op omgevingszaken hebben, als het kijkrecht op adviezen bij een omgevingszaak als het kijkrecht op processtappen bij een omgevingszaak. | ||
| + | |||
| + | Met de schermidentifier voor detail wordt verwezen naar een kaart in tbscreencolumns (beheertegel // | ||
| + | tabellen standaard-api// | ||
| + | * klasse: sysStandard | ||
| + | * API: getSysStandardDetail | ||
| + | * view/tabel: vwfrmomgvergunningen | ||
| + | * identifier scherm: xml-filename : MDDC_getTrackNTrace_OmgDetail.xml | ||
| + | * kopegel1: select dvobjadres | | dvobjplaats from vwfrmomgvergunningen where dnkeyomgvergunning = {id} | ||
| + | In de kolom // | ||
| + | |||
| + | Een zeer karig voorbeeld: | ||
| + | |||
| + | <code xml> | ||
| + | <?xml version=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | </ | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | Met de blokken label // | ||
| + | |||
| + | De API getflexdetail maakt een xml met data en metadata op basis van de bovenstaande schermlayout en de gegevens van de gewenste kaart van vwfrmomgvergunningen. De REST-service stuurt deze informatie naar de derde partij die vervolgens de twee vervolgaanroepen doet naar de REST-service. | ||
| + | |||
| + | De REST-functies aanroepen voor de twee lijsten hebben een parameter die hier in de blokken gevuld worden met de waarde van de dnkey van de omgevingszaak waar de adviezen en termijnstappen aan zijn verbonden (dat doet de variabele %keypointer%). De {arg1} bij de definitie van de RestFlex-functies wordt hiermee gevuld bij uitvoering. | ||
| + | |||
| + | ==== Adviezenlijst bij een omgevingszaak ==== | ||
| + | De applicatiebeheerder zal als volgt een sysstandardtable kaart aanmaken voor tonen van de lijstgegevens van de adviezen bij een omgevingszaak: | ||
| + | * **Code**: TrackNTrace_AdviezenOmg | ||
| + | * **Hoofdtabel of viewnaam**: vwfrmadviezen | ||
| + | * **Kolomnaam van de primary key**: dnadvkey | ||
| + | * **Tabelnaam waarop hoofdtabel/ | ||
| + | * **Kolomnaam foreign key uit deze achterliggende tabel**: dnkeyomgvergunningen | ||
| + | * **Kolomnaam foreign key (uit hoofdtabel/ | ||
| + | * **Parenttabelnaam**: | ||
| + | * **Schermidentifier voor detail**: MDLC_getTrackNTrace_AdviezenOmgList.xml | ||
| + | * **Tbqueries.dvcode voor lijst**: omgeving_trackntrace | ||
| + | * ** where clausule bij lijst**: ddvervallen is null | ||
| + | De overige kolommen van deze kaart kunnen leeg blijven. | ||
| + | |||
| + | De API getflexlist zal de data van de advieskaarten ophalen uit vwfrmadviezen where dnkeyomgvergunningen = {arg1} (dus in ons voorbeeld bijv. 2345 (de %keypointer%)). Hierbij worden alleen de kaarten met ddvervallen is null meegenomen. | ||
| + | |||
| + | Allereerst wordt een rechtencheck gedaan door het statement uit tbqueries (beheerportaal-Nieuw) met dvcode = // | ||
| + | |||
| + | Met de schermidentifier voor lijst wordt verwezen naar een kaart in tbscreencolumns (beheertegel // | ||
| + | tabellen standaard-api// | ||
| + | * klasse: sysStandard | ||
| + | * API: getSysStandardList | ||
| + | * view/tabel: vwfrmadviezen | ||
| + | * identifier scherm: xml-filename: | ||
| + | * default sortering: ddadvaanvraag, | ||
| + | In de kolom // | ||
| + | |||
| + | Een voorbeeld: | ||
| + | |||
| + | <code xml> | ||
| + | < | ||
| + | < | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | ==== Processtappenlijst bij een omgevingszaak ==== | ||
| + | De applicatiebeheerder zal als volgt een sysstandardtable kaart aanmaken voor de lijstgegevens van de processtappen bij een omgevingszaak: | ||
| + | * **Code**: TrackNTrace_ProcesstappenOmg | ||
| + | * **Hoofdtabel of viewnaam**: vwfrmtermijnbewstappen | ||
| + | * **Kolomnaam van de primary key**: dnkey | ||
| + | * **Tabelnaam waarop hoofdtabel/ | ||
| + | * **Kolomnaam foreign key uit deze achterliggende tabel**: dnkeyomgvergunningen | ||
| + | * **Kolomnaam foreign key (uit hoofdtabel/ | ||
| + | * **Parenttabelnaam**: | ||
| + | * **Schermidentifier voor detail**: MDLC_getTrackNTrace_ProcesstappenOmgList.xml | ||
| + | * **Tbqueries.dvcode voor lijst**: omgeving_trackntrace | ||
| + | * ** where clausule bij lijst**: dlingebruik = ' | ||
| + | De overige kolommen van deze kaart kunnen leeg blijven. | ||
| + | |||
| + | De API getflexlist zal de data van de processtappen ophalen uit vwfrmtermijnbewstappen where dnkeyomgvergunningen = {arg1} (dus in ons voorbeeld bijv. 2345 (de %keypointer%)). Hierbij worden alleen de kaarten met dlingebruik = ' | ||
| + | |||
| + | Allereerst wordt een rechtencheck gedaan door het statement uit tbqueries (beheerportaal-Nieuw) met dvcode = // | ||
| + | |||
| + | Met de schermidentifier voor lijst wordt verwezen naar een kaart in tbscreencolumns (beheertegel // | ||
| + | tabellen standaard-api// | ||
| + | * klasse: sysStandard | ||
| + | * API: getSysStandardList | ||
| + | * view/tabel: vwfrmtermijnbewstappen | ||
| + | * identifier scherm: xml-filename : MDLC_getTrackNTrace_ProcesstappenOmgList.xml | ||
| + | * default sortering: dntrmvolgnr | ||
| + | In de kolom // | ||
| + | |||
| + | Een voorbeeld: | ||
| + | |||
| + | <code xml> | ||
| + | <?xml version=" | ||
| + | < | ||
| + | < | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | <column tagnaam=" | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||