Added description for loading templates from

the config file.


git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@637 d688527b-c9ab-4aba-bd8d-4036d912da1d

1 files changed, 61 insertions, 0 deletions

diff --git a/id.server/doc/moa_id/id-admin_2.htm b/id.server/doc/moa_id/id-admin_2.htm
index 3d58f86cb..8ce11705d 100644
--- a/id.server/doc/moa_id/id-admin_2.htm
+++ b/id.server/doc/moa_id/id-admin_2.htm
@@ -199,6 +199,53 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
                   Verbindung zum Auswahldienst (siehe <a href="#ConnectionParameter"><tt>ConnectionParameter</tt></a>),
                   jedoch kann das Kind-Element <tt>ClientKeyStore</tt> nicht angegeben
                   werden. </p>
+                <div id="AuthTemplates" />
+                  <p id="block"> <b>AuthComponent/Templates</b> <br />                  
+                Das optionale Element <tt>Templates</tt> kann genau einmal vorkommen, um
+                das Aussehen der Seiten &quot;Auswahl der B&uuml;rgerkartenumgebung&quot; sowie
+                &quot;Anmeldung mit B&uuml;rgerkarte&quot; anzupassen. Die hier
+                spezifizierten (globalen) Templates haben Priorit&auml;t gegen&uuml;ber Templates,
+                die in der aufrufenden URL (vgl. <a href="id-anwendung_1.htm" target="_new">Aufruf von MOA-ID-AUTH</a>) 
+                &uuml;bergeben werden, haben jedoch Nachrang gegen&uuml;ber in
+                der Konfigurationsdatei f&uuml;r eine Online-Applikation individuell definierte (lokale)
+                Templates (siehe <a href="#OnlineApplication/AuthComponent/Templates" target="_new">
+                OnlineApplication/AuthComponent/Templates</a>).
+                Das heißt, sind in der Konfigurationsddatei f&uuml;r eine Online-Applikation lokale
+                Templates definiert (Element <tt>OnlineApplication/AuthComponent/Templates</tt>), so werden 
+                die als global spezifizierten Templates (<tt>AuthComponent/Templates</tt>) f&uuml;r diese
+                OnlineApplikation ignoriert, jedoch f&uuml;r alle anderen Online-Applikationen
+                verwendet. Templates in der aufrufenden URL werden demnach nur mehr dann
+                herangezogen, wenn in der Konfigurationsdatei weder globale (f&uuml;r alle
+                Online-Applikationen g&uuml;ltig) noch lokale (Templates je Online-Applikation)
+                spezifiziert sind.<br>
+                Das <tt>Templates</tt>-Element hat die zwei Kindelemente
+                <tt>BKUSelectionTemplate</tt> und <tt>Template</tt>. Jedes dieser
+                beiden Elemente kann genau einmal vorkommen oder fehlen.
+                Das Kindelement <tt>BKUSelectionTemplate</tt> spezifiziert ein Template  
+                zur Gestaltung der Seite &quot;Auswahl der B&uuml;rgerkartenumgebung&quot;,
+                während das Kindelement <tt>Template</tt> die Seite
+                &quot;Anmeldung mit B&uuml;rgerkarte&quot; referenziert.
+                Beide Elemente haben genau ein Attribut namens <tt>URL</tt>,
+                das die Lage des Templates im Form einer URL beschreibt.
+                Relative Pfadangaben werden dabei relativ zum Verzeichnis, in dem sich die 
+                MOA-ID Konfigurationsdatei befindet, interpretiert.<br>
+                Im folgenden Beispiel werden zwei Templates im Verzeichnis 
+                CATALINA_HOME/conf/moa-id/templates referenziert:
+                <br>
+                <pre>
+&lt;Templates&gt;
+  &lt;BKUSelectionTemplate URL="templates/SampleBKUSelectionTemplate.html"/&gt;
+  &lt;Template URL="templates/SampleTemplate.html"/&gt;
+&lt;/Templates&gt;</pre>
+                
+                <br>
+                Richtlinien zur Struktur der beiden Templates k&ouml;nnen der 
+                MOA-ID-Spezifikation bzw. dem Abschnitt 
+                <a href="id-anwendung_1.htm" target="_new">Aufruf von MOA-ID-AUTH</a>
+                dieses Handbuches entnommen werden.
+                  
+                  </p>
+                  </div>
                 <div id="SecurityLayer" />
                   <p id="block"> <b>AuthComponent/SecurityLayer</b> <br />
                     Das Element <tt>SecurityLayer</tt> enth&auml;lt Parameter
@@ -454,6 +501,19 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
                               Namespace verwendet werden sollen. Das Element <tt>AnyNumber</tt> wurde haupts&auml;chlich in
                               das Schema aufgenommen, um offen f&uuml;r m&ouml;gliche Erweiterungen zu sein.
                             </p>
+                            <div id="OnlineApplication/AuthComponent/Templates" />
+                            <p id="block"> <b>OnlineApplication/AuthComponent/Templates</b>
+                              <br />
+                            Dieses Kindelement kann genau einmal vorkommen und entspricht in seiner Struktur dem
+                            Element <a href="#AuthTemplates" target="_new">AuthComponent/Templates</a>.
+                            Es kann verwendet werden, um Templates zur Gestaltung der Seiten 
+                            &quot;Auswahl der B&uuml;rgerkartenumgebung&quot; sowie
+                			&quot;Anmeldung mit B&uuml;rgerkarte&quot; individuell f&uuml;r 
+                            eine Online-Applikation zu definieren. Die hier definierten Templates haben
+                            Priorit&auml;t gegen&uuml;ber globalen Templates und Templates, die
+                            in der aufrufenden URL &uuml;bergeben werden.
+                            </p>
+                            </div>
 
                             <div id="OnlineApplication/AuthComponent/TransformsInfo" />
                             <p id="block"> <b>OnlineApplication/AuthComponent/TransformsInfo</b>
@@ -477,6 +537,7 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
                             ein entsprechendes <tt>MOA-SP/VerifyAuthBlock/VerifyTransformsInfoProfileID</tt>
                             Element vorhanden sein muss.</p>
                             </p>
+                            </div>
 
                             <div id="OnlineApplication/ProxyComponent" />
                               <p id="block"> <b>OnlineApplication/ProxyComponent</b>