pixiItemGetByTags

Liefert Artikel, deren zugeordnete Tags einem XML-Tagfilter mit AND-, OR- und NOT-Gruppen entsprechen; Tags werden per ID oder (Teil-)Name bestimmt.

Sucht Artikel anhand der ihnen zugeordneten Tags (Tabelle TagMatch).

1. Filter einlesen

TagFilter ist ein XML-Dokument mit dem Wurzelelement TagFilter und den Gruppen AND, OR und NOT. Jede Gruppe kann beliebig viele TagId- und TagName-Elemente enthalten. Namen werden getrimmt; leere Namen gelten als fehlend.

2. Tags auflösen

Jeder Eintrag wird gegen Tags mit TypeId = 1 aufgelöst:

• TagId wird mit der Tag-ID verglichen.
• TagName wird bei PartialTagNameMatch = 0 exakt verglichen, bei PartialTagNameMatch = 1 per LIKE '%name%'. Ein Teilname kann mehrere Tags treffen.

3. Prüfung

Der Aufruf bricht mit einer Status-Ergebnismenge ab und liefert keine Artikel, wenn:

• ein Eintrag keinem Tag zugeordnet werden kann oder
• dasselbe Tag mehrfach aufgelöst wird. Das gilt gruppenübergreifend, innerhalb einer Gruppe und wenn ein Tag sowohl per ID als auch per Name angegeben ist.

Dann wird je Filtereintrag eine Zeile geliefert:

• Fehlerhafte Einträge erhalten Status = ERROR.
• Gültige Einträge erhalten OK mit Complete match on TagName, Partial match on TagName oder Complete match on TagId.

4. Artikelauswahl

Berücksichtigt werden nur Artikel, denen in TagMatch mindestens ein Tag zugeordnet ist. Ein Artikel wird geliefert, wenn er keines der NOT-Tags hat und mindestens eine der folgenden Bedingungen gilt:

• es wurden weder AND- noch OR-Tags angegeben (nur NOT oder leerer Filter);
• er hat alle AND-Tags. Bei StrictANDCondition = 1 darf er zusätzlich keine weiteren Tags haben; seine Tag-Menge muss also genau der AND-Menge entsprechen;
• er hat mindestens ein OR-Tag.

AND und OR werden mit ODER verknüpft. OR-Tags erweitern das Ergebnis also, statt es einzuschränken.

Das Ergebnis enthält ItemId, ItemNrInt und ItemName. Die Zeilen sind eindeutig und nicht sortiert.

Parameter

<TagFilter>
  <AND>
    <TagId>12</TagId>
    <TagName>Summer</TagName>
  </AND>
  <OR>
    <TagId>15</TagId>
    <TagName>New</TagName>
  </OR>
  <NOT>
    <TagId>20</TagId>
    <TagName>Discontinued</TagName>
  </NOT>
</TagFilter>

Antwort

Result-Set 1 · Bei Erfolg (Filter vollständig aufgelöst, keine doppelten Tags)

Eindeutige Artikel, die dem Tagfilter entsprechen, unsortiert.

Result-Set 2 · Anstelle der Artikelliste, wenn ein Filtereintrag nicht gefunden wird, ein Tag mehrfach aufgelöst wird oder das Einlesen fehlschlägt

Eine Statuszeile je Filtereintrag mit dem Auflösungsergebnis. Bei einem unerwarteten Fehler eine einzelne Zeile, in der alle Spalten außer Status und StatusMessage NULL sind.

<SqlRowSet1>
  <row>
    <ItemId>4711</ItemId>
    <ItemNrInt>ART-10023</ItemNrInt>
    <ItemName>Garden chair teak</ItemName>
  </row>
  <row>
    <ItemId>4712</ItemId>
    <ItemNrInt>ART-10024</ItemNrInt>
    <ItemName>Garden table teak</ItemName>
  </row>
</SqlRowSet1>

Fehlermeldungen

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:pixiItemGetByTags>
      <TagFilter><![CDATA[<TagFilter><AND><TagId>12</TagId><TagName>Summer</TagName></AND><OR><TagId>15</TagId><TagName>New</TagName></OR><NOT><TagId>20</TagId><TagName>Discontinued</TagName></NOT></TagFilter>]]></TagFilter>
      <!-- <PartialTagNameMatch>0</PartialTagNameMatch> -->
      <!-- <StrictANDCondition>0</StrictANDCondition> -->
    </ns1:pixiItemGetByTags>
  </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:pixiItemGetByTags>
      <TagFilter><![CDATA[<TagFilter><AND><TagId>12</TagId><TagName>Summer</TagName></AND><OR><TagId>15</TagId><TagName>New</TagName></OR><NOT><TagId>20</TagId><TagName>Discontinued</TagName></NOT></TagFilter>]]></TagFilter>
      <!-- <PartialTagNameMatch>0</PartialTagNameMatch> -->
      <!-- <StrictANDCondition>0</StrictANDCondition> -->
    </ns1:pixiItemGetByTags>
  </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 = [
    'TagFilter' => '<TagFilter><AND><TagId>12</TagId><TagName>Summer</TagName></AND><OR><TagId>15</TagId><TagName>New</TagName></OR><NOT><TagId>20</TagId><TagName>Discontinued</TagName></NOT></TagFilter>',
    // 'PartialTagNameMatch' => '0',
    // 'StrictANDCondition' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiItemGetByTags

Prozedur zuletzt geändert am 2026-10-05

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