pixiReportActiveLogins

Liefert die aktuell in Pixi angemeldeten Benutzer, die Lizenzen belegen, optional einschließlich mobiler Sitzungen.

Listet die aktiven, lizenzrelevanten Anmeldungen aus dem letzten Anmelde-Snapshot in UsersLoggedIn auf.

1. Zuerst wird der letzte Snapshot-Zeitstempel (Tag) ermittelt. Berücksichtigt werden die Sitzungstypen 1 und 2 (Desktop/Web), bei IncludeMobileLicences = 1 die Typen 1, 2, 4 und 5.
2. Anschließend wird die interne Prozedur Pixi_ShowConcurrentUsersForTag im Distinct-Modus aufgerufen. Diese berechnet den Zeitstempel neu als letzten Tag der Sitzungstypen 1 und 2. Gibt es keinen Eintrag, wird das aktuelle Datum mit Uhrzeit verwendet.
3. Desktop-/Web-Sitzungen (Typen 1, 2) mit diesem Tag werden nur berücksichtigt, wenn alle folgenden Bedingungen erfüllt sind:
   • ihr AppName ist ein Client in ExeClientVersion mit LicenceNeeded = 1;
   • der Lizenzmanager für den jeweiligen Client-Typ ist aktiv: Einstellung pixiLicencesManager für Desktop (UserActiveSessionTypeRef = 1) bzw. pixiLicencesManagerWeb für Web (UserActiveSessionTypeRef = 2).
4. Bei IncludeMobileLicences = 1 werden zusätzlich mobile Sitzungen (Typen 4, 5) mit demselben Tag aufgenommen.
5. Rechner aus MasterUsers und der Pixi-Benutzer master werden immer ausgeschlossen.
6. Die Zeilen werden je Sitzung und Pixi-Benutzer gruppiert, sodass jede Sitzung einmal erscheint. AppName ist Desktop/Web oder Mobile. ComputerName ist der größte Rechnername der Sitzung.

NrOfLicences enthält den Wert der Einstellung pixiLicences, wenn pixiLicencesManager den Wert 1 hat, sonst 0.

Parameter

Antwort

Result-Set 1 · Immer (ggf. leer)

Eine Zeile je aktiver, lizenzrelevanter Sitzung.

<SqlRowSet1>
  <row>
    <OnDate>2024-05-14T10:15:00</OnDate>
    <UsersCount>0</UsersCount>
    <Username>mmueller</Username>
    <AppName>Desktop/Web</AppName>
    <ComputerName>WS-LAGER01</ComputerName>
    <NrOfLicences>10</NrOfLicences>
  </row>
  <row>
    <OnDate>2024-05-14T10:15:00</OnDate>
    <UsersCount>0</UsersCount>
    <Username>kschmidt</Username>
    <AppName>Mobile</AppName>
    <ComputerName>MDE-07</ComputerName>
    <NrOfLicences>10</NrOfLicences>
  </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:pixiReportActiveLogins>
      <!-- <IncludeMobileLicences>1</IncludeMobileLicences> -->
    </ns1:pixiReportActiveLogins>
  </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:pixiReportActiveLogins>
      <!-- <IncludeMobileLicences>1</IncludeMobileLicences> -->
    </ns1:pixiReportActiveLogins>
  </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 = [
    // 'IncludeMobileLicences' => '1',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiReportActiveLogins

Prozedur zuletzt geändert am 2026-10-05

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