Benutzer-Werkzeuge

Webseiten-Werkzeuge

Action disabled: source

engine:procedures:mi_gettritrigger_ad

mi_GetTRITrigger_Ad

Gibt die Grundeinstellungen von sogenannten „TRI-Trigger“n zurück.

Die genaue Definition (sofern „ExecuteProcedureName“ NICHT konfiguriert ist, s. gleichnamige Rückgabespalte) kann mit Hilfe der Prozeduren mi_GetTRITriggerWorkflow_Ad, mi_GetTRITriggerConditions_Ad und mi_GetTRITriggerToDos_Ad abgerufen werden.

Anmerkung zur Rückgabespalte „ExecuteProcedureName“ :

Hierdurch wird im Prinzip das alte Verhalten über die „Action“-Prozeduren gewährleistet. Vor dem „TRI-Trigger“-feature gab es über „_ac_ChangeOrderState“ bzw. „_ac_NewOrder“ die Möglichkeit, auf Status-Wechsel bzw. Auftragsanlage zu reagieren. Per default ist daher ein Trigger für alle Status-Wechsel konfiguriert, der zur Ausführung von „_ac_ChangeOrderState“ führt (außer bei „OrderStateID = 0“, hier kann aber der Aufruf von „_ac_NewOrder“ konfiguriert werden, wofür ebenfalls schon ein TRI-Trigger definiert aber nicht zugewiesen ist). Ab Version 7.0.3 kann man auch eine andere Prozedur aufrufen lassen (s. Parameter „ExecuteProcedureName“ von mi_ModifyTRITrigger_Ad), aber die Übergabe der Daten BLEIBT gleich, d.h. : Via „dstoreifin.dbo._ac_ChangeOrderState“ werden die vom Status-Wechsel betroffenen „OrderContentID“s übergeben und außerdem wird die (konfigurierte) Prozedur mit den Parametern „ToOrderStateID“ (in welchen Status gewechselt wurde) und „NestingLevelForInputData“ (zu welchem „Nesting Level“ die Daten übergeben wurden) aufgerufen.

HTTP-MethodGET
HTTP-AuthOptional
Tags
Engine-Kategoriesystem administration
Engine-TypDaten-Ermittlung
Letzte Aktualisierung7.0.7 (2015-01-29)

Parameter

Name 1) Standard-Wert Beschreibung 2) SQL-Datentyp3) ab Version
TriggerID ID eines „TRI-Trigger“. Falls angegeben, wird nur der Datensatz zu diesem Trigger ermittelt.
smallint7.0.3
TriggerTypeIDNULL Wird nur beachtet wenn „TriggerID = NULL“ ist ! ID eines Trigger-Typs (mögliche Werte s. mi_GetTRITriggerTypes_Ad). Wenn angegeben, werden alle Trigger dieses Typs ermittelt.
tinyint7.0.3
UnusedTriggerOnly0 Wird nur beachtet wenn „TriggerID = NULL“ ist ! Falls „1“ angegeben wird, ermittelt die Prozedur ausschließlich Trigger, die noch nicht verwendet werden.
bit7.0.3

Rückgabe

(parameterunabhängig)

Spaltenname Beschreibung SQL-Datentyp4) ab Version
TriggerNameName des Triggers „TriggerID“
varchar(50)7.0.3
TriggerIDID eines „TRI-Trigger“
smallint7.0.3
TriggerTypeIDID des Typs von Triggern dem „TriggerID“ angehört (mögliche Werte : s. mi_GetTRITriggerTypes_Ad), sprich letztlich die Information, bei welcher Art von Datenänderung der Trigger ausgelöst werden kann
tinyint7.0.3
TriggerTypeBezeichnung der „TriggerTypeID“
varchar(50)7.0.3
TriggerDescriptionKurze Beschreibung des Triggers (wozu er dient, was er macht etc.)
varchar(255)7.0.3
ExecuteProcedureNameName einer Prozedur, die (wenn der Trigger ausgelöst wird) aufgerufen werden soll. Nur falls nicht konfiguriert (also „NULL“), steht die komplexere Definition eines Triggers (s. mi_ModifyTRITriggerWorkflow_Ad) zur Verfügung.
varchar(50)7.0.3
TriggerStatusStatus-Bitmap, also Summe folgender Werte :
- „1“ : Trigger-Definition ist fehlerhaft
- „2“ : Trigger-Definition ist ok
- „4“ : Trigger ist zugewiesen (also aktiv)
Sonderfall : „0“ bedeutet, daß der Trigger und seine Definition noch NICHT geprüft wurde.
tinyint7.0.3

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code Beschreibung Quelle 5)
-569Der Benutzer hat kein Ausführungsrecht für die Prozedurnur indirekt
-567Die Prozedur darf z. Zt. nicht ausgeführt werdennur indirekt
-566Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werdennur indirekt
-535Das Datum liegt nicht in der Vergangenheitnur indirekt
-530Der Wert ist nicht konvertierbarnur indirekt
-510Der Benutzer ist nicht registriertnur indirekt
-504Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochennur indirekt
-500Falsche Parameterdirekt und indirekt

XML-Schema

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

Historie

7.0.7 2015-01-29Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf]
7.0.3 2013-12-13Erstmalig 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/mi_GetTRITrigger_Ad?TriggerID=<value>'

Mit xmllint 6) formatierte Ausgabe:

curl -X GET  'http://<partner>-<project>.dstore.de/default/engine/mi_GetTRITrigger_Ad?TriggerID=<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'),
	'mi_GetTRITrigger_Ad',
		array(
			'TriggerID' => <value>,
			// 'TriggerTypeID' => NULL,
			// 'UnusedTriggerOnly' => 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="mi_GetTRITrigger_Ad">
			<Parameters>
				<Parameter Name="TriggerID"><!-- smallint value --></Parameter>
				<!-- <Parameter Name="TriggerTypeID">NULL</Parameter> -->
				<!-- <Parameter Name="UnusedTriggerOnly">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>
1)
Pflichtparameter sind unterstrichen
5)
direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“
6)
I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org
engine/procedures/mi_gettritrigger_ad.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)