Definisi Data MDX - MEMBUAT TINDAKAN

Membuat tindakan yang dapat dikaitkan dengan kubus, dimensi, hierarki, atau objek subordinat.

Sintaks

  
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' ]  

Argumen

Cube_Name
String valid yang menyediakan nama kubus.

Nama Action_
String valid yang menyediakan nama tindakan yang sedang dibuat.

Nama Hierarchy_
String valid yang menyediakan nama hierarki.

Nama Level_
String valid yang menyediakan nama tingkat.

Nama Member_
String valid yang menyediakan nama anggota atau kunci anggota.

MDX_Expression
Ekspresi MDX yang valid.

String_Expression
Ekspresi string yang valid.

Keterangan

Dimungkinkan bagi aplikasi klien untuk membuat dan menjalankan tindakan yang tidak aman; dimungkinkan juga bagi aplikasi klien untuk menggunakan fungsi yang tidak aman. Untuk menghindari situasi ini, gunakan properti Opsi Keamanan. Untuk informasi selengkapnya, lihat Properti Opsi Keamanan.

Catatan

Pernyataan ini disertakan untuk kompatibilitas mundur. Tindakan baru untuk Analysis Services, seperti tindakan Penelusuran atau Laporan, tidak didukung.

Jenis Tindakan

Tabel berikut ini menjelaskan berbagai jenis tindakan yang tersedia di Analysis Services.

Jenis tindakan	Deskripsi
URL	String tindakan yang dikembalikan adalah URL yang harus dibuka menggunakan browser Internet. Catatan: Jika tindakan ini tidak dimulai dengan https:// atau https://, tindakan tidak akan tersedia untuk browser kecuali SafetyOptions diatur ke DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML	String tindakan yang dikembalikan adalah skrip HTML. String harus disimpan ke file dan file harus dirender menggunakan browser Internet. Dalam hal ini, seluruh skrip dapat dijalankan sebagai bagian dari HTML yang dihasilkan.
PERNYATAAN	String tindakan yang dikembalikan adalah pernyataan yang perlu dijalankan dengan mengatur metode ICommand::SetText dari objek perintah ke string dan memanggil metode ICommand::Execute. Jika perintah tidak berhasil, kesalahan akan ditampilkan.
DATASET	String tindakan yang dikembalikan adalah pernyataan MDX yang perlu dijalankan dengan mengatur metode ICommand::SetText dari objek perintah ke string dan memanggil metode ICommand::Execute . ID antarmuka (IID) yang diminta harus IDataset. Perintah berhasil jika himpunan data telah dibuat. Aplikasi klien harus memungkinkan pengguna menelusuri himpunan data yang dikembalikan.
SET BARIS	Mirip dengan DATASET, tetapi alih-alih meminta IID IDataset, aplikasi klien harus meminta IID IRowset. Perintah berhasil jika set baris telah dibuat. Aplikasi klien harus memungkinkan pengguna menelusuri set baris yang dikembalikan.
COMMANDLINE	Aplikasi klien harus menjalankan string tindakan. String adalah baris perintah.
BERPEMILIK	Aplikasi klien tidak boleh menampilkan, atau menjalankan tindakan kecuali aplikasi memiliki pengetahuan kustom dan nongenerik tentang tindakan tertentu. Tindakan kepemilikan tidak dikembalikan ke aplikasi klien kecuali aplikasi klien secara eksplisit memintanya dengan mengatur batasan yang sesuai pada APPLICATION_NAME.

Jenis Pemanggilan

Tabel berikut ini menjelaskan berbagai jenis pemanggilan yang tersedia di Analysis Services. Jenis pemanggilan hanya digunakan oleh aplikasi klien untuk membantu menentukan kapan harus memanggil tindakan. Jenis pemanggilan sebenarnya tidak menentukan perilaku pemanggilan tindakan.

Jenis pemanggilan	Deskripsi
INTERAKTIF	Tindakan harus dipanggil oleh aplikasi klien melalui interaksi pengguna.
ON_OPEN	Tindakan harus dipanggil oleh aplikasi klien ketika objek target dibuka. Jenis pemanggilan ini saat ini tidak diimplementasikan.
BATCH	Tindakan harus dipanggil oleh aplikasi klien ketika objek target terlibat dalam operasi batch, seperti yang ditentukan oleh aplikasi klien. Jenis pemanggilan ini saat ini tidak diimplementasikan.

Cakupan

Setiap tindakan didefinisikan untuk kubus tertentu dan memiliki nama unik dalam kubus tersebut. Tindakan dapat memiliki salah satu cakupan yang tercantum dalam tabel berikut.

Cakupan kubus
Untuk tindakan yang independen dari dimensi, anggota, atau sel tertentu; misalnya: "Luncurkan emulasi terminal untuk sistem produksi AS/400".

Cakupan dimensi
Tindakan ini berlaku untuk dimensi tertentu. Tindakan ini tidak bergantung pada pilihan tingkat atau anggota tertentu.

Cakupan tingkat
Tindakan ini berlaku untuk tingkat dimensi tertentu. Tindakan ini tidak bergantung pada pilihan tertentu anggota dalam dimensi tersebut.

Cakupan anggota
Tindakan ini berlaku untuk anggota tingkat tertentu.

Cakupan sel
Tindakan hanya berlaku untuk sel tertentu.

Menetapkan cakupan
Tindakan hanya berlaku untuk satu set. Nama, ActionParameterSet, dicadangkan untuk digunakan oleh aplikasi di dalam ekspresi tindakan.

Lihat Juga

Pernyataan Definisi Data MDX (MDX)