Definir serviços de interface

Selecione > > .

Clique em Novo.

Na janela Novo serviço de interface, especifique as seguintes informações:

Tipo de interface

Selecione o tipo de interface. Estas são as opções:

Advanced Planning
CSV
Banco de dados
EXCEL

Entidade de dados

Selecione a entidade de dados que deve ser mapeada para a interface. Os tipos de entidades de dados:

Calendário
Lista de códigos
Visualização do cenário
Nota: Se você selecionar essa opção, deverá especificar o Comportamento de importação.
Dados transacionais

Direção da interface

Com base nas suas seleções anteriores, especifique Exportar, Importar ou Importar ou exportar, conforme necessário.

Coluna por medida

Se essa caixa de seleção for selecionada, cada medida será exibida em uma nova coluna na interface. É possível adicionar novas linhas e medidas com essas dimensões na guia Mapeamentos:

Item
Local
Período do calendário

Se essa caixa de seleção estiver desmarcada, a lista de dimensões na guia Mapeamentos será fixada em cinco colunas com estas dimensões:

Item
Local
Período do calendário
Medida
Valor

Nota: É possível visualizar esse campo apenas se a Entidade de dados estiver definida para Valor de cenário para todos os tipos de interface.

Clique em OK. A lista é substituída por um formulário de detalhes, no qual os valores dos campos Tipo de interface e Entidade de dados são baseados na sua seleção.

Conforme a entidade de dados selecionada, especifique estas informações:

Módulo: O módulo ao qual o serviço de interface está vinculado. Selecione o módulo adequado.
Lista de códigos de destino: O nome da origem de dados usada como parte do serviço de interface.

Especifique as seguintes informações:

Nome: Especifique o nome do serviço de interface de interpolação.
Nome de exibição: Especifique o nome a ser exibido no aplicativo. Esse é um campo opcional.
Sistema: É um campo somente leitura.
Origem de dados: O nome da origem de dados usada como parte do serviço de interface.

Conforme o tipo de interface selecionado, especifique as informações necessárias:

Se você selecionar CSV:

Opção	Descrição
Arquivos	O nome do arquivo CSV usado como parte do serviço de interface.
Nomes do campo na linha de cabeçalho	Selecione esta caixa de seleção para indicar um dos seguintes: A primeira linha do arquivo importar contém etiquetas de campo e pode ser ignorada. A primeira linha do arquivo exportar deve conter cabeçalhos de campo.
Definição de período de calendário	Indica se os períodos de calendário são exportados usando a data inicial do período, a data final do período ou o nome do período definido no formato de calendário, por exemplo, AF10 M03.

Opção

Descrição

Arquivos

O nome do arquivo CSV usado como parte do serviço de interface.

Nomes do campo na linha de cabeçalho

Selecione esta caixa de seleção para indicar um dos seguintes:

A primeira linha do arquivo importar contém etiquetas de campo e pode ser ignorada.
A primeira linha do arquivo exportar deve conter cabeçalhos de campo.

Definição de período de calendário

Indica se os períodos de calendário são exportados usando a data inicial do período, a data final do período ou o nome do período definido no formato de calendário, por exemplo, AF10 M03.

Se você selecionar Banco de dados e, para a Origem, usar a seleção de Tabela padrão, especifique as seguintes informações:

Opção Descrição

Tabelas O nome da tabela usada como parte do serviço de interface.

Filtro de importação

Opção	Descrição
Tabelas	O nome da tabela usada como parte do serviço de interface.
Filtro de importação	Especifique um filtro nos dados enviados usando o serviço de interface, caso contrário, todos os registros da tabela de origem selecionados serão aplicáveis. O texto deve ter o formato de uma cláusula WHERE SQL padrão, embora a palavra-chave WHERE esteja implícita. Para filtrar os dados usando dimensões, você pode também usar estas variáveis: `%cycle%`: nome do ciclo `%cycleperiod%`: etiqueta do período de ciclo `%cycleperiod-Startdate%`: a data inicial do intervalo de período do ciclo atual (em Cycle.Periodicity) no formato de data necessário. Essa não é a data de início do período de ciclo. `%cycleperiod-Enddate%`: a data final do intervalo de período do ciclo atual (em Cycle.Periodicity) no formato de data necessário. Essa não é a data em que o período de ciclo foi concluído nem o fim do horizonte do período de ciclo. `%horizon-start%`: a data inicial do horizonte do período de ciclo no formato de data necessário. Esse é o primeiro período de base (mais antigo) dentro do período do ciclo atual. `%horizon-end%`: a data final do horizonte do período de ciclo no formato de data necessário. Esse é o último período de base (mais novo) dentro do período do ciclo atual. `%scenario%`: nome do cenário Exemplos: `CHAN_ID <> 'TOTAL' AND End_date > %CyclePeriod-StartDate%` ou `PROD_GROUP = %scenario% AND PERIOD >= %horizon-start% AND PERIOD <= %horizon-end%`

Especifique um filtro nos dados enviados usando o serviço de interface, caso contrário, todos os registros da tabela de origem selecionados serão aplicáveis. O texto deve ter o formato de uma cláusula WHERE SQL padrão, embora a palavra-chave WHERE esteja implícita.

Para filtrar os dados usando dimensões, você pode também usar estas variáveis:

%cycle%: nome do ciclo
%cycleperiod%: etiqueta do período de ciclo
%cycleperiod-Startdate%: a data inicial do intervalo de período do ciclo atual (em Cycle.Periodicity) no formato de data necessário. Essa não é a data de início do período de ciclo.
%cycleperiod-Enddate%: a data final do intervalo de período do ciclo atual (em Cycle.Periodicity) no formato de data necessário. Essa não é a data em que o período de ciclo foi concluído nem o fim do horizonte do período de ciclo.
%horizon-start%: a data inicial do horizonte do período de ciclo no formato de data necessário. Esse é o primeiro período de base (mais antigo) dentro do período do ciclo atual.
%horizon-end%: a data final do horizonte do período de ciclo no formato de data necessário. Esse é o último período de base (mais novo) dentro do período do ciclo atual.
%scenario%: nome do cenário

Exemplos:

CHAN_ID <> 'TOTAL' AND End_date > %CyclePeriod-StartDate% ou PROD_GROUP = %scenario% AND PERIOD >= %horizon-start% AND PERIOD <= %horizon-end%

Se você selecionar > > :

Opção	Descrição
Consulta	Especifique uma instrução SQL e clique em Verificar para validar o texto de consulta. Nota: Se a consulta for validada com sucesso, os campos retornados serão armazenados para uso nas guias Mapeamentos e Medidas de importação/exportação, que permitem selecionar os campos para mapeamento. Caso contrário, é preciso adicionar manualmente os campos na origem de dados para essa interface.

Para qualquer um dos tipos de interface:

Definição de período de calendário: Indica se os períodos de calendário são exportados usando a data inicial do período, a data final do período ou o nome do período definido no formato de calendário, por exemplo, AF10 M03.

Marque a caixa de seleção Limpar valores de cenário inalterados para redefinir os valores de cenário que não são modificados depois de importar os dados com base no filtro de medida.

Nota: Se esse filtro de medida for especificado, todos os valores inalterados para medidas no filtro serão redefinidos. Se não for especificado, todos os valores inalterados para medidas que são atualizados durante a importação serão redefinidos.

A guia Mapeamentos contém uma lista das dimensões a mapear e das definições do módulo, se aplicável. Nesta guia, altere as etiquetas de campo relacionadas conforme necessário.

A guia Medidas de importação/exportação contém uma lista de medidas (linhas) que atuam como origem ou destino da transferência e o identificador correspondente no serviço de interface. Nessa guia, clique em Novo para inserir medidas que atuem como filtro para o serviço de interface, importando e exportando somente as medidas definidas aqui.

Para o tipo de interface Banco de dados, a guia Constantes de exportação adicional lista os dados de constantes aplicáveis a serem exportados. Nesta guia, altere as etiquetas de campo relacionadas e valores, conforme necessário. As constantes de exportação especificadas nesta guia podem ser usadas para exportar vários cenários com uma única definição de interface usando as variáveis de Filtro de importação. Por exemplo, se a constante de exportação usar a variável %scenario%, esta variável poderá usar uma única definição de interface para exportar vários cenários.

Para filtrar os dados usando dimensões, também é possível usar estas variáveis:

%cycle%: nome do ciclo
%cycleperiod%: etiqueta do período de ciclo
%cycleperiod-Startdate%: a data inicial do intervalo de período do ciclo atual (em Cycle.Periodicity) no formato de data necessário. Essa não é a data em que o período de ciclo iniciou.
%cycleperiod-Enddate%: a data final do intervalo de período do ciclo atual (em Cycle.Periodicity) no formato de data necessário. Essa não é a data em que o período de ciclo foi concluído nem o fim do horizonte do período de ciclo.
%horizon-start%: a data inicial do horizonte do período de ciclo no formato de data necessário. Esse é o primeiro período de base (mais antigo) dentro do período do ciclo atual.
%horizon-end%: a data final do horizonte do período de ciclo no formato de data necessário. Esse é o último período de base (mais novo) dentro do período do ciclo atual.
%scenario%: Nome do cenário

Clique em Enviar.