Visser Labs – WooCommerce Plugins

  1. Startseite
  2. Wissensdatenbank
  3. WooCommerce Store Exporter Deluxe
  4. Automatisierung & Zeitplanung
  5. Wie man Exporte an eine entfernte URL in Store Exporter Deluxe POSTET
  1. Startseite
  2. Wissensdatenbank
  3. WooCommerce Store Exporter Deluxe
  4. Wie man Exporte an eine entfernte URL in Store Exporter Deluxe POSTET

Wie man Exporte an eine entfernte URL in Store Exporter Deluxe POSTET

Eine Exportdatei manuell an ein anderes System zu übergeben, sei es ein Reporting-Tool, ein Inventarsystem oder ein selbst ausgeführtes Skript, bedeutet, dass jemand sich anmelden, die Datei herunterladen und sie erneut hochladen muss. Store Exporter Deluxe kann diesen letzten Schritt für Sie übernehmen. Jedes Mal, wenn ein geplanter Export ausgeführt wird, sendet er die fertige Datei mit einer HTTP-POST-Anfrage an eine von Ihnen gewählte Webadresse.

Unten richten Sie POST an URL ein, sehen genau, was Ihr Endpunkt empfängt, und bestätigen, dass jede Datei angekommen ist. Entwickler erhalten auch eine Möglichkeit, Header wie ein API-Token hinzuzufügen.

Voraussetzungen

AnforderungDetails
PluginStore Exporter Deluxe ist aktiv
Geplante ExporteGeplante Exporte werden unter Einstellungen → Planung → Geplante Exporte aktivieren eingeschaltet. Wenn sie deaktiviert sind, zeigt der Bildschirm Geplante Exporte „Geplante Exporte sind derzeit deaktiviert.“ mit einer Schaltfläche Geplante Exporte aktivieren an.
Empfangender EndpunktEine Webadresse (URL), die POST-Anfragen akzeptiert und von Ihrem Website-Server aus erreichbar ist
EndpunktzugriffEine Möglichkeit, die Protokolle des empfangenden Systems zu überprüfen, damit Sie die Ankunft von Dateien bestätigen können

So funktioniert's

Wenn ein Zeitplan mit POST an URL ausgeführt wird, erstellt Store Exporter Deluxe wie gewohnt die Exportdatei und sendet sie dann in einer einzigen HTTP-POST-Anfrage an Ihre Remote-POST-URL. Die Anfrage ist immer ein POST. Es gibt keine Einstellung, um sie auf eine andere Methode umzuschalten.

Was Ihr Endpunkt empfängt

Ihr Endpunkt erhält den Inhalt der Exportdatei als rohen Body der Anfrage. Er kommt nicht als Datei-Upload-Formular an, sodass kein Formularfeld zum Lesen der Datei vorhanden ist. Wenn die Beschreibung Remote-URL-Einstellungen auf Ihrem Bildschirm eine Multipart-POST-Anfrage erwähnt, halten Sie sich an diesen Abschnitt: Die Datei ist der rohe Anfrage-Body.

Teil der AnfrageWas es enthält
MethodePOST
BodyDer vollständige Inhalt der Exportdatei, genau wie er in der heruntergeladenen Datei erscheinen würde
content-type-HeaderDer MIME-Typ, der Ihrem Exportformat entspricht (siehe Tabelle unten)
accept-HeaderDer gleiche MIME-Typ wie der content-type-Header
user-agent-HeaderWordPress/ gefolgt von Ihrer WordPress-Version

Store Exporter Deluxe sendet nicht den Dateinamen, zusätzliche Formularfelder oder Anmeldedaten. Es wartet bis zu 60 Sekunden auf eine Antwort und folgt keinen Weiterleitungen, geben Sie also die endgültige Adresse Ihres Endpunkts ein.

Der content-type-Header hängt vom gewählten Exportformat für den Zeitplan ab:

Exportformatcontent-type-Wert
CSVtext/csv
TSVtext/tab-separated-values
Excel (XLS)application/vnd.ms-excel
Excel (XLSX)application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
XMLapplication/xml
RSS 2.0application/rss+xml

POST an URL senden

Die folgenden Schritte beschreiben die Erstellung eines neuen geplanten Exports. Um einen bestehenden Zeitplan zu ändern, öffnen Sie ihn auf dem Bildschirm Geplante Exporte. Weitere Informationen zum Erstellen und Verwalten von Zeitplänen finden Sie unter So planen Sie Exporte in Store Exporter Deluxe.

Schritt 1: Öffnen Sie das Formular für neue Zeitpläne

  1. Gehe zu WooCommerce → Store Export.
  2. Klicken Sie in der Store Exporter-Seitenleiste auf Geplante Exporte.
  3. Klicken Sie auf Neuer Zeitplan. Das Formular wird mit der Überschrift Neuen geplanten Export hinzufügen und fünf Schritten oben geöffnet: Allgemein, Filter, Methode, Zeitplanung und Erweitert.
Der Bildschirm Geplante Exporte mit der Schaltfläche "Neuer Zeitplan" in der oberen rechten Ecke hervorgehoben

Schritt 2: Wählen Sie aus, was exportiert werden soll

Konfigurieren Sie auf dem Schritt Allgemein den Export selbst.

  1. Geben Sie einen Namen in Name des Zeitplans ein. Dieses Feld ist erforderlich.
  2. Wählen Sie den Datentyp aus Exporttyp, z. B. Produkte oder Bestellungen.
  3. Wählen Sie den Dateityp aus Exportformat. Wählen Sie ein Format, das Ihr Endpunkt lesen kann, aus der Tabelle Exportformat unter „Was Ihr Endpunkt empfängt“ oben.
  4. Wählen Sie unter Exportfelder Alle Felder, Vorlage verwenden oder Gespeicherte Auswahl.

Der Schritt Allgemein enthält auch Optionen zur Datei- und Datenformatierung, wie z. B. das Spaltentrennzeichen und die Kopfzeilenformatierung. Lassen Sie diese unverändert, es sei denn, Ihr Endpunkt erwartet ein bestimmtes Layout.

Der Schritt "Allgemein" des neuen Zeitplanformulars mit den Optionen "Name des Zeitplans", "Exportformat" und "Exportfelder", die mit 1 bis 3 gekennzeichnet sind

Schritt 3: Export mit Filtern eingrenzen (optional)

Öffnen Sie den Schritt Filter, wenn Sie nur bestimmte Datensätze senden möchten, z. B. Bestellungen mit einem bestimmten Status. Überspringen Sie ihn, um jeden passenden Datensatz zu senden.

Schritt 4: Wählen Sie POST an URL

  1. Klicken Sie auf den Schritt Methode.
  2. Wählen Sie unter Zustellungsmethode die Karte POST an URL aus.
  3. Geben Sie unter Einstellungen für Remote-URL die Adresse Ihres Endpunkts in Remote-POST-URL ein, z. B. https://example.com/webhook/receive.
Die Karten für die Zustellmethode mit ausgewählter POST an URL und dem Bedienfeld "Zusammenfassung des Zeitplans", das die Methode als POST an Remote-URL anzeigt

Die Leiste Zusammenfassung des Zeitplans auf der rechten Seite wird aktualisiert, um POST an Remote-URL anzuzeigen, sobald die Karte ausgewählt ist.

Das Feld "Remote-POST-URL", gefüllt mit einer Beispieladresse

Das Feld Remote-POST-URL ist die einzige Einstellung, die diese Zustellungsmethode hat. Verwenden Sie die vollständige Adresse, einschließlich https://.

Schritt 5: Legen Sie fest, wann er ausgeführt wird

Wählen Sie auf dem Schritt Zeitplanung aus, wie oft der Export ausgeführt wird.

  • Stündlich: jede Stunde.
  • Täglich: einmal pro Tag.
  • Wöchentlich: einmal pro Woche.
  • Monatlich: am 1. jedes Monats.
  • Benutzerdefiniert: ein sich wiederholendes Intervall, das Sie in Ausführen alle festlegen.
  • Manuell: nur wenn Sie ihn selbst ausführen.

Wählen Sie eine Zeit und Zeitzone für die Ausführung und entscheiden Sie, ob sie sofort oder zu einem von Ihnen festgelegten Datum beginnt. Um zur lokalen Zeit Ihres Shops auszuführen, siehe So planen Sie Exporte nach Ihrer lokalen Zeit.

Der Schritt "Zeitplanung" mit den Optionen "Häufigkeit", den Feldern "Uhrzeit" und "Zeitzone" sowie den Optionen "Start", die mit 1 bis 3 gekennzeichnet sind

Schritt 6: Überprüfen Sie die erweiterten Optionen

Der Schritt Erweitert enthält weitere Optionen, wie z. B. Dateibenennung, Archivverwaltung und Protokollierung. Zwei davon sind für POST an URL am wichtigsten:

  • Dateinamensmuster: benennt die Exportdatei auf Ihrer Website. Der Dateiname wird nicht an Ihren Endpunkt gesendet.
  • Protokollierungsstufe: legt fest, wie viele Details das Audit-Protokoll für diesen Zeitplan aufzeichnet. Diese Option wird nur angezeigt, wenn das Audit-Protokoll aktiviert ist und die Protokollquelle Geplante Exporte nicht auf Keine gesetzt ist (Einstellungen → Audit-Protokoll → Protokollquellen).

Schritt 7: Speichern Sie den Zeitplan

  1. Überprüfen Sie das Panel Zusammenfassung des Zeitplans auf der rechten Seite. Methode sollte POST an Remote-URL anzeigen.
  2. Klicken Sie auf Zeitplan erstellen. Bei einem vorhandenen Zeitplan liest diese Schaltfläche Zeitplan speichern.

Überprüfung, ob die Datei angekommen ist

Store Exporter Deluxe zeichnet auf, ob es Ihren Endpunkt erreichen konnte, aber es liest nicht die Antwort Ihres Endpunkts. Überprüfen Sie also beide Seiten:

  1. Öffnen Sie das eigene Anforderungsprotokoll Ihres Endpunkts oder das empfangende Tool und suchen Sie nach einer POST-Anforderung zum Zeitpunkt der Ausführung des Zeitplans.
  2. Bestätigen Sie, dass der Anforderungstext die Exportdatei ist und dass sie korrekt geöffnet wird.
  3. Gehen Sie in WordPress zu Geplante Exporte in der Store Exporter-Seitenleiste. Die Liste Letzte Aktivität dort zeigt jede Ausführung an. Klicken Sie auf Nur Fehler neben Alle Aktivitäten, um nur fehlgeschlagene Ausführungen anzuzeigen. Klicken Sie auf Alle Aktivitäten, um jede Ausführung wieder anzuzeigen.
  4. Für weitere Details öffnen Sie das Audit-Protokoll aus derselben Seitenleiste und suchen Sie die Ausführung.
Die Liste "Letzte Aktivitäten" auf dem Bildschirm "Geplante Exporte" mit der hervorgehobenen Schaltfläche "Nur Fehler"

Das Audit-Protokoll ist standardmäßig aktiviert. Der Eintrag Audit-Protokoll erscheint nur in der Store Exporter-Seitenleiste, wenn das Audit-Protokoll eingeschaltet ist. Wenn es ausgeschaltet ist, gehen Sie zu Einstellungen in der Store Exporter-Seitenleiste, öffnen Sie den Abschnitt Audit-Protokoll und schalten Sie Audit-Protokoll aktivieren ein.

Um zu testen, ohne auf die nächste geplante Ausführung zu warten, richten Sie Remote POST-URL auf einen Anforderungserfassungsdienst, während Sie die Dinge einrichten. Klicken Sie auf dem Bildschirm Geplante Exporte auf das Drei-Punkte-Menü in der Zeile des Zeitplans und klicken Sie auf Jetzt ausführen. Überprüfen Sie dann, was angekommen ist. Wechseln Sie dann die Adresse zu Ihrem echten Endpunkt.

Wenn eine Anforderung überhaupt keine Verbindung herstellen kann, zum Beispiel weil die Adresse falsch eingegeben wurde, der Server ausgefallen ist oder die Verbindung zu lange dauert, wird die Ausführung im Audit-Protokoll als fehlgeschlagen markiert. Store Exporter Deluxe sendet die Datei einmal pro Ausführung. Die nächste geplante Ausführung erstellt und sendet eine neue Datei.

Hinzufügen eines API-Schlüssels oder anderer Header (Entwickler)

Der Einstellungsbildschirm enthält keine Felder für Authentifizierungsheader. Wenn Ihr Endpunkt einen API-Schlüssel oder ein Token benötigt, kann ein Entwickler Header mit dem Filter wsed_scheduled_export_post_args hinzufügen. Fügen Sie diesen Code zu einem benutzerdefinierten Plugin oder zur Datei functions.php Ihres Child-Themes hinzu:

add_filter( 'wsed_scheduled_export_post_args', function ( $args ) {
    $args['headers']['Authorization'] = 'Bearer YOUR_API_TOKEN';
    return $args;
} );

Ersetzen Sie YOUR_API_TOKEN durch das Token, das Ihr Endpunkt erwartet. Der Code wird zu den vorhandenen Headern hinzugefügt, anstatt sie zu ersetzen, sodass der content-type-Header an seinem Platz bleibt.

Dieser Filter gilt für jede Planung, die An URL senden verwendet, einschließlich des Auslöser für neue Bestellungen in Einstellungen. Er kann nicht verschiedene Header an verschiedene Endpunkte senden.

Fehlerbehebung

Das Audit-Protokoll zeigt einen fehlgeschlagenen Lauf für meine Planung „An URL senden“ an
Stellen Sie sicher, dass die Remote-POST-URL korrekt geschrieben ist und https:// enthält. Bestätigen Sie dann, dass der empfangende Server online ist und Anfragen von der IP-Adresse Ihres Hosting-Anbieters nicht blockiert. Store Exporter Deluxe zeichnet einen Fehler auf, wenn es keine Verbindung zu Ihrem Endpunkt herstellen kann.
Der Lauf wird als abgeschlossen angezeigt, aber nichts ist bei meinem Endpunkt angekommen
Überprüfen Sie die eigenen Protokolle Ihres Endpunkts auf eine abgelehnte Anfrage, z. B. einen Anmeldefehler oder einen falschen Inhaltstyp. Wenn ein API-Schlüssel benötigt wird, fügen Sie den Header mit dem Filter im obigen Entwicklerbereich hinzu. Store Exporter Deluxe markiert einen Lauf als abgeschlossen, sobald die Anfrage Ihren Server erreicht, unabhängig von der Antwort des Servers.
Mein Endpunkt empfängt die Anfrage, kann aber die Datei nicht finden
Die Datei ist der Rohkörper der Anfrage, kein Formularfeld. Aktualisieren Sie Ihren Endpunkt, um den Anfragetext direkt zu lesen, anstatt nach einer hochgeladenen Datei zu suchen.
Mein Endpunkt leitet die Anfrage an eine andere Adresse weiter
Store Exporter Deluxe folgt keinen Weiterleitungen. Geben Sie die endgültige Adresse in Remote-POST-URL ein, zum Beispiel die https://-Adresse, wenn Ihr Endpunkt von http:// weiterleitet.
Ich kann „Geplante Exporte“ nicht in der Store Exporter-Seitenleiste finden
Gehen Sie zu Einstellungen in der Store Exporter-Seitenleiste, öffnen Sie den Abschnitt Erweitert und schalten Sie Tab „Geplante Exporte“ ausblenden aus. Wenn diese Option aktiviert ist, wird der Eintrag Geplante Exporte aus der Seitenleiste entfernt.
Ein großer Export schlägt fehl (Timeout)
Store Exporter Deluxe wartet bis zu 60 Sekunden auf eine Antwort Ihres Endpunkts. Wenn Ihr Endpunkt länger benötigt, grenzen Sie den Export im Schritt Filter ein, damit eine kleinere Datei erstellt wird.

Häufig gestellte Fragen

Kann ich PUT oder eine andere Methode anstelle von POST verwenden?
Nein. Die Anfrage ist immer ein HTTP POST.
Kann ich einen API-Schlüssel oder einen Autorisierungsheader hinzufügen?
Nicht über den Einstellungsbildschirm. Ein Entwickler kann Header mit dem Filter wsed_scheduled_export_post_args hinzufügen. Siehe den Entwicklerbereich oben.
Wird die Datei als Formular-Upload gesendet?
Nein. Der Dateiinhalt ist der Rohkörper der Anfrage, mit einem content-type-Header, der dem Exportformat entspricht.
Versucht Store Exporter Deluxe einen erneuten Versuch, wenn die Anfrage fehlschlägt?
Nein. Die Datei wird einmal pro Lauf gesendet. Der nächste geplante Lauf sendet eine neue Datei.
Erhält der Endpunkt den Dateinamen?
Nein. Es werden nur die Dateiinhalte und die oben aufgeführten Header gesendet.
Ist POST an URL im kostenlosen Store Exporter Plugin verfügbar?
Nein. Geplante Exporte und jede Zustellmethode sind Teil von Store Exporter Deluxe.

Benötigen Sie Hilfe?

Wenn Sie eine Frage haben oder auf Probleme stoßen, sind wir für Sie da.

War dieser Artikel hilfreich?

Verwandte Artikel

Ressourcen & Hilfe