オンデマンドでのコメントの送信を可能にします。XL3Link と組み合わせて使うことで、実行をトリガーできます。
この構成は、任意の数のタプルに対するコメントを一括送信できるように考案されたものです。
構文
XL3DoComment( PerformComment, CommentHtml, Connection, [Hierarchy1], [Member1],…, [Hierarchy100], [Member100] )
パラメーター
パラメーター | 説明 |
PerformComment | コメントを送信するかどうかを指定するブール値 (TRUE 又は FALSE)。これが Excel 範囲である場合は、送信後にこのセルの値が FALSE にリセットされます。 |
CommentHtml | 送信されるコメント。通常は Excel セル参照。これには HTML タグを含めることができます。 |
Connection | 使用する接続番号。 |
Hierarchy1,…, HierarchyN | 後続のメンバーが適用される階層の名前。たとえば、「Measures」や 「[Customer].[Customer Geography] 」など。 |
Member1,…, MemberN | 単一のメンバーの一意名または XL3Member 式。 |
例
この例では、XL3DoComment を使用して実現できる入力テンプレートを示します。このテンプレートには列が一つあり、五つのコメントが送信されます。ただし、同じコンセプトは多くのコメント適用可能です。このテンプレートを使用する手順は、次のとおりです。
- 列 C に新しい値を入力します。
- セル A1 の XL3Link を選択します。B1 が TRUE に更新されます。
- 列 E の XL3DoComment 式がトリガーされます。
- プロセスが完了すると、セル B1 は自動的に FALSE にリセットされます。
A | B | C | D | E | |
1 | =XL3Link(,"Submit Comment",,XL3Address($B$1),TRUE) | FALSE | |||
2 | |||||
3 | =XL3Member(1,"[Department]","[Department].&[0001]") | Acceptable | =XL3DoComment($B$1,$C3,1,"[Measures]","[Measures].[Budget Amount]","[Date].[Calendar]","[Date].[Calendar].[Date].&[1128]","[Department]",$A3) | ||
4 | =XL3Member(1,"[Department]","[Department].&[0002]") | Excelling | =XL3DoComment($B$1,$C4,1,"[Measures]","[Measures].[Budget Amount]","[Date].[Calendar]","[Date].[Calendar].[Date].&[1128]","[Department]",$A4) | ||
5 | =XL3Member(1,"[Department]","[Department].&[0003]") | Acceptable | =XL3DoComment($B$1,$C5,1,"[Measures]","[Measures].[Budget Amount]","[Date].[Calendar]","[Date].[Calendar].[Date].&[1128]","[Department]",$A5) | ||
6 | =XL3Member(1,"[Department]","[Department].&[0004]") | Acceptable | =XL3DoComment($B$1,$C6,1,"[Measures]","[Measures].[Budget Amount]","[Date].[Calendar]","[Date].[Calendar].[Date].&[1128]","[Department]",$A6) | ||
7 | =XL3Member(1,"[Department]","[Department].&[0005]") | Underperforming | =XL3DoComment($B$1,$C7,1,"[Measures]","[Measures].[Budget Amount]","[Date].[Calendar]","[Date].[Calendar].[Date].&[1128]","[Department]",$A7) |
この入力テンプレートの実行結果は以下のようになります。

凡例
- コントロール ブロック: XL3DoComment のコメント アクションをトリガーするために使用されます。
- 新しいコメント: この一連のセルに、送信する新しいコメントが保持されます。
- XL3DoComment ブロック: この部分の XL3DoComment 式によって、コメントの送信先となるキューブの断面を制御します。
ウェブでの制約
Web Edition では、XL3Lookup やその他の Anaplan XL 式を使用して XL3DoComment のソース値を取得することはサポートされていません。XL3Lookup は XL3DoComment の後に実行されます。