Ejecutar scripts con macros - Automate_Studio - Latest

Código de muestra para ejecutar scripts de Transaction

function RunNormalTXRfile() {

  // ---------------------------------------------------------
  // 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;

  // For local File, set ShuttleFile to local file path to Run
  ws.ShuttleFile = "<<Path of script file>>";

  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
  // 1  = RunAndStopOnErrors
  // 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();

}    

Código de muestra para ejecutar un script de Query

function RunNormalQsqFile() {

  // ---------------------------------------------------------
  // 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;

  // For local File, set ShuttleFile to local file path to Run
  ws.ShuttleFile = "<<Path of script file>>";

  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();
}

1. Abra la plantilla de Hojas de cálculo de Google desde Google Drive.
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. Haga clic en el dibujo que creó en Hojas de cálculo de Google. El script se ejecutará y podrá cerrar la ventana una vez que reciba el mensaje Ejecución de macros finalizada y registros descargados.

También podrá ejecutar los siguientes scripts con la macro:

1. 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.
2. Scripts de encadenado cruzado: puede ejecutar scripts de Transaction y Query juntos en distintas cadenas en una sola plantilla.
3. 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.

Cuando ejecuta una macro de Transaction o Query no publicada desde Hojas de cálculo de Google, debe introducir la ruta del archivo de script con barras invertidas dobles (\). Por ejemplo, puede utilizar este formato cuando especifique la ruta de la secuencia de comandos: C:\\Users\\username\\Documents\\Winshuttle\\Studio\\Script\\SampleMacro.qsq