regain manual

**Dies ist eine alte Version des Dokuments!** ----

= Howto: Wiederverwendbare Zeichenfolgen(Entities) in *.xml-Dateien = ==wiederverwendbare Zeichenfolgen(Entities) in *.xml-Dateien== ;Einführungsbeispiel:Wenn mehrere Indexe in der Datei ''SearchConfiguration.xml'' eingebunden und in einem Ordner gespeichert sind, z.B. ''C:/Tomcat 5.0/webapps/regain/WEB-INF'' dann ist es sinnvoll, am Anfang der SearchConfiguration.xml unter der Zeile <!ENTITY lt ...> eine Zeile ''<!ENTITY <span style="color:green">indexPfad</span> "C:\Tomcat 5.0\webapps\regain\WEB-INF">'' einzufügen. Dann können Sie an Stelle <dir>C:/Tomcat 5.0/webapps/regain/WEB-INF/MySearchindex</dir> einfach ''<dir><span style="color:green">&indexPfad;</span>/MySearchindex</dir>'' schreiben. Diese Schreibweise macht den Quelltext der SearchConfiguration.xml übersichtlicher und die Änderungen von Pfadangaben für die Indexe bei der Migration von regain, z.B. aus einer Entwicklungs- in die produktive Umgebung können dann durch Änderung des Werts ''indexPfad'' an einer Stelle gemacht werden. Gebnauso können Sie vorgehen bei der Definition von <prefix>-Werten in <whitelist> und <blacklist> in der ''CrawlerConfiguration.xml''. ;Entities als Parameter in XML-Elementen einsetzen:Wenn man solche Entities in der Datei ''CrawlerConfiguration.xml'' definiert ''<!ENTITY <span style="color:green">prefix1</span> "file://C:/wwwroot/">'' ''<!ENTITY replacement1</span> "http://meinServer.de/">'' dann ist auch diese platz- und zeitsparende Schreibweise bei der Definition von ''rewriteRules'' zulässig: ''<rewriteRules> <rule prefix='<span style="color:green">&prefix1;</span>' replacement='<span style="color:green">&replacement1;</span>'/> </rewriteRules>'' ;komplette XML-Elemente als Entities:Solche Entity-Definition ''<!ENTITY <span style="color:#ff9900">rewriteRules1</span> "<rewriteRules><rule prefix='file://C:/wwwroot/' replacement='&replacement1;'/></rewriteRules>"> '' ist auch zulässig. Sie ist sinnvoll, wenn die ''rewriteRules''-Werte für mehrere Suchindexe identisch sind. Dann kann man nach der Definition der ''rewriteRules1''-Entity alle Abschnitte ''<rewriteRules><rule prefix='file://C:/wwwroot/' replacement='http://meinServer.de/' /></rewriteRules>'' durch ein Entity-Element <span style="color:#ff9900">&rewriteRules1;</span> ersetzen ;-) ;verschachtelte Entities: Das Beispiel ist selbsterklärend, nehme ich an ''<!ENTITY <span style="color:#ff9900">rewriteRules1</span> "<rewriteRules><rule prefix='<span style="color:green">&prefix1;</span>' replacement='<span style="color:green">&replacement1;</span>'/></rewriteRules>">'' Also man darf Entities in Entities verwenden. ;siehe [[CrawlerConfiguration.xml]], [[SearchConfiguration.xml]], [[DesktopConfiguration.xml]] u. [[Build.xml%2C_die_im_regain-Projekt_eingesetzt_wird|Build.xml]]