6-2. Añadir búsqueda de acreedores

Volver a

Pasos de esta fase

  1. Crear plantillas de nombre
  2. Añadir búsqueda de acreedores
  3. Añadir un servicio web de validación de dirección
  4. Crear una tabla seleccionable de los resultados de búsqueda

En este paso añadiremos una función de búsqueda eficaz para permitir que los usuarios de formularios busquen acreedores antes de crear una solicitud de un acreedor nuevo. Resumen del proceso:

  1. Cree una función en Winshuttle Query que busque acreedores.
  2. Cree un grupo de búsqueda de acreedores y los campos asociados en el formulario.
  3. Importe el script de Winshuttle Query a Composer y configúrelo.
  4. Añada un elemento de casilla al formulario de Composer que invocará la búsqueda.
  5. Configure una o varias reglas que gestionen el comportamiento de la casilla de búsqueda.

En esta página

  1. Crear el script de búsqueda de acreedores en Query
  2. Crear la sección de búsqueda de acreedores del formulario
  3. Importar el script de búsqueda de acreedores
  4. Configurar los campos de búsqueda de acreedores
  5. Añadir un servicio web para la búsqueda
  6. Añadir un botón de búsqueda de acreedores
  7. Añadir una regla que cambie de minúsculas a mayúsculas
  8. Probar la función de búsqueda

Recursos adicionales

Ayuda de Query

Crear el script de búsqueda de acreedores en Query

Volver al principio

Cree la función de búsqueda mediante Winshuttle Query. La captura de pantalla (derecha) muestra los campos de salida.

Tenga en cuenta que la casilla de la columna Selección está marcada para los campos de códigos de correspondencia (matchcode).

  • Matchcode 1 (MCOD1) = nombre
  • Matchcode 3 (MCOD3) = ciudad

 

Pruebe la búsqueda en Winshuttle Query.

Aquí buscamos el término «Acme» y la consulta devuelve los resultados correctamente.

 

Asigne los campos a Salida a XML y guarde el archivo como Vendor Lookup.qsq.

 

Crear la sección de búsqueda de acreedores del formulario

Volver al principio

En este paso crearemos un grupo de campos de formulario para usar en la información de Búsqueda de acreedores. El resultado final debería tener este aspecto cuando hayamos terminado:

Crear el grupo Buscar acreedores existentes

  1. En Composer, haga clic en la pestaña Formulario.

  2. Haga clic en la pestaña Originador.

  3. En la cinta, haga clic en Nuevo grupo.

  4. En el panel Propiedades, haga clic en Elementos.
  5. En Elementos básicos, haga clic en Cuadro de texto dos veces para crear dos cuadros de texto.
  6. En el panel Propiedades, en Elementos de contenedor, haga clic en Tabla de repetición.
  7. En el cuadro de diálogo Nueva tabla de repetición, en Número de columnas, escriba 4 y haga clic en Aceptar.

    En este punto, el grupo añadido recientemente debe tener este aspecto:

    En los pasos restantes, daremos formato al grupo nuevo y cambiaremos el nombre de sus elementos.

  8. Haga clic en Etiqueta de grupo, en el texto del marcador de posición y, a continuación, sustitúyalo por Buscar acreedores existentes.

    Opcional: Destaque el texto Buscar acreedores existentes y haga que sea más fácil de ver. En la cinta de Composer, haga clic en el icono Aumentar fuente (Gráfico de icono Aumentar fuente de Composer) dos veces.

  9. Debajo de Buscar acreedores existentes, haga clic en Etiqueta (haga clic para editar) y sustituya el texto por Nombre del acreedor, como se muestra a continuación.

  10. En Buscar acreedores existentes, haga clic en Etiqueta (haga clic para editar) y sustituya el texto por Nombre de la ciudad, como se muestra a continuación.

  11. En la tabla de repetición, cambie el nombre de cada uno de los encabezados como se describe a continuación:

    Encabezado 1: Haga clic y cambie el nombre por Nombre del acreedor.

    Sugerencia: Puede pulsar la tecla Tab para ir al siguiente encabezado y cambiarle el nombre.

    Encabezado 2: Cambie el nombre por Ciudad

    Encabezado 3: Cambie el nombre por País

    Encabezado 4: Cambie el nombre por Número de cuenta

    Como es el último paso, moveremos la sección Búsqueda de acreedores sobre el grupo Información básica de acreedor.

  12. Haga clic con el botón secundario en el grupo Buscar acreedores existentes y, a continuación, haga clic en Subir. Repita este paso hasta que el grupo Buscar acreedores existentes esté debajo del grupo Información del solicitante.

El resultado final debería tener este aspecto:

Importar el script de búsqueda de acreedores

Volver al principio

  1. En Composer, haga clic en la pestaña Solución.

  2. En el panel Solución, haga clic con el botón secundario en Scripts de Query y, a continuación, haga clic en Importar.

  3. Haga clic en Elegir archivo y vaya a la carpeta del archivo Vendor Lookup.qsq.
  4. Haga clic en Abrir y, a continuación, en Siguiente.
  5. En el cuadro de diálogo Confirmar, haga clic en Sí.
  6. En la pantalla Asignación de campos, establezca las propiedades siguientes (deje las que no se muestran con sus valores predeterminados):
    • Descripción: VendorLookup
    • Nombre de grupo: Búsqueda
    • Nombre de asignación: Búsqueda de acreedores
    • Conexión: Utilizar la cuenta de Windows conectada

     

  7. Haga clic en Generar.
  8. Debería ver una pantalla Asignación de campos similar a la que se muestra a continuación. Haga clic en Aceptar.

    En la pantalla Parámetro de asignación de campos, haga clic en Generar campos de formulario y, a continuación, en Aceptar. Captura de pantalla de importación de script y generación de campo de formulario de Composer

  9. Haga clic en Aceptar para terminar.

Configurar los campos de búsqueda de acreedores

Volver al principio

Ahora configuraremos las uniones de campos de entrada y salida para nuestra función Búsqueda de acreedores.

  1. Haga clic en la pestaña Formulario.

  2. En el grupo Buscar acreedores existentes, haga clic en el campo Nombre del acreedor.
  3. En el panel Propiedades, junto a Enlace, haga clic en la flecha y seleccione LikeOP en la lista.

  4. En el grupo Buscar acreedores existentes, haga clic en el campo Nombre de la ciudad.
  5. En el panel Propiedades, junto a Enlace, haga clic en la flecha y seleccione LikeOP_1 en la lista.

    Ahora conectaremos los campos Tabla de repetición con la salida generada por la consulta de búsqueda de acreedores.

  6. En el grupo Buscar acreedores existentes, haga clic en el campo Nombre del acreedor.
  7. En el panel Propiedades, junto a Enlace, haga clic en la flecha y seleccione LFA1_Name_1 en la lista.

  8. En el grupo Buscar acreedores existentes, haga clic en el campo Ciudad.
  9. En el panel Propiedades, junto a Enlace, haga clic en la flecha y seleccione LFA1_City en la lista.

  10. En el grupo Buscar acreedores existentes, haga clic en el campo País.
  11. En el panel Propiedades, junto a Enlace, haga clic en la flecha y seleccione LFA1_País_Clave en la lista.

  12. En el grupo Buscar acreedores existentes, haga clic en el campo Número de cuenta.
  13. En el panel Propiedades, junto a Enlace, haga clic en la flecha y seleccione LFA_Número_de_cuenta_de_proveedor_o_acreedor en la lista.

Añadir un servicio web para la búsqueda

Volver al principio

Para activar la función Búsqueda de acreedores en nuestro formulario, debemos añadirle un elemento de servicio web.

Este servicio web es la consulta de búsqueda de acreedores que hemos importado a la solución anteriormente en esta sección. Ahora debemos añadir un servicio web y conectarlo a la consulta. En los pasos siguientes crearemos un botón que active este servicio web.

diagram-button-webservice-query-output

Para añadir y configurar el servicio web:

  1. En Composer, haga clic en la pestaña Formulario.

  2. En el panel Propiedades, haga clic en Elementos.

  3. Haga clic en Elementos avanzados y, a continuación, en Servicio web.

  4. En la pestaña Vista, haga clic en el elemento WebService.

  5. In the Properties pane, set the following properties for the Web Service element:
    • Name: (Optional) Type a name for the service (such as SAPWebService-VendorLookup), or you can leave the default name.
    • Web Service: Click the arrow, and then select Vendor Lookup from the list.
    • Invoked by Rule: Check the box.

Añadir un botón de búsqueda de acreedores

Volver al principio

Ahora añadiremos un botón al formulario que invoque la función Búsqueda de acreedores.

  1. Haga clic en la pestaña Formulario.

  2. Haga clic en el grupo Buscar acreedores existentes.
  3. En el panel Propiedades, haga clic en Elementos.

  4. En el panel Propiedades, haga clic en Elementos básicos y, a continuación, en Botón.

  5. En el lienzo Formulario, en el grupo Buscar acreedores existentes, haga clic en el elemento de botón que ha insertado.

  6. En el panel Propiedades, configure las propiedades siguientes:
    • Nombre: Buscar_acreedores
    • Etiqueta: Buscar acreedores
    • Comportamiento del botón: Haga clic en la flecha y seleccione Personalizar en la lista. (De este modo mostrará la opción Reglas como se indica a continuación).

  7. Junto a Reglas, haga clic en el botón Opciones. [...].
  8. Haga clic en Añadir y, a continuación, en Asistente de reglas.
  9. En la pantalla Crear regla, establezca las propiedades siguientes:
    • Etiqueta: Escriba un nombre (por ejemplo, CallWebService) para la regla.
    • Tipo: Haga clic en la flecha y seleccione Acciones en la lista.
  10. Haga clic en Añadir.

  11. En la pantalla Añadir acción de regla, establezca las propiedades siguientes:
    • Acción: Haga clic en la flecha y seleccione Ejecutar servicio web en la lista.
    • Control del servicio web: Haga clic en la flecha y seleccione VendorLookup en la lista.

    Sugerencia: El nombre del control del servicio web que seleccione aquí debe ser el mismo que el que se creó al importar el script de búsqueda de acreedores (en caso de que sea diferente de nuestras pantallas o pasos de muestra).

  12. Haga clic en Aceptar.
  13. En la pantalla Crear regla, haga clic en Aceptar.

  14. En la pantalla Editor de reglas, haga clic en Aceptar.

Añadir una regla que cambie de minúsculas a mayúsculas

Volver al principio

El campo Búsqueda de nombres de acreedores debe estar en mayúsculas para SAP. Para ello, añadiremos una regla o fórmula con la que cambiar los valores de minúsculas a mayúsculas.

  1. Haga clic en la pestaña Formulario.

  2. En el lienzo Formulario, haga clic en el campo Nombre del acreedor.

  3. En el panel Propiedades, junto a Reglas, haga clic en el botón Opciones [...].

  4. En la pantalla Editor de reglas, haga clic en Añadir y, a continuación, en Asistente de reglas.
  5. En la pantalla Crear regla, establezca las propiedades siguientes:
    • Etiqueta: Escriba un nombre (por ejemplo, MakeUpperCase) para la regla.
    • Tipo: Haga clic en la flecha y seleccione Acciones en la lista.
  6. Haga clic en Añadir.

  7. En la pantalla Añadir acción de regla, establezca las propiedades siguientes:
    • Acción: Haga clic en la flecha y seleccione Establecer un valor de campo en la lista.
    • Campo: Haga clic en la flecha y seleccione el nombre del campo al que está enlazado el campo Buscar acreedor. En este tutorial, el campo Buscar acreedor se ha enlazado al campo LikeOp, configurado en el paso Configurar campos de búsqueda de acreedores.

  8. Haga clic en el botón Función F(x)
  9. En la pantalla Insertar fórmula, haga clic en Insertar función.

  10. En la pantalla Insertar función, en Funciones, haga clic en la flecha y seleccione toUppercase en la lista.

  11. Haga clic en Aceptar.
  12. En la pantalla Insertar fórmula, haga clic en la fórmula y, a continuación, seleccione y elimine la palabra texto.

  13. Con el cursor entre (), haga clic en Insertar valor de campo.
  14. En la pantalla Seleccionar un campo, amplíe Búsqueda, Lookup_Input y, a continuación, haga clic en LFA1_SEARCH_TERM_FOR_MATCHCODE.

    Lo que estamos haciendo es añadir una fórmula que actúe sobre el campo Búsqueda de acreedores y convierta la entrada en mayúsculas después de que el usuario introduzca los datos.

  15. El resultado final debería tener este aspecto:

  16. Haga clic en Aceptar.

  17. Haga clic en Aceptar.

  18. Haga clic en Aceptar.
  19. Haga clic en Aceptar para terminar.

Probar la función de búsqueda

Volver al principio

Ahora deberíamos tener una función de búsqueda totalmente funcional integrada en el formulario. Publique la solución en su entorno de desarrollo y pruebe la función de búsqueda para asegurarse de que funcione.