General Lesen

pixiReadTranslations

Liefert Einträge der Pixi-Übersetzungstabelle seitenweise, sortiert nach `TranslationKey`, beginnend nach einem angegebenen Schlüssel.

Liest Übersetzungseinträge (sprachabhängige Texte) aus der Tabelle Translation per Keyset-Paging.

Wird TranslationKey weggelassen oder als NULL übergeben, wird der Wert auf 0 gesetzt. Das Lesen beginnt dann am Anfang der Tabelle.
Wird RowCount weggelassen oder als NULL übergeben, wird der Wert auf 1000 gesetzt.
Geliefert werden höchstens RowCount Zeilen, deren TranslationKey größer als der übergebene TranslationKey ist, aufsteigend sortiert nach TranslationKey.

Um alle Übersetzungen zu lesen, wird mit TranslationKey = 0 begonnen (oder der Parameter weggelassen). Danach wird die Abfrage jeweils mit dem höchsten TranslationKey der vorherigen Seite wiederholt, bis weniger als RowCount Zeilen zurückkommen.

Hinweise

Da beide Parameter bei NULL durch Standardwerte ersetzt werden, wird immer nur der Paging-Zweig ausgeführt. Der Code enthält zusätzlich Zweige für eine exakte Suche nach TranslationKey und für ein leeres Ergebnis. Diese Zweige sind jedoch nicht erreichbar.
Die Übergabe eines bestimmten TranslationKey liefert nicht diesen Eintrag, sondern die Einträge danach.
Die Tabelle wird WITH (NOLOCK) gelesen. Nicht festgeschriebene Änderungen können daher sichtbar sein.
RowCount = 0 liefert keine Zeilen. Ein negativer RowCount führt zu einem SQL-Server-Fehler aus der TOP-Klausel.
Die Spaltentypen sind im Code nicht erkennbar, da die Definition der Tabelle Translation nicht vorliegt.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`TranslationKey`	int	NULL	Paging-Cursor. Es werden nur Einträge mit einem `TranslationKey` größer als dieser Wert geliefert. `NULL` wird als `0` behandelt. Beispiel: `0`
`RowCount`	int	1000	Maximale Anzahl gelieferter Zeilen. `NULL` wird als `1000` behandelt. Beispiel: `500`

Antwort

Result-Set 1 · Immer

Übersetzungseinträge nach dem angegebenen Schlüssel, aufsteigend sortiert nach TranslationKey, begrenzt auf RowCount Zeilen.

Spalte	Typ	Beschreibung
`TranslationKey`	int	Eindeutiger Schlüssel des Übersetzungseintrags. Der höchste Wert einer Seite dient als Cursor für den nächsten Aufruf.
`LanguageID` Kann leer sein	string	Sprache der Übersetzung.
`TranslationID` Kann leer sein	string	Kennung des übersetzten Textes.
`TranslationText` Kann leer sein	string	Übersetzter Text.
`ApplicationName` Kann leer sein	string	Anwendung, zu der die Übersetzung gehört.
`DBObjectName` Kann leer sein	string	Name des Datenbankobjekts, auf das sich die Übersetzung bezieht.

Beispielantwort

<SqlRowSet1>
  <row>
    <TranslationKey>1</TranslationKey>
    <LanguageID>EN</LanguageID>
    <TranslationID>ORDER_STATUS_OPEN</TranslationID>
    <TranslationText>Open</TranslationText>
    <ApplicationName>pixi</ApplicationName>
    <DBObjectName>OrderStatus</DBObjectName>
  </row>
  <row>
    <TranslationKey>2</TranslationKey>
    <LanguageID>DE</LanguageID>
    <TranslationID>ORDER_STATUS_OPEN</TranslationID>
    <TranslationText>Offen</TranslationText>
    <ApplicationName>pixi</ApplicationName>
    <DBObjectName>OrderStatus</DBObjectName>
  </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:pixiReadTranslations>
      <!-- <TranslationKey>0</TranslationKey> -->
      <!-- <RowCount>500</RowCount> -->
    </ns1:pixiReadTranslations>
  </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:pixiReadTranslations>
      <!-- <TranslationKey>0</TranslationKey> -->
      <!-- <RowCount>500</RowCount> -->
    </ns1:pixiReadTranslations>
  </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 = [
    // 'TranslationKey' => '0',
    // 'RowCount' => '500',
];

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

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

Verwendete Tabellen

Translation · Lesen

SQL-Objekt:: dbo.pipiReadTranslations