Ampliar con scripts

Completado

Los sitios web de Power Pages no admiten reglas de negocio del lado del cliente ni procesos JavaScript personalizados que estén disponibles en los formularios basados en modelos.

Listas, Formularios y Formularios de varios pasos incluyen una columna de JavaScript personalizada que permite a los desarrolladores agregar scripts que implementen la funcionalidad requerida cuando se cargue una lista o un formulario específicos.

Captura de pantalla de JavaScript personalizado agregado al formulario en la aplicación Administración de Power Pages

Puede agregar JavaScript personalizado directamente a la página de un sitio web usando el editor de Visual Studio Code. Con la aplicación Administración de Power Pages, también puede incluir el script como parte de una plantilla web; de ese modo, la funcionalidad estará disponible para cualquier página basada en esa plantilla.

La funcionalidad puede ir desde simplemente ocultar controles y reemplazar controles de entrada por equivalentes más intuitivos hasta invocar servicios web externos e implementar escenarios de integración complejos.

Los sitios web de Power Pages incluyen de forma predeterminada la biblioteca jQuery, que hace que la manipulación del contenido y el aspecto de la página sea una tarea razonablemente sencilla.

Controles y columnas

Un formulario predeterminado Póngase en contacto con nosotros crea una fila en la tabla Comentarios en Microsoft Dataverse. Esa fila incluye una columna obligatoria Título que aparece en el formulario con la etiqueta Asunto. Esta columna podría resultar confusa para los visitantes del sitio. No puede usar CSS para ocultar el control, ya que quedaría presente el asterisco rojo que indica que la columna es obligatoria. JavaScript ayuda a que el trabajo de ocultar la columna sea relativamente sencillo. Para establecer esta columna en un valor predefinido y luego ocultarlo, siga estos pasos:

  1. Abra la página Póngase en contacto con nosotros en el estudio de diseño de Power Pages.

  2. Seleccione Editar código y espere a que se abra Visual Studio Code.

  3. Seleccione el archivo Contact us.en-US.customjs.js.

    Importante

    El nombre del archivo incluye el código de idioma, que puede ser diferente en su entorno.

  4. Agregue el siguiente script al archivo:

    $(document).ready
    (
     function()
     {
     $("#title").val('Submitted from contact us form'); // sets the value
     $("#title").closest('tr').hide(); // hide the row containing the column
     }
    );
    

    Nota

    Algunas plantillas de Power Pages usan la tabla Comentarios y la columna Título. Algunas plantillas de Microsoft Dynamics 365 pueden usar una tabla distinta (como Cliente potencial) y una columna diferente (como Asunto). Revise el formulario y la página Póngase en contacto con nosotros que se utilizan en su sitio web y cambie el script si es necesario.

    Captura de pantalla del script agregado al código de origen de la página

  5. Use el método abreviado de teclado Ctrl + S (⌘ + S en Mac) para guardar el archivo.

  6. Cierra la pestaña del navegador con el editor de Visual Studio Code y seleccione Sincronizar en el estudio de diseño para sincronizar los cambios.

  7. Seleccione Versión preliminar > Escritorio.

    Se debería abrir la nueva ventana con el formulario Póngase en contacto con nosotros, con la columna Tema (etiqueta Asunto) oculta.

JavaScript es una forma sencilla de agregar una funcionalidad o un comportamiento adicional a su sitio web de Power Pages. Puede agregarlo directamente a una página o a la configuración de Formulario a través de la aplicación Administración de Power Pages o como parte de una plantilla web, en función de sus necesidades de ámbito. Asimismo, puede usar el script en el formulario para llevar a cabo las siguientes acciones:

  • Implementar reglas de negocio.

  • Agregar dependencias entre elementos, como columnas de opciones dependientes.

  • Llevar a cabo otras validaciones de formulario.

  • Llamar a API web de portales o servicios externos.

Estas opciones son alternativas razonables a las reglas de negocio del lado del cliente y los scripts en formularios basados en modelos.

Para obtener más información, consulte Agregar JavaScript personalizado a un formulario.