Personalizar una plantilla de formulario mediante una secuencia de comandos

En este artículo

• Información general

• Consideraciones de compatibilidad

• Establecer el lenguaje de secuencias de comandos para una plantilla de formulario

• Mostrar un mensaje cada vez que se produce un evento

• Agregar una secuencia de comandos que se ejecuta cuando el usuario guarda los datos del formulario

• Agregar una secuencia de comandos que se ejecuta cuando un usuario envía los datos del formulario

• Agregar una secuencia de comandos que se ejecuta cuando el usuario hace clic en un botón

• Agregar una secuencia de comandos que se ejecuta cuando se combinan formularios existentes

• Agregar una secuencia de comandos para actualizar los formularios existentes

• Agregar una secuencia de comandos para otros eventos

Información general

Puede personalizar la plantilla de formulario de InfoPath usando reglas, fórmulas, validación de datos y formato condicional. Aunque estas características son muy flexibles y pueden controlar una amplia variedad de tareas, algunas tareas están más allá de las capacidades de estas características. Por ejemplo, no puede usar reglas para enviar un mensaje de correo electrónico cuando un usuario escribe un valor en un cuadro de texto en un formulario. Si necesita personalizar la plantilla de formulario de manera que sea más allá de las capacidades de estas características y está familiarizado con las secuencias de comandos mediante el lenguaje de secuencias de comandos JScript o VBScript, puede agregar una secuencia de comandos que se ejecuta cuando un usuario abre un formulario nuevo o modifica un ex formulario de istente que se basa en la plantilla de formulario.

Cuando agrega una secuencia de comandos para una plantilla de formulario, InfoPath inicia Microsoft Script Editor (MSE), que permite agregar, editar y depurar secuencias de comandos en una plantilla de formulario y coloca el cursor en el evento elegido. InfoPath agrega automáticamente un controlador de eventos a la secuencia de comandos. Un controlador de eventos es el código de función en una plantilla de formulario de InfoPath que responde a una acción del usuario o un cambio en los datos XML en un formulario. Por ejemplo, si desea que los usuarios guarden sus formularios en diversas ubicaciones de red, puede agregar una secuencia de comandos para el controlador de eventos OnSaveRequest . Cuando agrega una secuencia de comandos para que se ejecute cuando el usuario guarda un formulario basado en la plantilla de formulario, InfoPath inicia el editor de secuencias de comandos y agrega uno de los siguientes códigos en el script.

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

Consideraciones de compatibilidad

No puede agregar comandos a un plantilla de formulario compatible con el explorador. Puede agregar script solo a una plantilla de formulario cuyos formularios se rellenarán en InfoPath. Puede personalizar una plantilla de formulario compatible con el explorador mediante código administrado.

Volver al principio

Establecer el lenguaje de secuencias de comandos para una plantilla de formulario

Para personalizar una plantilla de formulario usando secuencias de comandos, puede usar Microsoft JScript o Microsoft Visual Basic Scripting Edition (VBScript). De forma predeterminada, InfoPath está configurado para agregar el script mediante JScript. Si la plantilla de formulario no contiene secuencias de comandos o código administrado, y prefiere usar VBScript como el lenguaje de secuencias de comandos, puede cambiar el lenguaje de secuencias de comandos para la plantilla de formulario a VBScript. No puede utilizar ambos lenguajes de secuencias de comandos en la misma plantilla de formulario.

Si la plantilla de formulario ya contiene secuencia de comandos en un idioma y desea utilizar el otro idioma, debe guardar la secuencia de comandos existente para que se puede convertir el script en el otro idioma, quitar la secuencia de comandos de la plantilla de formulario a través de las Opciones de formulario diálogo cuadro y, a continuación, agregue la secuencia de comandos convertida a la plantilla de formulario. InfoPath no puede convertir las secuencias de comandos a un nuevo lenguaje de secuencias de comandos. Cambiar el idioma de secuencia de comandos en el cuadro de diálogo Opciones de formulario solo afecta a esta plantilla de formulario. Otras plantillas de formulario tendrán JScript como lenguaje de secuencias de comandos predeterminado.

1. En el menú Herramientas, haga clic en Opciones de formulario.

2. En la lista categoría, en el cuadro de diálogo Opciones de formulario, haga clic en programación.

3. En la lista lenguaje del código de plantilla de formulario, en el lenguaje de programación, haga clic en VBScript.

   Notas: 

   • Después de establecer el lenguaje de secuencias de comandos y crear uno o varios controladores de eventos para una plantilla de formulario, no puede cambiar el lenguaje de la plantilla de formulario.

   • Si ha instalado Microsoft Visual Studio 2005 Tools para aplicaciones, el idioma predeterminado es Microsoft Visual Basic .NET. Aún puede usar este procedimiento para cambiar el idioma de scripting VBScript.

Volver al principio

Mostrar un mensaje cada vez que se produce un evento

Si desea saber qué controladores de eventos que se ejecutan en respuesta a una acción u otro evento, puede agregar código temporal para mostrar un cuadro de mensaje siempre que se ejecuta el controlador de eventos. Debe utilizar este código para determinar cuándo se ejecuta un controlador de eventos. Después de agregar este código, puede usar la vista previa para ver un formulario basado en esta plantilla de formulario o para publicar la plantilla de formulario y, a continuación, crear una nueva plantilla de formulario. Algunos controladores de eventos sólo se ejecutan al crear un formulario después de publicar la plantilla de formulario. A continuación, puede realizar una acción que cree podría ejecutar el controlador de eventos. Cuando se ejecuta el controlador de eventos, verá un cuadro de mensaje.

Después de determinar qué acciones o eventos ejecutan el controlador de eventos, quite el código y reanude el diseño de la plantilla de formulario. Si no quita este código y, a continuación, publicar la plantilla de formulario, los usuarios verán este cuadro de mensaje cuando se ejecuta el controlador de eventos.

1. Agregue el controlador de eventos.

2. Para agregar código en JScript, escriba XDocument.UI.Alert ("el evento nombre acaba de ejecutar"); Reemplazar por el nombre del controlador de eventos. Por ejemplo, si agrega este código al controlador de eventos OnValidate , podría escribir XDocument.UI.Alert ("el OnValidate solo ha encontrado el controlador de eventos");

3. Para agregar código en VBScript, escriba XDocument.UI.Alert ("el evento nombre acaba de ejecutar") , por ejemplo, si agrega este código al controlador de eventos OnSaveRequest , podría escribir XDocument.UI.Alert ("el OnSaveRequest solo ha encontrado el controlador de eventos")

4. Para probar el código, haga clic en vista previa en el menú archivo, o presione CTRL + MAYÚS + B y, a continuación, realice una acción del usuario que puede iniciar el evento. Cuando se produce el evento con la línea de código, un cuadro de mensaje debe mostrar el mensaje.

   Nota: Algunos eventos requieren publicar la plantilla de formulario y, a continuación, crear un formulario basado en esta plantilla de formulario antes de realizar una acción del usuario para iniciar el evento.

5. Antes de publicar la plantilla de formulario y permitir a los usuarios a rellenar formularios basados en esta plantilla de formulario, elimine el código que ha usado para mostrar el cuadro de mensaje.

Volver al principio

Agregar una secuencia de comandos que se ejecuta cuando el usuario guarda los datos del formulario

1. En el menú Herramientas, haga clic en Opciones de formulario.

2. En la lista categoría, en el cuadro de diálogo Opciones de formulario, haga clic en Abrir y guardar.

3. En Guardar comportamiento, active la casilla de verificación Guardar usando código personalizado y, a continuación, haga clic en Editar. Microsoft Script Editor comienza con el cursor en el controlador de eventos 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. Siga uno de los siguientes procedimientos o ambos:

   • Para agregar una secuencia de comandos que se ejecuta antes de que InfoPath guarde el formulario, reemplace el comentario Write the code to be run before saving here.por el código.

   • Para agregar una secuencia de comandos que se ejecuta después de que InfoPath guarde el formulario, reemplace el comentario Write the code to be run after saving here. por el código.

5. Para probar sus cambios, haga clic en Vista previa en la barra Estándar, o presione CTRL+MAYÚS+B.

   Nota: Si el controlador de eventos se ejecuta sólo después de crear un formulario basado en la plantilla de formulario, publicar la plantilla de formulario haciendo clic en Publicar en el menú archivo y, a continuación, complete el Asistente para la publicación. Después de publicar la plantilla de formulario, cree un formulario y, a continuación, realice una acción para ejecutar el controlador de eventos.

Volver al principio

Agregar una secuencia de comandos que se ejecuta cuando un usuario envía los datos del formulario

1. En el menú Herramientas, haga clic en Opciones de envío.

2. En el cuadro de diálogo Opciones de envío, seleccione la casilla de verificación Permitir a los usuarios enviar este formulario.

3. Haga clic en realizar una acción personalizada utilizando código y, a continuación, haga clic en Editar código. Microsoft Script Editor comienza con el cursor en el controlador de eventos 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. Reemplace el comentario If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here por el código.

5. Para probar sus cambios, haga clic en Vista previa en la barra Estándar, o presione CTRL+MAYÚS+B.

Volver al principio

Agregar una secuencia de comandos que se ejecuta cuando el usuario hace clic en un botón

1. Agregar un nuevo botón a una vista en la plantilla de formulario y, a continuación, haga doble clic en el botón.

   Nota: Si va a agregar comandos a un botón existente, haga doble clic en su lugar en el botón existente.

2. Haga clic en la pestaña General.

3. Haga clic en Editar código del formulario. El Editor de secuencias de comandos de Microsoft comienza con el cursor en el controlador de eventos OnClick para el botón.

   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. Reemplace el comentario Write your code here por el código.

5. Para probar sus cambios, haga clic en Vista previa en la barra Estándar, o presione CTRL+MAYÚS+B.

Volver al principio

Agregar una secuencia de comandos que se ejecuta cuando se combinan formularios existentes

1. En el menú Herramientas, haga clic en Opciones de formulario.

2. En la lista categoría, en el cuadro de diálogo Opciones de formulario, haga clic en Avanzadas.

3. En Combinar formularios, active la casilla de verificación Habilitar la combinación de formularios.

4. Active la casilla de verificación Combinar usando código personalizado y, a continuación, haga clic en Editar. Microsoft Script Editor comienza con el cursor en el controlador de eventos 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. Reemplace el comentario Write the code that handles each form being merged here. por el código.

6. Para probar el código en este caso, publicar la plantilla de formulario, cree varios formularios basados en esta plantilla de formulario y, posteriormente, combinar las plantillas de formulario.

   Nota: Buscar vínculos a más información acerca de cómo publicar la plantilla de formulario en la sección Vea también.

Volver al principio

Agregar una secuencia de comandos para actualizar los formularios existentes

Si actualiza una plantilla de formulario publicada anteriormente y que desea actualizar los formularios existentes basados en esa plantilla de formulario, puede agregar comandos a la plantilla de formulario actualizada que se ejecute cuando un usuario abre uno de los formularios existentes. Cuando un usuario abre un formulario existente, InfoPath comprueba el número de versión de su plantilla de formulario asociada en la ubicación de publicación. Si el número de versión de la plantilla de formulario en la ubicación de publicación es más reciente que el número de versión del formulario existente, que indica que se ha actualizado, InfoPath ejecuta el código de este evento para actualizar el formulario existente.

1. En el menú Herramientas, haga clic en Opciones de formulario.

2. En la lista categoría, en el cuadro de diálogo Opciones de formulario, haga clic en control de versiones.

3. En la lista al actualizar la versión, haga clic en Utilizar evento personalizado y, a continuación, haga clic en Editar. Microsoft Script Editor comienza con el cursor en el controlador de eventos 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. Reemplace el comentario Write your code here por el código.

5. Para probar el código de este evento, publique la plantilla de formulario, cree varios formularios basados en esta plantilla de formulario, modificar y publicar una versión actualizada de la plantilla de formulario y, a continuación, abra un formulario existente en función de la versión anterior de esta plantilla de formulario.

   Nota: Buscar vínculos a más información acerca de cómo publicar la plantilla de formulario en la sección Vea también.

Volver al principio

Agregar una secuencia de comandos para otros eventos

Este procedimiento se puede utilizar para agregar los siguientes controladores de eventos a la plantilla de formulario:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• En el menú Herramientas, elija programación y, a continuación, haga clic en el evento para agregarlo al controlador de eventos. El Editor de secuencias de comandos de Microsoft comienza con el cursor en el controlador de eventos que haya seleccionado.

• Reemplace el comentario Write your code here por el código.

Volver al principio