Führt einen Import von Binärobjekten für Artikel-Elemente oder Eigenschaften durch - das gibt man durch den Parameter „ValueOrItemBinaries“ an. Falls…

„0“ : Importiert „Binaries“ aus den Schnittstellen-Tabellen

• „ImportItemBinaries“
• „ImportItemBinaries_Copy“
• „ImportItemBinaries_Properties“

„1“ : Importiert „Binaries“ aus den Schnittstellen-Tabellen

• „ImportValueBinaries“
• „ImortValueBinaries_Properties“

ACHTUNG :
Zu einem „Binary“ müssen immer Bildtyp und Dateierweiterung (Eigenschaften zur „BinaryCharacteristicID“ „1“ bzw. „7“) angegeben sein, sonst gibt die Prozedur den Fehler „-500“ zurück.

Hinweis :
Schnittstellen-Tabellen bilden generell die einzige Ausnahme für eine direkte Daten-Manipulation, d.h. OHNE Verwendung von Prozedur-Aufrufen. Daher werden im folgenden die Spalten der genannten Tabellen dokumentiert, was gleichzeitig die Gewähr von Abwärtskompatibilität bedeutet - es kann sich lediglich der Datentyp „erweitern“ (z.B. von „tinyint“ auf „smallint“ oder von „varchar(100)“ auf „varchar(250)“ o.ä.) oder es können neue Spalten, die dann aber „NULL“able (also optional) sind, hinzukommen !

„Tabellen-Definitionen und Hinweise“

1.) Definition „ImportItemBinaries“ :

CREATE TABLE
ImportItemBinaries ( VariantOrItemNo varchar(50) NOT NULL,
SortNo tinyint NOT NULL,
BinaryCode image NOT NULL,
ThumbnailCode image NULL,
BinaryDescription varchar(100) NULL
)

CREATE UNIQUE CLUSTERED INDEX PK_IMPORTITEMBINARIES ON ImportItemBinaries ( VariantOrItemNo, SortNo )

Hinweise :
a) „VariantOrItemNo“-Werte referenzieren auf Artikelnummern (Eigenschaft zum Merkmal mit der ID „6“) von vorhandenn Produkten/Varianten
b) Die „BinaryDescription“ ist tatsächlich eine direkt zur Tabelle, in der die „Binaries“ selbst (also die „BinaryCode“-Werte) gespeichert sind, zugehörige Spalte (also nicht etwa eine spezielle „Property“), um das „Binary“ kurz beschreiben zu können
c) Die „SortNo“ dient der eindeutigen Identifizierung eines „Binaries“ zu einer „VariantOrItemNo“, da man ja MEHRERE „Binaries“ zu einem Artikel bzw. einer Variante hinterlegen kann.

2.) Definition „ImportItemBinaries_Copy“ :

CREATE TABLE
ImportItemBinaries_Copy ( SourceVariantOrItemNo varchar(50) NOT NULL,
SourceBinaryCharacteristicID tinyint NOT NULL,
SourceCharacteristicValue varchar(250) NOT NULL,
TargetVariantOrItemNo varchar(50) NOT NULL
)

CREATE UNIQUE CLUSTERED INDEX PK_IMPORTITEMBINARIES_COPY ON ImportItemBinaries_Copy ( SourceVariantOrItemNo, SourceBinaryCharacteristicID, TargetVariantOrItemNo )

Hinweis : Jeder Datensatz läßt sich so beschreiben : Alle „Binaries“ dem/der durch „SourceVariantOrItemNo“ referenzierten Artikel/Variante (s. Hinweis bei „ImportItemBinaries“), die die Eigenschaft „SourceCharacteristicValue“ zum (Binary-)Merkmal „SourceBinaryCharacteristicID“ besitzen, sollen auch dem/der durch „TargetVariantOrItemNo“ referenzierten Artikel/Variante zugeordnet werden.

3.) Definition „ImportItemBinaries_Properties“ :

CREATE TABLE
ImportItemBinaries_Properties ( VariantOrItemNo varchar(50) NOT NULL,
SortNo tinyint NOT NULL,
BinaryCharacteristicID tinyint NOT NULL,
Value varchar(250) NOT NULL
)

CREATE UNIQUE CLUSTERED INDEX PK_IMPORTITEMBINARIES_PROPERTI ON ImportItemBinaries_Properties ( VariantOrItemNo, SortNo, BinaryCharacteristicID )

Hinweis : „VariantOrItemNo“ und „SortNo“ referenzieren natürlich auf die entsprechende (eindeutige) Kombination aus „ImportItemBinaries“.

4.) Definition „ImportValueBinaries“ :

CREATE TABLE
ImportValueBinaries ( NodeCharacteristicID smallint NOT NULL,
Value varchar(1000) NOT NULL,
SortNo tinyint NOT NULL,
BinaryCode image NOT NULL,
ThumbnailCode image NULL,
BinaryDescription varchar(100) NULL
)

CREATE UNIQUE CLUSTERED INDEX PK_IMPORTVALUEBINARIES ON ImportValueBinaries ( NodeCharacteristicID, Value, SortNo )

Hinweise :
a) Die „SortNo“ dient der eindeutigen Identifizierung eines „Binaries“ zu einer (durch „NodeCharacteristicID“ und „Value“ referenzierten) Eigenschaft, da man ja MEHRERE „Binaries“ zu einem Artikel bzw. einer Variante hinterlegen kann.
b) Die „BinaryDescription“ ist tatsächlich eine direkt zur Tabelle, in der die „Binaries“ selbst (also die „BinaryCode“-Werte) gespeichert sind, zugehörige Spalte (also nicht etwa eine spezielle „Property“), um das „Binary“ kurz beschreiben zu können

5.) Definition „ImortValueBinaries_Properties“ :

CREATE TABLE
ImportValueBinaries_Properties ( NodeCharacteristicID smallint NOT NULL,
Value varchar(1000) NOT NULL,
SortNo tinyint NOT NULL,
BinaryCharacteristicID tinyint NOT NULL,
CharacteristicValue varchar(250) NOT NULL
)

CREATE UNIQUE CLUSTERED INDEX PK_IMPORTVALUEBINARIES_PROPERT ON ImportValueBinaries_Properties ( NodeCharacteristicID, Value, SortNo, BinaryCharacteristicID )

Hinweis : „NodeCharacteristicID“, „Value“ und „SortNo“ referenzieren natürlich auf die entsprechende (eindeutige) Kombination aus „ImportValueBinaries“.

Die Prozedur hat keine Rückgaben.

Die Prozedur hat keine Output-Parameter.

Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

• im_ImportBinaries_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_ImportBinaries_Ad'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_ImportBinaries_Ad' | xmllint --format -

use dStore_php\WebService;
 
$service = new WebService\Service( WebService\Scheme::HTTP,'<partner>-<project>.dstore.de', 80);
 
$request = new WebService\Requests\Engine\Procedure\Request(
			new WebService\Requests\AccessData('default'),
	'im_ImportBinaries_Ad',
		array(
			// 'ValueOrItemBinaries' => 0
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();

XML zur Ausführung mit der Methode engine/execute, z.B. per

curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'

<?xml version="1.0" encoding="UTF-8"?>
<ListOfBatches>
	<Batch No="0">
		<Procedure Name="im_ImportBinaries_Ad">
			<Parameters>
				<!-- <Parameter Name="ValueOrItemBinaries">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>