importStandardData

Adaptive Planning

Documentação do Workday Adaptive Planning (Workday 2025R2)
Integração
Como gerenciar a integração de dados
Documentação da API
Métodos de envio de dados

Última atualização: 2024-09-20

importStandardData

Atualizado na API v40 (13 de setembro de 2024)

Categoria	Envio de dados
Descrição	Insere ou substitui dados em contas padrão.
Permissões obrigatórias para invocar	Importar para todos os locais Apagar dados (API v36+ para oferecer suporte ao modo REPLACE)
Parâmetros obrigatórios na solicitação	Credentials, ImportDataOptions, Version, RowData

includeDescendants

A solicitação desse método contém os parâmetros que serão usados para determinar qual versão receberá as linhas de dados fornecidas. Os dados podem ser importados para qualquer conta padrão (conta LR, conta personalizada, suposição ou taxa cambial), independentemente de a conta ter sido colocada em uma planilha.

importStandardData não pode importar para contas que usam a configuração Entrada de dados
para fórmula de substituição
.

Formato da solicitação


<?xml version='1.0' encoding='UTF-8'?>
<call method="importStandardData" callerName="a string that identifies your client application">
<credentials login="sampleuser@company.com" password="my_pwd" instanceCode="INSTANCE1"/>
<importDataOptions planOrActuals="Plan" allowParallel="false" moveBPtr="false" useMappings="false" />
<version name="Budget 2004" isDefault="false" />
<rowData>
<header>Account|Level|Split Label|Product|Region|11/2005|01/2006</header>
<rows>
<row>70110|Corporate Plan||Bunnyrabbit Toy|Western-US|2037|4032</row>
</rows>
</rowData>
</call>

Cada invocação desta chamada de API deve conter exatamente um elemento de cada um dos tipos listados:

credenciais

importDataOptions

versão

rowData

cabeçalho

linhas

Uma incompatibilidade entre o número de caracteres de barra vertical ( | ) no cabeçalho e os dados causará um erro na API v30 ou superior.

Para a API v36+, se o atributo de modo importDataOptions é REPLACE, um elemento de escopo também deve ser especificado:

Exemplo: solicitação de substituição de modo

Disponível somente na API v36+


<?xml version='1.0' encoding='UTF-8'?>
<call method="importStandardData" callerName="a string that identifies your client application">
<credentials login="nobody@company.com" password="password" instanceCode="INSTANCE1"/>
<importDataOptions planOrActuals="Plan" allowParallel="true" moveBPtr="false" useMappings="false" mode="replace" />
<version name="Budget 2011" isDefault="false" />
<scope>
<accounts mode="explicit">
<account includeDescendants="false">30490</account>
<account includeDescendants="false">70313</account>
</accounts>
<levels mode="explicit">
<level includeDescendants="false">Development</level>
<level includeDescendants="true">Sales</level>
</levels>
<time mode="input" />
</scope>
<rowData>
<header>Account|Level|Split Label|Base Pay|CapitalAssetClass|Company|CountryRegion|01/2011</header>
<rows>
<row>30490|Asia Sales||120-150K|Furniture|ABC Cons|Washington|1</row>
<row>70313|Development||100-120K|OtherEquipment|ABC Cons|Maharashtra|2</row>
</rows>
</rowData>
</call>

elemento de credenciais
Nome da etiqueta		credenciais
Descrição		Todas as chamadas de API devem conter um únicoCredenciais para identificar o usuário que está invocando 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
conectar-se	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
password	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 adequado,nomes de períodos e formatação de datas). 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, a instância por padrão do usuário será usada. Para determinar os códigos de instância disponíveis, use a API exportInstances.	MYINSTANCE1
Conteúdo do elemento
(nenhum)

importDataOptions element

Nome da etiqueta

importDataOptions

Descrição

Especifica as opções a serem usadas na importação.

Atributos do elemento

Nome do atributo

Obrigatório?

Valor

Exemplo

planOrActuals

Defina como uma de "Plano" ou "Valores reais" para especificar o tipo de dados que estão sendo importados. Se essa configuração está em conflito com a versão especificada noEtiqueta de versão, aO valor da etiqueta de versão tem precedência e essa configuração é ignorada.

Plano

moveBPtr

Usado somente quando oO atributo planOrActuals está definido comoValores reais SemoveBPtr está definido comoVerdadeiro, a importação moverá o indicador de disponibilidade de valores reais na versão de valores reais para o período mais recente encontrado nos dados importados. Se definido comoSe for falso, a importação não afetará quais períodos mostram valores reais em nenhuma versão. Esse atributo deve ser definido como falso seplanOrActuals está definido comoPlano

falso

allowParallel

Usado somente quando oO atributo planOrActuals está definido comoValores reais Se definido comotrue, a importação prosseguirá mesmo se já houver outra importação de valores reais ou de transações em andamento para esta instância. Se definido comofalse, a tentativa de importação falhará se já houver uma importação de valores reais ou de transações sendo processada para esta instância.

false

useMappings

Especifica se mapeamentos de importação devem ser usados para contas, planos e valores de dimensão dentro dos elementos de linha. Consideradotrue por padrão. Sefalse, os identificadores internos devem ser usados: as contas são identificadas por código, os níveis e os valores de dimensão por nome.

false

includeContext

Especifica se as mensagens podem incluir o bloco de contexto. Os valores sãofalso (nunca mostrar contexto) outrue (mostra o contexto, se apropriado). Se não for especificado,é assumida como verdadeira.

false

displayNameEnabled

Disponível somente na API v30+ para instâncias que habilitam o nome de exibição.

displayNameEnabled=true indica que importStandardData deve ser esperado

Account Code

Level Code

Dimension Code

Dimension Name Column

na carga quando Habilitar nome de exibição está ATIVADO para a instância.

displayNameEnabled=false indica que a API importStandardData deve continuar seguindo o contrato de API anterior à versão 30, mesmo quando a opção Habilitar nome de exibição está ATIVADA para a instância. A API importStandardData ignora as propriedades de nome de exibição

Account Code

Level Code

Dimension Code

Dimension Name Column

O valor por padrão para displayNameEnabled é "falso".

false

splitsToUnsplit

Disponível somente na API v40+

splitsToUnsplit=true permite que as divisões sejam importadas para um local não dividido com dados existentes. O valor por padrão para este atributo é falso.

false

modo

Disponível somente na API v36+

Especifica o modo de importação, que é APPEND ou REPLACE.

Anexar	Os fatos existentes são atualizados ou novos fatos são adicionados. Nenhum fato será excluído.
Substituir	A solicitação deve incluir um elemento de escopo que represente as coordenadas do hipercubo dentro do qual os dados serão substituídos pelos fornecidos na carga. Todos os dados existentes dentro do escopo que não têm uma coordenada correspondente na carga serão excluídos.

Esse atributo de modo tem suporte na API v36 e versões posteriores. Chamar uma versão anterior da API com mode="REPLACE" é um erro.

O valor por padrão para o modo, quando não especificado, é APPEND.

ANEXO

Conteúdo do elemento

(nenhum)

elemento de versão
Nome da etiqueta		versão
Descrição		Indica qual versão deve ser usada para receber os dados solicitados. Uma versão deve ser fornecida para cada chamada.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
nome	N	O nome da versão a ser usada para receber os dados. Somente uma versão pode ser acessada em uma única chamada de API. Se um nome não é fornecido, oO indicador isDefault deve ser definido como verdadeiro neste elemento. Para obter uma lista de versões de moeda convertidas e seus nomes, faça uma solicitaçãoexportVersions com currencyVersions=true no elemento include.	Orçamento de 2014
isDefault	N	Se o autor da chamada deseja acessar a versão por padrão atual da instância, independentemente do nome, esse atributo pode ser definido como verdadeiro; nesse caso, o atributo de nome da etiqueta (se presente) é ignorado. Caso contrário, se esse valor é falso ou se esse atributo não está presente, uma versão com o nome fornecido deve existir e estar acessível ao usuário para que essa chamada seja bem-sucedida.	false
Conteúdo do elemento
(nenhum)

elemento de escopo
Nome da etiqueta		escopo Disponível somente na versão 36+ da API
Descrição		Especifica o escopo desta importação. Permitido somente quando o atributo de modo do elemento importDataOptions é REPLACE.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
eraseCellNotes	N	Especifica se as observações de célula devem ou não ser apagadas no escopo. Deve ser um dos três valores enumerados: NENHUM - Não apaga observações de célula. ALL - Apaga todas as observações de célula no escopo. MODIFIED_ONLY - Apaga observações de células dentro do escopo que são modificadas pela importação. Isso inclui células vazias que têm fatos importados e células cujos fatos foram apagados. Se eraseCellNotes não é especificado, o valor por padrão é NONE.	NENHUM
Conteúdo do elemento
Um elemento de tempo , um de contas e um de níveis , todos obrigatórios.

elemento de contas
Nome da etiqueta		contas Disponível somente na versão 36+ da API
Descrição		Especifica as contas para o escopo de importação. Se uma conta especificada existir, mas não houver dados para ela nos dados de importação, os dados nela serão removidos para o intervalo de tempo e o restante das coordenadas do escopo. Permitido somente quando o atributo de modo do elemento importDataOptions é REPLACE.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
modo	S	Especifica o modo para o escopo da conta. Deve ser uma das três opções a seguir. EXPLÍCITO - Se esse modo é especificado, espera-se ver um ou mais subelementos de conta que determinam o escopo da conta para a importação. INPUT - Quando esse modo é especificado, o escopo da conta é determinado pelo conjunto exclusivo de contas presentes nos dados de importação. Observação: accounts mode="ALL" não é permitido para o escopo de importação padrão.	EXPLÍCITO
Conteúdo do elemento
Se o modo é INPUT , não deve haver nenhum subelemento de <account>. Se o modo é EXPLICIT , deve haver um ou mais subelementos de <account>. Se o modo é EXPLÍCITO e qualquer código de conta em um subelemento <account> é inválido, todo o elemento <accounts> e, por extensão, o <escopo>, são considerados inválidos. Uma mensagem de erro será incluída na resposta para cada código inválido.

elemento de conta
Nome da etiqueta		account Disponível somente na versão 36+ da API
Descrição		Especifica o código da conta a ser incluído no escopo da importação. Permitido somente quando o atributo de modo do elemento importDataOptions é REPLACE.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
includeDescendants	N	Se a conta é uma conta folha, includeDescendants não tem efeito. Se a conta é uma conta pai, especificar esse atributo como verdadeiro incluirá todos os descendentes folha dessa conta no escopo. Ocorre um erro se a conta é uma conta pai e includeDescendants é falso. Só podemos importar para contas folha. Este é um atributo opcional e o valor por padrão será considerado falso.	true
seletor	N	Especifica o tipo de conteúdo do elemento de conta: Código O conteúdo do elemento de conta é um código de conta. Exemplo: <account selector="code">30440</account> Neste exemplo, 30440 é um código de conta. Tipo. O conteúdo do elemento de conta é um tipo de conta. Exemplo: <account selector="type">GL</account> Neste exemplo, o tipo de elemento de conta corresponde a todas as contas LR. Atualmente, oferecemos suporte apenas para os tipos de conta "LR" e "PERSONALIZADA" para importações padrão. Todos os outros resultados de conteúdo contêm erro. O valor por padrão para o seletor é código.
Conteúdo do elemento
O código da conta, que diferencia maiúsculas de minúsculas, usada como parte do escopo de importação. Por exemplo, Contas a pagar. O código não pode ficar em branco e a conta correspondente ao código deve existir. A conta não pode ser uma conta do sistema ou vinculada. Se a conta é uma conta calculada, deve haver uma substituição de entrada de dados para essa conta, caso contrário, ela é considerada inválida. Se um código de conta é inválido, todo o elemento <accounts> e, por extensão, o <escopo> são considerados inválidos.

elemento de níveis
Nome da etiqueta		níveis Disponível somente na versão 36+ da API
Descrição		Especifica os códigos de nível para o escopo de importação. Se um código de nível é especificado aqui, mas não há dados para este nível nos dados de importação, os dados neste nível serão removidos para o intervalo de tempo e o restante das coordenadas do escopo. Permitido somente quando o atributo de modo do elemento importDataOptions é REPLACE.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
modo	S	Especifica o modo para o escopo do nível. Deve ser uma das três opções a seguir. EXPLÍCITO - Se esse modo é especificado, espera-se que um ou mais subelementos <level> determinem o escopo do nível para a importação. INPUT - Quando esse modo é especificado, o escopo do nível é determinado pelo conjunto exclusivo de níveis presentes nos dados de importação. ALL - quando esse modo é especificado, o escopo do nível inclui todos os níveis importáveis.	EXPLÍCITO
Conteúdo do elemento
Se o modo é INPUT ou ALL, não deve haver nenhum subelemento de <nível>. Se o modo é EXPLÍCITO, deve haver um ou mais subelementos <level>. Se o modo é EXPLÍCITO e qualquer código de nível em um subelemento <level> é inválido, todo o elemento <levels> e, por extensão, o <escopo>, são considerados inválidos. Uma mensagem de erro será incluída na resposta para cada código inválido.

elemento de nível
Nome da etiqueta		level Disponível somente na versão 36+ da API
Descrição		Especifica o código de nível a ser incluído no escopo da importação. Permitido somente quando o atributo de modo do elemento importDataOptions é REPLACE.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
includeDescendants	N	Se o nível é um nível pai, especificar esse atributo como verdadeiro incluirá todos os descendentes folha desse nível, incluindo ele mesmo (o Único nó) no escopo. Esse é um atributo opcional. Se o atributo não é fornecido, o valor por padrão é falso. Se o atributo não é fornecido ou é fornecido como falso e o nível especificado é um nível pai, isso significa que a importação considerará o nó Somente (exemplo Somente engenharia) desse nível para fins de escopo. Os filhos do nível não serão incluídos no escopo, a menos que especificado explicitamente por outros elementos de nível.	true
Conteúdo do elemento
Especifica o código do nível que diferencia maiúsculas de minúsculas. Por exemplo, <level>Desenvolvimento</level>. Se houver um problema com o código do nível, por exemplo, um nível em que o código não foi encontrado, todos os <níveis> e, por extensão, o <escopo> são considerados inválidos. Uma mensagem de erro será incluída na resposta para cada código inválido.

elemento de tempo
Nome da etiqueta		time Disponível somente na versão 36+ da API
Descrição		Especifica um ou mais intervalos de tempo que representam o escopo de tempo da importação. Permitido somente quando o atributo de modo do elemento importDataOptions é REPLACE.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
modo	S	Especifica o modo para o escopo de tempo. Deve ser uma das três opções a seguir. INPUT - Quando esse modo é especificado, o escopo de tempo é determinado pelos códigos de entrada de horas no <header> elemento. Se o cabeçalho contém dois meses, o escopo da importação será esses dois meses. EXPLÍCITO - Se esse modo é especificado, espera-se ver um ou mais subelementos timeRange que determinam o escopo de tempo para a importação. VERSÃO - Quando esse modo é especificado, o escopo de tempo será o início e o término da versão, incluindo qualquer período de saldo inicial. Se o modo é INPUT ou VERSION, nenhum subelemento timeRange é permitido. Se os subelementos timeRange estiverem presentes, isso será tratado como um erro.	INPUT
Conteúdo do elemento
Um ou mais elementos timeRange, a menos que o modo seja INPUT ou VERSION.

elemento timeRange
Nome da etiqueta		timeRange Disponível somente na versão 36+ da API
Descrição		Especifica um único intervalo de tempo para o escopo de tempo. Permitido somente quando o atributo de modo do elemento importDataOptions é REPLACE.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
início	S	O período inicial do intervalo de tempo de importação.	07/2021
fim	S	O período final para o intervalo de tempo de importação.	08/2021
Conteúdo do elemento
Um ou mais elementos timeRange, a menos que o modo seja INPUT ou VERSION.

rowData element
Nome da etiqueta		rowData
Descrição		Contêiner para as linhas de dados que estão sendo importadas.
Atributos do elemento
(nenhum)
Conteúdo do elemento
Exatamente umelemento de cabeçalho e exatamente umelemento de linhas.

elemento de cabeçalho
Nome da etiqueta		cabeçalho
Descrição		Especifica os nomes e a ordem das colunas dos dados na tabela correspondente.elemento de linhas.
Atributos do elemento
(nenhum)
Conteúdo do elemento
Uma linha de texto com nomes de colunas separadas por barras verticais. Esses nomes de coluna devem corresponder aos nomes das dimensões ou campos na planilha ou aos códigos de período que podem conter dados. Eles são idênticos aos nomes das colunas encontrados no modelo de importação da planilha para a qual os dados estão sendo importados, com cada cabeçalho de coluna separado do seguinte por uma barra vertical ou um símbolo de barra vertical. Para instâncias que habilitam o nome de exibição, o cabeçalho não oferece suporte "<dimension>" em combinação com "<dimension> Name" ou "<dimension> Code" na API v30 ou superior para parâmetros regionais com suporte no Adaptive Planning.

elemento de linhas
Nome da etiqueta		linhas
Descrição		Contêiner para um ou maiselementos de linha.
Atributos do elemento
(nenhum)
Conteúdo do elemento
Um ou maiselementos de linha.

elemento de linha
Nome da etiqueta		linha
Descrição		Dados de uma única linha sendo importados.
Atributos do elemento
(nenhum)
Conteúdo do elemento
Dados para os campos em uma única linha que estão sendo importados, com o valor de cada campo separado por uma barra vertical ou símbolo de barra vertical. Os campos de dados devem estar na mesma ordem que a linha no elemento de cabeçalho. Se os números nos valores usam separadores de milhar, presume-se que sejam os separadores de vírgula usados nos parâmetros regionais especificados nas credenciais da solicitação.

Formato da resposta

Estes são exemplos de respostas para importação bem-sucedida e malsucedida de dados de conta padrão.

Exemplo de êxito


<?xml version='1.0' encoding='UTF-8'?>
<response success="true"></response>

Falha (com contexto)


<?xml version='1.0' encoding='UTF-8'?>
<response success="false">
<messages>
<message key="error-empty-account">
    <context>
        <col header="Account" value="" />
        <col header="Level" value="Corporate Plan" />
        <col header="Split Label" value="" />
        <col header="Product" value="Bunnyrabbit Toy" />
        <col header="Region" value="Western-US" />
        <col header="11/2005" value="2037" />
        <col header="01/2006" value="4032" />

    </context>
Account cannot be empty on row 1.

</message>
</messages>
</response>

Falha (sem contexto)


<?xml version='1.0' encoding='UTF-8'?>
<response success="false">
<messages>
<message key="error-empty-account">Account cannot be empty on row 1.</message>

</messages>
</response>

elemento de resposta
Nome da etiqueta		resposta
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
êxito	S	Qualquer umverdadeiro oufalse, indicando se a chamada à API foi bem-sucedida ou não. Mesmo as chamadas bem-sucedidas podem conter mensagens de aviso na resposta.	true
Conteúdo do elemento
Um único opcionalelemento de mensagens.

elemento de mensagens
Nome da etiqueta		mensagens
Descrição		Contêiner para um ou maiselementos da mensagem
Atributos do elemento
(nenhum)
Conteúdo do elemento
Um ou maiselementos da mensagem

elemento de mensagem
Nome da etiqueta		mensagem
Descrição		Representa uma mensagem que está sendo enviada pelo sistema de volta para o autor da chamada. As mensagens são usadas para mensagens de erro quando as solicitações não são bem-sucedidas, para mensagens de aviso quando as solicitações são bem-sucedidas e para mensagens de confirmação quando as solicitações são bem-sucedidas.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
chave	N	Quando fornecida, uma chave é uma forma de identificar uma determinada mensagem ou tipo de mensagem, útil para fins de registro automatizado de erros e recuperação em programas cliente. As chaves não são alteradas em diferentes parâmetros regionais de solicitações, mesmo quando o idioma da mensagem é alterado. As chaves também não devem ser alteradas no futuro devido a ajustes de texto ou alterações de terminologia.	invalid-attributevalueid
Conteúdo do elemento
O texto da mensagem. Esse texto está no idioma dos parâmetros regionais especificados na solicitação (supondo que haja suporte para os parâmetros regionais). O texto também pode conter informações variáveis, como o número de linhas que foram processadas ou a coluna ou valor específico que causou um erro. Um elemento de contexto opcional.

elemento de contexto
Nome da etiqueta		context
Descrição		Contêiner para um ou mais elementos col.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
nenhum
Conteúdo do elemento
Um ou mais elementos col.

elemento col
Nome da etiqueta		col
Descrição		Representa o contexto da mensagem. Fornece um par cabeçalho/valor para que a linha que gera a mensagem possa ser identificada.
Atributos do elemento
Nome do atributo	Obrigatório?	Valor	Exemplo
cabeçalho	S	O cabeçalho da coluna.	"Account"
valor	S	O valor na coluna.	"GL-29482-38233"
Conteúdo do elemento
(nenhum)

importCubeData

importTransactions

Este conteúdo foi útil?

O que precisamos melhorar? Informações corretas Responde à minha pergunta Fácil de encontrar Fácil de entender Ajuda a concluir minha tarefa Informações completas e detalhadas

O que precisamos melhorar? Informações incorretas Não responde à minha pergunta Não é fácil de encontrar Não é fácil de entender Não ajuda a concluir minha tarefa Informações incompletas ou pouco detalhadas

Conte-nos sobre a tarefa que você está executando. Quais informações adicionais podem melhorar este conteúdo? Há mais algum detalhe que gostaria de compartilhar?

Nome completo

E-mail

A Workday usará seu nome e e-mail para fornecer respostas relacionadas ao seu feedback. Suas informações serão tratadas de acordo com a nossa Declaração de Privacidade.

Agradecemos seu feedback