Macro EmailWorksheet

A macro EmailWorksheet é usada para carregar a planilha com o contexto enviado (item, local e período) e envia a planilha ao usuário. Essa macro é executada no nível do cenário.

Os parâmetros de macro determinam o contexto e a planilha a serem enviados por e-mail. Essa tabela lista os parâmetros usados para executar a macro EmailWorksheet. Esta macro não oferece suporte às planilhas com vários painéis.


Parâmetro	Descrição
Tipo de exportação	O formato do arquivo em que a planilha deve ser enviada. Opções possíveis: PDF XLS
Nome da planilha	O nome da planilha a executar e enviar por e-mail.
Usuário	O destinatário de e-mail para a planilha. Nota: O usuário deve ter acesso à planilha.
Item transmitido	A seleção de item transmitido para a planilha. Esse valor pode ser um único elemento ou um conjunto de elementos. Nota: a definição de MDX é suportada pelo conjunto de elementos. Se esse valor não for especificado, a definição de planilha padrão (se for definida) será usada; caso contrário, será usado o nó superior da hierarquia padrão. É possível usar %itemcontext% se o contexto de dados do item atual for necessário (este parâmetro é aplicável somente quando o comando for executado em uma planilha).
Local transmitido	O local selecionado transmitido para a planilha. Esse valor pode ser um único elemento ou um conjunto de elementos. Nota: a definição de MDX é suportada pelo conjunto de elementos. Se esse valor não for especificado, a definição de planilha padrão (se for definida) será usada; caso contrário, será usado o nó superior da hierarquia padrão. É possível usar %locationcontext% se o contexto de dados do local atual for necessário (este parâmetro será aplicável somente quando o comando for executado em uma planilha).
Período transmitido	A seleção de período aprovada para a planilha. Esse valor pode ser um único elemento ou um conjunto de elementos. Nota: a definição de MDX é suportada pelo conjunto de elementos. Se esse valor não for especificado, a definição de planilha padrão (se for definida) será usada; caso contrário, será usado o nó superior da hierarquia padrão. É possível usar %periodcontext% se o contexto de dados do período atual for necessário (este parâmetro será aplicável somente quando o comando for executado em uma planilha).

O valor do campo Comando deve ser especificado no seguinte formato:EmailWorksheet (Tipo de exportação, Nome da planilha, Usuário, [Item transmitido], [Local transmitido], [Período transmitido]).

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

Tabela 1. Exemplo
Requisito	Parâmetros
Executa a planilha de Análise da margem de demanda com seleção de item, local e período padrão da definição da planilha e envia o resultado em PDF por e-mail ao usuário “Scott”.	EmailWorksheet(“PDF”,“Análise de margem de demanda”,“Scott”). EmailWorksheet(“PDF”,“Análise de margem de demanda”,“Scott”,“”,“”,“”).
Executa a planilha de Princípios básicos da demanda com seleção de item, local e período padrão da definição da planilha e envia o resultado em XLS por e-mail ao usuário “Harry”.	EmailWorksheet(“XLS”,“Princípios básicos da demanda”,“Harry”,“”,“”,“”).
Executa a planilha Análise da precisão da previsão com nó de item Marca A, seleção de local padrão e nó de período Semanas em andamento e envia o resultado em PDF por e-mail ao usuário “Harry”.	EmailWorksheet(“PDF”,“Análise de precisão da previsão”,“Harry”,“Marca A”,“”,“Semanas em andamento”).

Validação e Execução

Na validação e execução bem-sucedidas da macro, a planilha é carregada com o item, o local e o período selecionados e enviados por e-mail ao usuário especificado. Estas são as regras de validação:

Se os parâmetros de macro forem Nulo, o valor padrão especificado na planilha para seleção de item, local e período será usado.
Se os parâmetros de macro e os parâmetros padrão da planilha para item, local e período forem Nulo, serão usadas as seleções de nó superior de item, local e período.

Mensagens de validação e de erro

Esta tabela lista o status do Período de ciclo e do cenário 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
Pausado	Qualquer	Não	Não é possível executar a macro {0} porque o status do Período de ciclo é “Pausado”
Concluído	Qualquer	Sim	N/D
Anulado	Qualquer	Sim	N/D
Arquivado	Qualquer	Não	Não é possível executar a macro {0} porque o status do Período de ciclo é “Arquivado”

A validação é realizada quando você executa a macro EmailWorksheet. 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 de validação	Mensagem de erro
Certifique-se de que a planilha seja válida para o usuário e o módulo atuais.	a planilha {0} não está habilitada para o módulo {1} ou usuário {2}.
Só há suporte para a adição de uma captura de tela de planilha nas planilhas padrão. As planilhas de vários painéis ainda não têm suporte.	Valor de parâmetro {0} inválido. A planilha não é do Tipo = Padrão.
Certifique-se de que o tipo de exportação corresponde aos formatos disponíveis.	Valor de parâmetro {0} inválido. O tipo de exportação deve ser PDF ou XLS.
Verifique se o usuário especificado é válido e tem um endereço de e-mail válido.	não é possível localizar o usuário {0}.
Verifique se o usuário especificado tem direitos de acesso à planilha necessária.	O usuário {0} não tem direitos de acesso à planilha {1}
Se forem especificados, certifique-se de que os nós de itens sejam válidos.	não é possível localizar o item {0}.
Se forem especificados, certifique-se de que os nós de local sejam válidos.	não é possível localizar o local {0}.
Se forem especificados, certifique-se de que os nós de período sejam válidos.	Não é possível localizar a etiqueta de período {0}.
Se forem especificados, certifique-se de que os valores dos nós de itens podem ser avaliados. Para alguns casos, o parâmetro da planilha rv_item_passed não pode ser usado para inicializar o parâmetro de macro.	Não é possível avaliar o item transmitido. Definir uma seleção alternativa.
Se forem especificados, certifique-se de que os valores dos nós de local possam ser avaliados. Para alguns casos, o parâmetro da planilha rv_location_passed não pode ser usado para inicializar o parâmetro de macro.	Não é possível avaliar o local transmitido. Definir uma seleção alternativa.
Se forem especificados, certifique-se de que os valores especificados para os nós de período possam ser avaliados. Para alguns casos, o parâmetro da planilha rv_period_passed não pode ser usado para inicializar o parâmetro de macro.	Não é possível avaliar o período transmitido. Definir uma seleção alternativa.