Scripts de Query en Studio - Automate_Studio - Latest

Guía del complemento Hojas de cálculo de Google de Automate Studio con Evolve y Studio Manager
Product type
Software
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Studio
Version
Latest
ft:locale
es-ES
Product name
Automate Studio
ft:title
Guía del complemento Hojas de cálculo de Google de Automate Studio con Evolve y Studio Manager
Copyright
2026
First publish date
2025
ft:lastEdition
2026-06-19
ft:lastPublication
2026-06-19T08:27:08.665000
L1_Product_Gateway
Integrate
L2_Product_Segment
Data Integration
L3_Product_Brand
Precisely Automate
L4_Investment_Segment
SAP Automation
L5_Product_Group
Winshuttle Enterprise
L6_Product_Name
Automate Studio

Crear un script de consulta mediante el tipo de datos de Hojas de cálculo de Google

Puede crear consultas con tablas, InfoSets, tablas de bases de datos lógicas, o desde la grabación de transacciones.

Crear consulta mediante tablas

  1. Haga clic en la pestaña Archivo y, a continuación, en Nuevo.
  2. Haga clic en Consulta.
  3. En Elegir un método de creación, haga clic en Crear desde tablas.
  4. En la pantalla de inicio de Studio, realice una de las siguientes acciones:
    • Seleccione el sistema SAP, introduzca el Nombre de usuario y la Contraseña y haga clic en Iniciar sesión en SAP. OR
    • Haga clic en Inicio de sesión en SAP avanzado. En el cuadro Inicio de sesión en SAP, elija el sistema SAP y, a continuación, escriba el nombre de usuario y la contraseña. El cliente está rellenado previamente.

    Para guardar las credenciales para futuras sesiones, marque la casilla Guardar como credenciales de inicio de sesión automático y haga clic en el cuadro Guardar credenciales de inicio de sesión automático. La próxima vez que inicie sesión en SAP desde Studio, verá su Nombre de conexión en la opción Inicio de sesión automático y sus otras credenciales. Debe seleccionar el Nombre de conexión.

  5. Haga clic en Aceptar.
  6. En la página Instrucciones para crear una consulta a partir de tablas, seleccione Hojas de cálculo de Google como Tipo de datos y haga clic en Crear script.
  7. En la pestaña Área de trabajo de Studio Query tiene diferentes formas de añadir tablas:
    • En el cuadro Agregar rápidamente, escriba el nombre de la tabla y haga clic en Añadir al área de trabajo o pulse Entrar.

      Para añadir varias tablas, escriba los nombres separados por comas o espacios. Por ejemplo: MARA MAKT MARC o MARA,MAKT,MARC.

    • En el cuadro Buscar tablas, escriba parte del nombre o de la descripción de la tabla y un comodín, como, por ejemplo, mat*l. Utilice las opciones en la lista desplegable para restringir la búsqueda.

      A continuación, haga clic en Buscar y, después, en el botón Añadir tabla al área de trabajo del panel Resultados de la búsqueda.

      Nota: Para ver qué campos están en la tabla antes de añadir más, haga clic en el botón Inspeccionar tabla que está junto al botón Añadir tabla al área de trabajo.
    • Haga clic en la lista desplegable que está en la parte superior del panel, a continuación, haga clic en Diccionario de datos, navegue a la tabla que desee y arrástrela al área de trabajo.

    Las tablas en el área de trabajo están conectadas por combinaciones internas.

    Si solo está usando una tabla, puede añadirla de nuevo y unirla a sí misma. Si tiene tablas que no están conectadas por combinaciones, puede añadir las combinaciones manualmente o buscar una tabla intermedia para conectar las demás tablas.

  8. Marque la casilla Salida para cada campo del que desee descargar datos de SAP.
    Nota: Si a un campo de entrada se le ha aplicado un exit de conversión, no se devolverá ningún dato. (El exit de conversión se admite en el nivel de campo. Esto le permite utilizar operaciones de formato como los rellenos de ceros.)
  9. Marque la casilla Criterios para cada campo que desee usar para definir el conjunto de datos que esté descargando.

    Por ejemplo, si desea que Query devuelva datos de material basados en un rango de números de material, marque la casilla de criterios para el campo MARA.MATNR.

    El siguiente paso es Definir criterios.

Crear consulta mediante InfoSets

  1. Haga clic en la pestaña Archivo y, a continuación, en Nuevo.
  2. Haga clic en Consulta.
  3. En Elegir un método de creación, haga clic en Crear desde InfoSet.
  4. En la pantalla de inicio de Studio, realice una de las siguientes acciones:
    • Seleccione el sistema SAP, introduzca el Nombre de usuario y la Contraseña y haga clic en Iniciar sesión en SAP. OR
    • Haga clic en Inicio de sesión en SAP avanzado. En el cuadro Inicio de sesión en SAP, elija el sistema SAP y, a continuación, escriba el nombre de usuario y la contraseña. El cliente está rellenado previamente.

    Para guardar las credenciales para futuras sesiones, marque la casilla Guardar como credenciales de inicio de sesión automático y haga clic en el cuadro Guardar credenciales de inicio de sesión automático. La próxima vez que inicie sesión en SAP desde Studio, verá su Nombre de conexión en la opción Inicio de sesión automático y sus otras credenciales. Debe seleccionar el Nombre de conexión.

  5. Haga clic en Aceptar.
  6. En la página Instrucciones para crear una consulta a partir de un InfoSet o una consulta de SAP, seleccione Hojas de cálculo de Google como Tipo de datos y haga clic en Crear script.
  7. Haga clic en Área global (todos los clientes que haya en el sistema SAP) o Área estándar (solo el cliente que esté usando).
  8. Haga clic en InfoSets de SAP o Consultas de SAP
  9. Busque el InfoSet o la consulta de SAP, o bien haga clic en Buscar InfoSet/Consulta, haga clic en Diccionario de datos y haga doble clic en el InfoSet que desee.
  10. Marque la casilla Salida para cada campo del que desee descargar datos de SAP.
  11. Marque la casilla Criterios para cada campo adicional que desee usar para restringir la consulta.
    Nota: Puede seleccionar campos de criterios adicionales en InfoSets. Las consultas de SAP solo pueden usar los campos de criterios predefinidos.

El siguiente paso es Definir criterios.

Crear consulta mediante bases de datos lógicas

  1. Haga clic en la pestaña Archivo y, a continuación, en Nuevo.
  2. Haga clic en Consulta.
  3. En Elegir un método de creación, haga clic en Crear desde base de datos lógica.
  4. En la pantalla de inicio de Studio, realice una de las siguientes acciones:
    • Seleccione el sistema SAP, introduzca el Nombre de usuario y la Contraseña y haga clic en Iniciar sesión en SAP. OR
    • Haga clic en Inicio de sesión en SAP avanzado. En el cuadro Inicio de sesión en SAP, elija el sistema SAP y, a continuación, escriba el nombre de usuario y la contraseña. El cliente está rellenado previamente.

    Para guardar las credenciales para futuras sesiones, marque la casilla Guardar como credenciales de inicio de sesión automático y haga clic en el cuadro Guardar credenciales de inicio de sesión automático. La próxima vez que inicie sesión en SAP desde Studio, verá su Nombre de conexión en la opción Inicio de sesión automático y sus otras credenciales. Debe seleccionar el Nombre de conexión.

  5. Haga clic en Aceptar. Deberá iniciar sesión en SAP.
  6. En la página Instrucciones para crear una consulta a partir de una base de datos lógica, seleccione Hojas de cálculo de Google como Tipo de datos y haga clic en Crear script.
  7. Busque la base de datos lógica (LDB) o haga clic en Buscar LDB, a continuación, en Diccionario de datos y expanda el diccionario de datos.

    Studio le mostrará la jerarquía de las bases de datos.

  8. Haga doble clic en el nodo de una base de datos para añadirla al área de trabajo.
    Nota: No puede añadir más de un nodo que esté en el mismo nivel en la jerarquía.

    Para ver los campos del interior de una base de datos, haga clic en la base de datos en el área de trabajo y, a continuación, en Inspeccionar el nodo de la base de datos lógica.

  9. Marque las casillas Salida para los campos que desee incluir en la consulta.

El siguiente paso es Definir criterios.

Crear consulta desde una grabación
  1. Haga clic en la pestaña Archivo y, a continuación, en Nuevo.
  2. Haga clic en Consulta.
  3. En Elegir un método de creación, haga clic en Crear desde grabación de SAP.
  4. En la pantalla de inicio de Studio, realice una de las siguientes acciones:
    • Seleccione el sistema SAP, introduzca el Nombre de usuario y la Contraseña y haga clic en Iniciar sesión en SAP. OR
    • Haga clic en Inicio de sesión en SAP avanzado. En el cuadro Inicio de sesión en SAP, elija el sistema SAP y, a continuación, escriba el nombre de usuario y la contraseña. El cliente está rellenado previamente.

    Para guardar las credenciales para futuras sesiones, marque la casilla Guardar como credenciales de inicio de sesión automático y haga clic en el cuadro Guardar credenciales de inicio de sesión automático. La próxima vez que inicie sesión en SAP desde Studio, verá su Nombre de conexión en la opción Inicio de sesión automático y sus otras credenciales. Debe seleccionar el Nombre de conexión.

  5. Haga clic en Aceptar.
  6. En el cuadro Código de transacción escriba el código que desee registrar.
  7. En el cuadro Descripción de la grabación escriba una descripción para la grabación. La descripción debe ser única.
  8. En la página Instrucciones para crear una consulta a partir de una grabación, seleccione Hojas de cálculo de Google como Tipo de datos y haga clic en Crear script. Se abre SAP GUI.
  9. Grabe la transacción. Asegúrese de introducir datos para todos los campos que desee incluir en la consulta.

    Si no desea confirmar los datos en SAP, salga de SAP GUI en lugar de hacer clic en Guardar.

    Una vez haya completado la grabación, Query se abre en la pestaña Área de trabajo.

  10. En Diccionario de datos, haga clic en la flecha que hay junto a Códigos de transacción registrados (RC) y, a continuación, haga clic en la flecha que hay junto a la grabación.
  11. Arrastre una tabla al área de trabajo o haga doble clic en ella.

    Los campos que haya modificado durante la grabación ya están seleccionados.

    Nota: Algunas de las tablas pueden contener solo campos tales como casillas. Haga clic en la tabla, a continuación, en Inspeccionar tabla y confirme que la tabla contiene los campos que desea. Si no es así, haga clic en la x roja de la esquina superior derecha de la tabla para eliminarla de la consulta.
  12. Marque la casilla Salida para cada campo adicional del que desee descargar datos de SAP.
  13. Marque la casilla Criterios para cada campo que desee usar para definir el conjunto de datos que esté descargando.

    Por ejemplo, si desea que Query devuelva datos de material basados en un rango de números de material, marque la casilla Criterios para el campo MARA.MATNR.

El siguiente paso es Definir criterios.

Definir criterios
  1. Haga clic en la pestaña Criterios y seleccione el primer campo que aparezca en la lista. Si es necesario, cambie la opción de relleno y el origen de los valores de búsqueda.
    Nota: Si no ve estas opciones, pase el ratón por encima del campo.

    Al aplicar criterios a uno o más campos restringe la consulta para que le devuelva solo la información que desee.

    Puede seleccionar cualquiera de las tres opciones:
    • Definido por el usuario: el usuario especificará este valor en tiempo de ejecución.
    • Celda: el origen de este valor es una celda de un archivo de hoja de cálculo de Google.
    • Valor fijo: el usuario no puede cambiarlo durante la ejecución.
  2. Elija un operador para el campo. Por ejemplo, para devolver datos para un conjunto de números de material que empiecen por 100-, haga clic en Like.
    Nota: Si está usando un InfoSet, los campos de tipo P solo pueden usar el operador =. Los campos de tipo S pueden usar cualquier operador.

  3. Introduzca el valor. En el ejemplo, el valor sería 100-*, donde * es un comodín.

    Si quiere que este valor sea el mismo cada vez que se ejecute la consulta, haga clic en la flecha y, a continuación, en Valor fijo.

    De lo contrario, el valor será Definido por el usuario, lo que significa que lo puede configurar la persona que ejecute el script.

    Para asegurarse de que siempre se introduzca un valor en los criterios definidos por el usuario, haga clic en el icono Obligatorio.

  4. Para añadir más criterios a un campo, seleccione el campo y haga clic en Añadir condición, que aparece en la cinta.

  5. Para añadir un campo, haga clic en el signo más que está junto a Buscar todos los elementos y, a continuación, haga clic en el nombre del campo.
    Nota: En un InfoSet puede añadir una condición Or a un campo de tipo S. No puede añadir condiciones a campos de tipo P. En una LDB, puede añadir una condición Or a un campo.

    Una instrucción de consulta no puede superar los 65 536 caracteres.

Asignar campos
  1. Haga clic en la pestaña Asignador o en la pestaña Asignar de la cinta. Puede utilizar los atajos del teclado CTRL Z (deshacer un comando) y CTRL F (buscar una o varias palabras).
  2. Realice una de las siguientes acciones:
    • Seleccione una fila de campos en el asignador y arrástrela a una columna en el panel Conjunto de datos. Repita la acción para cada fila en el asignador.
    • Seleccione varias filas de campos en el asignador y arrástrelas a una columna en el panel Conjunto de datos. Studio asigna todas las filas seleccionadas.
    • En la cinta, haga clic en Asignar automáticamente. Todos los campos se asignarán.
  3. Para guardar el archivo de datos, haga clic en Guardar.
  4. En el cuadro de diálogo Seleccionar unidad de Google de destino, elija la carpeta que desee y haga clic en Seleccionar.
  5. Introduzca el nombre para la nueva hoja de cálculo y haga clic en Aceptar. Se mostrará el nombre del archivo.
  6. Haga clic en Guardar, en la parte superior izquierda, para guardar el archivo de datos y el archivo de script.

Agregar regla de transformación

  1. En el asignador, haga clic en el campo que contiene los valores que desee transformar.

  2. En la cinta, haga clic en Añadir transformación.

  3. En el cuadro de diálogo Regla de transformación:

    • Defina primero la fórmula de transformación en las Hojas de cálculo de Google.
    • Copie la misma fórmula y péguela en el cuadro de texto Regla de transformación.

    La fórmula se valida mediante el componente SpreadsheetGear y la API de Hojas de cálculo de Google. La fórmula se marca como válida si ambas fórmulas devueltas son válidas y se almacenan en el script para su ejecución. Por ejemplo, si desea transformar los valores de Peso neto:

    • Suponga que los valores de origen comienzan en la celda H2.
    • Introduzca la fórmula de Hojas de cálculo de Google=H2*1.1 en la regla de transformación.
    • Los valores transformados se escriben en la columna de destino (por ejemplo, columna J a partir de J2).
    • En el tiempo de ejecución, la regla de transformación se aplica fila por fila, de la misma manera que las transformaciones basadas en Excel.

Desplazamiento de fila

Si es necesario evaluar la fórmula en una fila diferente de la fila asignada, especifique la fila en la que debe comenzar la fórmula. Por ejemplo, introduzca 3 para comenzar la evaluación desde la fila 3.

Fechas en Hojas de cálculo de Google

Cuando utilice fechas en una fórmula de transformación, utilice las Hojas de cálculo de Google compatibles con funciones de fecha y formato de fecha y aplique la fórmula con TEXT() para garantizar el formato correcto. Por ejemplo: =TEXT(TODAY()+1,"mm/dd/yyyy").

Transformaciones de encabezado y posición

Las transformaciones de campo de encabezado solo se aplican a las filas de encabezado, mientras que las transformaciones de campo de posición solo se aplican a las filas de posiciones. Si necesita asignar ambos tipos a la misma columna, debe agregar la regla de transformación dos veces, una para cada tipo de asignación.

Validar la fórmula de transformación

Haga clic en Validar para comprobar la fórmula. Si la fórmula contiene errores, aparecerá un mensaje de advertencia. Si la validación se realiza correctamente, puede continuar.

Sobrescribir y conservar los datos originales

  • Para sobrescribir los datos originales, cambie la letra de columna de destino a la columna asignada original y haga clic en Aceptar.

  • Para mantener los datos originales, conserve una columna de destino diferente y haga clic en Aceptar.

    La hoja de Google incluirá la fórmula en la fila de encabezado, al igual que las transformaciones basadas en Excel.

Enviar un script de Query a Evolve

  1. Haga clic en el icono Guardar de la parte superior izquierda. Si cambia los nombres de archivo predeterminados (los nombres predeterminados del script y del archivo de datos), no supere los 128 caracteres. Los archivos que tengan nombres que superen los 128 caracteres no se podrán enviar desde Studio.
  2. Haga los cambios que desee en los nombres de archivo y, a continuación, haga clic en Guardar ambos archivos.
    Consejo: Si usa para una nueva solución el mismo nombre que para una solución existente que ya está en producción, la nueva solución se convertirá en la versión al enviarla.
  3. En la pestaña Evolve, haga clic en Enviar.
  4. En la pestaña Información del script, añada el nombre de la solución y una descripción, la hoja del nivel de uso del sistema y los datos de hojas y de bloqueo de hojas. Haga clic en Siguiente. Si envía varios scripts, haga clic en Varios scripts antes de pulsar Siguiente.
  5. No se admite el bloqueo de hoja. Haga clic en Siguiente.
  6. En la pestaña Plantilla de datos, la ruta de la plantilla y el nombre de la solución son de solo lectura. Haga clic en Siguiente.
  7. En la pestaña Proceso de workflow de archivos de solución, seleccione la biblioteca de destino. Elija de entre la lista de bibliotecas disponibles. Si no hay bibliotecas personalizadas en la lista, figurará una biblioteca predeterminada (atenuada). Seleccione al Revisor y haga clic en Siguiente.
  8. En Documentos auxiliares, adjunte cualquier documento auxiliar (un archivo individual). Puede comprimir los archivos en una carpeta haciendo clic en Comprimir (el nombre de la carpeta comprimida será el mismo que el de la solución). Para descomprimir los archivos de la carpeta, haga clic en Descomprimir. Haga clic en Siguiente. Los documentos auxiliares incluyen scripts adicionales, hojas de datos o cualquier otro archivo que explique lo que envía para su aprobación.
  9. En la pestaña Resumen, haga clic en el botón Editar para realizar los cambios de la información que necesite. Studio le llevará a la pantalla correspondiente del asistente. Realice los cambios que necesite y haga clic en Siguiente hasta que vuelva a la pantalla Resumen.
  10. Haga clic en Enviar.
  11. Cuando Studio haya finalizado de enviar el script, haga clic en Aceptar.
  12. Apruebe el script siguiendo los pasos de Aprobar, rechazar o reasignar soluciones en Studio.
  13. Puede ejecutar el script con el complemento de Hojas de cálculo de Google.

Aprobar, rechazar o reasignar soluciones en Studio

Podrá aprobar o rechazar rápidamente la solución en la pantalla Mis tareas de Workflow o podrá abrir la solución y revisarla.

  1. En la pestaña Archivo de Studio, haga clic en Mis tareas de Workflow.
  2. En Visor de tareas, haga clic en la tarea Revisión necesaria del archivo de solución. En Detalles, podrá ver el proceso de workflow seleccionado. La información del origen del proceso de workflow incluye el nombre del originador y la fecha en la que creó el proceso de workflow.
  3. En Workflow, haga clic en Aprobar, Rechazar o Reasignar.
  4. Si hace clic en Reasignar, elija un revisor en la lista Revisor. También puede añadir un comentario para explicar los motivos de la aprobación, del rechazo o de la reasignación del archivo.
  5. Para completar la tarea haga clic en Aprobar, Rechazar o Reasignar. Si va a aprobar una solución de Query y cree que la consulta necesitará más recursos, cambie el Nivel de uso del sistema.

Valores de búsqueda F4

El valor de búsqueda F4 está disponible en la pestaña Criterios y Ejecutar.

Valores de búsqueda F4 en la pestaña Criterios:

  1. Abra el script de Query grabado.
  2. Vaya a la pestaña Criterios.
  3. Seleccione el campo para el que desea extraer valores de SAP.
  4. Haga clic en el símbolo de tres puntos.
  5. En la pantalla Constructor de listas, seleccione Lista de valores estáticos y luego seleccione Desde la búsqueda F4 de SAP en la lista desplegable Importar.
  6. El sistema obtiene todos los valores disponibles para el campo seleccionado desde SAP.
  7. Seleccione en la lista los valores que necesita y haga clic en Aceptar.
Valores de búsqueda F4 en la pestaña Ejecutar:
  1. Vaya a la pestaña Ejecutar del script de Query.
  2. Haga clic en Ejecutar.
  3. En el Asistente para variables de tiempo de ejecución, localice el campo configurado con la búsqueda de SAP.
  4. Seleccione el símbolo junto al campo denominado SAP opcional.
  5. Se abrirá el cuadro de diálogo Valores de SAP y se obtendrán los valores de clave válidos de SAP.
  6. Seleccione uno o más valores de la lista de valores de SAP.
  7. Los valores seleccionados aparecen automáticamente en el cuadro de diálogo de tiempo de ejecución.
  8. Haga clic en Aceptar.
  9. Continúe y complete la ejecución del script.