General Lesen

pixiAdminGetCUL

Liefert die an lizenzpflichtigen Pixi-Clients angemeldeten Benutzer zu einem Snapshot-Zeitpunkt oder zum letzten Snapshot, wenn kein Datum übergeben wird.

Listet die aktuell angemeldeten Benutzer (CUL) aus der Snapshot-Tabelle UsersLoggedIn auf.

Wird Date nicht übergeben, wird der jüngste Snapshot-Zeitpunkt (MAX(Tag)) aller Sitzungen mit Sitzungstyp 1 oder 2 verwendet.
Berücksichtigt werden nur Zeilen, deren Tag exakt diesem Datum entspricht, und nur Sitzungen vom Typ 1 oder 2.
Nur lizenzpflichtige Anwendungen werden einbezogen. Eine Anwendung zählt, wenn sie in ExeClientVersion mit LicenceNeeded = 1 eingetragen ist und entweder:
- die Einstellung pixiLicencesManager den Wert 1 hat und die Sitzungstyp-Referenz des Clients 1 ist (Desktop), oder
- die Einstellung pixiLicencesManagerWeb den Wert 1 hat und die Sitzungstyp-Referenz des Clients 2 ist (Web). Fehlende Einstellungen gelten als 0.
Master-Benutzer werden ausgeschlossen: Zeilen, deren UserName als ComputerName in MasterUsers vorkommt, sowie Zeilen mit UserNameUsingPixi = master.
Bekannte Programme erhalten einen sortierbaren Anzeigenamen (z. B. wird PPOS2.exe zu 1_POS, supplorders_a.exe zu 2_SupplOrders bis ControlCenter.exe zu 9_ControlCenter). Andere Anwendungsnamen bleiben unverändert.

Das Ergebnis ist nach UserName, UserNameUsingPixi und dem umbenannten AppName sortiert.

Hinweise

Alle Lesezugriffe verwenden NOLOCK; das Ergebnis kann nicht festgeschriebene Daten enthalten.
Sind beide Lizenzmanager-Einstellungen 0 oder nicht vorhanden, qualifiziert sich keine Anwendung und das Ergebnis ist immer leer.
Date muss exakt einem Snapshot-Tag entsprechen (inklusive Uhrzeit); ein Datum ohne die genaue Uhrzeit des Snapshots liefert keine Zeilen. Die Übergabe von 1900-01-01 wirkt wie das Weglassen des Datums, da der Code ISNULL(@Date, '') mit einer leeren Zeichenkette vergleicht.
AppName_clean entfernt einfach die ersten zwei Zeichen von AppName. Bei umbenannten Anwendungen fällt damit das numerische Präfix weg (1_POS → POS); bei nicht zugeordneten Anwendungen werden die ersten zwei Zeichen des ursprünglichen Programmnamens abgeschnitten.
Vollständige Zuordnung: PPOS2.exe → 1_POS, supplorders_a.exe → 2_SupplOrders, paymentsclient_a.exe → 3_Payments, shippingclient_a.exe → 4_Shipping, CustomerClient_A.exe → 5_CustomerService, ReportClientA.exe → 6_Reports, binclient_a.exe → 7_Bin, InvoicesClient_A.exe → 8_Invoices, ControlCenter.exe → 9_ControlCenter.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`Date`	datetime dateTime	NULL	Snapshot-Zeitpunkt (`Tag` in `UsersLoggedIn`), der ausgewertet wird. Muss exakt übereinstimmen. Ohne Angabe wird der letzte Snapshot der Sitzungstypen 1 und 2 verwendet. Beispiel: `2024-05-14T10:15:00`

Antwort

Result-Set 1 · Immer (kann leer sein)

Angemeldete Benutzer lizenzpflichtiger Anwendungen zum gewählten Snapshot, ohne Master-Benutzer.

Spalte	Typ	Beschreibung
`Tag`	datetime dateTime	Snapshot-Zeitpunkt des Anmeldeeintrags.
`UserNameUsingPixi` Kann leer sein	string	In der Sitzung verwendeter Pixi-Benutzername.
`UserName` Kann leer sein	string	Benutzer- bzw. Computername der Sitzung.
`SessionId` Kann leer sein	string	Kennung der Sitzung.
`AppName_clean` Kann leer sein	string	`AppName` ohne die ersten zwei Zeichen (z. B. `POS` für `1_POS`).
`AppName` Kann leer sein	string	Anwendungsname; bekannte Programme werden durch einen nummerierten Anzeigenamen wie `1_POS` ersetzt.
`AppVersion` Kann leer sein	string	Version der in der Sitzung verwendeten Anwendung.

Beispielantwort

<SqlRowSet1>
  <row>
    <Tag>2024-05-14T10:15:00</Tag>
    <UserNameUsingPixi>mmueller</UserNameUsingPixi>
    <UserName>WS-LAGER01</UserName>
    <SessionId>58</SessionId>
    <AppName_clean>Bin</AppName_clean>
    <AppName>7_Bin</AppName>
    <AppVersion>24.5.1.0</AppVersion>
  </row>
  <row>
    <Tag>2024-05-14T10:15:00</Tag>
    <UserNameUsingPixi>skraus</UserNameUsingPixi>
    <UserName>WS-OFFICE03</UserName>
    <SessionId>71</SessionId>
    <AppName_clean>SupplOrders</AppName_clean>
    <AppName>2_SupplOrders</AppName>
    <AppVersion>24.5.1.0</AppVersion>
  </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:pixiAdminGetCUL>
      <!-- <Date>2024-05-14T10:15:00</Date> -->
    </ns1:pixiAdminGetCUL>
  </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:pixiAdminGetCUL>
      <!-- <Date>2024-05-14T10:15:00</Date> -->
    </ns1:pixiAdminGetCUL>
  </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 = [
    // 'Date' => '2024-05-14T10:15:00',
];

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

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

Verwendete Tabellen

UsersLoggedIn · Lesen settings · Lesen ExeClientVersion · Lesen MasterUsers · Lesen

SQL-Objekt:: dbo.pipiAdminGetCUL