Benutzer-Werkzeuge

Webseiten-Werkzeuge


engine:procedures:mi_checkperformance_ad

mi_CheckPerformance_Ad

Dient zur Analyse der Performance von zentralen Prozeduren. Zu jedem Prozeduraufruf gibt es eine entsprechende „print“-Ausgabe (Prozeduraufruf inkl. Parameter), die am Schluß die Dauer in Millisekunden angibt.

Derzeit werden folgende Prozeduren getestet :

im_GetDirectSuccessors_Pu
im_GetDirectSuccessors_Tree_Pu
im_GetNodeDescriptions_Pu
im_GetNodeProperties
im_GetSuccessors_Pu
im_GetVariantMatrix
im_SearchCharacteristics_Pu
im_SearchProductTreeNodes_Pu
pm_GetPersons_Conditions_Ad
pm_InsertNewPerson_Ad
pm_DeletePerson_Ad
om_GetPrices_Pu
om_GetTrolley_Pu
om_GetTrolleyAsMatrix_Pu
om_GetOrders_Conditions_Ad
om_CopyFromTrolleyToOrder_Pu (Kann nur durch explizite Angabe getestet werden (ProcedureNames = …))

In kommenden Versionen wird es evtl. weitere Prozeduren geben, die getestet werden können.

Möchte man nur einen Teil dieser Prozeduren testen, kann man die entsprechenden Namen via „tempdb.dbo.AnyValues“ angegeben (in „ID“ kann irgendeine beliebige Zahl stehen) und setzt den Parameter „OnlyProceduresInAnyValues“ auf „1“ - ODER man gibt einen oder mehrere Prozedur-Namen („¶“-getrennt) in „ProcedureNames“ an.

Für die Prozeduren im „Item Management“ wird immer wenigstens eine „TreeNodeID“ benötigt. Man kann über den Parameter „TreeNodeID“ eine ID angegeben; andernfalls versucht die Prozedur, eine ID selbst zu ermitteln, und zwar wählt sie das „erste“ Element auf Produkt-Hierarchie (→ „ProductLevelID“ aus „Settings“), das AKTIV und NICHT GELÖSCHT ist und NICHT den „Root-Knoten“ als Vorgänger hat.

Die Parameter „TreeNodeIDForVariantMatrix“, „YAxisCharacteristicID“, „XAxisCharacteristicID“, „ValueCharacteristicID“ sind für den Performance-Check von im_GetVariantMatrix; die Prozedur kann diese Parameter allerdings auch selbst initialisieren.
Anmerkung : Wenn „YAxisCharacteristicID“ UND „XAxisCharacteristicID“ NICHT übergeben wurden, wird „TreeNodeIDForVariantMatrix“ ignoriert !

Zum Aufruf von im_SearchCharacteristics_Pu bzw. im_SearchProductTreeNodes_Pu werden Merkmale benötigt, zu denen gesucht werden soll; daher der Parameter „SearchNodeCharacteristicIDs“. Nach WAS gesucht werden soll, kann man über „SearchValue“ angeben.

Hinweis zu den Parameter „PersonOutputCharacteristics“ und „PersonCharacteristicIDs“: Falls Merkmale übergeben werden, für die eine lesende Zugriffsbeschränkung existiert (s. pm_GetPChAccRestrForUsers_Ad), kann es zu einem Fehler kommen.

HTTP-MethodPOST
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
ProcedureNamesNULL Ein oder mehrere Prozedur-Name(n) ('¶'-getrennt), für die ein Performance-Check durchgeführt werden soll
varchar(255)3.5.9
OnlyProceduresInAnyValues0 „0“ : Es werden alle oder nur die in „ProcedureNames“ angegebenen Prozeduren berücksichtigt
„1“ : Es werden die Prozeduren berücksichtigt, die in „tempdb.dbo.AnyValues“ angegeben sind
bit3.5.9
TreeNodeIDNULL ID eines Elementes im Artikelbaum, für das die Performance-Checks durchgeführt werden soll (gilt nur für Prozeduren im „Item Management“
integer3.5.9
TreeNodeIDForVariantMatrixNULL Für im_GetVariantMatrix, siehe Beschreibung
integer3.5.9
YAxisCharacteristicIDNULL Für im_GetVariantMatrix, siehe Beschreibung
integer3.5.9
XAxisCharacteristicIDNULL Für im_GetVariantMatrix, siehe Beschreibung
integer3.5.9
ValueCharacteristicIDNULL Für im_GetVariantMatrix, siehe Beschreibung
integer3.5.9
SearchNodeCharacteristicIDsNULL Für im_SearchProductTreeNodes_Pu, siehe Beschreibung
varchar(200)3.5.9
SearchValueNULL Für im_SearchProductTreeNodes_Pu, siehe Beschreibung
varchar(1000)3.5.9
SearchPersonTypeID1 ID eines Personentyps (es können nur Personen eines Typs gesucht werden)
smallint3.5.16
PersonOutputCharacteristicsNULL Zu allen gefundenen Personen werden in der Ausgabemenge Eigenschaften zu diesen Merkmalen angezeigt. Falls nichts angegeben wird, ermittelt die Prozedur die ersten drei (falls möglich) Pflichtmerkmale zum Personentyp „SearchPersonTypeID“.
varchar(255)3.5.16
PersonCharacteristicIDsNULL Siehe Dokumentation des Parameters „CharacteristicIDList“ bzw. „ConditionList“ der Prozedur pm_GetPersons_Conditions_Ad. Falls nicht angegeben, belegt die Prozedur diesen Parameter (zufällig) selbst
varchar(255)3.5.16
ConditionListNULL Siehe Dokumentation des Parameters „CharacteristicIDList“ bzw. „ConditionList“ der Prozedur pm_GetPersons_Conditions_Ad. Falls nicht angegeben, belegt die Prozedur diesen Parameter (zufällig) selbst
varchar(255)3.5.16
OrderPersonIDNULL Für die Tests der „Order Management“-Prozeduren wird eine Person benötigt. Wenn dieser Parameter nicht angegeben wird, wählt die Prozedur selbst eine Person für die Tests aus
integer3.5.16

Rückgabe

Die Prozedur hat keine Rückgaben.

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code Beschreibung Quelle 4)
-1323Die Person besitzt kein Konto zum angegebenen Typnur indirekt
-1322Transaktion kann nicht durchgeführt weden, da der Status des Kontos dies nicht erlaubtnur indirekt
-1321Transaktion kann nicht durchgeführt weden, da das Konto keine ausreichende Deckung aufweistnur indirekt
-1305Validierung fehlgeschlagen, der Code zur Zeit inaktiv istnur indirekt
-1304Validierung fehlgeschlagen, da die maximale Menge an Einlösungen der Person für diesen Code erreichtnur indirekt
-1303Validierung fehlgeschlagen, da die maximale Menge an Einlösungen für diesen Code erreicht istnur indirekt
-1302Validierung fehlgeschlagen, da der Code nicht mehr gültig istnur indirekt
-1301Validierung fehlgeschlagen, da der Code nicht existiertnur indirekt
-1204Fehlender oder falscher Eintrag in CampaignSettingsnur indirekt
-856Fehlerhafte Daten in „MainPostingSorting“nur indirekt
-855Fehlerhafte Konfiguration des Sortier-Kriteriumsnur indirekt
-850Sortier-Kriterium nicht definiert oder inaktiv oder nicht verwendbarnur indirekt
-840Posting kann nicht bearbeitet werden, weil es bereits von einem anderen Prozess bearbeitet wirdnur indirekt
-697Aktion kann nicht durchgeführt werden, da für ein Merkmal eine Zugriffsbeschränkung bestehtnur indirekt
-684Die Eigenschaft gehört zum Merkmal „Land“, aber es gibt keinen entsprechenden Eintrag in „Countries“nur indirekt
-677Die Person kann nicht gelöscht werden, da es mind. ein Posting gibt, das nicht gelöscht werden darfnur indirekt
-672Fehlende Berechtigung zum Löschen von Personen eines bestimmten Personentypsnur indirekt
-671Die Person kann nicht gelöscht werden, da mindestens ein Auftrag existiertnur indirekt
-661Die Person besitzt keine oder eine ungültige Eigenschaft zu einem bestimmten Merkmalnur indirekt
-660Identifikation fehlgeschlagendirekt und indirekt
-655Die VisitorID steht nicht mit der PersonID in Verbindungnur indirekt
-650Es sind nicht alle Pflichtmerkmale vorhandennur indirekt
-642Inkrementelle Änderung konnte aufgrund paralleler Änderungen nicht durchgeführt werdennur indirekt
-641Die „Unique“-Eigenschaft mindestens eines Merkmals ist verletzt - Prozedur wurde abgebrochennur indirekt
-640Einige Personendaten sind ungültignur indirekt
-630Personendaten konnten nicht angelegt werdennur indirekt
-621Fehlender oder falscher Eintrag in PersonTypeSettingsnur indirekt
-610Fehlende oder falsche Daten in PersonMetaInformationnur indirekt
-602Zur defaultUniqueID („VisitorID = -2“) können keinerlei Daten gespeichert oder verändert werdennur indirekt
-600Es konnte keine gültige VisitorID ermittelt werdennur indirekt
-599Lizenz ist ungültig oder abgelaufennur indirekt
-572Die Prozedur darf nur innerhalb einer Transaktion ausgeführt werdennur indirekt
-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
-561Prozedur kann nicht ausgeführt werdennur indirekt
-550Fehlender oder falscher Eintrag in Settingsdirekt und indirekt
-540Falsches Formatnur indirekt
-535Das Datum liegt nicht in der Vergangenheitnur indirekt
-530Der Wert ist nicht konvertierbarnur indirekt
-510Der Benutzer ist nicht registriertnur indirekt
-507Fehlerhafte Implementierung einer Prozedur - Daten in einem Ausgabeparameter sind ungültignur indirekt
-506Fehlerhafte Implementierung einer Prozedur - Daten in der Output-Schnittstelle sind ungültignur indirekt
-504Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochendirekt und indirekt
-503Fehlerhafte Daten in einer Tabelle - genauere Fehlermeldung auf der Standardausgabenur indirekt
-502Die Parameter-Werte der Prozedur können nicht verarbeitet werden (kein passendes Trennzeichen)nur indirekt
-501Der Parameter „TableID“ und/oder der Parameter „TableKeyID“ ist ungültignur indirekt
-500Falsche Parameterdirekt und indirekt
-398Einige OrderSurchargeInformation sind ungültignur indirekt
-391Einige OrderInformation sind ungültignur indirekt
-390Einige OrderContentInformation sind ungültignur indirekt
-385Die Brutto-Summe aus Warenwert plus Surcharges unterschreitet den vorgegebenen Mindestwertnur indirekt
-348Status-Änderung konnte aufgrund paralleler Änderungen nicht durchgeführt werdennur indirekt
-347Ungültige „OrderStateID“ (da für interne Zwecke reserviert)nur indirekt
-340Fehlende Berechtigung zum Ändern des Orderstatusnur indirekt
-338Die gegebene PaymentForShippingID ist keine mögliche Zahlungs-/Versandart-Kombinationnur indirekt
-337Keine PaymentForShippingID aufgrund HideWhenOrderedAlone-Einstellung möglichnur indirekt
-336Keine PaymentForShippingID gefunden, die für alle Artikel im Warenkorb möglich istnur indirekt
-334Mindestens einem Artikel ist keine PaymentForShippingID zugewiesennur indirekt
-333Ein benötigter Steuersatz ist nicht bekannt oder konnte nicht ermittelt werdennur indirekt
-332Die Kombination aus PaymentTypeID und ShippingTypeID ist mit der Bestellung nicht vereinbarnur indirekt
-331Es kann keine gültige PaymentForShippingID zu der PaymentTypeID und ShippingTypeID ermittelt werdennur indirekt
-330Es kann keine oder keine eindeutige PaymentForShippingID zu einer Order ermittelt werdennur indirekt
-329Keine PaymentForShippingID aufgrund der Gruppen-Zugehörigkeit des Auftraggebers gefundennur indirekt
-328Keine PaymentForShippingID gefunden, da Bestellwert nicht die Zahlungsarten-Beschränkungen erfülltnur indirekt
-327Keine PaymentForShippingID gefunden, da Bestellwert nicht die Versandarten-Beschränkungen erfülltnur indirekt
-326Keine PaymentForShippingID aufgrund der Region der Lieferanschrift gefundennur indirekt
-325Keine PaymentForShippingID aufgrund der Region des Auftraggebers gefundennur indirekt
-321Ein oder mehrere Artikel wurden aus dem Warenkorb entferntnur indirekt
-320Der Bestand eines Produktes darf nicht unter 0 sinkennur indirekt
-316Warenkorb kann nur einmal bestellt werden, verm. Ursache : paralleler „…TrolleyToOrder…“-Aufrufnur indirekt
-312Fehlerhafte Daten im Warenkorb konnten nicht repariert werdennur indirekt
-311Fehlerhafte Daten im Warenkorb : Es sind mehrere „HTreeNodeID“s mit gleicher „NodeID“ vorhandennur indirekt
-310Der Besucher hat keine gültigen Artikel im Warenkorbnur indirekt
-286Der Benutzer hat nicht die Berechtigung(en), Eigenschaften zu diesem(n) Merkmal(en) zu lesen/ändernnur indirekt
-285Der Benutzer hat keine Berechtigung, vergangene Eigenschaften zu diesem(n) Merkmal(en) zu ändernnur indirekt
-284Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu modifizierennur indirekt
-283Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu ermittelnnur indirekt
-245Einige Artikel-Eigenschaften sind ungültignur indirekt
-242Relative Änderung nicht möglich, da es eine Eigenschaft gibt, deren Gültigkeit in d. Zukunft beginntnur indirekt
-241Änderung(en) der Eigenschaft(en) konnte(n) aufgrund paralleler Änderungen nicht durchgeführt werdennur indirekt
-230Nicht alle Knoten haben Eigenschaften zu den angegebenen Merkmalennur indirekt
-221Es konnte kein rekursives Merkmal mit der Standardwährung als Einheit ermittelt werdennur indirekt
-220Es konnte keine Merkmal-ID für die Produktbezeichnung ermittelt werdennur indirekt
-210Das (die) Element(e) hat (haben) keine Eigenschaft zum angegebenen Merkmalnur indirekt
-120Der Benutzer hat keine Berechtigung für das (die) Element(e)nur indirekt
-110Das (die) Element(e) ist (sind) nicht vorhandennur 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.1 2013-08-07Datentyp-Erweiterung des Parameters „SearchValue“ [von 100 auf 1000]
6.5.4 2013-04-29Doku-Hinweis ergänzt bzgl. „PersonOutputCharacteristics“ und „PersonCharacteristicIDs“ [wg. des Merkmal-
Zugriffsbeschränkungen-Features]
6.5.3 2013-03-18Interne Anpassungen zwecks UTF8-Unterstützung
5.5.0 2008-01-071. (interne Änderung :) Code-Verlagerung
2. Ausgabe via „print“ im Fehler-Fall „-500“ (mit Informationen über die Ursache)
3. In einem Fall wird nun „-504“ statt „-500“ als Fehler zurückgegeben
5.1.7 2006-10-31Ab jetzt kann es theoretisch auch „Einkaufs-Aufträge“ geben, deren „OrderID“s und zugehörige „OrderContentID“s ein negatives Vorzeichen haben. Wir möchten hier aber nur Kunden-Aufträge testen ⇒ entsprechende Anpassungen
5.1.4 2006-08-14Damit ein cursor „for update“ auch in der ASE-Version 15 funktioniert, muß ein „unique“ index existieren ⇒ entspr. Anpassung
5.1.1 2006-04-05„NodeProperties“ hat sich in 5.1.0 geändert ⇒ kleine Performance-Verbesserung durch entsprechende Anpassungen
4.0.13 2004-05-181. Aufruf der Prozeduren „_mi_StartProcedure“, „_mi_FinishProcedure“ und „_mi_ChooseParamValueSeperator“
2. Ausführen von „set transaction isolation level 1“ und „set rowcount 0“ zu Beginn der Prozedur
3. Konsequente Fehlerbehandlung
4.0.5 2003-10-04Verlagerung diverser „Settings“-Einträge auf entsprechende „PersonTypeSettings“-Einträge
4.0.1 2003-05-16Fehler bzgl. der Gültigkeitszeiträume in „NodeProperties“ in einigen Fällen
3.5.21 2002-08-06
3.5.19 2002-06-17
3.5.16 2002-04-25
3.5.9 2001-06-16Erstmalig 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 POST  'http://<partner>-<project>.dstore.de/default/engine/mi_CheckPerformance_Ad'

Mit xmllint 5) formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_CheckPerformance_Ad' | 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_CheckPerformance_Ad',
		array(
			// 'ProcedureNames' => NULL,
			// 'OnlyProceduresInAnyValues' => 0,
			// 'TreeNodeID' => NULL,
			// 'TreeNodeIDForVariantMatrix' => NULL,
			// 'YAxisCharacteristicID' => NULL,
			// 'XAxisCharacteristicID' => NULL,
			// 'ValueCharacteristicID' => NULL,
			// 'SearchNodeCharacteristicIDs' => NULL,
			// 'SearchValue' => NULL,
			// 'SearchPersonTypeID' => 1,
			// 'PersonOutputCharacteristics' => NULL,
			// 'PersonCharacteristicIDs' => NULL,
			// 'ConditionList' => NULL,
			// 'OrderPersonID' => NULL
		)
);
 
$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_CheckPerformance_Ad">
			<Parameters>
				<!-- <Parameter Name="ProcedureNames">NULL</Parameter> -->
				<!-- <Parameter Name="OnlyProceduresInAnyValues">0</Parameter> -->
				<!-- <Parameter Name="TreeNodeID">NULL</Parameter> -->
				<!-- <Parameter Name="TreeNodeIDForVariantMatrix">NULL</Parameter> -->
				<!-- <Parameter Name="YAxisCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="XAxisCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="ValueCharacteristicID">NULL</Parameter> -->
				<!-- <Parameter Name="SearchNodeCharacteristicIDs">NULL</Parameter> -->
				<!-- <Parameter Name="SearchValue">NULL</Parameter> -->
				<!-- <Parameter Name="SearchPersonTypeID">1</Parameter> -->
				<!-- <Parameter Name="PersonOutputCharacteristics">NULL</Parameter> -->
				<!-- <Parameter Name="PersonCharacteristicIDs">NULL</Parameter> -->
				<!-- <Parameter Name="ConditionList">NULL</Parameter> -->
				<!-- <Parameter Name="OrderPersonID">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>
1)
Pflichtparameter sind unterstrichen
4)
direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“
5)
I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org
engine/procedures/mi_checkperformance_ad.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)