Gateway bearbeiten: Unterschied zwischen den Versionen
Klaus (Diskussion | Beiträge) KKeine Bearbeitungszusammenfassung |
|||
| Zeile 1: | Zeile 1: | ||
Mit dem hier aufklappenden Untermenü lassen sich die Gateways im Detail definieren und auf die | Mit dem hier aufklappenden Untermenü lassen sich die Gateways im Detail definieren und auf die | ||
gewünschte Schnittstelle anpassen. | gewünschte Schnittstelle anpassen. | ||
In den folgenden Schritten können | In den folgenden Schritten können Sie die Einstellungen, Parameter, Übergabeform und auch Returncodes auf die | ||
von | von Ihnen gewählte Schnittstelle konfigurieren. | ||
[[Datei:Admin_gatewaybearbeiten.png]] | [[Datei:Admin_gatewaybearbeiten.png]] | ||
===Gateway bearbeiten=== | ===Gateway bearbeiten=== | ||
Wählen | Wählen Sie hier zuerst das Gateway aus, das Sie bearbeiten möchten. | ||
Daraufhin können | Daraufhin können Sie mit dem +-Button neue Parameter erzeugen. | ||
Um neue Parameter bearbeiten zu können müssen | 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 | Jetzt können Sie jeden einzelnen Parameter bestimmen. | ||
*Parameter | *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. | 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. | Einzige Ausnahme ist hier der Wert Gateway_url, der für die Adress-URL des Gateways benötigt wird. | ||
Alle anderen Werte finden | Alle anderen Werte finden Sie in den entsprechenden Schnittstellenbeschreibungen Ihres Gateways. | ||
*Standardwert | *Standardwert | ||
Wenn ein Parameter immer einen festen Wert annimmt oder | 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. smskaufen https://www.smskaufen.com/sms/gateway/sms.php) | 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 | *Parameter-Typ | ||
Da einige Parameter vom System speziell behandelt werden müssen, stellen | 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 | 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 | *Überschreibbar | ||
Alle Parameter die später vom User angepasst werden sollen, markieren | 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 | *Löschen | ||
Mit Klick auf das Löschensymbol können | Mit Klick auf das Löschensymbol können Sie den Parameter wieder löschen. | ||
[[Datei:Admin_gatewaybearbeite_gatewaybearbeiten.png]] | [[Datei:Admin_gatewaybearbeite_gatewaybearbeiten.png]] | ||
| Zeile 29: | Zeile 29: | ||
===Gateway konfigurieren=== | ===Gateway konfigurieren=== | ||
An dieser Stelle bauen | 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. | ||
[[Datei:Admin_gatewaybearbeiten_gatewaykonfigurieren.png]] | [[Datei:Admin_gatewaybearbeiten_gatewaykonfigurieren.png]] | ||
| Zeile 35: | Zeile 35: | ||
===Returncodes=== | ===Returncodes=== | ||
Die meisten Gateways liefern beim Aufruf Werte zurück anhand | Die meisten Gateways liefern beim Aufruf Werte zurück, anhand derer der Status des Aufrufs erkennbar wird. | ||
Wichtig ist hier ein Returncode der kennzeichnet | 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) | (Bsp. smskaufen liefert dafür den Wert "100" zurück). | ||
Dieser Wert sollte dann mit der Meldung "OK" definiert werden. | 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 | Bei der Nutzung des Gateways wird sich dann bei Rückgabe des hier eingestellten Wertes das Popup-Fenster schließen. | ||
Damit weiß der User, | 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. | 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. | ||
| Zeile 47: | Zeile 47: | ||
===Gateway Einstellungen=== | ===Gateway Einstellungen=== | ||
Hier können | Hier können Sie für die einzelnen Gateways noch die Bezeichnung ändern und bestimmen, welches Gateway als Standard verwendet wird. | ||
[[Datei:Admin_gatewaybearbeiten_einstellungen.png]] | [[Datei:Admin_gatewaybearbeiten_einstellungen.png]] | ||
| Zeile 53: | Zeile 53: | ||
===Gateway löschen=== | ===Gateway löschen=== | ||
Mit dieser Funktion können | Mit dieser Funktion können Sie bestehende Gateways löschen.<br> | ||
[[Datei:Hinweis.png]] Sobald | [[Datei:Hinweis.png]] Sobald Sie hier ein Gateway auswählen, wird dieses gelöscht. | ||
Version vom 28. November 2009, 00:00 Uhr
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. 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 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.
