Um die Authentifizierung durchzuführen, muss bei dieser Methode eine Integration im Magento-Backend angelegt werden.
Note |
---|
Inhalt
Table of Contents
Magento 2 Systemvoraussetzungen (bei Nutzung der integrierten Lösung)
- Die allgemeinen Systemvoraussetzungen für büro+ können unserer Website entnommen werden: Systemvoraussetzungen.
- Sie haben die Registrierung für die microtech Cloud durchgeführt. Die Daten für die Cloud haben Sie nach der Registrierung in den Parametern von microtech büro+ unter "Sonstige" - "Zugangsdaten" hinterlegt
- Zudem benötigen Sie eine Magento 2-Lizenz / einen Magento 2-Account
Warning | ||
---|---|---|
| ||
Die Dokumentation zur Nutzung von Magento 2 mit büro+ UND der microtech Middleware finden Sie im entsprechenden Kapitel: Magento 2 (über Middleware nutzen). |
Magento 2: Vorbereitende Maßnahmen: Einrichten einer Anbindung über Integration
Magento 2 auf Sever einrichten
... so können Sie mit der auf dieser Seite vorgestellten Methode fortfahren. Sollten Sie stattdessen Felder wie "Callback-URL" oder "Identitäts-Link URL" vorfinden, so ist die neue Authentifizierungsmethode zu wählen - einen entsprechenden Hilfe-Artikel haben wir Ihnen bereitgestellt: Magento 2 - Authentifizierung (neue Methode). |
Inhalt
Nachdem Sie einen Magento 2-Shop auf einem Server eingerichtet oder von einem externen Dienstleister haben einrichten lassen, ist für die Verwendung mit microtech büro+ eine Integration in Magento 2 zu einzurichten. Dies ist in wenigen Schritten erledigt Table of Contents
Vorbereitende Maßnahme: Anlegen einer Integration im Magento-Backend
1) Loggen Sie sich zunächst in Ihrem Backend des Shops ein
Melden Sie sich mit Benutzernamen und Passwort an.
2) Wählen Sie: SYSTEM - INTEGRATIONEN
Klicken Sie zunächst in der linken Navigation auf: SYSTEM und wählen Sie dann im Bereich "Extensions" den Eintrag: INTEGRATIONEN.
3) Neue Integration hinzufügen
In der Übersicht sehen Sie ggf. bereits angelegte Integrationen. Wählen Sie die Schaltfläche: NEUE INTEGRATION HINZUFÜGEN.
4) Vergeben Sie einen Namen und ein Passwort für die Integration
Für das Erfassen der Integration ist ein Name und ein Passwort zu vergeben.
- Als Name bietet sich z. B. "microtech" an
- Das Passwort sollte möglichst stark ausgewählt werden und auch aus Sonderzeichen sowie Groß- und Kleinschreibung bestehen. Notieren Sie sich das Passwort und hinterlegen Sie dieses an einen sicheren, nur für Sie einsehbaren Ort
5) Erlauben Sie der API einen vollen Ressourcenzugriff
Wechseln Sie dazu in den Grundeinstellungen der neuen Integration auf den Eintrag "API" und wählen für die "verfügbaren APIs" den Ressourcenzugriff "Alle(s)" bzw. "All".
...
Speichern Sie im Anschluss Ihre neue Integration!
6) Aktivieren Sie die Integration für microtech büro+
In der Übersicht der Integrationen finden Sie die neu angelegte Integration "microtech", die Sie über die in der Tabelle blau unterlegte Schrift: "Aktivieren" freischalten können.
7) Berechtigungen für API-Zugriff durch Integration für büro+ erlauben
Es erfolgt nun eine Abfrage, ob die ausgewählte Integration ("microtech") über die API Zugang zu den dargestellten Bereichen in Magento 2 bekommen soll. Erlauben Sie diese Berechtigungen.
8) Notieren Sie die Integrations-Tokens für den Zugang zu büro+
- Client Key / Konsumentenschlüssel
- Client Secret / Konsumentengeheimnis
- Access Token / Zugriffstoken
- Access Token Secret / Zugriffstoken-Geheimnis
Note | ||
---|---|---|
| ||
Notieren Sie sich die Zugangsdaten und verwahren Sie diese an einem nur für Sie zugängliche Ort auf. Es ist auch möglich, diese in eine Datei zu kopieren - auch hier gilt, bewahren Sie diese sorgsam auf. Die Zugangsdaten werden im nächsten Schritt in microtech büro+ eingetragen. |
Magento 2: Plattform in microtech büro+ einrichten und verbinden (ohne Einsatz der Middleware)
Die Einrichtung eines Magento 2-Shops erfolgt bei Einsatz unserer integrierten Lösung - wie gewohnt - über den Bereich E-COMMERCE – STAMMDATEN – Register: "Plattformen":
Wechseln Sie in microtech büro+ in den Bereich: E-COMMERCE - STAMMDATEN. Sollte das Register: PLATTFORMEN noch nicht eingeblendet sein, können Sie dieses über den "Überblick" einblenden.
Magento Plattform-Typ anlegen
Wählen Sie auf dem Register: PLATTFORMEN die Schaltfläche: NEU.
...
Note | ||
---|---|---|
| ||
|
Wechseln Sie auf das Register: ZUGANGSDATEN
An dieser Stelle werden die Zugangsdaten zu Ihrem Shop eingegeben. Der Name der angelegten Integration muss Ihrem Benutzernamen für den Shop entsprechen.
Feld in microtech büro+ Zugangsdaten | Sicherheitsmerkmal der eingerichteten Integration in Magento 2 |
---|---|
Benutzername | Benutzername im Backend (gleicher Name wird auch für Integration vergeben) |
Passwort | Passwort Ihres Backend-Zugangs |
URL | URL Ihres Magento 2 - Shops: URL ohne Zusatz "/admin", z. B.: https://magento123456.meinlieblingssuperdemoshop.de/ |
Speichern & schließen Sie im Anschluss Ihre Eingaben. Mittels der Zugangsdaten wird die Verbindung in Zusammenarbeit mit der Cloud zum Shopsystem hergestellt.
...
Note | ||
---|---|---|
| ||
Sollten Sie noch keine Zugangsdaten zur microtech Cloud hinterlegt haben, werden Sie nun darauf hingewiesen, dass diese Informationen unter: PARAMETER - SONSTIGE - ZUGANGSDATEN zu erfassen sind. Weitere Informationen hierzu finden Sie auch innerhalb unserer Online-Hilfe: Registrierung / Zugangsdaten für die microtech Cloud. |
Einladen der Eigenschaften und Kategorien aus dem Shopsystem
Im nächsten Schritt laden Sie direkt aus dem Shopsystem die Eigenschaften und Kategorien in büro+ ein. In büro+ beim Betätigen der Schaltfläche: SPEICHERN & SCHLIESSEN die Abfrage, ob die Einstellungen zur Plattform importiert werden sollen.
Wir empfehlen Ihnen mit der Schaltfläche: "JA" diese einzuladen. Zu späteren Zeitpunkten können diese auch manuell eingeladen / aktualisiert werden.
Für die Shop-Einrichtung empfiehlt es sich, mit den Kategorien zu beginnen. Wenn klar ist, welche Produkt-Kategorien angezeigt werden sollen, ist es einfacher, die dazugehörigen Eigenschaften und Einstell-Optionen zu bilden. Über den Bereich: E-COMMERCE – MAGENTO 2-PLATTFORM – Register: "Kategorien kann zu den Kategorien gewechselt werden. Nach dem Einrichten der Plattform ist der Kategorie-Baum zunächst noch leer.
Kategorien initial einladen
Wählen Sie im Bereich: E-COMMERCE-MAGENTO-SHOP - Register: KATEGORIEN über die Schaltfläche: SCHNITTSTELLEN den Eintrag: KATEGORIEN INITIAL EINLADEN.
Der Initialimport lädt die bestehenden Kategorien aus Magento 2 in der dort angelegten Gliederung / Reihenfolge herunter.
In der Übersicht sollte nun die "Hauptkategorie" als Standard vorhanden sein.
Kategorien und Unterkategorien erfassen
Über die Schaltfläche: NEU lässt sich auf dem Register: KATEGORIEN ein Kategorienbaum mit verschiedenen Ästen aufbauen. Um eine Unterkategorie zu erstellen, markieren Sie zunächst die Hauptkategorie, zu der die Unterkategorie erstellt werden soll und wählen die Schaltfläche: NEU.
In der Erfassungsmaske vergeben Sie eine Bezeichnung für den neuen Magento-Shop-Kategorie-Datensatz. Im Kopf der Maske erhalten Sie unter der "Bezeichnung" auch eine Referenz zur übergeordneten Kategorie. Über das Auswahlfeld können Sie an dieser Stelle ggf. auch noch einmal die Zuordnung ändern.
Kategorien an die Plattform übermitteln
Nachdem Sie Ihren Kategorienbaum erstellt haben, laden Sie diesen zur Plattform hoch. Wählen Sie hierzu auf dem Register: KATEGORIEN die Schaltfläche: WEITERE - BEREICHS-AKTIONEN - "Kategorien an die Plattform übermitteln".
Note | ||
---|---|---|
| ||
Soll eine Kategorie gelöscht werden, muss diese Kategorie in microtech büro+ UND im Backend von Magento 2 gelöscht werden. Weitere ausführliche allgemeine Informationen zur Logik der Kategorien in büro+ erhalten Sie in folgendem Bereich der Hilfe: Kategorien. |
Eigenschaften (und Einstell-Optionen) einladen
Die Eigenschaften und Einstell-Optionen können jederzeit manuell eingeladen / aktualisiert werden.
Wählen Sie im Bereich: E-COMMERCE-MAGENTO-SHOP - Register: EIGENSCHAFTEN über die Schaltfläche: SCHNITTSTELLEN den Eintrag: NEUE EIGENSCHAFTEN EINLADEN.
Der Import lädt die bestehenden Eigenschaften aus Magento 2 herunter und listet diese auf.
Nachdem die Eigenschaften in büro+ eingeladen wurden, können diese konfiguriert werden. Je nach Eigenschaft kann der Vorgabewert ein Textfeld, Zahl, Datum oder Kennzeichen, etc. sein. Die Eigenschaften lassen sich in den jeweiligen Plattform-Artikel konfigurieren.
...
title | Beachten Sie: |
---|
Auf dem Register der Plattformartikel (z. B. Magento 2-Artikel) wird über die Schaltfläche: WEITERE - BEREICHS-AKTIONEN ein Aktualisierungslauf der Eigenschaften und Einstell-Optionen über die Artikel durchgeführt. Auf diese Weise werden die Einstellungen der einzelnen Plattform-Artikel, die auf "Aktualisierungslauf" eingestellt sind, entsprechend berücksichtigt. Nach diesem Aktualisierungslauf ist der aktualisierte Plattform-Artikel zu übertragen.
...