ASP-Store Locator-Beispiel für MapPoint Web Service

  • Artikel

Von Joe D. Como

In diesem Artikel erhalten Sie Informationen über das Installieren und Ausführen einer Store Locator-Anwendung, die mit Active Server Pages (ASP) erstellt wurde und Microsoft MapPoint Web Service verwendet.

Klicken Sie hier zum Herunterladen des Codebeispiels für diesen Artikel.

Auf dieser Seite

Einführung Einführung
Anforderungen Anforderungen
Installieren des ASP-Store Locators Installieren des ASP-Store Locators
Schlussfolgerung Schlussfolgerung

Einführung

ASP wurde nicht entwickelt, um Webdienste wie Microsoft MapPoint Web Service zu verwenden. Als ASP entwickelt wurde, waren Webdienste noch nicht verfügbar. MapPoint Web Service stützt sich allerdings auf die Fortschritte, die durch ASP.NET und Microsoft .NET Framework erzielt wurden. Da jedoch viele Unternehmen ältere ASP-Versionen verwenden, können sie ihre Anwendungen nicht zu ASP.NET konvertieren. Darum haben wir eine Beispielanwendung eines ASP-Store Locators entwickelt, die mit MapPoint Web Service zusammenarbeitet.

Der ASP-Store Locator verwendet Beispieldaten des erfundenen Unternehmens Fourth Coffee Company. Gibt der Benutzer eine Adresse oder einen Ort ein, kann die Anwendung der Eingabe einen regionalen Code zuordnen und eine Suche nach nahe gelegenen Filialen ausführen, die in den Beispieldaten von Fourth Coffee in MapPoint gespeichert sind. Der Benutzer kann sich durch den Store Locator Anfahrtsinformationen oder eine Karte für die Filialen anzeigen lassen, die von der Suche ausgegeben wurden. Sie können den ASP-Store Locator so anpassen, dass Ihr Warenzeichen angezeigt wird. Außerdem können Sie Daten abfragen, die Sie an die Customer Service Site (CSS) von MapPoint Web Service übertragen haben.

Hinweis Um Zugriff auf die CSS zu erhalten, müssen Sie MapPoint Web Service-Kunde sein. Weitere Informationen über MapPoint Web Service oder das Anmelden eines Testkontos erhalten Sie auf der Website MapPoint Web Service (in Englisch).

Der ASP-Store Locator besteht aus ASP-Dateien für die Benutzeroberfläche und Microsoft Visual Basic-Klassendateien, die in DLLs kompiliert sind (mit Visual Basic 6.0, Service Pack 5) und die Basisfunktionalität bereitstellen. Mit dem SOAP-Toolkit wird eine Web Services Meta Language-Datei (WSML - Metasprache für Webdienste) erzeugt, durch die die MapPoint Web Service-Operationen, die in der Web Services Description Language-Datei (WSDL - Beschreibungssprache für Webdienste) von MapPoint Web Service beschrieben werden, spezifischen Methoden im COM-Objekt (der DLL) zugeordnet werden. Die WSML-Datei legt fest, welches Objekt zu laden ist, um die Anforderung für jede Operation zu erfüllen.

 

Anforderungen

Um den ASP-Store Locator installieren zu können, muss folgende Software auf Ihrem Computer installiert sein:

  • Internetinformationsdienste (IIS) 5.0 mit den aktuellsten Sicherheitsaktualisierungen

  • Microsoft Windows 2000 Server, Windows XP Professional, oder Microsoft Windows Server 2003

  • Microsoft SOAP-Toolkit 3.0

  • Microsoft Visual Basic 6.0 mit Service Pack 5

Außerdem benötigen Sie ein gültiges MapPoint Web Service-Konto. Weitere Informationen über MapPoint Web Service oder das anmelden eines Testkontos erhalten Sie auf der Website MapPoint Web Service (in Englisch).

 

Installieren des ASP-Store Locators

Nach der Installation der erforderlichen Software können Sie den ASP-Store Locator installieren.

Installieren des Store Locators

  1. Laden Sie die Datei ASPGeneric.exe herunter und führen Sie Setup aus. (In der Standardeinstellung startet Setup automatisch, nachdem Sie die Dateien aus ASPGeneric.exe entpackt haben.)

  2. Wechseln Sie in den Installationsordner, den Sie während der Installation ausgewählt haben (in der Standardeinstellung ist das der Ordner C:\Programme\Store Locator using ASP), doppelklicken Sie auf ASPGeneric.exe und entpacken Sie die Dateien, die in dieser ausführbaren Datei enthalten sind.

  3. Erstellen Sie auf Ihrem Computer zwei Ordner auf gleicher Ebene. Ein Ordner enthält die ASP-Dateien und Bilder für die Anwendung. Der andere Ordner enthält die DLL, die WSML-Datei und die WSDL-Datei.

  4. Konfigurieren Sie den Ordner für die ASP-Dateien wie folgt, und kopieren Sie anschließend den Inhalt des ASP-Ordners, den Sie gerade entpackt haben, in diesen Ordner:

    • Klicken Sie auf den Ordner, klicken Sie auf Eigenschaften und anschließend auf die Registerkarte Webfreigabe.

    Klicken Sie auf Diesen Ordner freigeben und vergewissern Sie sich, dass in dem Feld Alias bearbeiten unter Anwendungsberechtigungen die Option Skripts aktiviert ist.

    Klicken Sie auf OK und anschließend auf Übernehmen.

  5. Kopieren Sie folgende Dateien vom Ordner MapPointTypeMappers, den Sie gerade entpackt haben, in den zweiten Ordner:

    • MapPointTypeMappers.dll

    • MapPoint.wsdl

    • MapPointSoapServices30.wsml

  6. Verwenden Sie RegSvr32.exe um MapPointTypeMappers.dll zu registrieren:

    • Öffnen Sie eine Eingabeaufforderung, wechseln Sie in das Verzeichnis, das die DLL enthält, und geben Sie folgende Zeile ein:
    regsvr32 MapPointTypeMappers.dll

  7. Wechseln Sie in den Ordner, der die ASP-Dateien enthält. Öffnen Sie mit einem Texteditor die Datei Constants.asp und ersetzen Sie die Standardwerte durch folgende Konstanten:

    • MAPPOINT_USER_ID - Ihr Benutzername für MapPoint Web Service

    • MAPPOINT_PASSWORD - Ihr Kennwort für MapPoint Web Service

    • MAPPOINT_WSDL_URL - Der Pfad zur Datei MapPoint.wsdl, die Sie auf Ihren Computer kopiert haben

    • MAPPOINT_WSML_FILE - Der Pfad zur Datei MapPointSoapServices30.wsml, die Sie auf Ihren Computer kopiert haben

    • LOCATOR_LOG_FILE - Der Pfad zu der Datei, in der ein Protokoll Ihrer Transaktionen gespeichert werden soll

Jetzt sollte die Anwendung ausgeführt werden können. Um die Anwendung zu testen, starten Sie einen Webbrowser und geben Sie die URL des Ordners ein, der die ASP-Dateien enthält (https://localhost/NameIhresOrdners). Wenn die erste Seite der Anwendung nicht angezeigt wird, müssen Sie möglicherweise einige Änderungen an den Sicherheitseinstellungen Ihres Webservers vornehmen.

Ändern der Sicherheitseinstellungen

  1. Konfigurieren Sie den Internetinformationsdienste-Manager (IIS) so, dass anonymer Zugriff über das IUSR_NameIhresServers-Konto möglich ist und IIS das Kennwort überprüfen kann.

  2. Gewähren Sie dem IUSR_NameIhresServers-Konto Lesezugriff auf den Ordner, der die Datei MapPointTypeMappers.dll enthält.

  3. Gewähren Sie dem IUSR_NameIhresServers-Konto Lese- und Schreibzugriff auf den Ordner, in den das Protokoll geschrieben wird.

  4. Verwenden Sie Regedit.exe, um dem IUSR_NameIhresServers-Konto Lesezugriff auf die Schlüssel HKEY_CLASSES_ROOT\Interface und HKEY_CLASSES_ROOT\TypeLib in der Registrierung zu gewähren.

Vorsicht Falsche Einstellungen in der Registrierung können ernsthafte Probleme hervorrufen und die Neuinstallation Ihres Betriebssystems erfordern. Microsoft übernimmt keine Gewähr, dass Probleme, die durch Bearbeitung der Registrierung verursacht wurden, behoben werden können. Sichern Sie wichtige Dateien vor der Bearbeitung der Registrierung.

Nach den Änderungen der Konfigurationseinstellungen haben Sie folgende Möglichkeiten, die Anwendung anzuzeigen:

  • Normale Benutzeroberfläche - Zugriff über https://localhost/NameIhresOrdners/default.asp

  • Benutzeroberfläche für Pocket PCs - Zugriff über https://localhost/NameIhresOrdners/PPCInputForm.asp

  • Werbebanner-Benutzeroberfläche - Zugriff über https://localhost/NameIhresOrdners/banner.html. Auf dieser Seite wird ein HTML-Formular angezeigt, dass von einer Bannergrafik unterlegt ist.

 

Schlussfolgerung

ASP ist eine Legacy-Plattform. Es ist keine einfache Aufgabe, aktuelle Technologien wie Web Services zu nutzen und sie mit ASP zu verwenden. Mit diesem ASP-Store Locator werden Ihnen jedoch die grundlegenden Interaktionen mit MapPoint Web Service ermöglicht. Sie können diese Anwendung erweitern, um sie Ihren persönlichen Anforderungen entsprechend anzupassen. Ist eine Aktualisierung auf ASP.NET nicht möglich, stellt Ihnen dieser Beispielcode eine Grundlage zur Verfügung, auf der Sie Ihre Anwendung aufbauen können.

„Die Inhalte der hier eingestellten Artikel stammen möglicherweise nicht von Microsoft, sondern von Dritten und werden Ihnen kostenlos zur Verfügung gestellt. Microsoft kann daher für die Richtigkeit und Vollständigkeit der Inhalte keine Haftung übernehmen.“