EmailWorksheet マクロ

EmailWorksheet マクロは、渡されたコンテキスト (品目、場所、期間) を持つワークシートをロードし、ワークシートをユーザーに電子メールで送信するために使用します。このマクロはシナリオレベルで実行されます。
マクロパラメーターは、電子メールで送信するコンテキストとワークシートを決定します。次の表に、EmailWorksheet マクロを実行するパラメーターを示します。このマクロでは、マルチパネルワークシートはサポートされていません。
パラメーター 説明
エクスポートタイプ ワークシートが送信されるファイルの形式。次のオプションがあります。
  • PDF
  • XLS
ワークシート名 実行するワークシートの名前です。
ユーザー ワークシートの電子メール受信者です。
注: ユーザーはワークシートにアクセスできる必要があります。
渡された品目 ワークシートに渡される品目の選択。この値は、単一の要素または要素のセットです。
注: 
  • MDX 定義は、要素のセットでサポートされます。
  • この値が指定されていない場合、デフォルトのワークシート定義 (定義されている場合) が使用されます。それ以外の場合、デフォルト階層のトップノードが使用されます。
  • 現在の品目のデータコンテキストが必要な場合に %itemcontext% を使用できます (必須パラメーターは、コマンドがワークシート内で実行されているときにのみ適用されます)。
渡された場所 ワークシートに渡される場所の選択。この値は、単一の要素または要素のセットです。
注: 
  • MDX 定義は、要素のセットでサポートされます。
  • この値が指定されていない場合、デフォルトのワークシート定義 (定義されている場合) が使用されます。それ以外の場合、デフォルト階層のトップノードが使用されます。
  • 現在の場所データコンテキストが必要な場合に %locationcontext% を使用できます (必須パラメーターは、コマンドがワークシート内で実行されているときにのみ適用されます)。
渡された期間 ワークシートに渡される期間の選択。この値は、単一の要素または要素のセットです。
注: 
  • MDX 定義は、要素のセットでサポートされます。
  • この値が指定されていない場合、デフォルトのワークシート定義 (定義されている場合) が使用されます。それ以外の場合、デフォルト階層のトップノードが使用されます。
  • 現在のサイクル期間のデータコンテキストが必要な場合に %periodcontext% を使用できます (このパラメーターは、ワークシート内でコマンドが実行される場合にのみ適用されます)。
[コマンド] フィールドの値を次の形式で指定する必要があります: EmailWorksheet (エクスポートタイプ、ワークシート名、ユーザー、[渡された品目]、[渡された場所]、[渡された期間])
注: オプションパラメーターは [ ] で指定します。
表 1. 例
要件 パラメーター
需要差益分析ワークシートをワークシート定義のデフォルトの品目、場所、期間の選択で実行し、PDF 出力をユーザーの Scott に電子メールで送信します。

EmailWorksheet("PDF","Demand Margin Analysis","Scott")

EmailWorksheet("PDF","Demand Margin Analysis","Scott","","","")
需要必須要素ワークシートをワークシート定義のデフォルトの品目、場所、期間を選択して実行し、XLS 出力をユーザーの Harry に電子メールで送信します。 EmailWorksheet("XLS","Demand Essentials","Harry","","","")
予測精度分析ワークシートをブランド A 品目ノード、デフォルトの場所の選択、およびローリング週の期間ノードで実行し、PDF 出力をユーザーの Harry に電子メールで送信します。 EmailWorksheet("PDF","Forecast Accuracy Analysis","Harry","Brand A","","Rolling Weeks")

検証と実行

マクロの検証と実行に成功すると、ワークシートが選択された品目、場所、および期間とともにロードされ、指定したユーザーに電子メールが届きます。次の検証ルールがあります。

  • マクロパラメーターが Null の場合、品目、場所、期間選択のためにワークシートで指定されているデフォルト値が使用されます。
  • マクロパラメーターと、品目、場所、期間のワークシートデフォルトパラメーターが Null の場合、品目、場所、期間の最上位ノードの選択が使用されます。

検証およびエラーメッセージ

次の表に、サイクル期間とシナリオの状況、および関連する検証メッセージを示します。
サイクル期間の状況 シナリオの状況 実行可 検証メッセージ
保留中 N/A いいえ サイクル期間の状況が「保留中」であるため、マクロ {0} を実行できません。
実行中 任意 はい N/A
一時停止 任意 いいえ サイクル期間の状況が「一時停止」であるため、マクロ {0} を実行できません。
完了済 任意 はい N/A
中止済 任意 はい N/A
アーカイブ済 任意 いいえ サイクル期間の状況が「アーカイブ済」であるため、マクロ {0} を実行できません。
EmailWorksheet マクロの実行時に検証が実行されます。検証に失敗した場合、マクロは中止され、関連するエラーメッセージが表示されます。次の表は、さまざまな検証エラーで表示されるエラーメッセージを示しています。
検証条件 エラーメッセージ
現在のユーザーとモジュールでワークシートが有効であることを確認します。 ワークシート {0} はモジュール {1} またはユーザー {2} に対して有効でありません。
ワークシート画面キャプチャの追加は、標準ワークシートでのみサポートされます。

マルチパネルワークシートはまだサポートされていません。

 パラメーター値 {0} が無効です。ワークシートはタイプ = 標準ではありません。
エクスポートタイプが使用可能なフォーマットに対応していることを確認します。 パラメーター値 {0} が無効です。エクスポートタイプは PDF または XLS でなければなりません。
指定したユーザーが有効で、有効な電子メールアドレスを持っていることを確認します。 ユーザー {0} が見つかりません。
指定したユーザーが、必要なワークシートへのアクセス権を持っていることを確認します。 ユーザー {0} にはワークシート {1} に対するアクセス権がありません。
指定する場合、品目ノードが有効であることを確認します。 品目 {0} が見つかりません。
指定する場合、場所ノードが有効であることを確認します。 場所 {0} が見つかりません。
指定する場合は、期間ノードが有効であることを確認します。 期間ラベル {0} が見つかりません。
指定する場合は、品目ノードの値が評価されるようにします。

場合によっては、ワークシートパラメーターである rv_item_passed を使用してマクロパラメーターを初期化できません。

 渡された品目を評価できません。代替選択を定義します。
指定する場合は、場所ノードの値が評価されるようにします。

場合によっては、ワークシートパラメーターである rv_location_passed を使用してマクロパラメーターを初期化することはできません。

 渡された場所を評価できません。代替選択を定義します。
指定する場合は、期間ノードに指定された値を評価できるようにします。

場合によっては、ワークシートパラメーターである rv_period_passed を使用してマクロパラメーターを初期化することはできません。

 渡された期間は評価できません。代替選択を定義します。