4.1.16. GREYHOUND Connect für Magento

Die Installation des Addons ist mit wenigen Handgriffen erledigt. Nach einigen Vorbereitungen im Magento Backend, kann das Addon dem bestehenden GREYHOUND-Vertrag hinzugebucht werden. Der GREYHOUND Server und die Clients installieren das Addon dann vollautomatisch.

1. Vorbereitung im Magento Backend

Damit das Addon Daten aus dem Magento-Shop abrufen kann, ist es wichtig, dass ...

• das magento-seitige Plugin ebenfalls installiert wird (Infos & Download unter https://marketplace.magento.com/catalogsearch/result/?q=GREYHOUND)

• ein Schnittstellenzugang greyhound eingerichtet wird.

Dazu die folgenden Schritte durchführen:

1. Das Magento-Plugin installieren und den Cache leeren.

2. Im Backend unter System/Web Services/SOAP-XML-RPC Gruppenberechtigungen eine neue Gruppe anlegen (z. B. "GREYHOUND Connect").

3. Dieser Gruppe die Berechtigungen GREYHOUND Connect sowie die beiden Unterberechtigungen Bestelldaten abrufen und Informationen über das Modul abrufen zuweisen.

   

4. Unter System/Web Services/SOAP-XML-RPC Benutzer einen neuen Benutzer anlegen (z. B. "greyhound").

5. Für diesen Benutzer einen API-Schlüssel festlegen und den API-Schlüssel sowie den Benutzernamen notieren (dies wird später in den Einstellungen des Addons im GREYHOUND Client benötigt). Das Benutzerkonto muss Aktiv sein.

6. In den Gruppenberechtigungen des Benutzers dann die zuvor angelegte Gruppe auswählen ("GREYHOUND Connect").

   

2. GREYHOUND Connect für Magento dem Vertrag hinzubuchen

Das Produkt GREYHOUND Connect für Magento im GREYHOUND Control Center (GCC) dem bestehenden Vertrag hinzubuchen:

3. GREYHOUND Connect für Magento im GREYHOUND Client einrichten

1. Nachdem das Addon dem Vertrag hinzugebucht wurde, erscheint im GREYHOUND Client ein neuer Menüeintrag Erweiterungen/GREYHOUND Connect für Magento - Einstellungen.

   

2. Hier wird die URL der Magento API angegeben (wenn möglich die sichere Verbindung, also mit https://...).

3. Ebenso wird hier der Benutzername und der API-Schlüssel angegeben, der in Magento Connect eingerichtet wurde.

4. Mit der Schaltfläche Verbindung testen kann überprüft werden, ob die Verbindung zur API des Shops aufgebaut werden kann.

Besonderheiten bei Magento 2

Bei Nutzung von Magento 2 bitte nur die Base-URL des Shops unter API-Url angeben, der vollständige Pfad ist in diesem Fall nicht notwendig. Nutzer von Magento 2 nehmen die Einrichtung wie folgt vor: Zunächst ist im Admin "System" > "Integrations" auszuwählen.

Dort findet man rechts oben einen Button "Add New Integration". Dieser ist anzuklicken.

In der neuen Integration ist als Name z. B. "GREYHOUND Connect" anzugeben.

Wichtig: Nachdem alle notwendigen Daten eingetragen sind, ist links im Kasten mit der Überschrift "Basic Settings" der Punkt "API" anzuklicken. Hier müssen nun ganz unten beide Berechtigungen für das GREYHOUND Connect Modul gewährt werden.

Danach kann man die Eingaben speichern. Ganz fertig ist man allerdings noch nicht: Nun muss man nochmal auf "Bearbeiten" klicken und in der Integration unten bei "Integration Details" den "Access Token" rauskopieren und im Addon bei GREYHOUND als Passwort eintragen. Der Benutzername muss bei Magento 2 nicht eingetragen werden, dort wird dann nur mit dem Access Token als Passwort gearbeitet.

Variablen für Textbausteine

Beim Beantworten oder Verfassen einer Nachricht über die Buttons in der Seitenleiste des Addons stellt das Addon einige Variablen bereit, die im Text der Nachricht oder in eingefügten Textbausteinen ersetzt werden. Der Inhalt der Variablen hängt von den Auftrags- und Kundendaten ab, die das Addon ermittelt hat. So können z. B. Variablen wie die Lieferanschrift leer sein, wenn in den Auftragsdaten keine separate Lieferanschrift übermittelt wurde. Wie üblich kann die Vorschaufunktion beim Verfassen der Nachricht genutzt werden, um zu überprüfen, durch welche Daten die Variablen ersetzt werden.

Es folgt eine Auflistung der Variablen und ihres Inhalts: