Componente de secuencia de comandos de entrada de texto

El componente de entrada de texto solicita al agente que introduzca texto y puede validar el texto. Puede vincular el valor de un componente de entrada de texto a una variable.

  1. Haga clic en el icono de Entrada en la barra de herramientas del componente. 

  2. En el panel de propiedades, use el Marcador de posición cuadro para rellenar previamente el control con un mensaje que le indique al lector qué debe escribir. Las variables nunca almacenan texto de marcador de posición. El texto del marcador de posición es un texto temporal que da instrucciones al agente y se reemplaza automáticamente por la entrada del usuario. Por ejemplo:

    ejemplo-texto-marcador de posición

    Puede rellenar previamente el campo con el valor de una variable. Para hacerlo, seleccione una variable de la lista Valor en las propiedades del componente. El valor se muestra automáticamente al usuario en tiempo de ejecución. El valor de la variable se actualiza automáticamente con el texto que escribe el usuario, sujeto a validación opcional.

  3. Para validar la entrada del usuario, expanda el Común grupo. Luego haga clic en el Validación lista.

    text_input_validation_drop_list2

  4. Escoger Seleccione o Personalizado para seleccionar un método de validación.

    Seleccione le permite elegir un patrón de validación preestablecido. Los preajustes de validación son:

    Correo electrónico La entrada debe ajustarse a la sintaxis de la dirección de correo electrónico.
    Alfabético Permitir solo la entrada alfabética (sin números).
    Alfabético - con espacios Permita solo la entrada alfabética y requiera espacios entre las palabras. Por ejemplo, "frijoles fríos" es aceptable, pero "frijoles_frescos" no lo es.
    Alfabético - con guiones bajos Requiere solo entrada alfabética (sin números) y guiones bajos entre palabras. Por ejemplo, "frijoles_frescos" es aceptable pero "frijoles fríos" no lo es.
    Alfanumérico La entrada de texto debe contener letras y números.
    Alfanumérico: con espacios La entrada de texto debe contener letras y números con palabras separadas por espacios.
    Alfanumérico: con guiones bajos La entrada de texto debe contener letras y números con palabras separadas por guiones bajos.

    Si una validación preempaquetada no es suficiente, puede usar una expresión regular para validar la entrada de texto. Seleccione Personalizado desde el Validación lista. Luego, ingrese una expresión regular en el cuadro de texto. Las expresiones regulares están fuera del alcance de este tema. Pero, suponga, por ejemplo, que desea que el usuario ingrese la frase "perro" en algún lugar dentro de una entrada de texto. Mecanografía perro en la propiedad de validación personalizada, configura una expresión regular simple que acepta perro, perro, perro caliente, mi buen perro Penny u otras combinaciones de caracteres que contienen esa cadena que distingue entre mayúsculas y minúsculas, pero no DOG Doggie, etc.

    Otro ejemplo es ^ [az] + $ para aceptar solo caracteres alfabéticos en minúscula.

    Propina: Internet ofrece muchos recursos para aprender sobre expresiones regulares. Ejemplos son http://www.regular-expressions.info/ y https://en.wikipedia.org/?title=Regular_expression.

    Cuando el foco sale del cuadro de texto, el valor del componente de entrada de texto se valida para garantizar que cumple con la regla de validación seleccionada. Si la entrada del usuario no pasa la validación, los bordes se vuelven rojos para indicar un problema de validación. Puede probar validaciones personalizadas y empaquetadas previamente en el modo de vista previa del editor.

    entrada-entrada-de-texto-inválida

  5. Selecciona el Requiere valor cambie a Sí si el usuario debe escribir un valor en el componente. Esta configuración es No de forma predeterminada, lo que significa que la entrada del usuario es opcional.

  6. Para establecer una acción, haga clic en No se seleccionó ninguna acción debajo Cambiar acción en el grupo de propiedades Avanzado. 

  7. Para seleccionar una acción, haga clic en una fila de la lista. Puede asignar una acción previamente definida o crear una nueva acción.

  8. Cierre la lista Seleccionar acciones. 

  9. Opcionalmente, establezca otras propiedades de este componente. Por ejemplo, puede ajustar el espaciado alrededor de este componente mediante la configuración de márgenes.

    Común

    El valor une un componente a la variable seleccionada. Por ejemplo, si vincula un componente de entrada de texto a una variable, el cuadro de entrada siempre mostrará el valor de esa variable, ignorando cualquier texto de marcador de posición especificado. La variable se actualiza automáticamente con el texto escrito por el usuario, sujeto a un proceso de validación.

    Otros controles, botones de opción, por ejemplo, usan Valor con una configuración de Texto de valor seleccionado. Cuando se selecciona el botón de radio en tiempo de ejecución, su "Texto de valor seleccionado" se convierte en el nuevo valor de la variable. De esta forma, cada botón de opción puede asignar un valor diferente a la misma variable.

    Cuando un control de calendario está vinculado a la variable, su valor se establece en la fecha seleccionada por el control. Dado que las variables pueden preestablecer el valor de los controles visuales y también ser configuradas por ellos, la vinculación es una técnica poderosa y de uso frecuente.

    El texto del marcador de posición muestra una sugerencia para el usuario.

    ejemplo-marcador-de-posición-propiedad

    Para una entrada de texto, el texto de marcador de posición se muestra hasta que el usuario escribe la entrada. Si el usuario borra el contenido de un cuadro de entrada, se vuelve a mostrar el texto del marcador de posición.

    ejemplo-marcador-de-posición-mostrado

    Para un menú desplegable, el texto del marcador de posición solicita al usuario que realice una selección.

    La figura muestra el texto del marcador de posición antes de realizar una selección desde un menú desplegable

    El marcador de posición se reemplaza después de que el usuario selecciona un elemento.

    marcador de posición reemplazado por selección

    Propina: El texto de marcador de posición escrito manualmente se ignora si el componente está vinculado a una variable. Si se selecciona una variable, siempre se muestra su valor.

    La validación asegura que el agente ingresó el texto con el formato adecuado. Cuando el foco deja el entrada de texto , Genesys Cloud prueba el valor del texto para asegurarse de que cumple con la regla de validación seleccionada. Si el texto no pasa la validación, los bordes se vuelven rojos para indicar un problema de validación con el texto.

    Utilice la lista desplegable para seleccionar un método de validación:

    seleccionar un método de validación

    • Seleccione: Le permite seleccionar un patrón de validación preestablecido:

      Correo electrónico La entrada debe ajustarse a la sintaxis de la dirección de correo electrónico.
      Alfabético Permitir solo entrada alfabética (sin números)
      Alfabético - con espacios Permita solo la entrada alfabética y requiera espacios entre las palabras. Por ejemplo, "frijoles fríos" es aceptable pero "frijoles fríos" no.
      Alfabético - con guiones bajos Requiere solo entrada alfabética (sin números) y guiones bajos entre palabras. Por ejemplo, "cool_beans" es aceptable pero "cool beans" no.
      Alfanumérico La entrada de texto debe contener letras y números.
      Alfanumérico: con espacios La entrada de texto debe contener letras y números con palabras separadas por espacios.
      Alfanumérico: con guiones bajos La entrada de texto debe contener letras y números con palabras separadas por guiones bajos.
    • Personalizado: Le permite seleccionar una variable de cadena. Por ejemplo, puede hacer que la variable de cadena sea la expresión regular y luego usar esa variable en varias páginas para mantener la validación igual. Para más información sobre el método de validación personalizado, consulte Componente de script de entrada de texto.

    Determina si el usuario debe escribir o seleccionar un valor. El valor predeterminado es No, lo que significa que la interacción del usuario es opcional.

    La interfaz de usuario indica visualmente si la entrada del usuario es opcional. 

     

    La entrada opcional se indica mediante una etiqueta debajo del componente:

    requiere-valor-falso

    Entrada de texto los cuadros admiten una sola línea de forma predeterminada. Cuando Multiline se establece en No (por defecto), una entrada de texto no ajusta el texto ni se redimensiona verticalmente.

    multilínea-falso

    Cuando Multiline se establece en No, puede borrar cualquier texto que se haya escrito anteriormente haciendo clic en este icono:

    botón de borrar-falso-multilínea

    Si establece Multilínea en Sí, una entrada de texto acepta varias líneas de texto. 

    multilínea-verdadero

    Diseño

    Configura el ancho a un tamaño fijo, para que crezca según sea necesario para mostrar contenido o para consumir tanto espacio como sea posible en relación con otros componentes, utilizando la ponderación para influir en los ajustes de tamaño.

    Configuración Descripción
    ajustes-dimensionamiento-auto-tamaño El tamaño automático configura el componente para que se reduzca o crezca de acuerdo con su contenido. Por ejemplo, el ancho de una etiqueta puede crecer dependiendo de la cantidad de texto que contenga.
    ajustes-dimensionamiento-estiramiento

    El estiramiento permite que un componente consuma tanto espacio como sea posible en relación con otros componentes, utilizando la ponderación para influir en los ajustes de tamaño.

    Si dos componentes están configurados para estirarse, a ambos se les asigna el 50% del espacio restante de forma predeterminada. Esta proporción se puede ajustar cambiando el valor de peso.

    Por ejemplo, si configura un componente con un peso de 200 y el otro con un peso de 100, el primer componente ocupará dos tercios del espacio restante, mientras que el otro solo ocupará un tercio. El primer componente aparece dos veces el tamaño del otro componente, ya que su peso era dos veces el peso del segundo componente.

    configuración-tamaño-píxeles Establece un tamaño fijo en píxeles. Puede escribir un valor entero en el cuadro o usar flechas hacia arriba o hacia abajo para incrementar o disminuir el tamaño. Estas flechas son visibles cuando el componente tiene el foco.

    Configura la altura a un tamaño fijo, para que crezca según sea necesario para mostrar contenido o para consumir tanto espacio como sea posible en relación con otros componentes, utilizando la ponderación para influir en los ajustes de tamaño.

    Configuración Descripción
    ajustes-dimensionamiento-auto-tamaño El tamaño automático configura el componente para que se reduzca o crezca de acuerdo con su contenido.
    configuración-tamaño-píxeles Establece un tamaño fijo en píxeles. Puede escribir un valor entero en el cuadro o usar flechas hacia arriba o hacia abajo para incrementar o disminuir el tamaño. Estas flechas son visibles cuando el componente tiene el foco.
    ajustes-dimensionamiento-estiramiento

    El estiramiento permite que un componente consuma tanto espacio como sea posible en relación con otros componentes, utilizando la ponderación para influir en los ajustes de tamaño.

    Si dos componentes están configurados para estirarse, a ambos se les asigna el 50% del espacio restante de forma predeterminada. Esta proporción se puede ajustar cambiando el valor de peso.

    Por ejemplo, si configura un componente con un peso de 200 y el otro con un peso de 100, el primer componente ocupará dos tercios del espacio restante, mientras que el otro solo ocupará un tercio. El primer componente aparece dos veces el tamaño del otro componente, ya que su peso era dos veces el peso del segundo componente.

    Alinea un componente a la izquierda, a la derecha o al centro, en relación con su contenedor principal.

    Propina: Un componente no se puede alinear verticalmente al centro si la configuración de Altura de su contenedor principal es Tamaño automático. Para corregir esto, establezca la Altura del contenedor principal en Estirarse oa una altura fija en Pixeles.
    Configuración Ejemplo
    align-left2 alinear-izquierda-ejemplo2
    align-center2 alinear-centro-ejemplo2
    align-right2 alinear-derecha-ejemplo2
    alinear-iniciar alinear-inicio-ejemplo
    alinear-centro-vertical alinear-centro-vertical-ejemplo
    alinear-extremo-vertical alinear-vertical-final-ejemplo

    Los márgenes establecen el espaciado izquierdo, derecho, superior e inferior alrededor de un borde.

    La imagen muestra la relación entre los ajustes de margen, borde y relleno.

    1. Para actualizar opcionalmente todos los valores de los márgenes a la vez, presione el Establecer todos botón de Margen en el panel de propiedades.

      imagen del botón configurar todo

    2. Haga clic en el campo de valor para obtener un margen. Aparece un control de giro en ese campo.

    3. Utilice el control de giro para aumentar o disminuir el margen. Si Establecer todos se seleccionó, el cambio se aplica a todos los márgenes.

      settings-margin-spinner

      El componente se reposiciona inmediatamente utilizando su nueva configuración de margen.

    Establece la visibilidad de un componente según el valor de una variable booleana (verdadera o falsa).

    1. Haga clic en el Diseño grupo de propiedad. Debajo de Visible, haga clic en Seleccionar variable.
    2. Seleccione una variable u, opcionalmente, cree una nueva variable Sí / No y luego asigne esa nueva variable a la Visible propiedad.
    3. En tiempo de ejecución, el componente es visible cuando el valor de la variable es Verdadero. Por el contrario, está oculto cuando el valor de la variable es Falso.

    Avanzado

    El valor une un componente a la variable seleccionada. Por ejemplo, si vincula un componente de entrada de texto a una variable, el cuadro de entrada siempre mostrará el valor de esa variable, ignorando cualquier texto de marcador de posición especificado. La variable se actualiza automáticamente con el texto escrito por el usuario, sujeto a un proceso de validación.

    Otros controles, botones de opción, por ejemplo, usan Valor con una configuración de Texto de valor seleccionado. Cuando se selecciona el botón de radio en tiempo de ejecución, su "Texto de valor seleccionado" se convierte en el nuevo valor de la variable. De esta forma, cada botón de opción puede asignar un valor diferente a la misma variable.

    Cuando un control de calendario está vinculado a la variable, su valor se establece en la fecha seleccionada por el control. Dado que las variables pueden preestablecer el valor de los controles visuales y también ser configuradas por ellos, la vinculación es una técnica poderosa y de uso frecuente.

    El texto del marcador de posición muestra una sugerencia para el usuario.

    ejemplo-marcador-de-posición-propiedad

    Para una entrada de texto, el texto de marcador de posición se muestra hasta que el usuario escribe la entrada. Si el usuario borra el contenido de un cuadro de entrada, se vuelve a mostrar el texto del marcador de posición.

    ejemplo-marcador-de-posición-mostrado

    Para un menú desplegable, el texto del marcador de posición solicita al usuario que realice una selección.

    La figura muestra el texto del marcador de posición antes de realizar una selección desde un menú desplegable

    El marcador de posición se reemplaza después de que el usuario selecciona un elemento.

    marcador de posición reemplazado por selección

    Propina: El texto de marcador de posición escrito manualmente se ignora si el componente está vinculado a una variable. Si se selecciona una variable, siempre se muestra su valor.

    Todos los componentes están habilitados de forma predeterminada. La propiedad Disabled vincula una variable Verdadero / Falso a un componente, para deshabilitarlo o habilitarlo en función del valor de tiempo de ejecución de la variable.

      1. Para crear una variable Verdadero / Falso, haga clic en el Variables pestaña.

      2. Hacer clic + para agregar una variable.

        La figura muestra el botón que agrega una nueva variable.

      3. Seleccione Verdadero Falso como el tipo de datos.

        La figura muestra los tipos de datos variables

      4. Escriba un nombre descriptivo en el cuadro Nombre.

        variable actualmente habilitada

      5. Establecer valor predeterminado en Cierto o Falso.

        • Si la variable es True, el componente está deshabilitado.

        • Si la variable es False, el componente está habilitado.

      6. Hacer clic Solicitar para guardar la variable.
      7. Asigne la variable a la propiedad Disabled. Debajo Discapacitado, haga clic en Seleccionar variable.

        establecimiento-propiedad-discapacitados

      8. Seleccione la variable Verdadero / Falso.

        actualmente-habilitado-variable-seleccionado

    Para probar su trabajo, haga clic en Avance.

    La validación asegura que el agente ingresó el texto con el formato adecuado. Cuando el foco deja el entrada de texto , Genesys Cloud prueba el valor del texto para asegurarse de que cumple con la regla de validación seleccionada. Si el texto no pasa la validación, los bordes se vuelven rojos para indicar un problema de validación con el texto.

    Utilice la lista desplegable para seleccionar un método de validación:

    seleccionar un método de validación

    • Seleccione: Le permite seleccionar un patrón de validación preestablecido:

      Correo electrónico La entrada debe ajustarse a la sintaxis de la dirección de correo electrónico.
      Alfabético Permitir solo entrada alfabética (sin números)
      Alfabético - con espacios Permita solo la entrada alfabética y requiera espacios entre las palabras. Por ejemplo, "frijoles fríos" es aceptable pero "frijoles fríos" no.
      Alfabético - con guiones bajos Requiere solo entrada alfabética (sin números) y guiones bajos entre palabras. Por ejemplo, "cool_beans" es aceptable pero "cool beans" no.
      Alfanumérico La entrada de texto debe contener letras y números.
      Alfanumérico: con espacios La entrada de texto debe contener letras y números con palabras separadas por espacios.
      Alfanumérico: con guiones bajos La entrada de texto debe contener letras y números con palabras separadas por guiones bajos.
    • Personalizado: Le permite seleccionar una variable de cadena. Por ejemplo, puede hacer que la variable de cadena sea la expresión regular y luego usar esa variable en varias páginas para mantener la validación igual. Para más información sobre el método de validación personalizado, consulte Componente de script de entrada de texto.

    Determina si el usuario debe escribir o seleccionar un valor. El valor predeterminado es No, lo que significa que la interacción del usuario es opcional.

    La interfaz de usuario indica visualmente si la entrada del usuario es opcional. 

     

    La entrada opcional se indica mediante una etiqueta debajo del componente:

    requiere-valor-falso

    los Cambiar acción La propiedad le permite establecer una acción que se ejecuta cuando se cambia el estado o el valor de este componente.

    Puede seleccionar una acción de Scripter, una Acción de salida o una acción personalizada. Las acciones salientes no están disponibles a menos que la propiedad Saliente esté habilitada. 

    Entrada de texto los cuadros admiten una sola línea de forma predeterminada. Cuando Multiline se establece en No (por defecto), una entrada de texto no ajusta el texto ni se redimensiona verticalmente.

    multilínea-falso

    Cuando Multiline se establece en No, puede borrar cualquier texto que se haya escrito anteriormente haciendo clic en este icono:

    botón de borrar-falso-multilínea

    Si establece Multilínea en Sí, una entrada de texto acepta varias líneas de texto. 

    multilínea-verdadero