Uso de fragmentos de secuencias de comandos

Un fragmento de secuencia de comandos contiene un objeto de secuencia de comandos. Un objeto de secuencias de comandos contiene funciones de JavaScript reutilizables o valores que se almacenan de forma independiente en relación con cualquier otro objeto de formulario, como el analizador de fechas o la invocación de servicios Web. Normalmente, los objetos de secuencias de comandos se utilizan para crear funciones y métodos personalizados que se desean utilizar en diversas ubicaciones del formulario. El uso de objetos de secuencias de comandos reduce la cantidad global de secuencias de comandos necesarias para realizar acciones repetitivas.

Los fragmentos de comando incluyen sólo objetos de secuencias de comandos que aparecen como elementos secundarios de variables en la paleta Jerarquía. Los fragmentos no pueden contener secuencias de comandos que estén asociadas a otros objetos de formulario, como secuencias de comandos de sucesos como validate, calculate o initialize.

Se crea un fragmento de secuencia de comandos desde la paleta Jerarquía.

Los fragmentos de secuencias de comandos se editan del mismo modo que otros fragmentos.

    Propiedades del fragmento de secuencia de comandos

    Cuando selecciona un fragmento de secuencia de comandos, la ficha de objetos de secuencias de comandos, en la paleta Objeto, muestra las propiedades del fragmento.

    Archivo de origen

    Establece el archivo de origen para la referencia de fragmento. Esta propiedad solo se muestra visible cuando el objeto seleccionado es una referencia de fragmento.

    Nombre del fragmento

    Establece el nombre del fragmento. Puede hacer clic en el botón Información de fragmento para ver la información del fragmento.

    Esta propiedad se muestra visible cuando se selecciona una referencia de fragmento o un fragmento definido en un archivo de origen. Cuando el objeto seleccionado es una referencia de fragmento, esta propiedad no aparece si no se especifica el archivo de origen. La lista Nombre del fragmento incluye todos los fragmentos del archivo de origen especificado. La opción Personalizado admite directamente una expresión SOM o un valor ID como referencia de fragmento y admite la implantación en XML Forms Architecture.

      Creación de un fragmento de secuencia de comandos

      Se crea un fragmento de secuencia de comandos de funciones comunes que se puede reutilizar en varios formularios. Para crear un fragmento de secuencia de comandos, se crea un objeto de secuencia de comandos que contiene las funciones que desea reutilizar en varios diseños de formulario. El fragmento de secuencia de comando puede incluir sólo un objeto de secuencia de comandos.

      1. Cree un objeto de secuencia de comandos.

      2. En la paleta Jerarquía, haga clic con el botón derecho del ratón en el objeto de secuencia de comandos y seleccione Fragmentos > Crear fragmento.

        Nota: También puede crear un fragmento de secuencia de comandos arrastrando el objeto de secuencia de comandos de la paleta Jerarquía a la paleta Biblioteca de fragmentos.

      3. Para utilizar un nombre de fragmento diferente en el cuadro Nombre, introduzca un nombre para el fragmento.

      4. (Opcional) En el cuadro Descripción, escriba una descripción del fragmento.

      5. Seleccionar un método para crear el fragmento:

        • Para definir el fragmento en un archivo XDP independiente que se almacene en la Biblioteca de fragmentos, seleccione Crear nuevo fragmento en la biblioteca de fragmentos. En la lista Biblioteca de fragmentos, seleccione la Biblioteca de fragmentos en la que desee guardar el archivo de fragmento. Para utilizar un nombre de archivo diferente en el cuadro Nombre de archivo, introduzca un nombre de archivo para el fragmento. Si no desea reemplazar la selección con el nuevo fragmento, anule la selección de Sustituir selección por referencia a nuevo fragmento de formulario.

        • Para definir el fragmento en el archivo actual, seleccione Crear un nuevo fragmento en el documento actual.

      6. Haga clic en Aceptar.

        Inserción de un fragmento de secuencia de comandos

        Puede utilizar fragmentos de secuencias de comandos para reutilizar funciones de JavaScript en varios formularios. Al crear un diseño de formulario, se inserta una referencia en un fragmento de secuencia de comandos existente y el fragmento se muestra en el diseño de formularios.

        No puede insertar un fragmento en un documento XFAF.

        Nota: Para obtener una vista previa de los fragmentos en la paleta Biblioteca de fragmentos, seleccione Mostrar panel de vista previa en el menú de la paleta.

        Insertar un fragmento de secuencia de comandos desde la paleta Biblioteca de fragmentos:

        1. En la biblioteca de fragmentos, seleccione el fragmento de secuencia de comandos.

        2. Arrastre el fragmento a un subformulario u objeto de variables de la paleta Jerarquía.

        Insertar un fragmento de secuencia de comandos desde el menú Insertar:

        1. Seleccione Insertar > Fragmento.

        2. Vaya al archivo que contiene el fragmento.

        3. Seleccione el archivo y pulse Aceptar. El fragmento se muestra como un elemento secundario del objeto de variables en el subformulario raíz.