CGI-Script

Anforderungen

WebServer - Mindestvoraussetzungen

• Beliebiger Webserver mit Perl 5.x
• Das Recht eigene Scripts zu verwenden
• FTP-Zugang

Script-Dateien

Vorlagedateien übertragen

Für die CGI-Vorlagen muss auf dem Webserver ein beliebiges Verzeichnis angelegt werden. Die CGI-Vorlagen werden in dieses Verzeichnis mit einem beliebigen FTP-Client übertragen.

ACHTUNG Auf UNIX oder UNIX-Derivat-Server müssen vor allem die Mailvorlagen ASCII übertragen werden.

Installation

Bevor des CGI-Script verwendet werden kann, sind folgende Schritte durchzuführen :

Konfiguration - bikcfg.cgi

Zum Konfigurieren des CGI-Scripts bik.cgi muss die Datei bikcfg.cgi (z.B. mit einem beliebigen Texteditor) bearbeitet werden.

Regeln:

• Schreibweise für Einstellungen:
  name=wert oder name =wert oder name = wert
  Leerzeichen oder tabs werden unmittelbar vor und nach dem = und am Ende der Zeile ignoriert
• Groß- und Kleinschreibung ist für die Schlüssel (name) unbeachtlich
  name=wert oder Name=wert oder NAME=wert ist das selbe
• Pfadangaben sind die tatsächlichen Pfade auf dem Webserver und unterscheiden sich in den aller meisten Fällen von den FTP-Pfaden. (wenn nicht bekannt Provider fragen)
• bei Pfadangaben müssen auch auf NT-Servern statt dem \ (Backslash) als Trennzeichen ein / (Slash) verwendet werden z.B. c:/inetpub/wwwroot/vhs-demohausen/programm
• Wenn relative Pfadangeben nicht funktionieren, absolute Pfade angeben.
  (z.B. statt relativ ../programm absolut /home/vhs-demohausen/programm
• Pfadangeben immer ohne abschließendes / Slash
  falsch: /home/vhs-demohausen/programm/
  richtig: /home/vhs-demohausen/programm
• Kommentarzeilen werden mit einem # (Raute) eingeleitet.

PATHDB

Serverpfad für Datenbanken/Kursprogramm. Damit die Kursrecherche und die Einzelterminanzeige funktioniert, muss dieser Pfad richtig eingegeben werden. Beim Publizieren des Kursprogramms werden auch die Tabellen für die Recherche und Einzeltermine übertragen.

siehe auch BIK4/Einstellungen/Optionen: CGI-Suchdatei erzeugen

Pflichtfeld

PATHDB=/home/vhs-demohausen/programm

PATHTPL

Serverpfad für alle CGI-Vorlagen (Templates)

Pflichtfeld

PATHTPL=C:/projekte/bik/Warenkorb/Internet/cgi-vorlagen

MAILBESTAETIGUNG_AN_VHS

Soll für die Anmeldung eine Mail-Bestätigung an EMAILANMELDUNG

geschickt werden? 0=Nein 1=Ja

Pflichtfeld

MAILBESTAETIGUNG_AN_VHS=1

MAILBESTAETIGUNG_AN_TEILNEHMER

Soll für die Anmeldung eine Mail-Bestätigung an den Teilnehmer

geschickt werden? 0=Nein 1=Ja

Pflichtfeld

MAILBESTAETIGUNG_AN_TEILNEHMER=1

SMTP

SMTP-Server(nur bei IIS auf NT-Server oder wenn sendmail nicht installiert)

Pflichtfeld wenn MAILBESTAETIGUNG_AN_VHS=1 und/oder MAILBESTAETIGUNG_AN_TEILNEHMER=1

SMTP=smtp.kundenserver.de

SENDMAIL

Nur für Unix(-Derivat)-Webserver

Serverpfad + Datei nur für sendmail

Wenn nicht bekannt, dann Provider fragen.

Pflichtfeld wenn MAILBESTAETIGUNG_AN_VHS=1 und/oder MAILBESTAETIGUNG_AN_TEILNEHMER=1

SENDMAIL=/usr/lib/sendmail

EMAILANMELDUNG

Emailadresse für Kursanmeldung oder Warteliste

Pflichtfeld wenn MAILBESTAETIGUNG_AN_VHS=1 und/oder MAILBESTAETIGUNG_AN_TEILNEHMER=1

EMAILANMELDUNG=VHS-Demohausen <bik-demoanmeldung@s-w-k.com>

ANMELDUNG_AN_BASYSINTERFACE

Soll die Anmeldung zur automatischen Verarbeitung mit BASys

vorbereitet werden? 0=Nein 1=Ja

ANMELDUNG_AN_BASYSINTERFACE=1

EMAIL_BASYSINTERFACE

Emailadresse für Anmeldungen zur automatischen Verarbeitung mit BASys.
Hinweis: Wenn bei EMAIL_BASYSINTERFACE eine Emailadresse angegeben ist wird die Angabe bei PATHANMELDUNG ignoriert.

PATHANMELDUNG

Serverpfad für Anmeldungen zur automatischen Verarbeitung mit BASys

Pflichtfeld wenn ANMELDUNG_AN_BASYSINTERFACE=1

PATHANMELDUNG=

Hinweis: Wenn bei EMAIL_BASYSINTERFACE eine Emailadresse angegeben ist wird die Angabe bei PATHANMELDUNG ignoriert.

LOGANMELDUNG

Serverpfad Log-file, wenn Log geschrieben werden soll

Optional (wenn nicht vorhanden wird kein Anmeldeprotokoll geschrieben)

LOGANMELDUNG=

ANMELDUNG_AUSSCHLUSS

Belegungsnummer(n) für die eine Anmeldung ausgeschlossen werden soll
durch Komma getrennt (z.B.: ANMELDUNG_AUSSCHLUSS=3,4 )
0 = Die Mindestteilnehmerzahl ist noch nicht erreicht
1 = Der Kurs ist frei und die Mindestteilnehmerzahl ist erreicht
2 = Die in BIK eingestellte Belegungsschwelle ist erreicht. D.h. der Kurs ist fast voll belegt.
3 = Der Kurs ist voll belegt
4 = Der Kurs hat bereits begonnen oder ist bereits beendet
5 = Der Eintrag ist eine Ebene
6 = Für diesen Kurs kann man sich nicht anmelden oder Anmeldung nicht nötig
7 = Für diesen Kurs kann man sich nicht anmelden oder Anmeldung nicht nötig

( Für Nr 5 und 6 wird automatisch der Bereich ANMELDUNG_AUSSCHLUSS im der CGI-Vorlage gelöscht

z.B.: ANMELDUNG_AUSSCHLUSS=3,4

Benutzerdefinierte Einstellungen

Neben den oben genannten Einstellungen können beliebig viele eigene Einstellungen gemacht werden, um diese als Konstanten in den CGI-Vorlagedateien verwenden zu können.

wenn man z.B. in der bikcfg.cgi folgende Zeile einfügt:

URLKURSPROGRAMM = http://www.vhs-demohausen/programm

, dann würde in den CGI-Volagedateien die Variable $urlkursprogramm$
durch den Wert http://www.vhs-demohausen/programm ersetzt werden

Dateien auf den Webserver übertragen

Zum übertragen der Scriptdateien kann einen beliebigen FTP-Client verwenden

Unix und Unix Derivate

In der ersten Zeile der Datei bik.cgi steht der Pfad für den Perlinterpreter:

#!/usr/bin/perl

in den aller meisten Fällen stimmt dieser Pfad. Wenn das Script beim Aufrufen einen "Interial Server Errror" produziert, kann es unter anderem daran liegen, dass dieser Pfad verkehrt ist. Bitte in den Unterlagen nachschauen oder den Provider fragen, wo sich der Perl-Interpreter befindet und gegebenenfalls die Datei bik.cgi mit einem Texteditor öffnen und Pfad korrigieren.

Das Verzeichnis für CGI-Scripte  ist nicht unbedingt frei wählbar. Auf manchen Webservern wird das Verzeichnis in dem sich CGI-Scripte befinden dürfen vorgeschrieben. Bitte in den Unterlagen nachschauen oder den Provider fragen, wo sich CGI-Scripte befinden dürfen.

Für Unix- oder Unix-Derivat-Server müssen die Script-Dateien unbedingt ASCII übertragen werden

Beispiel für das ASCII Übertragen mit einem FTP-Client (WS_FTP)

Nach dem Übertragen müssen die Zugriffrechte / Permissions für die Programmscripte eingestellt werden
chmod 775
  

Beispiel für das Vergeben der Zugriffsrechte mit einem FTP-Client (WS_FTP)

NT-Server

Das Verzeichnis für CGI-Scripte  ist nicht frei wählbar. Auf NT-Servern wird das Verzeichnis in dem sich CGI-Scripte befinden dürfen vorgeschrieben. Bitte in den Unterlagen nachschauen oder den Provider fragen wo sich CGI-Scripte befinden dürfen.

Manchmal können NT-Server nicht die Dateikennung .cgi verarbeiten. Es ist dann die Dateikennung .pl registriert. Damit die BIK CGI-Scripte ausgeführt werden können, müssen die Dateien umbenannt werden:

bik.cgi nach bik.pl , bikcfg.cgi nach bikcfg.pl und bik_sendmail.cgi nach bik_sendmail.pl

Die Dateien können mit einem beliebigen FTP-Client auf den Webserver in das Scriptverzeichnis übertragen werden.