Help Center > Studio v11 Help

Utilizar macros para ejecutar un script

Para ejecutar un script con una macro, cree la macro en Visual Basic for Applications (VBA).

  1. Abra el archivo de datos que esté asociado al script que desee ejecutar.

    Importante: Asegúrese de usar una archivo habilitado para macros o archivo .xlsm.

  2. Pulse Alt+F11.
  3. En el editor de VBA, en Objetos de Microsoft Excel, haga doble clic en la hoja que contenga los datos que desee ejecutar.
  4. Copie y pegue el código de abajo en la ventana.
  5. Reemplace la ruta del archivo de datos, la del archivo de script, el nombre de la hoja y el nombre de inicio de sesión automático de abajo con la información de sus archivos y su nombre de inicio de sesión automático.
  6. Haga clic en Guardar y, a continuación, cierre el editor de VBA.
  7. En Excel, haga clic en la pestaña Vista y, a continuación, en Macros.
  8. Haga clic en la macro que desee ejecutar y, a continuación, en Ejecutar.

Nota: Asegúrese de que el complemento de Excel no esté activo (de que no haya iniciado sesión en Foundation).

Macros de Transaction

Ejecutar un script publicado

  1. Defina los objetos del complemento.

    Dim StudioMacrosAddin, StudioMacros

  2. Consiga el objeto del complemento de Excel.

    Set StudioMacrosAddin = Application.COMAddIns.Item("WinshuttleStudioMacros.AddinModule")

  3. Consiga el objeto COM del objeto del complemento.

    Set StudioMacros = StudioMacrosAddin.Object.Macros

  4. Seleccione el archivo publicado que desee ejecutar y defina otras propiedades de ejecución (consulte Propiedades para un objeto de complemento de Transaction).

    Dim StudioMacros.PublishedFile = "MM02_MacroTest"

  5. Abra el script publicado.

    StudioMacros.OpenPublishedScript

  6. Ejecute AddinObject para ejecutar el script.

    StudioMacros.RunScript

Ejecutar un script de Transaction existente

  1. Defina los objetos del complemento.

    Dim StudioMacrosAddin, StudioMacros

  2. Consiga el objeto del complemento de Excel.

    Set StudioMacrosAddin = Application.COMAddIns.Item("WinshuttleStudioMacros.AddinModule")

  3. Consiga el objeto COM del objeto del complemento.

    Set StudioMacros = StudioMacrosAddin.Object.Macros

  4. Seleccione el script de Transaction que desee ejecutar y defina otras propiedades de ejecución (consulte Propiedades para un objeto de complemento de Transaction).

    Dim strShuttleFile = "C:\Users\Normal_Tx_Macro.txr"

  5. Abra el script que va a ejecutar.

    StudioMacros.OpenScript (strShuttleFile)

  6. Ejecute AddinObject para ejecutar el script.

    StudioMacros.RunScript

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(s)

Descripción

PublishedFile

Descripción del script publicado

Selecciona el archivo publicado que se va a ejecutar

OpenPublishedScript

NA

Abre el script publicado

OpenScript()

Ruta del archivo de script

Abre el script para ejecutarlo

StartRow

Número de fila

Fila de Excel a partir de la que debe empezar la carga de datos

EndRow

Número de fila

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

WriteHeader

NA

Escribe encabezados durante la ejecución

LogColumn

Columna/Celda

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

SheetName

Nombre de la hoja

Nombre de la hoja que se usará para la ejecución

AlfName

Archivo de inicio de sesión automático

Nombre de inicio de sesión automático que se va a usar

RunReason

Cadena del motivo de la ejecución

Especifica un motivo para esta ejecución

RunSelectedRows

NA

Verdadero: ejecuta solo las filas seleccionadas en Excel

RunFilteredRows

NA

Verdadero: ejecuta solo las filas mostradas en Excel

RunType

0 – Ejecutar rango especificado

1 – Ejecutar y detener en errores

2 – Ejecutar las cinco primeras filas

3 – Ejecutar solo filas de error

4 – Ejecutar solo filas no procesadas

5 – Depurar rango especificado

6 – Depurar solo la primera fila

7 – Validar rango especificado

8 – Validar las cinco primeras filas

9 – Validar solo filas de error

10 – Validar solo filas no procesadas

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

RunScript

NA

Ejecutar el script

Código de muestra: Ejecutar un script de Transaction existente

  Sub RunNormalTXRfile() '---------------------------------------------- ' Macro para usar el complemento WinshuttleStudioMacros con código  '---------------------------------------------- ‘ ' Macro RunPublishedfile ' Dim StudioMacrosAddin, StudioMacros On Error GoTo ErrHandler ' OBTENER OBJETO DE COMPLEMENTO DE EXCEL Set StudioMacrosAddin = Application.COMAddIns.Item("WinshuttleStudioMacros.AddinModule") If StudioMacrosAddin Is Nothing Then MsgBox "Unable to initialize object of WinshuttleStudioMacros.AddinModule addin» Exit Sub End If ' Obtener objeto com de objeto de complemento Set StudioMacros = StudioMacrosAddin.Object.Macros If StudioMacros Is Nothing Then MsgBox "Unable to initialize com object of Macros» Exit Sub End If StudioMacros.StartRow = 2 StudioMacros.EndRow = 0 ' Configurar como Verdadero para escribir encabezados durante la ejecución StudioMacros.WriteHeader = True ' Configurar RunReason para proporcionar un motivo para la ejecución. StudioMacros.RunReason = "Run Reason" 'StudioMacros.RunSelectedRows = True 'StudioMacros.RunFilteredRows = True ' RunSpecifiedRange = 0, ' RunAndStopOnErrors = 1, ' RunFirstFiveRows = 2, ' RunOnlyErrorRows = 3, ' RunOnlyUnProcessedRows = 4, ' DebugSpecifiedRange = 5, ' DebugFirstRowOnly = 6, ' ValidateSpecifiedRange = 7, ' ValidateFirstFiveRows = 8, ' ValidateOnlyErrorRows = 9, ' ValidateOnlyUnProcessedRows = 10, StudioMacros.RunType = 0 strShuttleFile = "C:\Users\ssingh\Documents\Winshuttle\Studio\Script\Normal_Tx_Macro.txr» ' Llamar a la función de ejecución para abrir el script especificado StudioMacros.OpenScript (strShuttleFile) ' Llamar a la función de ejecución para ejecutar el script StudioMacros.RunScript Exit Sub ErrHandler: MsgBox Err.Description End Sub

Problemas conocidos

  1. Las macros que se hayan creado en Transaction o Query v10.x no se convierten automáticamente al formato de Studio v11. Las macros en formato de Studio v11 no son compatibles con las versiones 10.x. Para ejecutarlas, hay que convertir las macros de forma manual.
  2. Mientras use macros, no debería tener cargados los complementos de Winshuttle (no debería tener iniciada la sesión en Foundation). Los complementos de Winshuttle se pueden habilitar.
  3. La fila de inicio siempre es la 2, a no ser que se indique otra fila.
  4. RunSelectedRows y RunFilteredRows son opciones mutuamente excluyentes. El script usará el último que se haya configurado.
  5. Los archivos de datos tienen que usar el flujo de trabajo de Revisión de datos para poder ejecutarse con macros en el modo Foundation.
  6. La opción Guardar en Foundation no funcionará cuando se use una macro para ejecutar el archivo de datos en el modo Foundation.