RunInterfaceService (Exportar) no nível do período de ciclo

A macro RunInterfaceService (Exportar) é usada para executar um serviço de interface que exporta dados de calendário no contexto de um período de ciclo. Essa macro é executada no nível de período de ciclo.

Essa tabela lista os parâmetros usados para executar a macro RunInterfaceService (Exportar):


Parâmetro	Descrição
Nome do serviço de interface	O nome do serviço de interface executado.
Direção	A direção do fluxo de dados. Nota: Este valor é definido como “Exportar” quando a macro é criada.
Tipo de calendário	O período para o qual os dados são exportados. Possíveis valores: Bucket: o período especificado em “Rótulo de período” e usa os parâmetros [Rótulo de período], [Número de períodos] e [Nível do horizonte]. Bucket atual: o período de planejamento atual e usa somente [Número de períodos] e [Nível de horizonte]. Bucket inicial: O primeiro período (mais antigo) no horizonte do período de ciclo e pode ser usado para recuperar todos os buckets. [Números de períodos] e [Nível do horizonte] são usados. Nota: Se o valor não for especificado, o período de Bucket inicial será considerado.
Etiqueta de período	O período inicial para exportar os dados. Isso oferece suporte aos nós de período em andamento. Nota: Esse campo é aplicável somente quando Tipo de calendário está definido como Bucket. Se o valor não for especificado, o período de planejamento atual será considerado.
Número de períodos	O número de períodos de nível de horizonte a serem exportados. Se o nível do horizonte não for igual ao Nível de calendário para armazenar planos ou se a opção Telescópico estiver ativada, todos os buckets base dentro do intervalo especificado de períodos selecionados serão exportados. Possíveis valores: Nulo: todos os períodos base até o fim do horizonte de período de ciclo são exportados. 0: todos os buckets base que pertencem ao período especificado na Etiqueta de período são exportados se Tipo de calendário for definido como “Bucket”. >=1: todos os períodos base que pertencem a [Número de períodos] de buckets de Nível do horizonte, começando no Período inicial especificado são exportados.
Nível do horizonte	O nível de horizonte de calendário a ser usado por [Número de períodos] para exportação. Nota: Se esse valor não for especificado, o número de períodos será baseado no nível de calendário para armazenar valores de cenário.

O valor do campo Comando deve ser especificado neste formato: RunInterfaceService (Nome do serviço de interface, Direção, [Tipo de calendário], [Rótulo do período], [Número de períodos], [Nível do horizonte]).

Nota: Os Parâmetros opcionais são especificados em [ ].

Tabela 1. Exemplo
Requisito	Parâmetro
Exporte períodos de calendário base do período de planejamento atual para o horizonte do período de ciclo no nível do calendário para armazenar valores de cenário (nenhum período telescópico definido).	RunInterfaceService(“Meu calendário AP”,“Exportar”,“Bucket atual”,“”)
Exporte períodos de calendário base começando do período de planejamento atual correspondente a 6 buckets no nível do calendário para armazenar valores de cenário.	RunInterfaceService(“Meu calendário AP”,“Exportar”,“Bucket atual”,“6”)
Exporte períodos de calendário base do período AF14 M12 correspondente a 10 períodos no nível do calendário para armazenar valores de cenário.	RunInterfaceService(“Meu calendário AP”,“Exportar”,“Bucket”,“AF14 M12”,“10”)
Exporte períodos de calendário base, a partir do período AF14 M12 correspondente a 10 meses.	RunInterfaceService(“Meu calendário AP”,“Exportar”,“Bucket”,“AF14 M12”,“10”,“Meses”)
Exporte 1 mês de telescópico, buckets base dos dados do calendário do período de planejamento atual. Por exemplo, “AF14 M12”, em que a opção Telescópica está ativada para o ciclo. Nível do calendário de ciclo para armazenar planos = Semanas, períodos telescópicos para ciclo = 7 dias, com horizonte futuro = 8 semanas. O resultado é 1 mês de telescópico, buckets base, ou seja, 7 buckets diários, 3 buckets semanais.	RunInterfaceService(“Exportar arquivo do Cenário”,“Exportar”,“Bucket atual”,“1”,“Meses”).

Mensagens de validação e de erro

Esta tabela lista o status do Período de ciclo e as mensagens de validação relacionadas:


Status do período de ciclo	Status do cenário	Pode executar?	Mensagem de validação
Pendente	N/D	Não	Não é possível executar a macro {0} porque o status do Período de ciclo é “Pendente”.
Em execução	Qualquer	Sim	N/D
Concluído	Qualquer	Sim	N/D
Anulado	Qualquer	Sim	N/D
Pausado	Qualquer	Sim	N/D
Arquivado	Qualquer	Não	Não é possível executar a macro {0} porque o Período de ciclo tem o status “Arquivado"

Os dados de calendário são exportados no contexto do período de ciclo especificado na validação e execução bem-sucedida da macro. Se a validação falhar, a macro será anulada e a mensagem de erro relacionada será exibida. Esta tabela lista as mensagens de erro exibidas para várias falhas de validação:


Condição/Regras de validação	Mensagem de erro
Verifique se o serviço de interface passado é válido.	Não é possível localizar o serviço de interface "{0}"
Se a Direção não corresponder à Direção da interface do Serviço de Interface selecionado, a macro não será executada.	O parâmetro de direção {0} não corresponde à direção do Serviço de Interface selecionado “{1}”.
Se o nível de calendário não for maior ou igual ao nível de Calendário para armazenar valores de cenário, uma mensagem de aviso será exibida e o processo de Importação será anulado.	O Nível de calendário {0} está abaixo do Nível de calendário {1} para armazenar valores de cenário.
RunInterfaceService no contexto do período de ciclo deve ser de um período de ciclo com o status Em execução, Pausado, Concluído e Anulado.	Não é possível executar RunInterfaceService para um período de ciclo com o status {0}.
Se a entidade de dados de Serviço de interface selecionada não for aplicável ao contexto da macro atual, a macro não será executada, ou seja, RunInterfaceService só poderá executar interfaces de entidade de dados = calendário em um contexto de período de ciclo.	O serviço de interface {0} não corresponde à entidade de dados necessária para uma macro de período de ciclo.
Ao executar RunInterfaceService em um contexto de período de ciclo, o serviço de interface selecionado deve fazer referência a um calendário que corresponde ao calendário do período de ciclo atual. Caso contrário, a macro não será executada.	O calendário referido no Serviço da interface {0} não corresponde ao calendário do período de ciclo atual.
Ao executar RunInterfaceService para exportação, verifique se o nível de horizonte, se especificado, é válido.	Não é possível localizar o Nível de horizonte {0}.
Ao executar RunInterfaceService para exportação, verifique se o nível de horizonte, se especificado, está no ou acima do Nível de calendário para armazenar planos (se a opção Telescópico não estiver ativada).	O Nível de horizonte {0} está abaixo do Nível de calendário {1} para armazenar valores de cenário