Konfigurationsdateien

Nahezu alle Einstellungen, die im succest Testcase Repository (TCR) vorgenommen werden können, müssen in bestimmten Konfigurationsdateien vorgenommen werden. Die Konfigurationsdateien befinden sich in einem Ordner innerhalb des Storage des TCR. Den genauen Ablageort können Sie der Einstellung ConfigurationFolder der web.config entnehmen.

Wann werden Konfigurationsdateien wie verändert?

Die Konfigurationsdateien werden üblicherweise im Zuge der Installation von succest erstellt und konfiguriert. In der Regel finden nach der Erstinstallation kaum noch Änderungen an den Konfigurationsdateien statt. Sie können - unabhängig davon, dass es im TCR teilweise Oberflächen zum Pflegen bestimmter Einstellungen gibt - am Server über Texteditoren bearbeitet werden und müssen wohlgeformte XML Dateien sein. Bitte beachten Sie in jedem Fall diese Regeln für wohlgeformtes XML. Besonders beim Verwenden von Passwörtern in den Konfigurationsdateien kommt es oft zu Situationen in denen die Passworte bspw. ein "&" als Sonderzeichen im Passwort enthalten. Wird dies wirklich als "&" (statt als &) im Passwort eingegeben, ist die Konfigurationsdatei nicht mehr lesbar.

Verschlüsseln von sensitiven Einträgen

Die Konfigurationsdateien werden auch benutzt, um Verbindungen zu Um-Systemen zu beschreiben. Beispielweise können LDAP Server oder Versionsverwaltungssysteme (wie bspw. Subversion oder GIT) an succest angebunden werden. Im Regelfall werden zum Aufbau der Verbindungen zu diesen Um-Systemen Zugangsdaten (Benutzername und Kennwort) benötigt. Um diese sicher ablegen zu können, können beliebige Elemente in den Konfigurationsdateien mit dem Attribut Encrypt="true" versehen werden. Wenn succest eine Konfigurationsdatei einliest und auf einen Tag mit diesem Attribut stößt, prüft succest ob der Textknoten des Elements verschlüsselt ist. Ist dies nicht der Fall, verschlüsselt succest den Textkonten und speichert die Konfigurationsdatei wieder ab. Zur Verschlüsselung nutzt succest Microsoft's DPAPI. So ist sichergestellt, dass die Konfigurationsdateien nur von succest und nur auf der Maschine auf der sie verschlüsselt wurden, wieder entschlüsselt werden können. Werte ver- und entschlüsseln kann man mit Hilfe eines kleinen mitgelieferten Tools.

Sonderzeichen in Einträgen

Wie oben erwähnt, ist es unbedingt erforderlich, dass die Konfigurationsdateien wohlgeformt sind. Nur manchmal ist es nötig Zeichen zu verwenden, die sich nicht direkt eintragen lassen: ", ', &, < und > Sie können Daten mit diesen Sonderzeichen entweder richtig kodieren oder den entsprechenden Wert in CDATA einfassen und das Element mit dem Attribute AsCdata="true" versehen. Vergessen Sie das Attribut, wird der Wert beim nächsten automatischen Rausschreiben nicht in CDATA eingefasst und kann zu ungültigem XML führen. Die Kodierungen der einzelnen Zeichen sind wie folgt:

Zeichen	Kodiert
&	&
"	"
'	'
<	&lt;
>	&gt;

Welche Konfigurationsdateien gibt es?

• AlConfiguration
• AlmTestExecuterParametersConfiguration
• ApplicationConfiguration
• AuthenticationServiceConfiguration
• CentralComponentsConfiguration
• ClientConfigConfiguration
• CodeItemsConfiguration
• DatasourceConfiguration
• DestinationsConfiguration
• ExportFileConfiguration
• HpAlmConfiguration
• KioskConfiguration
• LoadingSystemConfiguration
• LogConfiguration
• LogViewConfiguration
• MailerConfiguration
• OperationQueueConfiguration
• PoolConfiguration
• ReportXsltConfiguration
• SapXsltConfiguration
• SchedulerConfiguration
• TestcaseConfiguration
• TextTemplateConfiguration
• UserSettingsConfiguration
• VersionSystemConfiguration
• WorkflowConfiguration