pixiAdminGetCULStatistics

Liefert die maximale Anzahl gleichzeitig lizenzierter Benutzer (CULs) pro Stunde oder pro Tag seit einem Startdatum, aufgeteilt nach Pixi-Client-Anwendung.

Wertet die Sitzungs-Snapshots in UsersLoggedIn aus und liefert, wie viele lizenzrelevante Benutzer gleichzeitig angemeldet waren.

Zeitraum

• Ist StartDate leer, wird der früheste Tag aller Desktop-/Web-Sitzungen (UserActiveSessionTypeId 1 oder 2) verwendet.
• Es wird ein Kalenderraster von heute zurück bis StartDate erzeugt: eine Zeile pro Tag und Stunde 0–23 bei Hourly = 1, bzw. eine Zeile pro Tag (Stunde 0) bei Hourly = 0.

Gezählte Sitzungen

• Sitzungstyp 1 (Desktop) oder 2 (Web) mit Tag nach StartDate.
• Die Anwendung (AppName) muss in ExeClientVersion mit LicenceNeeded = 1 hinterlegt sein, und der Lizenzmanager für ihren Sitzungstyp muss aktiv sein: Einstellung pixiLicencesManager für Desktop-Clients, pixiLicencesManagerWeb für den Web-Client.
• Rechner aus MasterUsers sowie der Pixi-Benutzer master werden ausgeschlossen.

Berechnung

1. Sitzungen werden pro Snapshot (Tag) gezählt; eine Sitzung pro Tag/SessionId/Pixi-Benutzer.
2. Pro Stunde wird der höchste Snapshot-Wert als CULs übernommen.
3. Pro Tag wird der höchste Stundenwert als CULsPerDay an der Stunde vermerkt, in der er zuerst erreicht wurde.
4. Tage ohne Nutzung erhalten eine Zeile mit CULs = 0 und CULsPerDay = 0.
5. Die Spalten pro Anwendung zählen die Sitzungen des Spitzen-Snapshots der Stunde, zugeordnet über den Programmnamen (z. B. PPOS2.exe → POS, pixi.Presentation.Web → Web).

Ausgabe

• Hourly = 1: eine Zeile pro Tag und Stunde; CULsPerDay ist nur in der Spitzenstunde des Tages gefüllt, sonst NULL.
• Hourly = 0: eine Zeile pro Tag mit dem Tagesmaximum in CULs und CULsPerDay; Hour ist immer 0.
• Sortierung nach Date aufsteigend, danach nach der Stunde der Nutzungsdaten.

Parameter

Antwort

Result-Set 1 · Immer (leer, wenn kein Startdatum ermittelt werden kann)

Statistik der gleichzeitig lizenzierten Benutzer pro Tag und Stunde (bzw. pro Tag) mit Aufteilung nach Client-Anwendung.

<SqlRowSet1>
  <row>
    <Date>2024-05-13T14:37:00</Date>
    <Hour>9</Hour>
    <Day>13</Day>
    <Month>5</Month>
    <POS>0</POS>
    <SupplOrders>2</SupplOrders>
    <Payments>1</Payments>
    <CustomerService>3</CustomerService>
    <Shipping>4</Shipping>
    <Reports>0</Reports>
    <Bin>1</Bin>
    <Invoices>1</Invoices>
    <ControlCenter>2</ControlCenter>
    <Web>1</Web>
    <CULs>15</CULs>
    <CULsPerDay>15</CULsPerDay>
  </row>
  <row>
    <Date>2024-05-13T14:37:00</Date>
    <Hour>10</Hour>
    <Day>13</Day>
    <Month>5</Month>
    <POS>0</POS>
    <SupplOrders>1</SupplOrders>
    <Payments>1</Payments>
    <CustomerService>3</CustomerService>
    <Shipping>3</Shipping>
    <Reports>1</Reports>
    <Bin>1</Bin>
    <Invoices>0</Invoices>
    <ControlCenter>1</ControlCenter>
    <Web>1</Web>
    <CULs>12</CULs>
  </row>
</SqlRowSet1>

Beispiele

POST https://apigateway.descartes.com/tms/pixi/
Content-Type: text/xml; charset=utf-8
Authorization: Basic BASE64(USERNAME:PASSWORD)

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiAdminGetCULStatistics>
      <!-- <StartDate>2024-05-01T00:00:00</StartDate> -->
      <!-- <Hourly>1</Hourly> -->
    </ns1:pixiAdminGetCULStatistics>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

curl -X POST 'https://apigateway.descartes.com/tms/pixi/' \
  --user 'USERNAME:PASSWORD' \
  --header 'Content-Type: text/xml; charset=utf-8' \
  --data-binary @- <<'XML'
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiAdminGetCULStatistics>
      <!-- <StartDate>2024-05-01T00:00:00</StartDate> -->
      <!-- <Hourly>1</Hourly> -->
    </ns1:pixiAdminGetCULStatistics>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
XML

<?php

$soapClient = new SoapClient(null, [
    'login' => 'USERNAME',
    'password' => 'PASSWORD',
    'location' => 'https://apigateway.descartes.com/tms/pixi/',
    'uri' => 'https://apigateway.descartes.com/tms/pixi/',
]);

$arguments = [
    // 'StartDate' => '2024-05-01T00:00:00',
    // 'Hourly' => '1',
];

$soapArguments = [];
foreach ($arguments as $name => $value) {
    $soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}

$response = $soapClient->__soapCall('pixiAdminGetCULStatistics', $soapArguments);

Verwendete Tabellen

SQL-Objekt:

dbo.pipiAdminGetCULStatistics

Prozedur zuletzt geändert am 2026-10-05

Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben