Frage: Wie konfiguriere ich die Act! Web-API bei Verwendung einer benutzerdefinierten Website-Konfiguration?
Produktdetails:
- Produktfamilie: Act!
- Produkt: Act! Premium (Zugriff via Web)
Antwort:
Wenn Sie Ihre eigene benutzerdefinierte APFW-Website in IIS (Internet Information Services) eingerichtet haben, müssen Sie sicherstellen das beide, Ihre Act! API und Ihre benutzerdefinierte Website korrekt eingerichtet sind.
Die erforderliche Einrichtung hängt davon ab, ob Sie Act! Connect Link installiert haben oder ob Sie die Act! Web-API anwenden die bereits mit dem Programm installiert wurde. Bitte folgen Sie zur Orientierung folgende Anweisungen.
Hinweis: Auf dem Host-Computer Ihrer APFW-Website sollten folgende Schritte durchgeführt werden.
> Ich benutze den Act! Web-API
Standardmäßig befindet sich die Konfigurationsdatei Ihrer Act! Web-API-Anwendung unter C:\Programme (x86)\ACT\Act.Web.API\web.config und in dieser Datei befinden sich 2 Einstellungen welche Sie, nachdem Sie Ihre APFW-Website angepasst haben auf Ihre Richtigkeit prüfen müssen:
- Der Key "AdminFileLocation"
Dieser Key verweist Ihre Act! Web-API zur Datei Admin.xml welche alle mit Ihrer Website verbundenen Datenbanken speichert und sich standardmäßig unter C:\Programme (x86)\ACT\Act for Web\PadFiles\Admin.xml befindet. - Der Key "VirtualDirectory"
Das ist die Bezeichnung Ihrer Act! (Zugriff via Web) Application in IIS welche standardmäßig "APFW" lautet.
Anbei finden Sie ein Beispiel dieser Keys im Standardzustand. Korrigieren Sie einen dieser Werte, falls sich einer während der Anpassung geändert hat.
Beispiel:
Wir erstellen eine benutzerdefinierte APFW-Anwendung in IIS mit dem Namen "CompanyInc" welche auf die Kopie der APFW-Anwendungsdateien an folgender Stelle verweist: C:\Programmdateien (x86)\ACT\Akt für Web\APFW-CompanyInc\
Zusätzlich verschieben wir die oben genannte Datei admin.xml in das benutzerdefinierte Verzeichnis an folgender Stelle: C:\Programmdateien (x86)\ACT\Akt für Web\APFW-CompanyInc\PadFiles\Admin.xml
Mit diesem Setup erwarten wir das die web.config Datei für Ihre Act! Web API wie im Screenshot unten aussieht:
Website-Konfiguration von Act! (Zugriff via Web)
Standardmäßig befindet sich die Konfigurationsdatei Ihrer APFW-Website unter C:\Programme (x86)\ACT\Act for Web\APFW\web.config und in dieser Datei gibt es eine Einstellung welche Sie, nachdem Sie Ihre APFW-Website angepasst haben auf Ihre Richtigkeit prüfen müssen:
Suchen Sie in dieser Konfigurationsdatei nach dem Key namens "WebAPIBaseURL". Standardmäßig ist diese leer und wird wie folgt angezeigt.
Damit Ihre Website Ihr Act! Web-API nutzen kann, müssen Sie den WebAPIBaseURL Key mit Ihrer vollständigen API-URL aktualisieren.
Beispiel:
Sie haben Ihre benutzerdefinierte API-Site in IIS so eingerichtet, dass sie folgendermaßen aussieht: https://companyinc.com/companyinc-API/act.web.api
Bei diesem Setup erwarten wir, dass die Datei web.config für Ihre APFW-Website wie im folgenden Screenshot aussieht:
Ich verwalte mehrere Websites auf diesem Computer.
Wenn Sie mehrere Websites auf demselben Webserver verwalten, müssen Sie sicherstellen, dass jede API-Anwendung den eigenen, eindeutigen "BearerKey" enthält. Dieser BearerKey befindet sich in der web.config Datei der API, welche sich standardmäßig unter 'C:\Programme (x86)\ACT\Act.Web.API\web.config' befindet. Folgender Hinweis geht davon aus, dass sich diese betroffenen Dateien und Ordnerder am Standardspeicherort befinden.
Via Command Prompt verwenden wir die ausführbare RegenerateBearerKey.exe, die sich in den Installationsdateien der Act! Web-API befindet. Im folgenden Abschnitt finden Sie ein Beispiel, wie zur Standardanwendung der act.web.api einen NEUEN BearerKey zur Verfügung gestellt wird.
Drücken Sie die Windows-Taste auf Ihrer Tastatur und geben Sie CMD ein und drücken Sie die Enter-Taste, um das Command Prompt Fenster zu öffnen.
Geben Sie folgende Zeile ein:
C:\updateactwebapi_v1.0.375.0\regenerateBearerKey.exe -fk -l "c:\programme (x86)\act\act for web\act.web.api"
Drücken Sie die Enter-Taste.
Wenn dies erfolgreich ist, sollte die CMD-Abfrage ohne Fehlermeldung oder Bestätigung in eine neue Zeile gehen. Sie sollten nun sehen, dass ein neuer Key in der von Ihnen gewählten API web.config-Datei generiert wurde.
> Ich verwende den Act! Connect Link
Diese Anleitung geht davon aus, dass Sie bereits den Act! Connect Link installiert haben und bereit sind, Ihre benutzerdefinierte APFW-Website zu konfigurieren. Falls Sie den Act! Connect Link noch nicht installiert haben, dann lesen bitte folgenden Artikel, um mit der Installation zu beginnen: https://www.act.com/de-de/produkte/act-connect-link
Bei der Verwendung des Act! Connect Links mit benutzerdefinierten APFW-Websites, musse die web.config-Datei Ihrer benutzerdefinierten Website aktualisiert werden, um die bereitgestellte API-URL verwenden zu können. Bitte befolgen Sie die Anweisungen.
- Öffnen Sie auf Ihrem Webserver die Act! Desktop-Software und klicken Sie in der Navigation links auf Act! Connect. Hier wird oben links Ihre einzigartige Act! Connect Adresse angezeigt. Kopieren Sie den Link in den Zwischenspeicher.
Nach Bedarf können Sie den Link (z.B. per Editor) speichern, um ihn später wieder verwenden zu können.
- Schließen Sie Act! und suchen Sie anschließend die web.config Datei. Diese befindet sich standardmäßig in Ihrem Act! Installationsverzeichnis: C:\Programme (x86)\ACT\Act für Web\APFW\web.config
- Klicken Sie mit der rechten Maustaste auf die Datei und wählen Sie Öffnen mit um sie mit dem Editor zu bearbeiten.
Klicken Sie auf das Menü Bearbeiten, wählen Sie die Option Suchen und suchen Sie nach WebAPIBaseURL. Sobald Sie die gefunden haben, können Sie den Wert mit Ihrer zuvor kopierten Connect Webadresse ändern. Speichern und schließen Sie die Datei.
Bitte beachten Sie: Den zusätzlichen Schrägstrich (forward slash «/») welcher am Schluss der Adresse hinzugefügt werden MUSS: