Benutzer-Werkzeuge

Webseiten-Werkzeuge


engine:procedures:im_getbinary_pu

im_GetBinary_Pu

Liest den Code zu einer „BinaryCodeID“, d.h. das Binärobjekt selbst, aus der Datenbank aus (z.B. ein Bild). Alternativ kann man sich zu diesem Objekt auch das sogenannte „Thumbnail“ ausgeben lassen.

Anmerkung zur Rückgabespalte „BinaryType“ :

Hier wird eine spezielle Eigenschaft (zum Merkmal mit der ID „1“) des „Binaries“ ausgegeben - nämlich die, die man auch durch folgenden Aufruf erhalten kann : exec im_GetBinaryProperties_Pu <BinaryCodeID>, BinaryCharacteristicID = 1. Das Merkmal mit der ID „1“ dient dazu, den „MIME-Type“ hinterlegen zu können (daher auch die entsprechende Bezeichnung, s. im_GetBinaryCharacteristics_Ad). Die Engine stellt aber nicht sicher (und kann dies auch nicht), daß dort tatsächlich der richtige MIME-Type hinterlegt ist.

HTTP-MethodGET
HTTP-AuthOptional
Tags
Engine-Kategorieitem management
Engine-TypDaten-Ermittlung
Letzte Aktualisierung3.5.0 (2000-11-23)

Parameter

Name 1) Standard-Wert Beschreibung 2) SQL-Datentyp3) ab Version
BinaryCodeID ID eines Binärobjektes
integer3.5.0
ReturnThumbnailCode0 „0“ : Originalobjekt ausgeben
„1“ : Thumbnailobjekt ausgeben
bit3.5.0

Rückgabe

(parameterunabhängig)

Spaltenname Beschreibung SQL-Datentyp4) ab Version
BinaryTypeEigenschaft von „BinaryCodeID“ zum Merkmal mit der ID „1“ (aktuelle Bezeichnung : „MIME-Type“). Hinweis : Die Engine kann nicht SICHERSTELLEN, daß der Wert wirklich den Typ des „Binaries“ darstellt (s. Beschreibung) !
varchar(250)3.5.0
BinaryCodeDer zur „BinaryCodeID“ zugehörige Code, also quasi das Binärobjekt selbst - oder das zugehörige „Thumbnail“
longvarbinary3.5.0

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Die Prozedur hat keine Fehlercodes.

XML-Schema

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

Historie

3.5.0 2000-11-23Erstmalig in dieser Version erstellt

Code-Snippets

Engine Playground

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

cURL

Unformatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/im_GetBinary_Pu?BinaryCodeID=<value>'

Mit xmllint 5) formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/im_GetBinary_Pu?BinaryCodeID=<value>' | xmllint --format -
dStore_php
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_GetBinary_Pu',
		array(
			'BinaryCodeID' => <value>,
			// 'ReturnThumbnailCode' => 0
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();
engine/execute

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_GetBinary_Pu">
			<Parameters>
				<Parameter Name="BinaryCodeID"><!-- integer value --></Parameter>
				<!-- <Parameter Name="ReturnThumbnailCode">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>
1)
Pflichtparameter sind unterstrichen
5)
I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org
engine/procedures/im_getbinary_pu.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)