Tùy chỉnh mẫu biểu mẫu bằng cách sử dụng một script

Trong bài viết này

• Tổng quan

• Cân nhắc tính tương thích

• Đặt ngôn ngữ cho kịch bản cho một mẫu biểu mẫu

• Hiển thị một thông báo mỗi khi xảy ra một sự kiện

• Thêm một script chạy khi người dùng lưu dữ liệu biểu mẫu

• Thêm một script chạy khi một người dùng gửi dữ liệu biểu mẫu

• Thêm một script chạy khi người dùng bấm vào một nút

• Thêm một script chạy khi biểu mẫu hiện có được sáp nhập

• Thêm một kịch bản cập nhật các biểu mẫu hiện có

• Thêm một kịch bản cho các sự kiện khác

Tổng quan

Bạn có thể tùy chỉnh của mẫu biểu mẫu InfoPath bằng cách sử dụng quy tắc, công thức, kiểm soát dữ liệu và định dạng có điều kiện. Mặc dù các tính năng này rất linh hoạt và có thể xử lý hàng loạt nhiệm vụ, một số tác vụ nằm ngoài các tính năng của các tính năng này. Ví dụ, bạn không thể sử dụng quy tắc để gửi thông điệp email khi người dùng vào một giá trị trong một hộp văn bản trên một biểu mẫu. Nếu bạn cần để tùy chỉnh của mẫu biểu mẫu theo cách nằm ngoài các tính năng của các tính năng này và bạn đã quen thuộc với việc viết script bằng cách sử dụng ngôn ngữ tạo script JScript hoặc VBScript, bạn có thể thêm một script chạy khi người dùng sẽ mở ra một biểu mẫu mới hoặc sửa đổi một ví dụ biểu mẫu isting dựa trên mẫu biểu mẫu của bạn.

Khi bạn thêm một script vào mẫu biểu mẫu, InfoPath khởi động các Microsoft Script trình soạn thảo (MSE), vốn cho phép bạn thêm, sửa và gỡ lỗi script trong mẫu biểu mẫu và đặt con trỏ trong sự kiện bạn đã chọn của bạn. InfoPath tự động thêm một trình xử lý sự kiện kịch bản. Trình xử lý một sự kiện là mã hàm trong mẫu biểu mẫu InfoPath, phản hồi một hành động người dùng hoặc thay đổi dữ liệu XML trong một biểu mẫu. Ví dụ, nếu bạn muốn người dùng của bạn để lưu biểu mẫu của họ vào một vài vị trí mạng, bạn có thể thêm một script trình xử lý sự kiện OnSaveRequest . Khi bạn thêm một script để chạy khi người dùng lưu biểu mẫu dựa trên mẫu biểu mẫu của bạn, InfoPath khởi động trình soạn thảo script và thêm một trong các mã sau đây để kịch bản.

//=======
// 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

Cân nhắc tính tương thích

Bạn không thể thêm script vào một mẫu biểu mẫu tương thích với trình duyệt. Bạn có thể thêm script chỉ vào một mẫu biểu mẫu biểu mẫu có sẽ được điền trong InfoPath. Bạn có thể tùy chỉnh mẫu biểu mẫu tương thích với trình duyệt chỉ bằng cách sử dụng mã được quản lý.

Đầu trang

Đặt ngôn ngữ cho kịch bản cho một mẫu biểu mẫu

Để tùy chỉnh mẫu biểu mẫu bằng cách dùng script, bạn có thể sử dụng Microsoft JScript hoặc Microsoft Visual Basic Scripting Edition (VBScript). Theo mặc định, InfoPath được cấu hình để thêm script bằng cách dùng JScript. Nếu mẫu biểu mẫu của bạn không chứa bất kỳ script hoặc mã được quản lý, và bạn muốn dùng VBScript làm ngôn ngữ kịch bản của bạn, bạn có thể thay đổi ngôn ngữ cho kịch bản cho mẫu biểu mẫu của bạn để VBScript. Bạn không thể dùng cả hai ngôn ngữ kịch bản trong cùng một mẫu biểu mẫu.

Nếu mẫu biểu mẫu đã chứa script bằng một ngôn ngữ và bạn muốn sử dụng ngôn ngữ khác, bạn cần phải lưu script hiện có để bạn có thể chuyển đổi các kịch bản sang ngôn ngữ khác, loại bỏ script từ mẫu biểu mẫu thông qua Tùy chọn biểu mẫu hộp thoại, và sau đó thêm mã lệnh đã chuyển đổi trở về mẫu biểu mẫu. InfoPath không thể chuyển đổi script để tạo script ngôn ngữ mới. Thay đổi ngôn ngữ cho kịch bản trong hộp thoại Tùy chọn biểu mẫu chỉ ảnh hưởng đến mẫu biểu mẫu này. Mẫu biểu mẫu khác sẽ có JScript làm mặc định, tính năng tạo script ngôn ngữ.

1. Trên menu công cụ , bấm Tùy chọn biểu mẫu.

2. Trong danh sách thể loại , trong hộp thoại Tùy chọn biểu mẫu , bấm lập trình.

3. Trong danh sách ngôn ngữ mã mẫu biểu mẫu , bên dưới ngôn ngữ lập trình, bấm VBScript.

   Lưu ý: 

   • Sau khi bạn đặt ngôn ngữ cho kịch bản và tạo một hoặc nhiều xử lý sự kiện cho mẫu biểu mẫu, bạn không thể thay đổi ngôn ngữ cho kịch bản cho mẫu biểu mẫu.

   • Nếu bạn đã cài đặt Microsoft Visual Studio 2005 công cụ cho các ứng dụng, ngôn ngữ mặc định là Microsoft Visual Basic .NET. Bạn vẫn có thể sử dụng thủ tục này để thay đổi ngôn ngữ cho kịch bản để VBScript.

Đầu trang

Hiển thị một thông báo mỗi khi xảy ra một sự kiện

Nếu bạn muốn tìm hiểu bộ xử lý sự kiện chạy trong phản hồi cho một hành động hoặc sự kiện khác, bạn có thể thêm mã tạm thời để hiển thị một hộp thông báo mỗi khi chạy trình xử lý sự kiện. Bạn nên dùng mã này chỉ để xác định khi chạy một trình xử lý sự kiện. Sau khi bạn thêm mã này, bạn có thể sử dụng bản xem trước để xem biểu mẫu dựa trên mẫu biểu mẫu này hoặc để phát hành mẫu biểu mẫu và sau đó tạo một mẫu biểu mẫu mới. Một số bộ xử lý sự kiện chạy chỉ khi bạn tạo một biểu mẫu sau khi bạn phát hành mẫu biểu mẫu. Sau đó, bạn có thể thực hiện một hành động mà bạn nghĩ có thể chạy trình xử lý sự kiện. Khi trình xử lý sự kiện chạy, bạn thấy một hộp thư.

Sau khi bạn xác định những hành động hoặc sự kiện chạy trình xử lý sự kiện, loại bỏ mã và sau đó tiếp tục thiết kế mẫu biểu mẫu. Nếu bạn không loại bỏ mã này và sau đó bạn phát hành mẫu biểu mẫu, người dùng của bạn sẽ thấy hộp thông báo này khi chạy trình xử lý sự kiện.

1. Thêm trình xử lý sự kiện của bạn.

2. Để thêm mã trong JScript được, hãy nhập XDocument.UI.Alert ("The sự kiện tên sự kiện chỉ chạy"); Thay thế bằng tên của trình xử lý sự kiện của bạn. Ví dụ, nếu bạn thêm mã này vào trình xử lý sự kiện OnValidate , bạn sẽ nhập XDocument.UI.Alert ("The OnValidate trình xử lý sự kiện chỉ chạy");

3. Để thêm mã trong VBScript, nhập XDocument.UI.Alert ("The sự kiện tên sự kiện chỉ chạy") ví dụ, nếu bạn thêm mã này vào trình xử lý sự kiện OnSaveRequest , bạn sẽ nhập XDocument.UI.Alert ("The OnSaveRequest trình xử lý sự kiện chỉ chạy")

4. Để kiểm tra mã, bấm xem trước trên menu tệp , hoặc nhấn CTRL + SHIFT + B, và sau đó thực hiện một hành động người dùng có thể bắt đầu sự kiện. Khi xảy ra sự kiện với dòng mã, một hộp thông báo sẽ hiển thị thông báo của bạn.

   Lưu ý: Một số sự kiện có thể yêu cầu bạn phát hành mẫu biểu mẫu và sau đó tạo một biểu mẫu dựa trên mẫu biểu mẫu này trước khi bạn có thể thực hiện một hành động người dùng để bắt đầu sự kiện.

5. Trước khi bạn phát hành mẫu biểu mẫu và cho phép người dùng của bạn để điền biểu mẫu dựa trên mẫu biểu mẫu này, xóa bỏ mã mà bạn đã dùng để hiển thị hộp thư.

Đầu trang

Thêm một script chạy khi người dùng lưu dữ liệu biểu mẫu

1. Trên menu công cụ , bấm Tùy chọn biểu mẫu.

2. Trong danh sách thể loại , trong hộp thoại Tùy chọn biểu mẫu , hãy bấm mở và lưu.

3. Dưới lưu hành vi, hãy chọn hộp kiểm lưu bằng cách dùng mã tùy chỉnh , sau đó bấm sửa. Trình soạn thảo Script Microsoft bắt đầu với con trỏ nằm ở trình xử lý sự kiện 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. Thực hiện một hoặc hai thao tác sau đây:

   • Để thêm một script chạy trước khi InfoPath lưu biểu mẫu, thay thế chú thích Write the code to be run before saving here.với mã của bạn.

   • Để thêm một script chạy sau khi InfoPath lưu biểu mẫu, thay thế chú thích Write the code to be run after saving here. với mã của bạn.

5. Để kiểm tra các thay đổi của bạn, hãy bấm Xem trước trên thanh công cụ Chuẩn hoặc nhấn CTRL+SHIFT+B.

   Lưu ý: Nếu trình xử lý sự kiện chạy chỉ sau khi bạn tạo một biểu mẫu dựa trên mẫu biểu mẫu của bạn, phát hành mẫu biểu mẫu bằng cách bấm phát hành trên menu tệp , và sau đó hoàn tất trình hướng dẫn phát hành. Sau khi bạn phát hành mẫu biểu mẫu, tạo một biểu mẫu và sau đó thực hiện một hành động để chạy trình xử lý sự kiện.

Đầu trang

Thêm một script chạy khi một người dùng gửi dữ liệu biểu mẫu

1. Trên menu công cụ , bấm Tùy chọn gửi.

2. Trong hộp thoại Tùy chọn gửi , hãy chọn hộp kiểm cho phép người dùng để nộp biểu mẫu này .

3. Bấm thực hiện hành động tùy chỉnh bằng cách dùng mã, sau đó bấm Sửa mã. Trình soạn thảo Script Microsoft bắt đầu với con trỏ nằm ở trình xử lý sự kiện 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. Thay thế chú thích If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here với mã của bạn.

5. Để kiểm tra các thay đổi của bạn, hãy bấm Xem trước trên thanh công cụ Chuẩn hoặc nhấn CTRL+SHIFT+B.

Đầu trang

Thêm một script chạy khi người dùng bấm vào một nút

1. Thêm một nút mới vào một dạng xem trong mẫu biểu mẫu, và sau đó bấm đúp vào nút.

   Lưu ý: Nếu bạn muốn thêm kịch bản cho một nút hiện có, bấm đúp vào nút hiện có.

2. Bấm tab chung .

3. Bấm sửa biểu mẫu mã. Trình soạn thảo Script Microsoft bắt đầu với con trỏ nằm ở trình xử lý sự kiện ảnh cho nút đó.

   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. Thay thế chú thích Write your code here với mã của bạn.

5. Để kiểm tra các thay đổi của bạn, hãy bấm Xem trước trên thanh công cụ Chuẩn hoặc nhấn CTRL+SHIFT+B.

Đầu trang

Thêm một script chạy khi biểu mẫu hiện có được sáp nhập

1. Trên menu công cụ , bấm Tùy chọn biểu mẫu.

2. Trong danh sách thể loại , trong hộp thoại Tùy chọn biểu mẫu , bấm nâng cao.

3. Bên dưới sáp nhập biểu mẫu, hãy chọn hộp kiểm bật biểu mẫu sáp nhập .

4. Chọn hộp kiểm phối bằng cách dùng mã tùy chỉnh , sau đó bấm sửa. Trình soạn thảo Script Microsoft bắt đầu với con trỏ nằm ở trình xử lý sự kiện 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. Thay thế chú thích Write the code that handles each form being merged here. với mã của bạn.

6. Để kiểm tra mã trong sự kiện này, phát hành mẫu biểu mẫu, tạo một số biểu mẫu dựa trên mẫu biểu mẫu này, và sau đó phối các mẫu biểu mẫu.

   Lưu ý: Tìm nối kết để biết thêm thông tin về phát hành mẫu biểu mẫu của bạn trong phần Xem thêm .

Đầu trang

Thêm một kịch bản cập nhật các biểu mẫu hiện có

Nếu bạn Cập Nhật đã được phát hành mẫu biểu mẫu, và bạn muốn cập nhật các biểu mẫu hiện có, dựa trên mẫu biểu mẫu đó, bạn có thể thêm script vào mẫu biểu mẫu Cập Nhật sẽ chạy khi người dùng sẽ mở ra một trong các biểu mẫu hiện có. Khi người dùng sẽ mở ra biểu mẫu hiện có, InfoPath kiểm tra số phiên bản của mẫu biểu mẫu liên kết của nó ở một vị trí phát hành. Nếu số phiên bản ở vị trí phát hành mẫu biểu mẫu mới hơn số phiên bản trong biểu mẫu hiện có, cho biết rằng nó đã được Cập Nhật, InfoPath sẽ chạy mã trong sự kiện này để cập nhật biểu mẫu hiện có.

1. Trên menu công cụ , bấm Tùy chọn biểu mẫu.

2. Trong danh sách thể loại , trong hộp thoại Tùy chọn biểu mẫu , hãy bấm lập phiên bản.

3. Trong danh sách trên phiên bản nâng cấp , bấm sự kiện tùy chỉnh sử dụng, sau đó bấm sửa. Trình soạn thảo Script Microsoft bắt đầu với con trỏ nằm ở trình xử lý sự kiện 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. Thay thế chú thích Write your code here với mã của bạn.

5. Để kiểm tra mã trong sự kiện này, phát hành mẫu biểu mẫu, hãy tạo một số biểu mẫu dựa trên mẫu biểu mẫu này, sửa đổi và phát hành phiên bản Cập Nhật của mẫu biểu mẫu, sau đó mở biểu mẫu hiện có, dựa trên phiên bản cũ hơn của mẫu biểu mẫu này.

   Lưu ý: Tìm nối kết để biết thêm thông tin về phát hành mẫu biểu mẫu của bạn trong phần Xem thêm .

Đầu trang

Thêm một kịch bản cho các sự kiện khác

Quy trình này có thể dùng để thêm bộ xử lý sự kiện sau đây vào mẫu biểu mẫu của bạn:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• Khi tải trang

• OnSwitchView

• OnSign

• OnValidate

• Trên menu công cụ , trỏ tới lập trình, sau đó bấm sự kiện để thêm vào trình xử lý sự kiện. Trình soạn thảo Script Microsoft bắt đầu với con trỏ nằm ở trình xử lý sự kiện mà bạn đã chọn.

• Thay thế chú thích Write your code here với mã của bạn.

Đầu trang