Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

--- public:faqoxid2tradebyteoxid6 [2020/07/16 15:16]
josefineleuschner [Voraussetzungen]
+++ public:faqoxid2tradebyteoxid6 [2022/02/28 13:48] (aktuell)
josefineleuschner [Composer]
@@ Zeile 5: / Zeile 5: @@
 Das Plugin auf Github: https://github.com/FATCHIP-GmbH/plugin-oxid6-oxid2tradebyte (private)
+{{:public:fc_plugin_oxid2tradebyte_usecase_process_de.png?nolink&800|}}
 ===== Voraussetzungen =====
@@ Zeile 14: / Zeile 15: @@
 ===== Installation =====
+==== Composer ====
+Öffnen Sie die Datei **composer.json** im Stammverzeichnis Ihres Shops und fügen Sie das Repository hinzu oder vervollständigen Sie die vorhandene Konfiguration: \\
+<code yaml>
+"repositories": [{
+  "type": "composer",
+  "url": "https://packages.fatchip.de/packages"
+}]
+</code>
+Nach erfolgter Ergänzung der Datei //composer.json// können Sie da Plugin installieren.\\ Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden.\\
+Führen Sie folgenden Befehl aus, um das Plugin zu installieren
+    composer require fatchip-gmbh/plugin-oxid6-oxid2tradebyte
+Beachten Sie, dass der genaue Aufruf des Composers für Ihre konkrete OXID-Installation abweichen kann. \\
+Sie werden nun nach einem Benutzer und einem Passwort gefragt. Geben Sie die Zugangsdaten ein, welche Ihnen per E-Mail übersandt wurden.\\
+Bitte speichern Sie diese Zugangsdaten **nicht** auf Ihrem Server, da es sonst zu Problemen kommt, sollten Sie mehrere unserer Plugins einsetzen oder einsetzen wollen.
+Nach korrekter Eingabe der Zugangsdaten wird das Plugin installiert.
+==== Manuell ====
 === Inhalt aus dem Pluginpaket kopieren ===
 Kopiern Sie den Inhalt aus dem Pluginpaket fcOxid2Tradebyte_VERSION_oxid6_source in SHOPROOT/source/modules Ihrer OXID eShop-Installation (bei FTP - binären Übertragungsmodus nutzen).
@@ Zeile 30: / Zeile 50: @@
 **In OXID-Versionen ab 6.2 (ältere Versionen können den Schritt überspringen)** muss die Modulkonfiguration eingelesen werden.\\
 Melden Sie sich dazu per SSH an dem Server an, auf dem sich die Shop-Installation befindet, und navigieren Sie zu dem Verzeichnis, in dem sich der Source- und Vendorornder befinden. Führen Sie die folgenden Befehle aus:\\
-<code> /vendor/bin/oe-console oe:module:install-configuration source/modules/fc/fctradebyteone
+    vendor/bin/oe-console oe:module:install-configuration source/modules/fc/fcTradebyteOne
-/vendor/bin/oe-console oe:module:apply-configuration </code>
+    vendor/bin/oe-console oe:module:apply-configuration
 Bei erfolgreichem Einlesen/Import erscheint die Nachricht\\
 **Module configuration has been installed**
@@ Zeile 63: / Zeile 83: @@
 ----
-===== Konfiguration =====
+===== Konfiguration OXID 2 Tradebyte Connector =====
-=== OXID 2 Tradebyte Connector Grundeinstellungen ===
+{{public:faq:ox2tb_ox6:201113_ox2tb_setting_1.png?nolink|}}
+=== Grundeinstellungen ===
 Die Grundeinstellungen des Connectors finden Sie unter //Erweiterungen -> Module -> FATCHIP Oxid2Tradebyte Connector -> Einstellungen -> Grundeinstellungen//.
-{{:public:o2tb_2.1.png?nolink&800|}}
+{{public:faq:ox2tb_ox6:201113_ox2tb_basic_settings.png?nolink|}}
 ^ Konfiguration ^ Beschreibung ^
@@ Zeile 74: / Zeile 96: @@
 |PHP-Interpreter für den Exportaufruf|Hier müssen Sie den verwendeten PHP-Interpreter eintragen. Dies sind mögliche PHP-Interpreter-Pfade: \\ ///usr/bin/php// \\ ///usr/bin/php_cli// \\ ///usr/bin/php5//|
-=== Tradebyte Channels ===
+=== Tradebyte sFTP und REST-API Zugangsdaten ===
-Die OXID 2 Tradebyte Connector Channels finden Sie unter //Erweiterungen -> Module -> FATCHIP Oxid2Tradebyte Connector -> Einstellungen -> Tradebyte Channels//. Hier können Sie entscheiden, welche Channels aktiv oder inaktiv sein sollen. Die XML mit Ihren Produktdaten wird für die aktiven Channels aufbereitet und auf dem Tradebyte Server zur Verfügung gestellt.
+{{public:faq:ox2tb_ox6:201113_ox2tb_setting_sftp.png?nolink|}}
+Es stehen zwei verschiedene Verbindungsarten zu Tradebyte zur Verfügung. Entweder eine Verbindung über einen sFTP-Server oder über die Tradebyte REST-API. Die Zugangsdaten können Sie unter //Erweiterungen -> Module -> FATCHIP Oxid2Tradebyte Connector -> Einstellungen -> Tradebyte sFTP Zugangsdaten// oder //Tradebyte REST-API Zugangsdaten// hinterlegen.
-{{:public:o2tb_2.2.png?nolink&800|}}
-^ Konfiguration ^ Beschreibung ^
-|Active Dropdown|Über das Dropdown können Sie einzelne Channels aktiv oder inaktiv schalten.|
-|{{:public:o2tb_2.2_1.png?nolink&300|}}|//Inactive, but visible in admin:// \\ Dieser Channel ist inaktiv, wird aber bei den Artikeln im OXID Administrationsbereich angezeigt.|
-=== Tradebyte FTP und REST-API Zugangsdaten ===
+**Die Verbindung über REST-API sollte immer der bevorzugte Weg sein und wird auch von Tradebyte forciert.**
-Es stehen zwei verschiedene Verbindungsarten zu Tradebyte zur Verfügung. Entweder eine Verbindung über einen FTP-Server oder über die Tradebyte REST-API. Die Zugangsdaten können Sie unter //Erweiterungen -> Module -> FATCHIP Oxid2Tradebyte Connector -> Einstellungen -> Tradebyte FTP Zugangsdaten// oder //Tradebyte REST-API Zugangsdaten// hinterlegen.
-{{:public:o2tb_2.3.png?nolink&800|}}
+{{public:faq:ox2tb_ox6:201113_ox2tb_setting_rest.png?nolink|}}
 ^ Konfiguration ^ Beschreibung ^
-|FTP-Upload aktiv|Verbindung zu Tradebyte über einen FTP-Server aktivieren|
+|sFTP-Upload aktiv|Verbindung zu Tradebyte über einen sFTP-Server aktivieren|
-|Host-URL|Host-URL (FTP Zugangsdaten)|
+|Host-URL|Host-URL (sFTP Zugangsdaten)|
-|Benutzername|Benutzername (FTP Zugangsdaten)|
+|Benutzername|Benutzername (sFTP Zugangsdaten)|
-|Passwort|Passwort (FTP Zugangsdaten)|
+|Passwort|Passwort (sFTP Zugangsdaten)|
 |REST Upload aktiv (Deaktivieren zu Testzwecken)|Verbindung zu Tradebyte über die REST-API aktivieren|
 |API-URL (i.e. rest.trade-server.net)|Für die benötigten Zugangsdaten müssen Sie einen API Benutzer im TB.One Webinterface anlegen.|
@@ Zeile 102: / Zeile 118: @@
 Neben dem Export der Produkte zu Tradebyte, ist es auch möglich die Bestellungen aus anderen Channels zu importieren. Die Einstellungen für den Import der Bestellungen können Sie unter //Erweiterungen -> Module -> FATCHIP Oxid2Tradebyte Connector -> Einstellungen -> Order Import// vornehmen.
-{{:public:o2tb_2.4.png?nolink&800|}}
+{{public:faq:ox2tb_ox6:201113_ox2tb_setting_order_import.png?nolink|}}
 ^ Konfiguration ^ Beschreibung ^
 |Order import active|Import der Bestellungen aktivieren oder deaktivieren|
-|Kommunikationsart Order Import|Order Importiert über FTP oder REST API|
+|Kommunikationsart Order Import|Order Importiert über sFTP oder REST API|
 |Order xml dir on remote server|Der Pfad zum Verzeichnis auf dem entfernten Server, in dem die XML-Datei mit den Bestellungen aus den Channels liegt.|
 |Default payment id, which will be used for order import|Die Standard Bezahlmethode für importierte Bestellungen aus den Channels.|
@@ Zeile 116: / Zeile 132: @@
 Die Produkte Einstellungen können Sie unter //Erweiterungen -> Module -> FATCHIP Oxid2Tradebyte Connector -> Einstellungen -> Produkte Einstellungen// vornehmen.
-{{:public:o2tb_2.5.png?nolink&800|}}
+{{public:faq:ox2tb_ox6:201113_ox2tb_setting_product_settings.png?nolink|}}
 ^ Konfiguration ^ Beschreibung ^
@@ Zeile 125: / Zeile 141: @@
 Das Logging können Sie unter //Erweiterungen -> Module -> FATCHIP Oxid2Tradebyte Connector -> Einstellungen -> Logging// aktivieren. Durch das Aktivieren der Logging Funktion werden Exportinformationen in einer Log-Datei gespeichert.
-{{:public:o2tb_2.6.png?nolink&800|}}
+{{public:faq:ox2tb_ox6:201113_ox2tb_setting_log.png?nolink|}}
 ^ Konfiguration ^ Beschreibung ^
 |Loglevel (1-4)|1: Nur Fehler \\ 2: Fehler und Warnungen \\ 3: Fehler, Warnungen und Abläufe \\ 4: Entwicklerdebugging|
 |XML Archivierungsdauer in Tagen|Hier können Sie die Archivierungsdauer in Tagen einstellen.|
+=== Tradebyte Channels ==
+Im OXID Administrationsbereich unter //FC Tradebyte -> Tags// können Sie die Tradebye Channels aktivieren, deaktivieren und konfigurieren. In diesem Beispiel sehen Sie drei Tradebyte Channel, die aktiviert wurden.\\
+{{public:faq:ox2tb_ox6:201113_ox2tb_setting_channels.png?nolink|}}
+Wählen Sie einen Channel aus der Dropdownliste in der unteren Hälfte aus und klicken Sie auf "Speichern". Der Channel erscheint dann in der oberen Liste und steht Ihnen bei den Artikeln (Vater und Varianten) zur Auswahl zur Verfügung.\\
+Mit Klick auf einen der Channels in der oberen Liste erhalten Sie die Konfigurationsmöglichkeiten dieses Channels\\
+{{public:faq:ox2tb_ox6:201113_ox2tb_setting_channel_konfig.png?nolink|}}
 === Tradebyte Tags ===
@@ Zeile 143: / Zeile 166: @@
 ----
-===== Export =====
+===== Artikelzuordnung zu den Tradebyte Channel =====
+Ab der Modulversion **1.0.4** wird der TB Cat 1.4 verwendet. Dieser ermöglicht die Aktivierung von Artikeln auf Variantenebene für die einzelnen Kanäle.\\
-=== Artikel für den Export vorbereiten ===
+. **Export aller Varianten eines Artikels an einen Kanal**\\
-Damit die Artikel für Tradebyte aufbereitet und exportiert werden, müssen diese für den Export aktiviert werden. Unter //Artikel verwalten -> Artikel -> Oxid2Tb Reiter// können Sie auswählen welcher Channel für diesen Artikel aktiv sein soll und den Artikel für den Export aufbereiten.
+  Um alle in OXID aktiven Varianten an einen Kanal zu exportieren, müssen Sie nur den Kanal im Tab *OXID2TB* beim Vater aktivieren.\\
+  {{public:faq:ox2tb_ox6:201113_ox2tb_setting_article_parent.png?nolink|}}\\
-{{:public:o2tb_3.1.png?nolink&800|}}
+. **Export einzelner Varianten eines Artikels an einen Kanal**\\
+  Um nur einzelne Varianten eines Artikels an einen Kanal zu exportieren, aktivieren Sie den Kanal im Tab *OXID2TB* **beim Vater**.\\
+  Wechseln Sie danach zur Variante, die Sie an den Kanal übergeben möchten und aktivieren Sie den Kanal im Tab *OXID2TB* der Variante.\\
+  {{public:faq:ox2tb_ox6:201113_ox2tb_setting_article_variant.png?nolink|}}\\
 ^ Konfiguration ^ Beschreibung ^
@@ Zeile 154: / Zeile 180: @@
 |alternative Langbeschreibung|Eine alternative Langbeschreibung für den Export an Tradebyte.|
 |alternative Produktbilder für Tradebyte|Artikelbilder werden in der Detailansicht eines Artikels verwendet. Sie können bis zu 7 Artikelbilder pro Artikel hochladen. Nach dem Hochladen wird der Dateiname im jeweiligen Eingabefeld angezeigt. Wenn noch kein Bild hochgeladen wurde, wird --- angezeigt. \\ Es können Bilder mit maximal 2 MB oder 1500*1500 Pixel Auflösung hochgeladen werden. Diese Einschränkung gilt, um Probleme mit dem PHP-Speicherlimit zu vermeiden. Danach wird aus diesen Bildern automatisch das Artikelbild, Zoombild, Thumbnail und Icon generiert.|
-|{{:public:o2tb_3.1_1.png?nolink&500}}|Hier können Sie dem Artikel bestimmte Tags zuweisen. \\ Dazu wählen Sie einen Tag und eine passende Option aus und bestätigen die Eingabe über den „Add“ Button. \\ Die Tags und deren Optionen wurden zuvor im Schritt 2.7 angelegt.|
+|Channel Tag, Tag Value| Hier können Sie dem Artikel bestimmte Tags zuweisen. \\ Dazu wählen Sie einen Tag und eine passende Option aus und bestätigen die Eingabe über den „Add“ Button. \\ Die Tags und deren Optionen wurden zuvor im Schritt 2.7 angelegt. \\ {{:public:o2tb_3.1_1.png?nolink&500}}|
-|Channel Tag, Tag Value| |
-=== Einzelne Varianten vom Export ausschließen ===
+----
-Unter //Artikel verwalten -> Artikel -> Varianten -> Oxid2Tb Reiter// können einzelne Varianten vom Export ausgeschlossen werden. Diese Varianten Artikel werden nicht für Tradebyte aufbereitet und exportiert.
-{{:public:o2tb_3.4.png?nolink&800|}}
+===== Export =====
 === Export manuell erstellen ===
 Sie können unter //FC Tradebyte -> Oxid2Tb -> Stamm// den Export manuell anstoßen. Wenn Sie Artikel für den Export aktiviert haben, wird eine XML-Datei erstellt und auf dem Tradebyte Server zur Verfügung gestellt.
-{{:public:o2tb_3.2.png?nolink&800|}}
+{{public:faq:ox2tb_ox6:201113_ox2tb_setting_man_export.png?nolink|}}
 === Export über einen Cronjob erstellen ===
@@ Zeile 187: / Zeile 211: @@
   - [[#Wie verarbeitet das Plugin Teilstornierungen von Artikelpositionen auf OXID Seite bzw. wie verhält es sich bei Teillieferungen?]]
   - [[#Wichtige Information zur Benennung der XML Importdatei]]
-  - [[#Wichtige Information zum Orderimport]]
   - [[#Ist es möglich sFTP zu nutzen?]]
   - [[#Das Plugin ist richtig konfiguriert, es werden aber dennoch keine bzw. nicht alle Artikel exportiert.]]
@@ Zeile 217: / Zeile 240: @@
 Die Importdatei darf im Namen das Wort "TEST" NICHT enthalten.
-=== 9. Wichtige Information zum Orderimport ===
+=== 9. Ist es möglich sFTP zu nutzen? ===
-Der Orderimport ist aktuell (19.03.2014) nur über FTP möglich.
+Ein Nutzung von sFTP ist ab der Version 1.0.3 möglich.
-=== 10. Ist es möglich sFTP zu nutzen? ===
-Ein Nutzung von sFTP ist nicht möglich. Tradebyte stellt aber sowohl einen sFTP als auch einen FTP-Zugang zur Verfügung. Bitte wenden Sie sich an den Tradebyte-Support, um diese Daten abzufragen.
-=== 11. Das Plugin ist richtig konfiguriert, es werden aber dennoch keine bzw. nicht alle Artikel exportiert. ===
+=== 10. Das Plugin ist richtig konfiguriert, es werden aber dennoch keine bzw. nicht alle Artikel exportiert. ===
 Zu Tradebyte werden keine Artikel ohne EAN Nummer übertragen. Prüfen Sie daher bitte ob bei allen Artikel EAN-Nummern gepflegt sind oder aktivieren Sie bei Bedarf im Plugin die Option „Eigene EAN generieren wenn nicht gepflegt“. Danach sollte der Export wie gewünscht funktionieren.
-=== 12. Wie kann ein neuer Channel hinzugefügt werden? ===
+=== 11. Wie kann ein neuer Channel hinzugefügt werden? ===
 Wenn Sie für den Export einen neuen Channel hinzufügen möchten, müssen zwei Anpassungen vorgenommen werden.
@@ Zeile 266: / Zeile 286: @@
 </code>
-=== 13. Warum werden meine Attribute nicht exportiert ===
+=== 12. Warum werden meine Attribute nicht exportiert ===
 Für den Export der Attribute muss der jeweilige Wert in dem Feld **//Oxid2Tb attribute//** (Attribute -> Reiter "Oxid2Tb") gesetzt sein.

Fatchip GmbH Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge