Gateway bearbeiten

Mit dem hier aufklappenden Untermenü lassen sich die Gateways im Detail definieren und auf die gewünschte Schnittstelle anpassen. In den folgenden Schritten können sie die Einstellungen, Parameter, Übergabeform und auch Returncodes auf die von ihnen gewählte Schnittstelle konfigurieren.

Gateway bearbeiten

Wählen sie hier zuerst das Gateway aus, daß sie bearbeiten möchten. Daraufhin können sie mit dem +-Button neue Parameter erzeugen. Um neue Parameter bearbeiten zu können müssen sie das Menü einmal verlassen und zurückkehren, damit die Werte übernommen werden. Jetzt können sie jeden einzelnen Parameter bestimmen.

• Parameter

Hier steht der Name des Parameters. Dieser muss unbedingt exakt stimmen, da er mit dieser Bezeichnung auch später in der URL übergeben wird. Einzige Ausnahme ist hier der Wert Gateway_url der für die Adress-URL des Gateways benötigt wird. Alle anderen Werte finden sie in den entsprechenden Schnittstellenbeschreibungen ihres Gateways.

• Standardwert

Wenn ein Parameter immer einen festen Wert annimmt oder ich einen Wert als Vorgabe definieren möchte, können sie diesen Wert hier einstellen. (Bsp. Absendernummer) Für den Parameter Gateway-URL MUSS hier die entsprechende URL eingetragen werden ( Bsp. smskaufen https://www.smskaufen.com/sms/gateway/sms.php)

• Parameter-Typ

Da einige Parameter vom System speziell behandelt werden müssen, stellen sie hier ein welche Art Parameter sie gerade eintragen. So wird zum Beispiel der Parameter-Typ FILE später Base64-codiert an die Schnittstelle übergeben. Nur wenn sie für den parameter hier keine Zuordnung finden, können sie dies auslassen.

• Überschreibbar

Alle Parameter die später vom User angepasst werden sollen, markieren sie hier als überschreibbar. Dadurch wird z.B. Die Absendernummer vom Benutzer änderbar. Die Parameter für Text, Empfänger oder Dateianhang müssen da natürlich in jedem Fall überschreibbar sein um das Gateway überhaupt nutzen zu können.

• Löschen

Mit Klick auf das Löschensymbol können sie den Parameter wieder löschen.

Gateway konfigurieren

An dieser Stelle bauen sie die URL und die Parameter in der richtigen Reihenfolge zusammen. Wichtig ist hier, daß jeder Parameter einmal eingestellt wurde und die Gateway_URL vorne steht. Die Reihenfolge der Parameter dahinter ist in der Regel egal.

Returncodes

Die meisten Gateways liefern beim Aufruf Werte zurück anhand denen der Status des Aufrufs erkennbar wird. Wichtig ist hier ein Returncode der kennzeichnet daß die Schnittstelle den Aufruf problemlos verarbeitet hat. (Bsp. smskaufen liefert dafür den Wert "100" zurück) Dieser Wert sollte dann mit der Meldung "OK" definiert werden. Bei der Nutzung des Gateways wird sich dann bei Rückgabe des hier eingestellten Wertes das Popup-Fenster schliessen. Damit weiß der User, daß die Übetragung erfolgreich war. Zur Fehlerbehebung und Erkennung können hier nun noch beliebige andere Returncodes definiert werden und mit entsprechenden vorgegebenen Meldungen belegt werden. Diese Meldung wird dann jeweils im Gatewayfenster dem User ausgegeben.

Gateway Einstellungen

Hier können sie für die einzelnen Gateways noch die Bezeichnung ändern und bestimmen welches Gateway als Standard verwendet wird.

Gateway löschen

Mit dieser Funktion können sie bestehende Gateways löschen.
Sobald sie hier ein Gateway auswählen, wird dieses gelöscht.