キューブ、ディメンション、階層、または下位オブジェクトに関連付けることができるアクションを作成します。
構文
CREATE ACTION CURRENTCUBE | Cube_Name
.Action_Name <action body>
<action body> ::=
FOR
CUBE
| Hierarchy_Name [MEMBERS]
| Level_Name [MEMBERS]
| CELLS
| SET }
AS 'MDX_Expression'
[, TYPE = '
{ URL
| HTML
| STATEMENT
| DATASET
| ROWSET
| COMMANDLINE
| PROPRIETARY }
']
[ , INVOCATION = 'INTERACTIVE | ON_OPEN | BATCH ' ]
[ , APPLICATION = String_Expression ]
[ , DESCRIPTION = String_Expression ]
[ , CAPTION = 'MDX_Expression' ]
論争
Cube_Name
キューブ名を提供する有効な文字列。
Action_名
作成されるアクションの名前を提供する有効な文字列。
Hierarchy_名
階層名を提供する有効な文字列。
Level_名
レベル名を提供する有効な文字列。
Member_名
メンバー名またはメンバー キーを提供する有効な文字列。
MDX_Expression
有効な MDX 式。
String_Expression
有効な文字列式。
注釈
クライアント アプリケーションは、安全でないアクションを作成して実行できます。また、クライアント アプリケーションで安全でない関数を使用することもできます。 このような状況を回避するには、 Safety Options プロパティを使用します。 詳細については、「Safety Options プロパティ」を参照してください。
注
このステートメントは、下位互換性のために含まれています。 ドリルスルー アクションやレポート アクションなど、Analysis Services に初めて使用するアクションはサポートされていません。
アクションの種類
次の表では、Analysis Services で使用できるさまざまな種類のアクションについて説明します。
| アクションの種類 | 説明 |
|---|---|
| URL | 返されるアクション文字列は、インターネット ブラウザーを使用して開く必要がある URL です。 注: このアクションが https:// または https://で始まらない場合、 SafetyOptions が DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL に設定されていない限り、このアクションはブラウザーで使用できなくなります。 |
| HTML | 返されるアクション文字列は HTML スクリプトです。 文字列をファイルに保存し、インターネット ブラウザーを使用してファイルをレンダリングする必要があります。 この場合、生成された HTML の一部としてスクリプト全体を実行できます。 |
| 陳述 | 返されるアクション文字列は、コマンド オブジェクトの ICommand::SetText メソッドを文字列に設定し、 ICommand::Execute メソッドを呼び出すことによって実行する必要があるステートメントです。 コマンドが成功しない場合は、エラーが返されます。 |
| データセット | 返されるアクション文字列は、コマンド オブジェクトの ICommand::SetText メソッドを文字列に設定し、 ICommand::Execute メソッドを呼び出すことによって実行する必要がある MDX ステートメントです。 要求されたインターフェイス ID (IID) は IDataset である必要があります。 データ・セットが作成された場合、このコマンドは成功します。 クライアント アプリケーションは、ユーザーが返されたデータ セットを参照できるようにする必要があります。 |
| ROWSET | DATASET と同様ですが、IDataset の IID を要求する代わりに、クライアント アプリケーションは IRowset の IID を要求する必要があります。 行セットが作成されている場合、コマンドは成功します。 クライアント アプリケーションでは、ユーザーが返された行セットを参照できるようにする必要があります。 |
| COMMANDLINE | クライアント アプリケーションはアクション文字列を実行する必要があります。 文字列はコマンド ラインです。 |
| 独自 | クライアント アプリケーションは、特定のアクションに関するカスタムの非一般的な知識がない限り、アクションを表示したり、実行したりしないでください。 クライアント アプリケーションがAPPLICATION_NAMEに適切な制限を設定して明示的に要求しない限り、独自のアクションはクライアント アプリケーションに返されません。 |
呼び出しの種類
次の表では、Analysis Services で使用できるさまざまな種類の呼び出しについて説明します。 呼び出しの種類は、アクションを呼び出すタイミングを判断するために、クライアント アプリケーションによってのみ使用されます。 呼び出しの種類は、実際にはアクションの呼び出し動作を決定しません。
| 呼び出しの種類 | 説明 |
|---|---|
| インテラクティブ | アクションは、ユーザーの操作を通じてクライアント アプリケーションによって呼び出される必要があります。 |
| ON_OPEN | アクションは、ターゲット オブジェクトを開いたときにクライアント アプリケーションによって呼び出される必要があります。 この呼び出しの種類は現在実装されていません。 |
| バッチ | このアクションは、クライアント アプリケーションによって決定されたバッチ操作にターゲット オブジェクトが関係している場合に、クライアント アプリケーションによって呼び出される必要があります。 この呼び出しの種類は現在実装されていません。 |
範囲
各アクションは特定のキューブに対して定義され、そのキューブに一意の名前が付けられます。 アクションには、次の表に示すスコープのいずれかを指定できます。
キューブ スコープ
特定のディメンション、メンバー、またはセルに依存しないアクションの場合。例: "AS/400 実稼働システムのターミナル エミュレーションを起動する"。
ディメンションスコープ
アクションは特定のディメンションに適用されます。 これらのアクションは、レベルまたはメンバーの特定の選択に依存しません。
レベル スコープ
アクションは、特定のディメンション レベルに適用されます。 これらのアクションは、そのディメンション内のメンバーの特定の選択に依存しません。
メンバー スコープ
アクションは、特定のレベルのメンバーに適用されます。
セルスコープ
アクションは特定のセルにのみ適用されます。
スコープの設定
アクションはセットにのみ適用されます。
ActionParameterSet という名前は、アクションの式内のアプリケーションで使用するために予約されています。