Macro EmailWorksheet

La macro EmailWorksheet se utiliza para cargar la hoja de trabajo con contexto pasado (artículo, ubicación y período) y enviar la hoja de trabajo por correo electrónico al usuario. Esta macro se ejecuta en el nivel de escenario.

Los parámetros de la macro determinan el contexto y la hoja de trabajo que se va a enviar por correo electrónico. En esta tabla se muestran los parámetros utilizados para ejecutar la macro EmailWorksheet. Las hojas de trabajo multipanel no se admiten en esta macro.


Parámetro	Descripción
Tipo de exportación	El formato del archivo en el que se va a enviar la hoja de trabajo. Posibles opciones: PDF XLS
Nombre de hoja de trabajo	El nombre de la hoja de trabajo para ejecutar y enviar por correo electrónico.
Usuario	El destinatario de correo electrónico de la hoja de trabajo. Nota: El usuario debe tener acceso a la hoja de trabajo.
Artículos pasados	La selección de artículos pasados a la hoja de trabajo. Este valor puede ser un elemento único o un conjunto de elementos. Nota: La definición de MDX se admite para el conjunto de elementos. Si no se especifica este valor, se utiliza la definición de hoja de trabajo predeterminada (si está definida); de lo contrario, se utiliza el nodo superior de la jerarquía predeterminada. Puede utilizar %itemcontext% si se necesita el contexto de datos de artículo actual (este parámetro solo se aplica cuando se ejecuta el comando dentro de una hoja de trabajo).
Ubicación pasada	La selección de ubicaciones pasadas a la hoja de trabajo. Este valor puede ser un elemento único o un conjunto de elementos. Nota: La definición de MDX se admite para el conjunto de elementos. Si no se especifica este valor, se utiliza la definición de hoja de trabajo predeterminada (si está definida); de lo contrario, se utiliza el nodo superior de la jerarquía predeterminada. Puede utilizar %locationcontext% si se necesita el contexto de datos de ubicación actual (este parámetro solo se aplica cuando se ejecuta el comando dentro de una hoja de trabajo).
Período pasado	La selección de períodos pasados a la hoja de trabajo. Este valor puede ser un elemento único o un conjunto de elementos. Nota: La definición de MDX se admite para el conjunto de elementos. Si no se especifica este valor, se utiliza la definición de hoja de trabajo predeterminada (si está definida); de lo contrario, se utiliza el nodo superior de la jerarquía predeterminada. Puede utilizar %periodcontext% si se necesita el contexto de datos de período actual (este parámetro solo se aplica cuando se ejecuta el comando dentro de una hoja de trabajo).

Se debe especificar el valor para el campo Comando en el siguiente formato:EmailWorksheet (Tipo de exportación, Nombre de hoja de trabajo, Usuario, [Artículo pasado], [Ubicación pasada], [Período pasado]).

Nota: Los parámetros opcionales se especifican en [ ].

Tabla 1. Ejemplo
Requisito	Parámetros
Ejecutar hoja de trabajo Análisis de márgenes de la demanda con selección de artículo, ubicación y período predeterminados de la definición de hoja de trabajo y enviar la salida en PDF por correo electrónico al usuario "Scott".	EmailWorksheet("PDF","Análisis de márgenes de demanda","Scott"). EmailWorksheet("PDF","Análisis de márgenes de demanda","Scott","","","").
Ejecutar la hoja de trabajo Datos esenciales de la demanda con selección de artículo, ubicación y período predeterminados de definición de hoja de trabajo y enviar la salida en XLS por correo electrónico al usuario al usuario "Harry".	EmailWorksheet("XLS","Datos esenciales de la demanda","Harry","","","").
Ejecutar la hoja de trabajo Análisis de exactitud de previsión con nodo de artículo de marca A, selección de ubicación predeterminada y nodo de período de semanas de traslado y enviar la salida en PDF por correo electrónico al usuario "Harry".	EmailWorksheet("PDF","Análisis de exactitud de previsión","Harry","Marca a","","Semanas de traslado").

Validación y ejecución

Tras la validación y ejecución correctas de la macro, la hoja de trabajo se carga con el artículo, la ubicación y el período seleccionados por correo electrónico al usuario especificado. Estas son las reglas de validación:

Si los parámetros de macro son nulos, se utiliza el valor predeterminado especificado en la hoja de trabajo para las selecciones de artículo, ubicación y período.
Si los parámetros de macro y los parámetros predeterminados de hoja de trabajo para artículo, ubicación y período son nulos, se utilizan las selecciones de nodo superior de artículo, ubicación y período.

Mensajes de validación y error

En esta tabla se muestran el período de ciclo y el estado de escenario, así como los mensajes de validación relacionados:


Estado del período de ciclo	Estado del escenario	¿Se puede ejecutar?	Mensaje de validación
Pendiente	N/A	No	No se puede ejecutar la macro {0} porque el período del ciclo tiene el estado "Pendiente".
En ejecución	Cualquiera	Sí	N/A
Parado	Cualquiera	No	No se puede ejecutar la macro {0} porque el período de ciclo tiene el estado "Parado".
Completado	Cualquiera	Sí	N/A
Anulado	Cualquiera	Sí	N/A
Archivado	Cualquiera	No	No se puede ejecutar la macro {0} porque el período del ciclo tiene el estado "Archivado".

La validación se realiza al ejecutar la macro EmailWorksheet. Si la validación falla, se anula la macro y se muestra el mensaje de error relacionado. En esta tabla se muestran los mensajes de error para diversos errores de validación:


Condición de validación	Mensaje de error
Asegúrese de que la hoja de trabajo sea válida para el usuario y módulo actuales.	La hoja de trabajo {0} no está habilitada para el módulo {1} o usuario {2}.
La adición de una captura de pantalla de hoja de trabajo solo se admite para hojas de trabajo estándar. Aún no se admiten las hojas de trabajo multipanel.	Valor de parámetro {0} no válido. La hoja de trabajo no es del tipo = Estándar.
Asegúrese de que el tipo de exportación se corresponda con los formatos disponibles.	Valor de parámetro {0} no válido. El tipo de exportación debe ser PDF o XLS.
Asegúrese de que el usuario especificado sea válido y que tenga una dirección de correo electrónico válida.	No se encuentra el usuario {0}.
Asegúrese de que el usuario especificado tenga derechos de acceso a la hoja de trabajo requerida.	El usuario {0} no tiene permiso de acceso a la hoja de trabajo {1}.
Si se especifica, asegúrese de que los nodos de artículo sean válidos.	no se encuentra el artículo {0}.
Si se especifica, asegúrese de que los nodos de ubicación sean válidos.	no se encuentra la ubicación {0}.
Si se especifica, asegúrese de que los nodos de ubicación sean válidos.	No se encuentra la etiqueta de período {0}.
Si se especifica, asegúrese de que se puedan evaluar los valores de los nodos de artículo. En algunos casos, el parámetro de la hoja de trabajo rv_item_passed no se puede utilizar para inicializar el parámetro de macro.	No se puede evaluar el artículo pasado. Defina una selección alternativa.
Si se especifica, asegúrese de que se puedan evaluar los valores de los nodos de ubicación. Para algunos casos, el parámetro de la hoja de trabajo rv_location_passed no se puede utilizar para inicializar el parámetro de macro.	La ubicación pasada no se puede evaluar. Defina una selección alternativa.
Si se especifica, asegúrese de que se puedan evaluar los valores especificados para los nodos de período. Para algunos casos, el parámetro de la hoja de trabajo rv_period_passed no se puede utilizar para inicializar el parámetro de macro.	El período pasado no se puede evaluar. Defina una selección alternativa.