http://wiki.dstore.de/ 2026-05-03T17:25:19+0200 http://wiki.dstore.de/ http://wiki.dstore.de/lib/tpl/dstore/images/favicon.ico text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/access?rev=1415876767&do=diff Zugriffsberechtigungen xml_SmartGate Bei den Zugriffsbeschränkungen wird grundsätzlich unterschieden zwischen * Zugriff auf die Weboberfläche („GUI“) * API-Zugriff zum automatischen Datenaustausch Zugriff auf die GUI ist für alle Benutzer möglich für die eine text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/items_in?rev=1415876767&do=diff items_in Diese Schnitttstelle dient dem Import von Artikeldaten aus einem Fremdsystem in den dStore. In der XML-Datei wird eine Liste von Artikeln mit ihren Varianten übergeben, wobei grundsätzlich zwei Arten von Listen unterschieden werden. Dies ist zum einen die vollständige Artikelliste (FullList) und zum anderen die Teilliste (PartialList). text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/items_in_configuration?rev=1415876767&do=diff items_in Konfiguration Die Konfiguration der Schnittstelle geschieht über ApplicationSettings. Eine Beispielkonfiguration zum Einlesen per Import-Funktion des admin_SmartGate findet sich hier: :!: Sofern es sich nicht um eine Sandbox-Umgebung handelt ist absolute Sorgfalt wichtig, da bestehende Einstellungen unter Umständen überschrieben werden. text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/items_in_internals?rev=1415876767&do=diff items_in Interna Ein Artikelimport läuft grundsätzlich so ab, dass die XML-Daten in die entsprechenden Schnittstellentabellen geschrieben werden. Nach dem Schreiben in die Schnittstellentabellen wird die Import-Prozedur aufgerufen. Es wird für den Import der Datenbankbenutzer text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/items_in_schema?rev=1415876767&do=diff items_in XML-Schema Schema Das vollständige Schema finden Sie unter items_in_v1_1.xsd. Im folgenden gehen wir auf die wichtigsten Elemente des Schemas ein. Beim Lesen hilft es sich die untenstehende Beispieldatei vor Augen zu halten. ListOfItems Dieses Element ist das Wurzelement und taucht genau einmal in einem items_in-Job auf. Es enthält wiederum ein oder mehrere Item-Elemente. text/html 2015-04-15T13:21:08+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/jobdownload?rev=1429096868&do=diff Download von Jobs Um Jobs unabhängig ihres Typs (Artikel, Personen, Aufträge) vom Server abzurufen verwenden Sie die folgende URL https://<Partner>-<Projekt>.dstore.de/xml/job mit den Pflichtparametern: * Interfacename : Name der Schnittstelle, also in der Regel text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/jobmanagement?rev=1415876767&do=diff Verwaltung von Jobs Neben dem Hochladen (Upload) von Jobs und dem Abrufen (Download) von Jobs gibt es weitere Methoden zur Verwaltung von Jobs. Es ist eine HTTP-Auth-Anmeldung mit einem dStore-User für alle diese Methoden erforderlich. jobqueue Liefert eine Liste mit allen Jobs in der Queue zur angegebenen Schnittstelle. Für die text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/jobupload?rev=1415876767&do=diff Upload von Jobs XML-Dateien werden grundsätzlich unabhängig ihres Typs (Artikel, Personen, Aufträge) an die folgende URL per POST-Request unter Angabe eines Benutzernamens und Kennwortes gesendet: https://<Partner>-<Projekt>.dstore.de/xml/upload text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/orders_in?rev=1415876767&do=diff orders_in Diese Schnitttstelle dient dem Import von Auftragsstatus, Auftragsinformationen und Positionsinformationen aus einem Fremdsystem in den dStore. :!: Mit dieser Schnittstelle können nicht, wie der Namen vermuten ließe, neue, noch nicht im dStore bestehende Aufträge importiert werden. text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/orders_in_configuration?rev=1415876767&do=diff orders_in Konfiguration Die Konfiguration der Schnittstelle geschieht über ApplicationSettings. Da diese Schnittstele kann Einstellungen hat haben wir auf eine Beispielkonfiguration zum Einlesen verzichtet. Alle im folgenden beschriebenen Einstellungen können während der Laufzeit erfolgen und werden mit der Abarbeitung des nächsten Jobs nach der Konfigurationsänderung wirksam. text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/orders_in_internals?rev=1415876767&do=diff orders_in Interna Diese Schnittstelle arbeitet nicht mit Schnittstellentabellen (wie z.B. die items_in oder persons_in), sondern ausschließlich über den Aufrufe der folgenden Prozeduren: * om_GetOrders_Ad (wird aufgerufen, falls mit DefaultPositionState gearbeitet wird) text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/orders_in_schema?rev=1415876767&do=diff orders_in XML-Schema Schema Das vollständige Schema finden Sie unter orders_in_v1_1.xsd. Im folgenden gehen wir auf die wichtigsten Elemente des Schemas ein. Beim Lesen hilft es, sich die untenstehende Beispieldatei vor Augen zu halten. ListOfOrders Dieses Element ist das Wurzelelement und taucht genau einmal in einem order_in-Job auf. Unterelemente sind ein oder mehrere Order-Elemente. text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/orders_out?rev=1415876767&do=diff Der dStore kennt den Status nur auf Positionsebene (also quasi einen Auftragspositionsstatus). Von einem Auftragsstatus spricht man, wenn alle Positionen den gleichen Status haben. Haben die Positionen unterschiedliche Status, so ist der Auftragsstatus text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/orders_out_configuration?rev=1415876767&do=diff orders_out Konfiguration Die Konfiguration der Schnittstelle geschieht über ApplicationSettings. Eine Beispielkonfiguration zum Einlesen per Import-Funktion des admin_SmartGate findet sich hier: :!: Sofern es sich nicht um eine Sandbox-Umgebung handelt ist absolute Sorgfalt wichtig, da bestehende Einstellungen unter Umständen überschrieben werden. text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/orders_out_internals?rev=1415876767&do=diff order_out Interna Der Export von Aufträgen wird über die folgenden Prozeduren vorgenommen. Als Benutzer wird der „interfaceuser“ verwendet. * om_ExportOrders_Ad : Fast alle Parameter der Prozedur können durch entsprechende ApplicationSettings gesteuert werden * om_GetPersonInfoForOrders_Ad : Wichtig in diesem Zusammenhang ist der Schlüssel text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/orders_out_schema?rev=1415876767&do=diff orders_out XML-Schema Schema Das vollständige Schema finden Sie unter orders_out_v1_1.xsd Im folgenden gehen wir auf die wichtigsten Elemente des Schemas ein. Beim Lesen hilft es sich die unten stehende Beispieldatei vor Augen zu halten. ListOfOrders Eine Liste von exportierte Aufträgen. text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/persons_in?rev=1415876767&do=diff persons_in Diese Schnittstelle dient dem Anlegen und Ändern von Personendaten. Im XML-Job wird eine Liste von Personen übergeben mit einem eindeutigen Schlüssel als Attribut der Person zur Referenzierung (der sog. „IdentifyingValue“) übergeben. Auf welches Merkmal sich der Referenz-Schlüssel bezieht ist entweder in den ApplicationSettings zum xml_SmartGate hinterlegt oder kann pro Job über ein Attribut gesteuert werden. Typische Referenzen sind Kundennummer oder E-Mail Adresse. text/html 2015-04-21T10:27:22+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/persons_in_configuration?rev=1429604842&do=diff persons_in Konfiguration Die Konfiguration der Schnittstelle geschieht über ApplicationSettings. Eine Beispielkonfiguration zum Einlesen per Import-Funktion des admin_SmartGate findet sich hier: :!: Sofern es sich nicht um eine Sandbox-Umgebung handelt ist absolute Sorgfalt wichtig, da bestehende Einstellungen unter Umständen überschrieben werden. text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/persons_in_internals?rev=1415876767&do=diff persons_in Interna Der Import von Personen wird über ein Einfügen von Daten in eine der folgenden Schnittstellentabellen vorgenommen: * ImportPersonData_Modify * ImportPersonData_NewOrModify Danach wird dann die Prozedur pm_ImportPersonData_Ad aufgerufen. Eventuelle Fehler finden sich in den Tabellen text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/persons_in_schema?rev=1415876767&do=diff persons_in XML-Schema Schema Das vollständige Schema finden Sie unter persons_in_v1_0.xsd Im folgenden gehen wir auf die wichtigsten Elemente des Schemas ein. Beim Lesen hilft es, sich die untenstehende Beispieldatei vor Augen zu halten. ListOfPersons Eine Liste von Personen, die imortiert werden sollen. Jede Person darf in der Liste nur ein Mal auftauchen (referenziert über den IdentifyingValue). text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/persons_out?rev=1415876767&do=diff persons_out Diese Schnittstelle dient dem Export von Personendaten. Das Prinzip des Exports darin, dass in Intervallen eine Suche (per pm_GetPersons_Conditions_Ad) von neuen und/oder geänderten Personen seit dem letzen Lauf des Exports durchgeführt wird. Beispieldatei <?xml version="1.0" encoding="UTF-8" ?> <ListOfPersons xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://resources.dstore.de/xsd/xml_SmartGate/persons_out_v1_0.xsd" PersonType… text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/persons_out_configuration?rev=1415876767&do=diff persons_out Konfiguration Die Konfiguration der Schnittstelle geschieht über ApplicationSettings. Eine Beispielkonfiguration zum Einlesen per Import-Funktion des admin_SmartGate findet sich hier: :!: Sofern es sich nicht um eine Sandbox-Umgebung handelt ist absolute Sorgfalt wichtig, da bestehende Einstellungen unter Umständen überschrieben werden. text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/persons_out_internals?rev=1415876767&do=diff persons_out Interna Pro Export (die durchnummerierten ApplicationParts) finden ein oder zwei Aufrufe von pm_GetPersons_Conditions_Ad statt. Die Anzahl richtet sich danach ob nur neue oder neue und geänderte Personen exportiert werden sollen. Die Daten der Personen werden dann per text/html 2014-11-13T12:06:07+0200 Anonymous (anonymous@undisclosed.example.com) http://wiki.dstore.de/xml/persons_out_schema?rev=1415876767&do=diff persons_out XML-Schema Schema Das vollständige Schema finden Sie unter persons_out_v1_0.xsd Im folgenden gehen wir auf die wichtigsten Elemente des Schemas ein. Beim Lesen hilft es, sich die untenstehende Beispieldatei vor Augen zu halten. ListOfPersons Eine Liste von Personen, die exportiert wurden. Jede Person taucht in der Liste nur ein Mal auf (referenziert über die PersonID).