Uso y ejemplo

La extensión web Lista de elementos tiene parámetros para su funcionalidad central y parámetros adicionales para personalizar su contenido.

Estos son los parámetros principales:

  • Claves de elementos: Una referencia a un intervalo de celdas que contienen los nombres exclusivos de elementos y acciones para su procesamiento posterior. Cuando se desencadena una acción, Actions.Input.Text envía uno de estos valores:
    • Actions.Input.Text="Row": El elemento está seleccionado.
    • Actions.Input.Text="Edit": Se ha hecho clic en el botón Editar.
    • Actions.Input.Text="Delete": Se ha hecho clic en el botón Eliminar.
  • Datos de elemento: Una referencia a un intervalo de celdas que contiene datos de elementos, o a una celda que contiene XML de los mismos datos. La primera columna del intervalo de datos está reservada para estas propiedades opcionales de claves de elementos:
  • Título (cadena)
  • Descripción 1 (cadena)
  • Descripción 2 (cadena)
  • Marca de tiempo (cadena)
  • Visible (booleano): Si es False, el elemento está oculto. True es la opción predeterminada.
  • Habilitado (booleano): Si es False, el elemento está deshabilitado. True es la opción predeterminada.
  • Seleccionado (booleano): Si es True, el elemento está seleccionado. False es la opción predeterminada.
  • Editar (booleano): Si es True, se muestran los iconos Editar y Eliminar en línea. False es la opción predeterminada.
Estos parámetros adicionales habilitan la personalización del contenido. Especifique ="" para utilizar los valores predeterminados donde estén disponibles.
Nota

Cuando se puede especificar texto, como por ejemplo para el mensaje de error, utilice la función TRANSLATEUNIQUESTRING para asegurarse de que el texto se traduce si se cambia el idioma de la interfaz de usuario.

  • Selección múltiple: Si es True, la selección múltiple está habilitada. False es la opción predeterminada.
  • Marcador de posición del cuadro de búsqueda: De forma predeterminada, el cuadro de búsqueda es visible y está vacío. Especifique False para deshabilitar la casilla de verificación.
  • Mensaje de error: De forma predeterminada, si no hay elementos de lista, el mensaje de error es Ningún elemento disponible.
  • Título principal: El título de la lista. De forma predeterminada, no se muestra ningún título.
  • Color del título principal: El color predeterminado del título es #368ac0.
  • Color del título: El color predeterminado de la fuente del título es #1a1a1a.
  • Color seleccionado: El color en el que se resalta la fila seleccionada. El valor predeterminado es #c8e9f4.
  • Texto de elementos seleccionados: De forma predeterminada, el texto está Seleccionado. Este parámetro solo es aplicable si está habilitada la selección múltiple.
  • Acción Quitar: Defina una acción en una celda, que se desencadena al hacer clic en el botón Quitar. El texto predeterminado es Quitar. Este parámetro solo es aplicable si está habilitada la selección múltiple.
  • Ocultar bordes laterales: Especifique True para ocultar los bordes izquierdo y derecho de la fila. De forma predeterminada, los bordes son visibles.
  • Color de borde: De forma predeterminada, el color de los bordes es #d8d8d8.
  1. Cree un informe de Application Studio.
  2. Inserte estos datos de ejemplo en el intervalo B8:H12:
    Key Título Descripción 1 Descripción 2 Habilitado Seleccionado Editar
    a Elemento A Descripción A FALSE TRUE
    b Elemento B Descripción B Información detallada B FALSE FALSE FALSE
    c Elemento C Descripción C TRUE FALSE
    d Elemento D Descripción D FALSE FALSE
  3. Cree una variable de informe denominada rv_SelectedItem, especifique c como el valor y el valor predeterminado y selecciónelo como su valor. En las propiedades de la variable, especifique False como el valor de la opción Es persistente.
  4. En la celda G9, especifique =ReportVariables.rv_SelectedItem.Text=B9. Copie la fórmula en las celdas G10, G11 y G12.
    Después de esta actualización, las celdas mantienen sus textos originales.
  5. En cada una de las celdas clave (B9, B10, B11 y B12), cree una acción con estas características:
    Acciones: Tipo
    Seleccione Establecer parámetros como el tipo de acción.
    Acciones: Modo
    Seleccione Extensión web como el modo.
    Acciones: Condición
    Especifique =Actions.Input.Text="ROW".
    Nota

    Esta condición no es válida a menos que el modo de acción sea Extensión web.

    Parámetros: Nombre
    Haga clic en Añadir parámetro y seleccione la variable rv_SelectedItem.
    Parámetros: Propiedad
    Especifique Selected Value(.Text).
    Parámetros: Valor
    Para la acción en B9, especifique =B9. Para las demás acciones, especifique =B10, =B11 y =B12, respectivamente.
  6. Cree una variable de informe denominada rv_TitleItemA y especifique Elemento A como su valor. En las propiedades de la variable, especifique Elemento A como el valor predeterminado y seleccione False como el valor de la opción Es persistente.
  7. En la celda C9, especifique =ReportVariables.rv_TitleItemA.Text y pulse Intro.
    Después de esta actualización, la celda mantiene su texto original.
  8. En la celda B9, cree una acción con estas características:
    Acciones: Tipo
    Seleccione Establecer parámetros como el tipo de acción.
    Acciones: Modo
    Seleccione Extensión web como el modo.
    Acciones: Condición
    Especifique =Actions.Input.Text="EDIT"
    Nota

    Esta condición no es válida a menos que el modo de acción sea Extensión web.

    Parámetros: Nombre
    Haga clic en Añadir parámetro y seleccione la variable rv_TitleItemA.
    Parámetros: Propiedad
    Seleccione Value(.Text)
    Parámetros: Valor
    Especifique ="Edited Item A".
  9. En la celda B13, especifique esta fórmula SETPROPERTY: 
    =SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)
  10. Haga clic en Extensión web en la barra de herramientas Objetos y haga doble clic en la extensión web Lista de elementos.
    El cursor cambia a una cruz.
  11. Arrastre el cursor para insertar, dimensionar y colocar la extensión web.
  12. Especifique estos parámetros:
    Nombres exclusivos
    Especifique el intervalo de celdas que contienen los nombres exclusivos de los elementos de lista. En este ejemplo, especifique =B9:B12.
    Datos de elemento
    Especifique el intervalo de celdas que define la tabla de datos para la extensión. En este ejemplo, especifique =B13.
  13. Si lo desea, especifique valores para estos parámetros o especifique ="" para utilizar los valores predeterminados.
    Título principal
    De forma predeterminada, la lista no tiene título. Si lo desea, especifique un título.
    Color de fuente del título principal
    Si se especifica un título principal, su color predeterminado es azul (#368ac0). Si lo desea, especifique un valor de color diferente.
    Marcador de posición del cuadro de búsqueda
    De forma predeterminada, el cuadro de búsqueda está vacío. Si lo desea, especifique el texto que desea mostrar en el cuadro. Para ocultar el cuadro de búsqueda, especifique FALSE (distingue entre mayúsculas y minúsculas).
    Mensaje de error
    De forma predeterminada, no se muestra ningún error si no hay elementos disponibles. Si lo desea, especifique un mensaje de error. Utilice TRANSLATESTRING para facilitar la traducción del error si se cambia el idioma de la interfaz de usuario.
    Color de fuente del título
    De forma predeterminada, el título de los elementos de lista es gris oscuro (#1a1a1a). Si lo desea, especifique un valor de color diferente
    Color seleccionado
    Especifique el color en el que se resalta el elemento de lista seleccionado. El valor predeterminado es azul claro (#c8e9f4). Si lo desea, especifique un valor de color diferente.
    Selección múltiple
    De forma predeterminada, solo puede seleccionar elementos individuales. Para habilitar casillas de verificación para la selección de varios elementos, especifique =”TRUE”.
    Ocultar bordes laterales
    De forma predeterminada, cada fila tiene un borde izquierdo y un borde derecho. Especifique “=TRUE” para ocultar estos bordes.
    Color de borde
    De forma predeterminada, los bordes superior y lateral de la lista son gris claro (#d8d8d8). Si lo desea, especifique un valor de color diferente.
    Texto de elementos seleccionados
    Si la selección múltiple está habilitada, se indica el número de elementos seleccionados, seguido de Seleccionado. Si lo desea, especifique un texto diferente. Utilice TRANSLATESTRINGUNIQUE para facilitar la traducción del texto si se cambia el idioma de la interfaz de usuario.
    Botón Quitar de barra de acciones

    Si la selección múltiple está habilitada, puede mostrar un botón Quitar para anular la selección de los elementos seleccionados. Especifique la referencia de una celda que contiene la palabra Quitar.

    Utilice TRANSLATESTRING para facilitar la traducción del botón si se cambia el idioma de la interfaz de usuario.