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, das 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 Sie einen Wert als Vorgabe definieren möchten, können Sie diesen Wert hier einstellen (z.B. die Absendernummer). Für den Parameter Gateway-URL MUSS hier die entsprechende URL eingetragen werden ( Bsp. clicksend https://<Ihr Instanzname>.infra-struktur.eu/clicksend/send/sms )

• 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 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, dass jeder Parameter einmal eingestellt wurde und die Gateway_URL vorne steht. Die Reihenfolge der angehängten Parameter ist in der Regel beliebig.

Returncodes

Die meisten Gateways liefern beim Aufruf Werte zurück, anhand derer der Status des Aufrufs erkennbar wird. Wichtig ist hier ein Returncode, der kennzeichnet, dass 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 schließen. Damit weiß der User, dass 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.