pixiGetApplicationUsageStatistic

Liefert pro Tag die pixi*-Anwendungen, die zum Zeitpunkt der meisten verbundenen Benutzer geöffnet waren, oder nur die Liste der genutzten Anwendungen.

Wertet die in UsersLoggedIn gespeicherten Anmelde-Snapshots aus, um zu zeigen, welche pixi*-Clients zum Zeitpunkt der höchsten Lizenznutzung eines Tages verwendet wurden.

1. Für jeden Snapshot (Tag) werden die angemeldeten Sitzungen gezählt. Ausgeschlossen werden Sitzungen, deren UserName einem ComputerName in MasterUsers entspricht, sowie Sitzungen mit UserNameUsingPixi = master.
2. Pro Kalendertag (Datumsanteil von Tag) wird der Snapshot mit der höchsten Anzahl Sitzungen gewählt. Bei Gleichstand gewinnt der späteste Snapshot des Tages.
3. Für den gewählten Snapshot jedes Tages werden die Sitzungen pro Anwendung (AppName) gezählt, mit denselben Ausschlüssen.
4. Die technischen Anwendungsnamen werden über eine fest hinterlegte Liste in lesbare Namen übersetzt (z. B. BinClient_A.exe → Lager, ShippingClient_A.exe → Versand, mehrere Web-Komponenten → Web pixi*). Anwendungen, die nicht in dieser Liste stehen, fallen aus dem Ergebnis heraus.

Die Ausgabe hängt von ShowOnlyApplicationsused ab:

• 0 (Standard): eine Zeile pro Tag und Anwendung mit Anzahl der Sitzungen, sortiert nach Tag_Date und ApplicationFormatted.
• 1: nur die eindeutige Liste der Anwendungen (technischer und lesbarer Name), die in einem der täglichen Spitzen-Snapshots vorkamen, ohne definierte Sortierung.

Es gibt keinen Datumsfilter; alle Snapshots in UsersLoggedIn werden ausgewertet.

Parameter

Antwort

Result-Set 1 · Wenn ShowOnlyApplicationsused = 0 (Standard)

Eine Zeile pro Tag und Anwendung zum täglichen Spitzen-Snapshot, sortiert nach Tag_Date und ApplicationFormatted.

Result-Set 2 · Wenn ShowOnlyApplicationsused = 1

Eindeutige Liste der Anwendungen, die in einem täglichen Spitzen-Snapshot vorkamen; keine definierte Sortierung.

<SqlRowSet1>
  <row>
    <Tag_Date>2024-03-11T00:00:00</Tag_Date>
    <Application>BinClient_A.exe</Application>
    <ApplicationFormatted>Lager</ApplicationFormatted>
    <Total>5</Total>
  </row>
  <row>
    <Tag_Date>2024-03-11T00:00:00</Tag_Date>
    <Application>ShippingClient_A.exe</Application>
    <ApplicationFormatted>Versand</ApplicationFormatted>
    <Total>3</Total>
  </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:pixiGetApplicationUsageStatistic>
      <!-- <ShowOnlyApplicationsused>0</ShowOnlyApplicationsused> -->
    </ns1:pixiGetApplicationUsageStatistic>
  </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:pixiGetApplicationUsageStatistic>
      <!-- <ShowOnlyApplicationsused>0</ShowOnlyApplicationsused> -->
    </ns1:pixiGetApplicationUsageStatistic>
  </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 = [
    // 'ShowOnlyApplicationsused' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetApplicationUsageStatistic

Prozedur zuletzt geändert am 2026-10-05

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