Legt ein neues Binärobjekt an und weist dieses (mit einem gewünschten Gültigkeitszeitraum) einer Liste von Artikel-Elementen zu. Die Gültigkeit der Zuordnung kann auf einen längeren Zeitraum und/oder bestimmte Tageszeiten beschränkt werden.

Das Binärobjekt muß dabei über die Tabelle „tempdb.dbo.ImageData“ zur „SortNo = 1“ übergeben werden. Falls zu dem Binärobjekt auch ein „Thumbnail“ angelegt werden soll, fügt man dieses vor dem Aufruf dieser Prozedur ebenfalls in „tempdb.dbo.ImageData“ ein, und zwar zur „SortNo = 2“.

Falls man das neue „Binary“ mehr Elementen zuweisen möchte, als über den Parameter „NodeIDs“ angegeben werden kann, gibt es zwei Möglichkeiten :
1.) Man setzt „NodeIDs = NULL“ und übergibt alle gewünschten Elemente in „tempdb.dbo.OneID“
2.) Man läßt sich durch Angabe von „ReturnBinaryCodeID = 1“ eine Rückgabemenge ausgeben, die die ID des neu angelegten „Binaries“ enthält und ruft anschließend im_AddBinaryToNodes_Ad (evtl. mehrfach) auf. Nachteil dieser Methode ist allerdings, daß man keine Transaktions-Sicherheit über ALLE Operationen hat.

Jedes Binärobjekt besitzt bestimmte Eigenschaften. Die des neu anzulegenden „Binaries“ werden über „tempdb.dbo.CharacteristicValues“ angegeben. Dabei MÜSSEN zwei Eigenschaften existieren :
1. „MIME type“, „BinaryCharacteristicID = 1“
2. „Bildtyp“, „BinaryCharacteristicID = 7“

Anmerkung:
Da es sich bei den Tabellen „tempdb.dbo.ImageData“ und „tempdb.dbo.CharacteristicValues“ nur um Tabellen für die reine Parameterübergabe handelt, und nicht unnötig Speicher in der „tempdb“ belegt werden soll, werden diese Tabellen am Ende der Prozedur automatisch geleert (selbstverständlich nur die Daten zur „spid“…) !

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_InsertNodeBinary_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_InsertNodeBinary_Ad?NodeIDs=<value>'

Mit xmllint ⁶⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/im_InsertNodeBinary_Ad?NodeIDs=<value>' | 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_InsertNodeBinary_Ad',
		array(
			'NodeIDs' => '<value>',
			// 'BinaryDescription' => NULL,
			// 'FromDate' => NULL,
			// 'ToDate' => NULL,
			// 'FromTime' => NULL,
			// 'ToTime' => NULL,
			// 'AutoContinue' => 0,
			// 'ReturnBinaryCodeID' => 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_InsertNodeBinary_Ad">
			<Parameters>
				<Parameter Name="NodeIDs"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="BinaryDescription">NULL</Parameter> -->
				<!-- <Parameter Name="FromDate">NULL</Parameter> -->
				<!-- <Parameter Name="ToDate">NULL</Parameter> -->
				<!-- <Parameter Name="FromTime">NULL</Parameter> -->
				<!-- <Parameter Name="ToTime">NULL</Parameter> -->
				<!-- <Parameter Name="AutoContinue">0</Parameter> -->
				<!-- <Parameter Name="ReturnBinaryCodeID">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>