Makro EmailWorksheet

Das Makro EmailWorksheet wird verwendet, um das Arbeitsblatt mit weitergegebenem Kontext (Artikel, Ort und Periode) zu laden und das Arbeitsblatt an den Benutzer zu schicken. Dieses Makro wird auf Szenarienebene ausgeführt.

Die Makroparameter bestimmen den Kontext und das Arbeitsblatt, das per E-Mail gesendet werden soll. Die folgende Tabelle enthält die Parameter, die zum Ausführen des Makros EmailWorksheet verwendet werden: Arbeitsblätter mit mehreren Bereichen werden in diesem Makro nicht unterstützt.


Parameter	Beschreibung
Exporttyp	Das Dateiformat, in dem das Arbeitsblatt gesendet werden soll. Mögliche Optionen: PDF XLS
Arbeitsblattname	Der Name des Arbeitsblatts, das ausgeführt und per E-Mail gesendet werden soll.
Benutzer	Der E-Mail-Empfänger für das Arbeitsblatt. Hinweis: Der Benutzer muss Zugriff auf das Arbeitsblatt haben.
Artikel weitergegeben	Die Artikelauswahl, die an das Arbeitsblatt weitergegeben wurde. Bei diesem Wert kann es sich um ein einzelnes Element oder einen Satz von Elementen handeln. Hinweis: MDX-Definition wird für Sätze von Elementen unterstützt. Wenn dieser Wert nicht angegeben ist, wird die Standardarbeitsblattdefinition (falls definiert) verwendet, anderenfalls wird der oberste Knoten der Standardhierarchie verwendet. Sie können %itemcontext% verwenden, wenn der aktuelle Artikeldatenkontext erforderlich ist (dieser Parameter ist nur anwendbar, wenn der Befehl innerhalb eines Arbeitsblatts ausgeführt wird).
Orte weitergegeben	Die Ortsauswahl, die an das Arbeitsblatt weitergegeben wurde. Bei diesem Wert kann es sich um ein einzelnes Element oder einen Satz von Elementen handeln. Hinweis: MDX-Definition wird für Sätze von Elementen unterstützt. Wenn dieser Wert nicht angegeben ist, wird die Standardarbeitsblattdefinition (falls definiert) verwendet, anderenfalls wird der oberste Knoten der Standardhierarchie verwendet. Sie können %locationcontext% verwenden, wenn der aktuelle Ortsdatenkontext erforderlich ist (dieser Parameter ist nur anwendbar, wenn der Befehl innerhalb eines Arbeitsblatts ausgeführt wird).
Perioden weitergegeben	Die Periodenauswahl, die an das Arbeitsblatt weitergegeben wurde. Bei diesem Wert kann es sich um ein einzelnes Element oder einen Satz von Elementen handeln. Hinweis: MDX-Definition wird für Sätze von Elementen unterstützt. Wenn dieser Wert nicht angegeben ist, wird die Standardarbeitsblattdefinition (falls definiert) verwendet, anderenfalls wird der oberste Knoten der Standardhierarchie verwendet. Sie können %periodcontext% verwenden, wenn der aktuelle Periodendatenkontext erforderlich ist (dieser Parameter ist nur anwendbar, wenn der Befehl innerhalb eines Arbeitsblatts ausgeführt wird).

Der Wert für das Feld Befehl muss im folgenden Format angegeben werden: EmailWorksheet (Exporttyp, Arbeitsblattname, Benutzer, [Weitergegebener Artikel], [Weitergegebener Ort], [Weitergegebene Periode]).

Hinweis: Die optionalen Parameter werden in eckigen Klammern [ ] angegeben.

Tabelle 1. Beispiel
Anforderung	Parameter
Arbeitsblatt "Bedarf - Margenanalyse" mit Standardartikel-, Orts- und Periodenauswahl aus der Arbeitsblattdefinition ausführen und PDF-Ausgabe per E-Mail an Benutzer Andreas schicken.	EmailWorksheet("PDF","Bedarf - Margenanalyse","Andreas"). EmailWorksheet("PDF","Bedarf - Margenanalyse","Andreas","","","").
Arbeitsblatt "Bedarf - Grundlagen" mit Standardartikel-, Orts- und Periodenauswahl aus der Arbeitsblattdefinition ausführen und XLS-Ausgabe per E-Mail an Benutzer Jan schicken.	EmailWorksheet("XLS","Bedarf - Grundlagen","Jan","","","").
Arbeitsblatt "Prognosegenauigkeit - Analyse" mit Artikelknoten "Marke A", Standardortsauswahl und Periodenknoten "Rollierende Wochen" ausführen und PDF-Ausgabe an Benutzer Jan schicken.	EmailWorksheet("PDF","Prognosegenauigkeit - Analyse","Jan","Marke A","","Rollierende Wochen").

Validierung und Ausführung

Nach erfolgreicher Validierung und Ausführung des Makros wird das Arbeitsblatt mit dem ausgewählten Element, dem ausgewählten Ort und der ausgewählten Periode geladen und an den angegebenen Benutzer geschickt. Es gibt die folgenden Validierungsregeln:

Wenn die Makroparameter null lauten, wird der im Arbeitsblatt für Artikel-, Ort- und Periodenauswahl angegebene Standardwert verwendet.
Wenn die Makroparameter und die Standardparameter des Arbeitsblatts für Artikel, Ort und Periode null sind, werden die obersten Knotenauswahlen für Artikel, Ort und Periode verwendet.

Validierungs- und Fehlermeldungen

Die folgende Tabelle listet den Status der Zyklusperiode und des Szenarios sowie die damit verbundenen Validierungsmeldungen auf:


Zyklusperiode - Status	Szenario - Status	Ausführen möglich?	Validierungsmeldung
Ausstehend	---	Nein	Makro {0} kann nicht ausgeführt werden, da die Zyklusperiode den Status "Ausstehend" hat.
Wird ausgeführt	Beliebig	Ja	---
Angehalten	Beliebig	Nein	Makro {0} kann nicht ausgeführt werden, da die Zyklusperiode den Status "Angehalten" hat.
Abgeschlossen	Beliebig	Ja	---
Abgebrochen	Beliebig	Ja	---
Archiviert	Beliebig	Nein	Makro {0} kann nicht ausgeführt werden, da die Zyklusperiode den Status "Archiviert" hat.

Die Validierung erfolgt, wenn Sie das Makro EmailWorksheet ausführen. Wenn die Validierung fehlschlägt, wird das Makro abgebrochen und die entsprechende Fehlermeldung angezeigt. Die folgende Tabelle enthält die Fehlermeldungen, die für die verschiedenen Validierungsfehler angezeigt werden:


Validierungsbedingung	Fehlermeldung
Stellen Sie sicher, dass das Arbeitsblatt für den aktuellen Benutzer und das aktuelle Modul gültig ist.	Arbeitsblatt {0} ist für Modul {1} oder Benutzer {2} nicht aktiviert.
Das Hinzufügen einer Arbeitsblatt-Bildschirmerfassung wird nur für Standardarbeitsblätter unterstützt. Arbeitsblätter mit mehreren Bereichen werden noch nicht unterstützt.	Ungültiger Parameterwert {0}. Arbeitsblatt ist nicht vom Typ "Standard".
Stellen Sie sicher, dass der Exporttyp den verfügbaren Formaten entspricht.	Ungültiger Parameterwert {0}. Exporttyp muss PDF oder XLS sein.
Stellen Sie sicher, dass der angegebene Benutzer gültig ist und eine gültige E-Mail-Adresse hat.	Benutzer {0} wurde nicht gefunden.
Stellen Sie sicher, dass der angegebene Benutzer Zugriffsrechte auf das erforderliche Arbeitsblatt hat.	Benutzer {0} hat keine Zugriffsrechte auf Arbeitsblatt {1}.
Falls angegeben, stellen Sie sicher, dass die Artikelknoten gültig sind.	Element {0} wurde nicht gefunden.
Stellen Sie bei Bedarf sicher, dass Ortsknoten gültig sind.	Ort {0} wurde nicht gefunden.
Stellen Sie bei Bedarf sicher, dass Periodenknoten gültig sind.	Periodenbezeichnung "{0}" wurde nicht gefunden.
Falls angegeben, stellen Sie sicher, dass die Werte für Artikelknoten ausgewertet werden können. In manchen Fällen kann der Arbeitsblattparameter rv_item_passed nicht zur Initialisierung des Makroparameters verwendet werden.	Weitergegebener Artikel kann nicht ausgewertet werden. Definieren Sie eine alternative Auswahl.
Falls angegeben, stellen Sie sicher, dass die Werte für Ortsknoten ausgewertet werden können. In manchen Fällen kann der Arbeitsblattparameter rv_location_passed nicht zur Initialisierung des Makroparameters verwendet werden.	Weitergegebener Ort kann nicht ausgewertet werden. Definieren Sie eine alternative Auswahl.
Falls angegeben, stellen Sie sicher, dass die für Periodenknoten angegebenen Werte ausgewertet werden können. In manchen Fällen kann der Arbeitsblattparameter rv_period_passed nicht zur Initialisierung des Makroparameters verwendet werden.	Die weitergegebene Periode kann nicht ausgewertet werden. Definieren Sie eine alternative Auswahl.