Ejecutar un script de Transaction con macros
- 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.
- En Hojas de cálculo de Google, en Extensiones, haga clic en Scripts de aplicaciones.
- En la página Script de aplicaciones, copie el código de macro proporcionado y péguelo en el editor.
- Haga clic en el signo + que está junto a Bibliotecas.
- 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.
- 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.
- Configure los parámetros del script según sus requisitos:
- Fila inicial
- Fila final
- Columna de registro
- Tipo de ejecución
- Nombre de conexión y otra propiedad disponible
- 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
registerDeveloperMetadataal menos una vez desde el proyecto Apps Script:AutomateMacroLibraryQA.registerDeveloperMetadata()AutomateMacroLibraryQAes el espacio de nombres predeterminado para la biblioteca de macros. Si es necesario, se puede especificar un nombre diferente. - Abra cualquier script de Transaction en el cliente de Studio.
- Explore Google Drive y seleccione la plantilla incrustada con macros.
- Asignar los campos. Para obtener más información, consulte la sección Asignar los campos.
- Envíe la solución para su revisión. Para obtener más información, consulte la sección Enviar script para revisión.
- Apruebe la solución. Para obtener más información, consulte la sección Aprobar, rechazar o reasignar soluciones en Studio.
- 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 |
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
- 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.
- En Hojas de cálculo de Google, vaya a Extensiones y haga clic en Script de aplicaciones.
- En el editor de scripts de aplicaciones, copie y pegue el código de macro proporcionado.
- Haga clic en el signo + que está junto a Bibliotecas.
- 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.
- 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.
- Configure los parámetros del script según sus requisitos:
- Fila inicial
- Columna de registro
- Tipo de ejecución
- Nombre de conexión
- 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
registerDeveloperMetadataal menos una vez desde el proyecto Apps Script:AutomateMacroLibraryQA.registerDeveloperMetadata()AutomateMacroLibraryQAes el espacio de nombres predeterminado para la biblioteca de macros. Si es necesario, se puede especificar un nombre diferente. - Abra cualquier script de Query en el cliente de Studio.
- Explore Google Drive y seleccione la plantilla incrustada con macros.
- Asignar los campos. Para obtener más información, consulte la sección Asignar los campos.
- Envíe la solución para su revisión. Para obtener más información, consulte la sección Enviar script para revisión.
- Apruebe la solución. Para obtener más información, consulte la sección Aprobar, rechazar o reasignar soluciones en Studio.
- 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. |
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
- 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.
- Haga clic en Dibujo en la pestaña Insertar.
- 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.
- Seleccione la forma insertada y haga clic en los tres puntos.
- Haga clic en Asignar script.
- Introduzca el nombre del script en el cuadro de diálogo Asignar script y haga clic en Aceptar.
- En la pestaña Extensiones, haga clic en Script de aplicaciones.
- 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.
- Haga clic en el signo + junto a Bibliotecas.
- 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.
- Haga clic en Buscar, seleccione la versión de la biblioteca reciente en la opción Versión y haga clic en Agregar.
- Haga clic en Guardar para guardar la hoja de cálculo de Google con un nombre. Ahora, la macro está incrustada en la plantilla.
- En el cliente de Studio, explore y seleccione la plantilla incrustada con macros de Google Drive.
- Asignar los campos. Para obtener más detalles, consulte la sección Asignar los campos.
- Envíe la solución para su revisión. Para obtener más detalles, consulte la sección Enviar script para revisión.
- Apruebe la solución. Para obtener más detalles, consulte la sección Aprobar, rechazar o reasignar soluciones en Studio.
- 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.
- 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.
- 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.
- Scripts de encadenado cruzado: puede ejecutar scripts de Transaction y Query juntos en distintas cadenas en una sola plantilla.