Ir para o conteúdo principal
Adaptive Planning
Última atualização: 2023-06-23
exportLocales

exportLocales

Categoria
Recuperação de metadados
Descrição
Retorna uma lista de todos os parâmetros regionais de uma empresa.
Parâmetros obrigatórios na solicitação
Credenciais
A solicitação desse método contém apenas uma etiqueta de
credenciais
para identificar e autorizar o usuário que está fazendo a chamada. Uma vez verificado, o método retorna um documento XML que descreve o conjunto completo de todos os parâmetros regionais associados a essa empresa.

Formato da solicitação

<?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>
elemento de credenciais
Nome da etiqueta
credenciais
Descrição
Todas as chamadas de API devem conter um único elemento de credenciais para identificar o usuário que invoca a API. A chamada à API é então executada como este usuário (qualquer trilha de auditoria ou histórico de ações no sistema mostrará que este usuário executou a ação) e, portanto, o usuário deve ter as permissões necessárias para executar a ação para que a chamada à API funcione. bem-sucedido.
Atributos do elemento
Nome do atributo
Obrigatório?
Valor
Exemplo
login
S
O nome de logon do usuário que invoca o método de API. Esse usuário deve ter as permissões necessárias para invocar o método.
sampleuser@company.com
senha
S
A senha do usuário que invoca o método de API.
my_password
parâmetros regionais
N
Especifique os parâmetros regionais a serem usados para interpretar números e datas de entrada e para formatar números e datas de saída (usando o separador de milhares, nomes de meses e formatação de data adequados). Os parâmetros regionais também são usados para especificar o idioma em que as mensagens do sistema na resposta devem ser exibidas. Se não especificado, en_US (inglês americano) é usado.
fr_FR
instanceCode
N
Se o usuário especificado nas credenciais tem acesso a mais de uma instância do
Adaptive Planning
, esse atributo pode ser usado para especificar que o usuário pretende acessar uma instância diferente da instância por padrão. Se não for especificada, será usada a instância por padrão do usuário. Para determinar os códigos de instância disponíveis, use a API exportInstances.
MYINSTANCE1
Conteúdo do elemento
(nenhum)

Formato da resposta

<?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>
elemento de resposta
Nome da etiqueta
resposta
Atributos do elemento
Nome do atributo
Obrigatório?
Valor
Exemplo
êxito
S
Verdadeiro ou falso, indicando se a chamada à API foi bem-sucedida ou não. Mesmo as chamadas bem-sucedidas podem conter mensagens de aviso na resposta.
verdadeiro
obsoleto
N
Se presente na etiqueta de resposta e definido como verdadeiro, esse atributo indica que a versão do método ou da API que está sendo invocada se tornou obsoleta e está oficialmente obsoleta. Embora continue a funcionar neste momento, pode deixar de funcionar em breve. Normalmente, esse atributo não está presente.
false
Conteúdo do elemento
Um único elemento de mensagens opcional e exatamente um elemento de saída obrigatório.
elemento de saída
Nome da etiqueta
saída
Atributos do elemento
Nome do atributo
Obrigatório?
Valor
Exemplo
(nenhum)
Conteúdo do elemento
Um único elemento de atributos obrigatórios. Esse invólucro de saída é padrão em todas as respostas de API e inclui a saída válida de qualquer chamada de API bem-sucedida.
elemento de parâmetros regionais
Nome da etiqueta
parâmetros regionais
Descrição
Contêiner para um ou mais elementos de parâmetros regionais.
Atributos do elemento
Nome do atributo
Obrigatório?
Valor
Exemplo
(nenhum)
Conteúdo do elemento
Um ou mais elementos de parâmetros regionais.
elemento de parâmetros regionais
Nome da etiqueta
parâmetros regionais
Descrição
Representa um único parâmetro regional associado a uma empresa.
Atributos do elemento
Nome do atributo
Obrigatório?
Valor
Exemplo
código
S
O código de parâmetros regionais padrão usado pelo Firefox.
en
nome
S
Uma versão legível do nome dos parâmetros regionais.
Inglês
isDefault
S
Se esse parâmetro regional é o valor por padrão para a empresa, 1. Caso contrário, 0.
1
Conteúdo do elemento
(nenhum)