{"id":55000081,"date":"2017-04-01T00:00:00","date_gmt":"2020-03-27T19:25:43","guid":{"rendered":"http:\/\/access-im-unternehmen.aix-dev.de\/aiu\/?p=81"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-30T00:00:00","slug":"Webservice_testen_am_Beispiel_von_DHL","status":"publish","type":"post","link":"https:\/\/vbentwickler.de\/Webservice_testen_am_Beispiel_von_DHL\/","title":{"rendered":"Webservice testen am Beispiel von DHL"},"content":{"rendered":"

Wer einen Webshop betreibt, kennt sich mindestens mit den Webseiten des einen oder anderen Paketdienstes aus. Dabei gibt es beim Erstellen von Versandetiketten für Pakete verschiedene Stufen der Automatisierung. Wir wollen zur Stufe der höchsten Automatisierung gelangen und unsere Daten für den Versand direkt an den Webservice eines Anbieters, in diesem Fall DHL, weiterleiten und die erstellten Versandetiketten in druckbarer Form herunterladen. Dazu erfahren Sie in diesem Artikel, wie Sie einen Webservice mithilfe des Tools SoapUI testen.<\/b><\/p>\n

Von der Handarbeit zur Vollautomatisierung<\/h2>\n

Wer es nicht so mit dem Internet hat, holt sich ein paar Paketscheine von der Post, füllt diese händisch mit den Adressen der Empfänger aus und sendet die Pakete dann ab. Bei kleinen Mengen mag das ein sinnvoller Ansatz sein. Wer hingegen gleich ein paar Lieferungen pro Tag verschickt, gibt die Daten vielleicht direkt in die Eingabemaske der Webseite dhl.de <\/b>ein. Hier können Sie alle relevanten Daten angeben – von der Paketgröße über das Gewicht bis hin zu den Absender- und Empfängerdaten. Wer regelmäßig Pakte versendet, möchte aber vielleicht noch etwas Geld sparen und nutzt den Geschäftskundentarif statt den für Privatkunden. Dann ist www.dhl-geschaeftskundenportal.de <\/b>die richtige Adresse. Hier benötigen Sie allerdings ein Kundenkonto – auf die Schnelle ein Paket verschicken und per Paypal bezahlen können Sie hier nicht. Als registrierter Kunde loggen Sie sich dann auf der Seite ein und können über den Menüpunkt Versenden|Versenden (Intraship) <\/b>zur Versandschnittstelle wechseln (siehe Bild 1).<\/p>\n

\"Aufruf<\/p>\n

Bild 1: Aufruf des Dienstes Intraship<\/span><\/b><\/p>\n

Hinweis: Zum Testen der in späteren Beispielen vorgestellten Zugriffe auf den Webservice von DHL benötigen Sie ein Entwickler-Konto bei DHL. Wie Sie dieses anlegen, erfahren Sie weiter unten.<\/p>\n

Hier haben Sie dann einige weitere Möglichkeiten. Dazu gehört das Anlegen eines neuen Auftrags, wobei Sie allerdings nur das Gewicht und die Empfängeradresse eintragen müssen – die Absenderadresse für Ihr Kundenkonto wird in den Einstellungen gespeichert und automatisch hinzugefügt. Außerdem können Sie hier einen Import von Aufträgen durchführen, wozu Sie auf den entsprechenden Link klicken (siehe Bild 2).<\/p>\n

\"Versandschnittstelle\"<\/p>\n

Bild 2: Versandschnittstelle<\/span><\/b><\/p>\n

Damit landen Sie auf einer Seite, auf der Sie die Datei mit den dafür vorbereiteten Daten auswählen und die enthaltenen Daten einlesen können. Nach dem Import zeigt die Seite die eingelesenen Sendungen in einer Liste an und Sie können diese markieren und ausdrucken oder auch stornieren. Nach dem Ausdrucken öffnet sich ein weiteres Fenster mit einer PDF-Datei, welche die Versandetiketten enthält. Diese drucken Sie nun noch auf entsprechendem Papier aus. Dieses stellt DHL seinen Geschäftskunden kostenlos zur Verfügung (siehe Bild 3).<\/p>\n

\"Auswahl<\/p>\n

Bild 3: Auswahl einer Empfängerliste<\/span><\/b><\/p>\n

Nun wollen wir dies alles komplett automatisieren. Das heißt, dass wir gar keinen Internetbrowser mehr öffnen wollen, sondern aus unserer Anwendung heraus einen Webservice aufrufen wollen, dem wir die Absender- und Empfängerdaten und die Angaben zur Sendung übermitteln wollen und der uns die Etiketten dann in der Antwort zur Verfügung stellen soll.<\/p>\n

DHL für Entwickler<\/h2>\n

Damit landen wir dann auf der Seite entwickler.dhl.de<\/b>. Hier können Sie nun unkompliziert ein Entwicklerkonto erstellen – die einzelnen Schritte wollen wir hier nicht darstellen. Nach dem Anlegen des Entwicklerkontos und dem Anmelden im Portal finden Sie eine Auswahl der verfügbaren APIs (siehe Bild 4). Uns interessiert im Moment vor allem die API für den Geschäftskundenversand.<\/p>\n

\"Einige<\/p>\n

Bild 4: Einige der verfügbaren APIs<\/span><\/b><\/p>\n

Webservice ansehen<\/h2>\n

Wenn Sie sich in den Informationen zur API für Geschäftskunden umsehen, finden Sie zunächst heraus, wo Sie die WSDL-Datei des Webservices finden, nämlich unter folgendem Link:<\/p>\n

https:\/\/cig.dhl.de\/cig-wsdls\/com\/dpdhl\/wsdl\/geschaeftskundenversand-api\/2.2\/geschaeftskundenversand-api-2.2.wsdl<\/pre>\n
Was Sie damit alles anstellen können, schauen wir uns mit einem speziellen Tool namens SoapUI an, mit dem Sie den Webservice auch testen können, ohne auch nur eine Zeile Code zu programmieren. Dieses laden Sie von der Seite https:\/\/www.soapui.org\/ <\/b>herunter und installieren es. Danach starten Sie SoapUI und klicken auf den Menüeintrag File|Create Empty Project<\/b>.<\/p>\n
Klicken Sie dann mit der rechten Maustaste auf den neuen Eintrag und wählen Sie den Kontextmenü-Eintrag Add WSDL <\/b>aus (siehe Bild 5).<\/p>\n
\"Hinzufügen<\/p>\n
Bild 5: Hinzufügen einer WSDL<\/span><\/b><\/p>\n
Es erscheint ein kleiner Dialog, in den Sie unter WSDL Location <\/b>den Link mit der WSDL-Datei eintragen (siehe Bild 6). Behalten Sie die Einstellung Create sample requests for all Operations <\/b>bei und klicken Sie auf OK<\/b>.<\/p>\n
\"WSDL<\/p>\n
Bild 6: WSDL eingeben<\/span><\/b><\/p>\n
Anschließend zeigt SoapUI<\/b> im Bereich Projects<\/b> alle Funktionen des Webservices mit der soeben analysierten WSDL-Datei an (siehe Bild 7).<\/p>\n
\"Funktionen<\/p>\n
Bild 7: Funktionen des Webservices<\/span><\/b><\/p>\n
Nun wollen wir einen Request zum Testen der Funktion getLabel <\/b>des Webservice erstellen – getLabel <\/b>hört sich so an, also ob es unsere Aufgabe, ein Label auf Basis der Versanddaten zu erstellen, erfüllen könnte. Dazu klicken Sie wieder mit der rechten Maustaste auf getLabel <\/b>und wählen den Eintrag New request <\/b>aus dem Kontextmenü aus. Geben Sie nun als Namen getLabelRequest <\/b>ein und schauen Sie sich den Inhalt des nun geöffneten Fensters an.<\/p>\n
Hier finden wir ein Element vor, das die für die Authentifizierung notwendigen Daten entgegennimmt und einen Body, in den Sie eine Version und bis zu 30 shipmentNumbers <\/b>eingeben können (siehe Listing 1). Das sieht doch eher danach aus, als ob man hier bereits erstellte Label anfragen kann statt neue anzulegen. Also müssen wir wohl doch noch einen Blick auf die übrigen Funktionen des Webservice werfen.<\/p>\n
<soapenv:Envelope xmlns:soapenv=\"...\">\r\n    <soapenv:Header>\r\n       <cis:Authentification>\r\n          <cis:user><\/cis:user>\r\n          <cis:signature><\/cis:signature>\r\n       <\/cis:Authentification>\r\n    <\/soapenv:Header>\r\n    <soapenv:Body>\r\n       <bus:GetLabelRequest>\r\n          <bus:Version>\r\n             <majorRelease><\/majorRelease>\r\n             <minorRelease><\/minorRelease>\r\n             <!--Optional:-->\r\n             <build><\/build>\r\n          <\/bus:Version>\r\n          <!--1 to 30 repetitions:-->\r\n          <cis:shipmentNumber><\/cis:shipmentNumber>\r\n          <!--Optional:-->\r\n          <labelResponseType><\/labelResponseType>\r\n       <\/bus:GetLabelRequest>\r\n    <\/soapenv:Body>\r\n<\/soapenv:Envelope><\/pre>\n
Listing 1: Request getLabel mit Platzhaltern<\/span><\/b><\/p>\n
Request testen<\/h2>\n
Schnell zeigt sich, dass CreateShipment-Order <\/b>die passende API-Funktion ist. Also erstellen wir einen neuen Request auf Basis dieser Funktion. Das Schöne am Tool SoapUI<\/b> ist: Sie können bereits jetzt einfach einmal einen Request absenden und erhalten die Antwort direkt im gleichen Fenster. In diesem Fall weist uns die Antwort darauf hin, dass wir keine Authentifizierungsdaten eingegeben haben (siehe Bild 8).<\/p>\n
\"Absenden<\/p>\n
Möchten Sie weiterlesen? Dann lösen Sie Ihr Ticket!<\/span>
\nHier geht es zur Bestellung des Jahresabonnements des Magazins Visual Basic Entwickler<\/strong>:<\/span>
\nZur Bestellung ...<\/a><\/span>
\nDanach greifen Sie sofort auf alle rund 200 Artikel<\/strong> unseres Angebots zu - auch auf diesen hier!<\/span>
\nOder haben Sie bereits Zugangsdaten? Dann loggen Sie sich gleich hier ein:<\/span><\/p>\n<\/div>\n\n\t\n\t
\n\n\t\t\n\t\t