Anhänge

Anhang A: Auflistung aller Konfiguration-Schlüssel

Anbei eine vollständige Auflistung aller Konfigurationsparameter. Die Bearbeitung der Konfigurationsparameter kann mit dem Konfigurationstool „vhs.Connect.Configuration.exe“ erfolgen. Die Daten werden in der Datei „vhs.Connect.exe.config“ gespeichert. Sensible Daten wie Passwörter werden verschlüsselt gespeichert.

Buchungsspezifische Optionen (BookingOptions)

Schlüssel	Beschreibung
BankHandlingMode	Verhalten bei Bankkonten: Soll ein neues zusätzliches Bankkonten automatisch als neues Hauptkonto erfasst (Option: OverwriteMain) oder einfach an die Liste der bestehenden Konto angehängt (Option: Append) werden?
BankTransferPaymentMethod	Eintrag für Überweisung in Zahlart, z.B. U
BarredByTeilKz	Kufer: Text in Sperrkennzeichen verursacht Sperre. Ansonsten wird das Feld Anmelde-Sperre verwendet.
BarredCustomersHandlingStrategy	Wie soll mit gesperrten Teilnehmer verfahren werden? Fehler bei Anmeldung oder Anmeldung auf Interessentenliste
BookingNote	Eintrag in das Feld Interne Notiz bei Internetanmeldung. Kann mit {0} auf Tan zugreifen. Bsp: 'Internetanmeldung (Tan={0})'
BookingSource	Eintrag in Feld Anmeldeart, z.B. I oder W für Internet/Web
CheckBarredCustomers	Teilnehmersperre prüfen
DebitPaymentMethod	Eintrag für Lastschrift in Zahlart, z.B. L
DisableDicounts	Sind Ermäßigungen möglich?
DisableWaitingList	Wartelistenbuchung deaktivieren
EpaymentPaymentMethod	Eintrag für E-Payment in Kufer-Feld Zahlart, z.B. L
FallbackPaymentMethod	Standard-Zahlform, die verwendet wird, falls in Internetanmeldung keine Zahlform übergeben wird.
KuferFreeField1Usage	Kufer-Verhalten Zusatzfelder in Belegung: Soll in Feld 1 die Tan oder der Anmeldemodus eingetragen werden?
KuferFreeField2Usage	Kufer-Verhalten Zusatzfelder in Belegung: Soll in Feld 2 die Tan oder der Anmeldemodus eingetragen werden?
KuferFreeField3Usage	Kufer-Verhalten Zusatzfelder in Belegung: Soll in Feld 3 die Tan oder der Anmeldemodus eingetragen werden?
KuferFreeField4Usage	Kufer-Verhalten Zusatzfelder in Belegung: Soll in Feld 4 die Tan oder der Anmeldemodus eingetragen werden?
LockStartedCourses	Sollen begonnene Kurse automatisch auf nicht buchbar gesetzt werden?
NewPersonInternalNote	Text für Interne Notiz bei Neuanlage eines Teilnehmer-Datensatzes
OrderArchiveDirectory	Verzeichnis zum Speichern der Internetanmeldungen
OrderArchivePathStrategy	Wie soll der Unterordner zum Speichern der Internetanmeldungen generiert werden?
OverwriteMainBankAccount	Darf Hauptbank in Teilnehmer-Stammdaten überschrieben werden?
OverwriteMainBillingRecipient	Darf Haupt-Rechnungsempfänger in Teilnehmer-Stammdaten überschrieben werden?
ShouldArchiveOrders	Sollen die Internetanmeldungen im Dateisystem speichert werden?
WaitingListDoesNotBlockFreeSeats	Soll der Kurs trotz vorhandener Warteliste weiterhin über das Internet buchbar sein?
WaitingListOverBookingPeriodExpiredError	Soll bei abgelaufener Anmeldefrist und keinen freien Plätzen die Fehlermeldung 'Ausgebucht' zurückgegben werden? Bei 'False' wird der Fehler 'Anmeldefrist abgelaufen' ausgegeben.

Einstellungen zum Kursexport (ExportOptions)

Schlüssel	Beschreibung
DiffCourseUpdateSchedule	Cron-Ausdruck für differentielles Kurs-Update, z.B. '/5 * * *'=>alle 5 Minuten
DiffExportPackageSize	Anzahl der Kurse pro MQ-Nachricht bei differentiellem Export, z.B. 10.
Enabled	MQ-Export aktivieren
EnableScheduledDiffCourseUpdate	Differentielles Kurs-Update aktivieren
EnableScheduledFullCourseStatusUpdate	Status-Export aktivieren
EnableScheduledFullCourseUpdate	Vollständigen Kurs-Export aktivieren. Legt kompletten Datenbestand auf der Homepage neu an und ist daher vorzugsweise nachts durchzuführen.
ExportMqServer	Abweichender RabbitMQ-Server.
ExportSqlCommandTimeout	Datenbanktimeout für Kursexport-Statements in Sekunden. Standard: 60s
ExportTarget	Eindeutiges lokales Kennzeichen für Kurs-Export. Nur erforderlich, wenn mehrere Dienste mit unterschiedlichen Exportkonfigurationen auf einer Datenbank arbeiten. Bsp.: LIVE=0, PLANUNG=1
FullCourseStatusUpdateSchedule	Cron-Ausdruck für Status-Kurs, z.B. '/5 * * *'=>alle 5 Minuten
FullCourseUpdateSchedule	Cron-Ausdruck für vollständigen Kurs-Export, z.B. '0 2 * * *'=>täglich 2.00 Uhr nachts
FullExportPackageSize	Anzahl der Kurse pro MQ-Nachricht bei vollständigem Export, z.B. 100.
SplitTitleStrategy	Wie soll Titel aus Kufer aufgeplittet werden? Title+Subtitle oder Title+Subtitle+ContentPre
StatusExportPackageSize	Anzahl der Kurse pro MQ-Nachricht bei Status-Export, z.B. 1000.
UploadPassword	Passwort für meinevhs-upload
UploadUserName	Username für meinevhs

Globale Einstellungen (GlobalOptions)

Schlüssel	Beschreibung
CacheExpiryMin	Wie lange sollen Personen- und Kurs-Objekte im Cache gehalten werden (in Minuten)? Bei fehlendem Eintrag wird auf 10 Minuten zurückgefallen.
DefaultCulture	Standart-Werte für Culture überschreiben. Normalerweise wird aktuelle Sprach-Einstellung des Betriebssystems verwendet.
DisableCourseCache	Caching für Kurse deaktivieren. Kurse werden standardmäßig für 10 Minuten im Cache vorgehalten, damit Sie während der Validierung und Buchung im Warenkorb nicht mehrfach neu geladen werden.
DisableErrorsToMq	Soll die automatische Meldung von Fehlern deaktiviert werden?
DisableMailService	Soll der Email-Versand deaktiviert werden? In diesem Fall werden ausgehende Emails zwar zum Versand markiert, aber noch nicht verarbeitet.
DisablePersonCache	Caching für Personendaten deaktivieren. Personendaten werden standardmäßig für 10 Minuten im Cache vorgehalten, damit Sie während der Validierung und Buchung im Warenkorb nicht mehrfach neu geladen werden.
LogErrorsToDb	Sollen alle Fehler in der lokalen Datenbank in der Tabelle ITEM_REQUESTLOGS gespeichert werden? Achtung: Diese Einstellung kann die Größe der Datenbank stark erhöhen.
LogWriteRequestsToDb	Sollen alle schreibenden Anfragen (Anmeldungen, Benutzerdatenänderungen) in der Tabelle ITEM_REQUESTLOGS der lokalen Datenbank protokolliert werden?
SessionExpiryMin	Wie lange sollen Sessions gültig sein (in Minuten)? Bei fehlendem Eintrag wird auf den Standardwert 1 h zurückgefallen.

SEPA-Mandat-Optionen (MandateOptions)

Schlüssel	Beschreibung
AutoCreateMandate	Soll bei fehlendem Lastschriftmandat automatisch ein Sepa-Mandat in der Datenbank für die Internetanmeldung angelegt werden? (None=Nie; OneOff=>Einmaliges Mandat; Recurring=Wiederkehrendes Mandat;)
DontSendMailMandateRequest	Soll eine Mandatsanforderung generiert, aber nicht in einer separaten Email verschickt werden? (Die generierte Mandatsreferenz kann z.B. im Mail-Template der Buchungsbestätigung ausgegeben werden.)
ElicitSepaMandateFromInvoiceRecipient	Soll bei Überweisungen auch eine Lastschriftmandatsanforderung an den Teilnehmer geschickt werden, um den Mandatsbestand aufzubauen?
RequestMandate	Soll bei fehlendem Lastschriftmandat automatisch ein Sepa-Mandat per Mail angefordert werden?

Benachrichtigungsoptionen (NotificationOptions)

Schlüssel	Beschreibung
ArchivePathStrategy	Strategie zur Generierung von Unterordner
ConfirmationMailRecipient	An wen soll Bestätigungsemail verschickt werden: Teilnehmer oder Debitor (Kontoinhaber bei Abbuchung, Rechnungsempfänger bei Überweisung)
CouponDeliveryMode	Sollen die Gutscheine in einer einzelnen Mail ausgeliefert werden?
LissyOleDirUnc	Pfad zu Dateifreigabe für LISSY-OLEDIR
LLDir	Pfad zu Dateifreigabe für Listenverzeichnis. Bei Einsatz von LISSY kann das Standard-Listenverzeichnis verwendet werden.
MailArchiveDirectory	Pfad zum Mail-Archiv
MailNotificationRecipients	Empfänger von Benachrichtigungen
NotifyDepartment	Sollen die Anmelde-Protokolle auch an die Fachbereichsleiter/HPMs gesendet werden? (Achtung: Erfordert Feld Staffer in CourseDetails-Statement))
SendBookingConfirmationAtPayment	Soll die Bestätigungs-Email bei Epayment nach dem Zahlungsprozess geschickt werden?
SendDailyOrderStatistics	Soll täglich eine Mail mit Buchungsstatistiken verschickt werden?
SendMonthlyOrderStatistics	Soll eine monatliche Mail mit Buchungsstatistiken für den Monat verschickt werden?
SendNotificationsToLocalMessageSystem	Sollen den Benachrichtigungen an ein lokales datenbankbasiertes Nachrichtensystem geschickt werden, z.B. LISSY-Wiedervorlage?
SendNotificationsToLocalMessageSystemMatchPattern	Welche Nachrichten sollen an das lokale Nachrichtensystem verschickt werden? Bsp.: '.' => alle, 'error.' => nur Fehler
SendPaymentReminder	Soll bei Epayment eine Zahlungserinnerung verschickt werden?
SendPaymentReminderDelayMin	Nach wie vielen Minuten soll bei Epayment eine Zahlungserinnerung geschickt werden?
SendWeeklyOrderStatistics	Soll wöchentlich eine tägliche Mail mit Buchungsstatistiken für die Woche verschickt werden?
ShouldArchiveMails	Sollen alle Email im Verzeichnis MailsArchive archiviert werden
ShouldSendConfirmationMail	Soll bei erfolgreicher Anmeldung Bestätigungsmail an Teilnehmer verschickt werden?
ShouldSendEpaymentConfirmationMail	Soll bei erfolgreichem Epayment eine Zahlungsbestätigung per Email an den Teilnehmer geschickt werden?
SuppressReservationConfirmationMail	Soll die Bestätigungs-Email nach einer Reservierungsbestätigung unterdrückt werden?
SuppressReservationRequestMail	Soll die Bestätigungs-Email nach einer Reservierungsanfrage unterdrückt werden?

Pop3-Importoptionen (Pop3LegacyImportOrderOptions)

Achtung: Der Support für den POP3-Import aus LISSY.Web/CMX läuft aus.

Schlüssel	Beschreibung
Enabled	Soll der Email-Import aktiviert werden? Achtung: Diese Einstellung ist nur beim Import aus LISSY.Web oder CMS-Systemen notwendig.
Password	Passwort
PollingIntervalMin	Intervall in Minuten, mit dem Nachrichten von Pop3-Account abgeholten werden.
Port	Port
Server	Pop3-Server
Timeout	Timeout
User	Benutzername
UseSSL	SSL

RabbitMQ-Einstellungen (Pop3LegacyImportOrderOptions)

Schlüssel	Beschreibung
ConnectionTimeout	Timeout für Verbindung zu MQ-Server.
EnableSSL	Soll SSL aktiviert werden?
HeartBeatInterval	HeartbeatInterval in Sekunden. Empfohlen: 60 s. Verhindert, dass Firewall die TCP-Verbindung zum RabbitMQ-Server kappt.
Host	IP/Hostname des MQ-Servers
Password	Passwort für Zugriff auf MQ-Server
Port	Port
ProxyHost	IP/Hostname des Http-Proxyservers.
ProxyPassword	Passwort zur Anmeldung an Http-Proxyserver.
ProxyPort	Port des Http-Proxyserver, z.B. 8080.
ProxyUsername	Benutzername zur Anmeldung an Http-Proxyserver.
SSLServerName	CommonName von SSL-Zertifikat
Username	Benutzername für Zugriff auf MQ-Server, z.B. 'Bildungseinrichtung-demohausen'
VirtualHost	Name des virtuellen Hosts, z.B. 'Bildungseinrichtung-demohausen'

Suchoptionen (SearchOptions)

Schlüssel	Beschreibung
ExcludeLoginsFromSearch	Sollen vorhandene Login-Datensätze von der automatischen Dubletten-Zusammenführung bei der Gastanmeldung ausgeschlossen werden?
FindBankThreshold	Ab diesem Wert (0-100%) wird von einer übereinstimmenden Bankverbindung ausgegangen. (Standard=80%)
FindPersonThreshold	Ab diesem Wert (0-100%) wird von einem übereinstimmenden Personendatensatz ausgegangen. (Standard=80%)
NoSearch	Soll keine automatische Suche und Zusammenführung bei Gastanmeldungen durchgeführt werden?

SMTP-Einstellungen (SmtpConfig)

Schlüssel	Beschreibung
Password	Passwort
Port	Port
Server	IP/Hostname von SMTP-Server
Timeout	Timeout
User	Benutzer
UseSSL	SSL verwenden. Muss von Mail-Server unterstützt werden

Kursverwaltungsprogramm-Optionen (TargetSystemConfig)

Schlüssel	Beschreibung
ConnectionString	ConnectionString zur Datenbank des Verwaltungsprogramms
DbType	Welches DBMS wird verwendet? MSSQL / ORACLE
GlobalSqlCommandTimeout	Globaler Command-Timeout in Sekunden (Standard: 30s)
MaxDbTransactionScope	Maximale mögliche Stufe für Datenbank-Transaktion.
	Lokal (Standard):
	Bei Lokal werden kleinere Gruppen von zusammengehörigen SQL-Statements innerhalb einer Transaktion ausgeführt.
	Global:
	Bei Global wird die gesamte Anmeldung innerhalb einer Transaktion durchgeführt. Dies kann die Entstehung von Dead-Locks zwischen itm:CONNECT und dem Kursverwaltungsprogramm begünstigen und ist daher nur zu Testzwecken zu verwenden.
TargetType	Welcher Typ von Verwaltungsprogramm wird verwendet? KUFER / LISSY
UserId	Benutzerkennung in Kufer, unter der Webservice operieren soll.

Einstellung zu Benutzerportal (UserAccountOptions)

Schlüssel	Beschreibung
AuthenticateByBvvInfo	Sollen die Benutzer über BVV-Infosystem authentifiziert werden?
AuthenticateByBvvInfoUri	URI für Webservice zur Authentifizierung von BVV-Benutzern.
GuestUserMarker	Sollen durch Gastanmeldung angelegte neue Teilnehmerdatensätze ein Kennzeichen erhalten? Die zugehörige Kennzeichen-Nummer aus Kufer muss hier eingetragen werden.
OrderRetentionYears	Wie viele Jahre darf die Anmeldehistorie im Benutzerprofil zurückgehen?
PromotionalUseStrategy	LISSY-spezifisch: Sollen die Kommunikationsdatensätze automatisch zur öffentlichen Verwendung freigegeben werden? (Mit der Option 'Disabled' wird die Verwendung grundsätzlich blockiert. Die Option 'None' übernimmt die von der Homepage übergebenen Werte.)
WebLoginMarker	Sollen neue WEB-Login-Teilnehmerdatensätze ein Kennzeichen erhalten? Die zugehörige Kennzeichen-Nummer aus Kufer muss hier eingetragen werden.

Anhang B: Netzplan (Skizze)

Anhang C: Abkürzungen

Übersicht der verwendeten Abkürzungen im Handbuch und deren Bedeutung:

DBMS: Datenbank-Management-System, derzeit: MS SQL Server, Oracle