Ejecutar scripts con macros - 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

En este tema, se indica cómo utilizar la macro para ejecutar el script de Transaction y Query.
Nota: El parámetro ConnectionName se utiliza para la conexión de SAP cuando se ejecuta la macro en el modo Evolve/SM.

Ejecutar un script de Transaction con macros

  1. Abra la plantilla de Hojas de cálculo de Google desde la unidad de Google seleccionando la opción Abrir plantilla en el complemento Hojas de cálculo de Google.
  2. En Hojas de cálculo de Google, en Extensiones, haga clic en Scripts de aplicaciones.
  3. En la página Script de aplicaciones, copie el código de macro proporcionado y péguelo en el editor.
  4. Haga clic en el signo + que está junto a Bibliotecas.
  5. En el cuadro de diálogo Agregar una biblioteca, pegue el Id. de script de la biblioteca de macros implementada.
    Nota: El Id. del script se genera al implementar la biblioteca.
  6. Haga clic en Buscar, seleccione la versión más reciente de la biblioteca en la lista desplegable Versión y haga clic en Agregar.
  7. Configure los parámetros del script según sus requisitos:
    1. Fila inicial
    2. Fila final
    3. Columna de registro
    4. Tipo de ejecución
    5. Nombre de conexión y otra propiedad disponible
  8. Haga clic en Guardar para guardar la hoja de cálculo de Google con un nombre. La macro ahora está integrada en la plantilla.
    Nota: Puede ejecutar manualmente el método de biblioteca registerDeveloperMetadata al menos una vez desde el proyecto Apps Script: AutomateMacroLibraryQA.registerDeveloperMetadata()

    AutomateMacroLibraryQA es el espacio de nombres predeterminado para la biblioteca de macros. Si es necesario, se puede especificar un nombre diferente.

  9. Abra cualquier script de Transaction en el cliente de Studio.
  10. Explore Google Drive y seleccione la plantilla incrustada con macros.
  11. Asignar los campos. Para obtener más información, consulte la sección Asignar los campos.
  12. Envíe la solución para su revisión. Para obtener más información, consulte la sección Enviar script para revisión.
  13. Apruebe la solución. Para obtener más información, consulte la sección Aprobar, rechazar o reasignar soluciones en Studio.
  14. Después de aprobar el script, haga clic en Ejecutar en la página Script de aplicaciones.

Propiedades para un objeto de complemento de Transaction

La configuración de la ejecución o las opciones avanzadas de ejecución configuradas en el script no se respetan durante la ejecución de la macro. Se deben configurar con las diversas propiedades que se han expuesto para el objeto del complemento.

Propiedad/Función Valor(es)/Parámetro Descripción

PublishedFile

Descripción del script publicado

Selecciona el archivo publicado que se va a ejecutar

StartRow

Número de fila

Fila de hoja de Google desde la que debe iniciarse la carga de datos

EndRow

Número de fila

Última fila de la hoja de Google desde la que se cargarán los datos

WriteHeader

No disponible

Escribe encabezados durante la ejecución

LogColumn

Columna/Celda

Columna o celda en la que se deben escribir los registros de la ejecución

ConnectionName

Nombre de conexión de SAP

Nombre de conexión de SAP

Ejemplo

StudioMacros.ConnectionName = "w6r"

RunReason

Cadena del motivo de la ejecución

Especifica un motivo para esta ejecución

RunType

0 - Run 2 - RunFirstFiveRows 3 - RunOnlyErrorRows 4 - RunOnlyUnProcessedRows 7 - ValidateSpecifiedRange 8 - ValidateFirstFiveRows 9 - ValidateOnlyErrorRows 10 - ValidateOnlyUnProcessedRows 15 - RunUnProcessedAndErrorRows 16 - ValidateUnProcessedAndErrorRows

Selecciona el tipo de ejecución de entre los posibles valores

 

RunScript

No disponible

Ejecutar el script

Código de muestra para ejecutar scripts de Transaction
function RunPublishedTXR() {

  // ---------------------------------------------------------
  // NOTE:
  // 'MacroLib' is the Apps Script LIBRARY IDENTIFIER
  // added to this Google Sheet project.
  //
  // If your library identifier is 'MacroLib', this function can be run AS-IS.
  // Otherwise, replace 'MacroLib' with your actual library name.
  // ---------------------------------------------------------

  const ws = MacroLib.onScript;

  // Select the published file to Run
  ws.PublishedFile = "MM02_MacroTest";

  ws.StartRow = 2;
  ws.EndRow = 6;

  // Set column used to log execution status
  ws.LogColumn = "A";
  
  // Set in case of Studio Administrator
  ws.AlfName = "w6r-800";

  // Set in case of Evolve
  ws.ConnectionName = "w6r";

  // Set RunReason to provide reason for run.
  ws.RunReason = "Run Reason";

   // ---------------------------------------------------------
  // RunType options
  //
  // 0  = Run
  // 2  = RunFirstFiveRows
  // 3  = RunOnlyErrorRows
  // 4  = RunOnlyUnProcessedRows
  // 7  = ValidateSpecifiedRange
  // 8  = ValidateFirstFiveRows
  // 9  = ValidateOnlyErrorRows
  // 10 = ValidateOnlyUnProcessedRows
  // 15 = RunUnProcessedAndErrorRows
  // 16 = ValidateUnProcessedAndErrorRows
  //
  // ---------------------------------------------------------
  
  ws.RunType = 0;
  
  //Set true to auto close the MacroDialog box after run. 
  ws.AutoClose = false

  // Execute the published TXR script
  ws.RunScript();
}

Ejecutar un script de Query con macros

  1. Abra la plantilla de Hojas de cálculo de Google desde la unidad de Google seleccionando la opción Abrir plantilla en el complemento Hojas de cálculo de Google.
  2. En Hojas de cálculo de Google, vaya a Extensiones y haga clic en Script de aplicaciones.
  3. En el editor de scripts de aplicaciones, copie y pegue el código de macro proporcionado.
  4. Haga clic en el signo + que está junto a Bibliotecas.
  5. En el cuadro de diálogo Agregar una biblioteca, pegue el Id. de script de la biblioteca de macros implementada.
    Nota: El Id. del script se genera al implementar la biblioteca.
  6. Haga clic en Buscar, seleccione la versión más reciente de la biblioteca en la lista desplegable Versión y haga clic en Agregar.
  7. Configure los parámetros del script según sus requisitos:
    1. Fila inicial
    2. Columna de registro
    3. Tipo de ejecución
    4. Nombre de conexión
  8. Haga clic en Guardar para guardar la hoja de cálculo de Google con el nombre que haya elegido. La macro ahora está integrada en la plantilla.
    Nota: Puede ejecutar manualmente el método de biblioteca registerDeveloperMetadata al menos una vez desde el proyecto Apps Script: AutomateMacroLibraryQA.registerDeveloperMetadata()

    AutomateMacroLibraryQA es el espacio de nombres predeterminado para la biblioteca de macros. Si es necesario, se puede especificar un nombre diferente.

  9. Abra cualquier script de Query en el cliente de Studio.
  10. Explore Google Drive y seleccione la plantilla incrustada con macros.
  11. Asignar los campos. Para obtener más información, consulte la sección Asignar los campos.
  12. Envíe la solución para su revisión. Para obtener más información, consulte la sección Enviar script para revisión.
  13. Apruebe la solución. Para obtener más información, consulte la sección Aprobar, rechazar o reasignar soluciones en Studio.
  14. Después de aprobar el script, introduzca el nombre PublishedFile y haga clic en Ejecutar en la macro de la página Script de aplicaciones.

Propiedades para un objeto de complemento de Query

La configuración de la ejecución o las opciones avanzadas de ejecución que estén configuradas en el script no se respetan durante la ejecución de la macro. Se deben configurar con las diversas propiedades que se han expuesto para el objeto del complemento.

Propiedad/Función Valor(es)/Parámetro Descripción

PublishedFile

Descripción de archivo publicado

Selecciona el archivo publicado que se va a ejecutar.

StartRow

Número de fila

Fila de Hojas de cálculo de Google a partir de la que se deben escribir los registros descargados.

RecordsToFetch

N.º de registros

Número de registros que devolverá la ejecución de Query.

WriteHeader

Verdadero/Falso

Escribe encabezados de asignación para los datos descargados.

ExtractAllRecords

Verdadero/Falso

Invalida RecordsToFetch y extrae todos los registros.

RunReason

Cadena del motivo de la ejecución

Especifica un motivo para esta ejecución.

LogColumn

Columna/Celda

Columna o celda en la que se deben escribir los registros de la ejecución.

ConnectionName

Nombre de conexión de SAP

Nombre de conexión de SAP

RunType

Tipo de ejecución

0 – Ejecutar para obtener registros según configuración

1 – Sobrescribir RecordsToFetch y descargar solo los primeros 50 registros

RunScript

No disponible

Ejecute el script.

Código de muestra para ejecutar un script de Query
function RunPublishedQSQ() {

  // ---------------------------------------------------------
  // NOTE:
  // 'MacroLib' is the Apps Script LIBRARY IDENTIFIER
  // added to this Google Sheet project.
  //
  // If your library identifier is 'MacroLib', this function
  // can be run AS-IS.
  // Otherwise, replace 'MacroLib' with your actual library name.
  // ---------------------------------------------------------

  const ws = MacroLib.onScript;

  // Select the published file to run
  ws.PublishedFile = "Table_20150113_150602";

  ws.StartRow = 2;

  // Number of records to fetch. if not set, then records will be fetched as per script settings.
  // Only respected when ExtractAllRecords = false
  ws.RecordsToFetch = 10;

  // True to fetch all records. If set false then RecordsToFetch property will be respected
  ws.ExtractAllRecords = false;

  // Set column used to log execution status
  ws.LogColumn = "A";
  
  // Set in case of Studio Administrator
  ws.AlfName = "w6r-800";

  // Set in case of Evolve
  ws.ConnectionName = "S25";

  // Set RunReason to provide reason for run.
  ws.RunReason = "Run Reason";

  // ---------------------------------------------------------
  // RunType options
  //
  // 0  = Run
  // 1  = RunOnlyFiftyRecords
  //
  // ---------------------------------------------------------

  ws.RunType = 0;
  
  //Set true to auto close the MacroDialog box after run. 
  ws.AutoClose = false

  // Execute the published QSQ script
  ws.RunScript();
}

Cree su propia macro y ejecute el script

  1. Abra la plantilla de Hojas de cálculo de Google desde la unidad de Google usando la opción Abrir plantilla en el complemento Hojas de cálculo de Google.
  2. Haga clic en Dibujo en la pestaña Insertar.
  3. En el cuadro de diálogo Dibujo, inserte cualquier forma y haga clic en Guardar y cerrar. La forma insertada se agregará a la hoja de cálculo de Google.
  4. Seleccione la forma insertada y haga clic en los tres puntos.
  5. Haga clic en Asignar script.
  6. Introduzca el nombre del script en el cuadro de diálogo Asignar script y haga clic en Aceptar.
  7. En la pestaña Extensiones, haga clic en Script de aplicaciones.
  8. En la página Script de aplicaciones, puede crear su propio código de macro en el editor y configurar los parámetros de ejecución.
  9. Haga clic en el signo + junto a Bibliotecas.
  10. En la pantalla Agregar una biblioteca, pegue el Id. de script de la biblioteca de macros implementada.
    Nota: El Id. del script se genera durante la implementación.
  11. Haga clic en Buscar, seleccione la versión de la biblioteca reciente en la opción Versión y haga clic en Agregar.
  12. Haga clic en Guardar para guardar la hoja de cálculo de Google con un nombre. Ahora, la macro está incrustada en la plantilla.
  13. En el cliente de Studio, explore y seleccione la plantilla incrustada con macros de Google Drive.
  14. Asignar los campos. Para obtener más detalles, consulte la sección Asignar los campos.
  15. Envíe la solución para su revisión. Para obtener más detalles, consulte la sección Enviar script para revisión.
  16. Apruebe la solución. Para obtener más detalles, consulte la sección Aprobar, rechazar o reasignar soluciones en Studio.
  17. Una vez que el script se apruebe, introduzca el nombre PublishedFile en la página Script de aplicaciones y haga clic en el dibujo que creó en la hoja de cálculo de Google. El script se ejecutará y podrá cerrar la ventana una vez que reciba el mensaje Ejecución de macro completada correctamente.
También podrá ejecutar los siguientes scripts con la macro:
  1. Scripts de ciclo completo: puede ejecutar scripts de Transaction y de Query con una plantilla única, lo que le permite completar de una sola vez un ciclo de operaciones completo.
  2. Scripts de encadenado: puede ejecutar scripts de Query o Transaction encadenados al mismo tiempo, lo que simplifica el proceso de ejecución de transacciones interconectadas.
  3. Scripts de encadenado cruzado: puede ejecutar scripts de Transaction y Query juntos en distintas cadenas en una sola plantilla.
Nota: Las macros no están disponibles cuando un archivo de Hojas de cálculo de Google habilitado para macros se abre en Excel mediante la opción Abrir en Excel desde el sitio de Evolve.