Changes between Version 4 and Version 5 of Documentatie/Beheerder/Schermen/Instellingen

Timestamp:

Aug 8, 2012 11:28:51 AM (14 years ago)

Author:

adriaan

Comment:

--

Documentatie/Beheerder/Schermen/Instellingen

@@ -68 +68 @@
 Uw adaptatie van OpenAC wordt gestart vanuit een Python-bronbestand {{{__init__.py}}}.  Onder deze
 knop zit een scherm waarin u dit bestand kunt bewerken.
+
+== Proxy-Instellingen ==
+
+(''vanaf [wiki:/Releases/v2.002 versie 2.002]'') 
+
+De proxy-instellingen van verschillende communicatie-onderdelen
+die HTTP of HTTPS gebruiken, kunnen verschillend zijn. Tot v2.000
+was er maar ''een'' HTTP proxy instelling (te vinden in het versie-
+beheerscherm). Die instellingen werden gebruikt voor alle HTTP en
+HTTPS verbindingen en zijn opgeslagen in de twee configuratie-
+variabelen svn_proxy en svn_puserpass. Beide variabelen hebben
+een tweeledige waarde: de svn proxy is een host:port combinatie,
+en puserpass is een username:password combinatie. Voor HTTP proxies
+zijn alle vier waarden nodig.
+
+In v2.002 is het mogelijk om meerdere configuratie-variabelen
+te hebben voor het instellen van HTTP proxies, of om de proxy
+uit te zetten in specifieke gevallen. Elke HTTP verbinding die
+OpenAC maakt zoekt de proxy instellingen op aan de hand van een
+naam. De namen zijn als volgt:
+  - In een kernmodule, `module`.`submodule` of alleen `module`.
+    Voorbeelden zijn `d035_zorgrelatie en e080_vecozo.declaratie.
+  - Losse modules `svn`, `sms`, `fenac` en `trac`.
+Voor elke proxy is het mogelijk om afzonderlijk te configureren
+welke proxy-instellingen gebruikt moeten worden.
+  - De proxy kan uit staan. Dan wordt er geen proxy gebruikt.
+  - De proxy kan in een tweetal configuratie-variabelen staan,
+    in dezelfde stijl als bij svn.
+  - De proxy kan hard-coded in OpenAC ingevoerd zijn.
+  - De proxy kan gebruik maken van de instellingen van een andere
+    proxy.
+Als bij een gegeven proxy-naam geen instellingen zijn gedefinieerd,
+dan worden de instellingen van svn gebruikt, net als in v2.000.
+
+De instellingen worden opgeslagen in logica.configuratie.!ProxyMap.
+De default indeling van de !ProxyMap is om alles door de spelen
+aan de twee svn variabelen, maar de adaptatie kan specifieke
+gevallen aanpassen. Die doe je door bepaalde waarden toe te kennen
+aan de namen in de !ProxyMap, zo:
+  {{{
+  logica.configuratie.ProxyMap[proxynaam] = waarde
+  }}}
+Hierbij is `proxynaam` een string om de proxy-instelling te
+benoemen, zoals `"e080_vecozo.declaratie"`. De waarde kan
+als volgt gekozen worden:
+  - `None`, om `de proxy uit te schakelen.
+  - `("var1","var2")` met de namen van twee configuratie-variabelen
+    waar de instellingen in moeten zitten. Deze moeten dan wel in je
+    `config.tsv` zitten (of in de database van gedeelde variabelen).
+  - `("host",port,"user","pass")` met de vier waarden die gebruikt
+    moeten worden, expliciet uitgeschreven in de code.
+  - `"proxynaam"` de naam van een andere proxy, wiens instellingen
+    gebruikt moeten worden.
+Als een proxy verwijst naar een andere proxy, kan die andere uiteraard
+zelf weer doorverwijzen, tot er een proxy is met eigen (niet-doorverwezen)
+instellingen (desnoods die voor svn).
+
+Proxy-instellingen van een en dezelfde module (zoals `e080_vecozo.declaratie`
+en `e080_vecozo.verzekeringsrecht`) kunnen worden ingesteld op '''module'''
+niveau of op '''submodule''' niveau. De meest specifieke instelling telt,
+dus de proxy-instelling voor `e080_vecozo` wordt gebruikt voor de proxy
+van `e080_vecozo.declaratie` '''alleen''' als er geen eigen instellingen
+zijn voor die submodule.
+
+Hier is een volledig voorbeeld, dat in de `finish()` functie van de eigen adaptatie gezet zou kunnen worden:
+ {{{
+ # Geen proxy voor TRAC
+ logica.configuratie.ProxyMap["trac"] = None
+ # Bevestig wat we over svn weten
+ logica.configuratie.ProxyMap["svn"] = ("svn_proxy","svn_puserpass")
+ # Upload naar FENAC gebruikt de svn instellingen
+ logica.configuratie.ProxyMap["fenac"] = "svn"
+ # De VECOZO (inclusief e080_vecozo.declaratie) gebruikt een vaste proxy
+ logica.configuratie.ProxyMap["e080_vecozo"] = ("proxy.local",8080,"http","geheim")
+ # Behalve verzekeringsrecht, dat gebruikt aparte configuratievariabelen
+ logica.configuratie.ProxyMap["e080_vecozo.verzekeringsrecht"] = ("vecozo_proxy","vecozo_puserpass")
+ }}}
+
+We verwachten dat het meest-gebruikte zal zijn om de proxy uit te schakelen
+voor specifieke verbindingen.
+
+'''NB.''' als proxy-instellingen naar elkaar verwijzen, ontstaat een oneindige loop.
+
+'''NB.''' de proxy instellingen kan je beter niet behandelen als attributen van !ProxyMap,
+maar alleen via de blokhaken zetten en benaderen. Merk op dat wat je er '''uit''' krijgt
+(een vier-tupel met instellingen) niet hetzelfde is als wat je er '''in''' stopt.