exportLokales
Kategorie
| Abrufen von Metadaten |
Beschreibung
| Gibt eine Liste aller Gebietsschemas für ein Unternehmen zurück. |
Auf Anforderung erforderliche Parameter
| Zugangsdaten |
Die Anforderung dieser Methode enthält nur ein
Credentials
-Tag zur Identifizierung und Autorisierung des aufrufenden Benutzers. Nach der Verifizierung gibt die Methode ein XML-Dokument zurück, das den vollständigen Satz aller Gebietsschemas beschreibt, die diesem Unternehmen zugeordnet sind.Anforderungsformat
<?xml version='1.0' encoding='UTF-8'?> <call method="exportLocales" callerName="a string that identifies your client application"> <credentials login="sampleuser@company.com" password="my_pwd"/> </call>
Element „Zugangsdaten“.
| |||
Tag-Name
| -Zugangsdaten | ||
Beschreibung
| Alle API-Aufrufe müssen ein einzelnes Element mit den Zugangsdaten enthalten, um den Benutzer zu identifizieren, der die API aufruft. Der API-Aufruf wird dann als dieser Benutzer ausgeführt (jeder Audit-Trail oder jede Aktionshistorie im System zeigt, dass dieser Benutzer die Aktion ausgeführt hat). Daher muss der Benutzer über die erforderlichen Berechtigungen zum Ausführen der Aktion verfügen, damit der API-Aufruf ausgeführt werden kann erfolgreich ist. | ||
Attribute des Elements
| |||
Name des Attributs
| erforderlich?
| Wert
| Beispiel
|
anmelden | J | Der Anmeldename des Benutzers, der die API-Methode aufruft. Dieser Benutzer muss über die erforderlichen Berechtigungen zum Aufrufen der Methode verfügen. | sampleuser@company.com |
Kennwort | J | Das Kennwort des Benutzers, der die API-Methode aufruft. | my_password |
Gebietsschema | N | Geben Sie das Gebietsschema an, das verwendet werden soll, um eingehende Zahlen und Datumsangaben zu interpretieren und ausgehende Zahlen und Datumsangaben zu formatieren (mit dem entsprechenden Tausendertrennzeichen, den Monatsnamen und der Datumsformatierung). Das Gebietsschema wird auch verwendet, um die Sprache anzugeben, in der Systemmeldungen in der Antwort angezeigt werden sollen. Wenn nicht angegeben, wird en_US (amerikanisches Englisch) verwendet. | fr_FR |
instanceCode | N | Wenn der in den Zugangsdaten angegebene Benutzer Zugriff auf mehr als eine Instanz von hat, Adaptive Planning : Dieses Attribut kann verwendet werden, um anzugeben, dass der Benutzer auf eine andere Instanz als seine Standardinstanz zugreifen möchte. Wenn nichts angegeben wird, wird die Standardinstanz des Benutzers verwendet. Verwenden Sie die exportInstances-API, um die verfügbaren Instanzcodes zu ermitteln. | MYINSTANCE1 |
Inhalt des Elements
| |||
(Keine) | |||
Antwortformat
<?xml version="1.0" encoding="UTF-8"?> <response success="true"> <output> <locales> <locale code="en" name="English" isDefault="1" /> <locale code="de" name="German" isDefault="0" /> <locale code="fr" name="French" isDefault="0" /> <locale code="es" name="Spanish" isDefault="0" /> <locale code="pt" name="Portuguese" isDefault="0" /> <locale code="nl" name="Dutch" isDefault="0" /> <locale code="ja" name="Japanese" isDefault="0" /> </locales> </output> </response>
Antwortelement
| |||
Tag-Name
| -Antwort | ||
Attribute des Elements
| |||
Name des Attributs
| erforderlich?
| Wert
| Beispiel
|
Erfolg haben | J | Entweder wahr oder falsch, was angibt, ob der API-Aufruf erfolgreich war oder nicht. Selbst erfolgreiche Aufrufe können in ihrer Antwort Warnmeldungen enthalten. | wahr |
veraltet | N | Wenn dieses Attribut im Antwort-Tag vorhanden und auf „true“ gesetzt ist, zeigt es an, dass die Version der Methode oder API, die aufgerufen wird, veraltet und offiziell veraltet ist. Auch wenn es zu diesem Zeitpunkt noch funktioniert, kann es sein, dass Sie in Kürze nicht mehr funktionieren. In der Regel ist dieses Attribut nicht vorhanden. | false |
Inhalt des Elements
| |||
Ein einzelnes optionales Nachrichtenelement und genau ein erforderliches Ausgabeelement. | |||
Ausgabeelement
| |||
Tag-Name
| Ausgabe | ||
Attribute des Elements
| |||
Name des Attributs
| erforderlich?
| Wert
| Beispiel
|
(Keine) | |||
Inhalt des Elements
| |||
Ein einzelnes erforderliches Attributelement. Dieser Ausgabe-Wraper ist ein Standard für alle API-Antworten und schließt die gültige Ausgabe jedes erfolgreichen API-Aufrufs ein. | |||
Element „Lokales“.
| |||
Tag-Name
| Gebietsschemas | ||
Beschreibung
| Container für ein oder mehrere Gebietsschema-Elemente. | ||
Attribute des Elements
| |||
Name des Attributs
| erforderlich?
| Wert
| Beispiel
|
(Keine) | |||
Inhalt des Elements
| |||
Ein oder mehrere Gebietsschema-Elemente. | |||
Gebietsschema-Element
| |||
Tag-Name
| Gebietsschema | ||
Beschreibung
| Stellt ein einzelnes Gebietsschema dar, das mit einem Unternehmen verknüpft ist. | ||
Attribute des Elements
| |||
Name des Attributs
| erforderlich?
| Wert
| Beispiel
|
-Code | J | Der Standardgebietsschema-Code, wie von Firefox verwendet. | de |
Name | J | Eine lesbare Version des Namens des Gebietsschemas. | Englisch |
isDefault | J | Wenn dieses Gebietsschema der Standard für das Unternehmen ist, wird 1. Andernfalls 0. | 1 |
Inhalt des Elements
| |||
(Keine) | |||