Mengkustomisasi Templat formulir dengan menggunakan skrip

Dalam artikel ini

• Gambaran Umum

• Pertimbangan kompatibilitas

• Menyetel bahasa scripting untuk Templat formulir

• Menampilkan pesan setiap kali acara terjadi

• Menambahkan skrip yang berjalan saat pengguna menyimpan data formulir

• Menambahkan skrip yang berjalan saat pengguna mengirimkan data formulir

• Menambahkan skrip yang berjalan saat pengguna mengklik tombol

• Menambahkan skrip yang berjalan saat formulir yang ada digabungkan

• Menambahkan skrip untuk memperbarui formulir yang sudah ada

• Menambahkan skrip untuk acara lain

Gambaran Umum

Anda bisa mengkustomisasi Templat formulir InfoPath dengan menggunakan aturan, rumus, validasi data dan pemformatan bersyarat. Meskipun fitur ini sangat fleksibel dan dapat menangani berbagai tugas, beberapa tugas yang melampaui kapabilitas fitur ini. Misalnya, Anda tidak bisa menggunakan aturan untuk mengirim pesan email saat pengguna memasukkan nilai dalam kotak teks pada formulir. Jika Anda perlu mengkustomisasi Templat formulir Anda dengan cara yang berada di luar kemampuan fitur ini dan Anda sudah familiar dengan menulis skrip dengan menggunakan bahasa skrip JScript atau VBScript, Anda bisa menambahkan skrip yang berjalan saat pengguna membuka formulir baru atau mengubah mantan isting formulir yang didasarkan pada Templat formulir Anda.

Saat Anda menambahkan skrip ke Templat formulir, InfoPath memulai Microsoft Script Editor (UMK), yang memungkinkan Anda untuk menambahkan, mengedit, dan debug skrip di Templat formulir dan menempatkan kursor dalam acara pilihan Anda. InfoPath secara otomatis menambahkan pengatur kejadian untuk skrip. Pengatur kejadian adalah fungsi kode di Templat formulir InfoPath yang tindakan pengguna atau perubahan data XML dalam bentuk. Misalnya, jika Anda ingin pengguna Anda untuk menyimpan bentuk ke beberapa lokasi jaringan, Anda bisa menambahkan skrip untuk pengatur kejadian OnSaveRequest . Saat Anda menambahkan skrip untuk menjalankan saat pengguna menyimpan formulir yang didasarkan pada Templat formulir Anda, InfoPath memulai editor skrip dan menambahkan salah satu kode berikut untuk skrip.

//=======
// The following function handler is created by Microsoft Office InfoPath.
// Do not modify the name of the function, or the name and number of arguments.
//=======
function XDocument::OnSaveRequest(eventObj)
{
   // Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation();
   // Write the code to be run after saving here.
   eventObj.ReturnStatus = true;
}

'=======
' The following function handler is created by Microsoft Office InfoPath.
' Do not modify the name of the function, or the name and number of arguments.
'=======
Sub XDocument_OnSaveRequest(eventObj)
' Write the code to be run before saving here.
eventObj.IsCancelled = eventObj.PerformSaveOperation
' Write the code to be run after saving here.
eventObj.ReturnStatus = True
End Sub

Pertimbangan kompatibilitas

Anda tidak bisa menambahkan skrip ke templat formulir yang kompatibel dengan browser. Anda bisa menambahkan skrip hanya ke formulir Templat formulir yang dapat diisi di InfoPath. Anda bisa mengkustomisasi Templat formulir yang kompatibel dengan browser hanya dengan menggunakan kode yang dikelola.

Atas halaman

Menyetel bahasa scripting untuk Templat formulir

Untuk mengkustomisasi Templat formulir dengan menggunakan skrip, Anda bisa menggunakan Microsoft JScript atau Microsoft Visual Basic Scripting Edition (VBScript). Secara default, InfoPath dikonfigurasikan untuk menambahkan skrip dengan menggunakan JScript. Jika Templat formulir Anda tidak berisi skrip atau kode yang dikelola, dan Anda lebih suka menggunakan VBScript sebagai bahasa Anda scripting, Anda bisa mengubah bahasa scripting untuk Templat formulir Anda untuk VBScript. Anda tidak bisa menggunakan bahasa scripting kedua di Templat formulir yang sama.

Jika Templat formulir yang sudah berisi skrip dalam satu bahasa dan Anda ingin menggunakan bahasa lain, Anda perlu menyimpan skrip yang sudah ada sehingga Anda bisa mengonversi skrip ke bahasa lain, menghapus skrip dari Templat formulir melalui Opsi formulir kotak dialog, dan lalu tambahkan skrip dikonversi kembali ke Templat formulir. InfoPath tidak bisa mengonversi skrip untuk skrip bahasa baru. Mengubah bahasa skrip dalam kotak dialog Opsi formulir hanya mempengaruhi Templat formulir ini. Templat formulir lainnya akan memiliki JScript sebagai default scripting bahasa.

1. Pada menu alat , klik Opsi formulir.

2. Dalam daftar kategori , dalam kotak dialog Opsi formulir , klik pemrograman.

3. Dalam daftar formulir Templat kode bahasa , di bawah bahasa pemrograman, klik VBScript.

   Catatan: 

   • Setelah Anda menyetel bahasa scripting dan membuat satu atau beberapa acara penangan untuk Templat formulir, Anda tidak bisa mengubah bahasa scripting untuk Templat formulir.

   • Jika Anda menginstal Microsoft Visual Studio 2005 Tools untuk aplikasi, bahasa default adalah Microsoft Visual Basic .NET. Anda masih bisa menggunakan prosedur ini untuk mengubah bahasa scripting VBScript.

Atas halaman

Menampilkan pesan setiap kali acara terjadi

Jika Anda ingin mengetahui apa yang menjalankan acara penangan menanggapi tindakan atau kejadian lainnya, Anda bisa menambahkan kode sementara untuk menampilkan kotak pesan setiap kali pengatur kejadian berjalan. Anda harus menggunakan kode ini hanya untuk menentukan saat menjalankan pengatur kejadian. Setelah Anda menambahkan kode ini, Anda bisa menggunakan pratinjau untuk menampilkan formulir yang didasarkan pada Templat formulir ini atau untuk menerbitkan Templat formulir dan lalu membuat Templat formulir baru. Beberapa event handler Jalankan hanya jika Anda membuat formulir setelah Anda menerbitkan Templat formulir. Anda lalu bisa melakukan tindakan yang menurut Anda mungkin menjalankan pengatur kejadian. Saat pengatur kejadian berjalan, Anda melihat kotak pesan.

Setelah Anda menentukan tindakan atau kejadian menjalankan pengatur kejadian, menghapus kode dan lalu Lanjutkan mendesain Templat formulir. Jika Anda tidak menghapus kode ini dan kemudian Anda menerbitkan Templat formulir, pengguna Anda akan melihat kotak pesan ini saat menjalankan pengatur kejadian.

1. Menambahkan pengatur kejadian.

2. Untuk menambahkan kode di JScript, ketik XDocument.UI.Alert ("acara nama acara hanya berlari"); Ganti dengan nama pengatur kejadian. Misalnya, jika Anda menambahkan kode ini ke pengatur kejadian OnValidate , Anda akan mengetik XDocument.UI.Alert ("OnValidate pengatur kejadian hanya berlari");

3. Untuk menambahkan kode di VBScript, ketik XDocument.UI.Alert ("acara nama acara hanya berlari") sebagai contoh, jika Anda menambahkan kode ini ke pengatur kejadian OnSaveRequest , Anda akan mengetik XDocument.UI.Alert ("OnSaveRequest pengatur kejadian hanya berlari")

4. Untuk menguji kode, klik pratinjau pada File menu, atau tekan CTRL + SHIFT + B, dan kemudian melakukan tindakan pengguna yang bisa mulai acara. Saat terjadi kejadian dengan garis kode, kotak pesan akan menampilkan pesan Anda.

   Catatan: Beberapa kegiatan mungkin mengharuskan Anda untuk menerbitkan Templat formulir dan lalu membuat formulir yang didasarkan pada Templat formulir ini sebelum Anda bisa menjalankan tindakan pengguna untuk memulai acara.

5. Sebelum Anda menerbitkan Templat formulir dan mengaktifkan pengguna Anda untuk mengisi formulir yang didasarkan pada Templat formulir ini, Hapus kode yang Anda gunakan untuk menampilkan kotak pesan.

Atas halaman

Menambahkan skrip yang berjalan saat pengguna menyimpan data formulir

1. Pada menu alat , klik Opsi formulir.

2. Dalam daftar kategori , dalam kotak dialog Opsi formulir , klik buka dan Simpan.

3. Di bawah Simpan perilaku, pilih kotak centang Simpan menggunakan kode kustom , dan lalu klik Edit. Microsoft Script Editor dimulai dengan kursor di pengatur kejadian OnSaveRequest .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSaveRequest(eventObj)
   {
      // Write the code to be run before saving here.
      eventObj.IsCancelled = eventObj.PerformSaveOperation();
      // Write the code to be run after saving here.
      eventObj.ReturnStatus = true;
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSaveRequest(eventObj)
   ' Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation
   ' Write the code to be run after saving here.
   eventObj.ReturnStatus = True
   End Sub
   

4. Lakukan satu atau kedua hal berikut ini:

   • Untuk menambahkan skrip yang berjalan sebelum InfoPath menyimpan formulir, ganti komentar Write the code to be run before saving here.dengan kode Anda.

   • Untuk menambahkan skrip yang berjalan setelah InfoPath menyimpan formulir, ganti komentar Write the code to be run after saving here. dengan kode Anda.

5. Untuk menguji perubahan, klik Pratinjau pada toolbar Standar, atau tekan CTRL+SHIFT+B.

   Catatan: Jika pengatur kejadian berjalan hanya setelah Anda membuat formulir yang didasarkan pada Templat formulir Anda, menerbitkan Templat formulir dengan mengklik terbitkan pada File menu, dan lalu menyelesaikan panduan penerbitan. Setelah Anda menerbitkan Templat formulir, membuat formulir dan lalu lakukan tindakan untuk menjalankan pengatur kejadian.

Atas halaman

Menambahkan skrip yang berjalan saat pengguna mengirimkan data formulir

1. Pada menu alat , klik Opsi mengirimkan.

2. Di kotak dialog Opsi mengirimkan , pilih kotak centang Perbolehkan pengguna untuk mengirim formulir ini .

3. Klik Jalankan tindakan kustom menggunakan kode, dan lalu klik Edit kode. Microsoft Script Editor dimulai dengan kursor di pengatur kejadian OnSubmitRequest .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSubmitRequest(eventObj)
   {
      // If the submit operation is successful, set
      // eventObj.ReturnStatus = true;
      // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSubmitRequest(eventObj)
   ' If the submit operation is successful, set
   ' eventObj.ReturnStatus = True
   ' Write your code here
   End Sub
   

4. Ganti komentar If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here dengan kode Anda.

5. Untuk menguji perubahan, klik Pratinjau pada toolbar Standar, atau tekan CTRL+SHIFT+B.

Atas halaman

Menambahkan skrip yang berjalan saat pengguna mengklik tombol

1. Menambahkan tombol baru ke tampilan di Templat formulir, dan lalu klik ganda tombol.

   Catatan: Jika Anda menambahkan skrip ke tombol yang sudah ada, klik ganda tombol yang sudah ada sebagai gantinya.

2. Klik tab umum .

3. Klik Edit formulir kode. Microsoft Script Editor dimulai dengan kursor di pengatur kejadian OnClick untuk tombol tersebut.

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function Button Name::OnClick(eventObj)
   {
   // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub Button Name_OnClick(eventObj)
   ' Write your code here
   End Sub
   

4. Ganti komentar Write your code here dengan kode Anda.

5. Untuk menguji perubahan, klik Pratinjau pada toolbar Standar, atau tekan CTRL+SHIFT+B.

Atas halaman

Menambahkan skrip yang berjalan saat formulir yang ada digabungkan

1. Pada menu alat , klik Opsi formulir.

2. Dalam daftar kategori , dalam kotak dialog Opsi formulir , klik tingkat lanjut.

3. Di bawah menggabungkan formulir, pilih kotak centang Aktifkan menggabungkan formulir .

4. Pilih kotak centang gabungkan menggunakan kode kustom , dan lalu klik Edit. Microsoft Script Editor dimulai dengan kursor di pengatur kejadian OnMergeRequest .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnMergeRequest(eventObj)
   {
   // Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM);
   eventObj.ReturnStatus = true;
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnMergeRequest(eventObj)
   ' Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM)
   eventObj.ReturnStatus = True
   End Sub
   

5. Ganti komentar Write the code that handles each form being merged here. dengan kode Anda.

6. Untuk menguji kode dalam acara, menerbitkan Templat formulir, membuat beberapa formulir yang didasarkan pada Templat formulir ini dan menggabungkan Templat formulir.

   Catatan: Temukan link untuk informasi selengkapnya tentang penerbitan Templat formulir Anda di bagian Lihat juga .

Atas halaman

Menambahkan skrip untuk memperbarui formulir yang sudah ada

Jika Anda memperbarui Templat formulir yang sebelumnya diterbitkan, dan Anda ingin memperbarui formulir yang sudah ada yang didasarkan pada Templat formulir tersebut, Anda bisa menambahkan skrip ke Templat formulir yang diperbarui yang berjalan saat pengguna membuka salah satu bentuk yang sudah ada. Ketika pengguna membuka formulir yang sudah ada, InfoPath memeriksa nomor versi Templat formulir yang terkait dengan lokasi terbitkan. Jika nomor versi Templat formulir di lokasi terbitkan baru dari nomor versi dalam formulir yang sudah ada, mengindikasikan bahwa ia telah diperbarui, InfoPath menjalankan kode acara ini untuk memperbarui formulir yang sudah ada.

1. Pada menu alat , klik Opsi formulir.

2. Dalam daftar kategori , dalam kotak dialog Opsi formulir , klik penerapan versi.

3. Di daftar pada versi memutakhirkan , klik gunakan kustom acara, dan lalu klik Edit. Microsoft Script Editor dimulai dengan kursor di pengatur kejadian OnVersionUpgrade .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnVersionUpgrade(eventObj)
   {
   // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnVersionUpgrade(eventObj)
   ' Write your code here
   End Sub
   

4. Ganti komentar Write your code here dengan kode Anda.

5. Untuk menguji kode dalam acara, menerbitkan Templat formulir, membuat beberapa formulir yang didasarkan pada Templat formulir ini, Ubah dan terbitkan versi terbaru dari Templat formulir dan lalu buka formulir yang sudah ada berdasarkan versi yang lebih lama dari Templat formulir ini.

   Catatan: Temukan link untuk informasi selengkapnya tentang penerbitan Templat formulir Anda di bagian Lihat juga .

Atas halaman

Menambahkan skrip untuk acara lain

Prosedur ini bisa digunakan untuk menambahkan penangan kejadian berikut ini ke Templat formulir Anda:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• Pada menu alat , arahkan ke pemrograman, dan lalu klik acara untuk menambahkan ke pengatur kejadian. Microsoft Script Editor dimulai dengan kursor di pengatur kejadian yang Anda pilih.

• Ganti komentar Write your code here dengan kode Anda.

Atas halaman