Uso de Readiness Toolkit para evaluar la compatibilidad de aplicaciones para Aplicaciones de Microsoft 365

The Readiness Toolkit for Office add-ins and VBA can help you identify compatibility issues with your Microsoft Visual Basic for Applications (VBA) macros and add-ins that you use with Office. The Readiness Toolkit includes the Readiness Report Creator, which creates an Excel report with VBA macro compatibility and add-in readiness information to help your organization assess its readiness to move to Microsoft 365 Apps.

You can download the Readiness Toolkit for free from the Microsoft Download Center. We recommend that you always download and use the most current version. The Readiness Toolkit checks if you're using the most current version when you run a report and will prompt you to download the most current version. You don't have to uninstall the older version of the Readiness Toolkit before installing the most current version.

Importante

The Readiness Toolkit doesn't repair or fix the code in your VBA macros. If you create an advanced report, the report does provide guidance, when available, for remediating your VBA macro code.

The Readiness Report Creator can scan for VBA macros in Word, Excel, PowerPoint, Outlook, Access, Project, Visio, and Publisher files, for Office versions as far back as Office 2003. It can also scan for certain types of add-ins used with Office. Add-ins for all Office applications are identified, but it doesn't include web add-ins. For more information, see File extensions analyzed for VBA macros and Types of add-ins for which the Readiness Report Creator collects data.

La descarga es un archivo MSI que puede usar para instalar el Kit de herramientas de preparación en el equipo de un usuario. Una vez instalado, al ejecutar el creador de informes de preparación, un asistente de interfaz de usuario le guiará por el proceso de creación de un informe de preparación. También hay un archivo ejecutable independiente que se puede ejecutar desde la línea de comandos o usarse con scripts. Esto es útil si necesita recopilar información de preparación de los usuarios de toda la empresa de forma más automatizada. Para obtener más información, consulte Obtener información de preparación para varios usuarios en una empresa.

Se proporciona la siguiente información para ayudarle a utilizar el Creador de informes de preparación:

Nota

  • After running the Readiness Toolkit, many enterprises find that they have fewer compatibility issues than first expected. Based on data provided by enterprises running the Readiness Toolkit, on average 6% of scanned files have macros, and of those files, 3.3% have macro issues. So that's only 0.2% files with macro compatibility issues. For Office add-ins, 75% of add-ins found are already categorized as adopted or supported.
  • Si tiene comentarios o preguntas sobre Readiness Toolkit, envíenos un correo electrónico a ReadyForOffice@microsoft.com.

Crear un informe de preparación

Requisitos y limitaciones para usar Readiness Toolkit

Antes de instalar y usar Readiness Toolkit, debe tener en cuenta los siguientes requisitos:

  • Windows 7 Service Pack 1 (SP1) o una versión posterior

  • Microsoft .NET Framework 4.5.1 o una versión posterior

  • Excel 2010 o una versión posterior

Nota

  • Se recomienda usar la versión de 64 bits de Excel, especialmente si espera que aparezcan más de 400.000 resultados en el informe de preparación.
  • Windows 7 y Excel 2010 ya no son productos compatibles.

Además, hay algunas limitaciones sobre el Creador de informes de preparación que debería conocer:

  • The Readiness Report Creator can't scan password protected files. If you try to scan one of these files, the file shows up as "Password protected" in the report.

  • By default, the Readiness Report Creator can't scan files that are saved in a SharePoint document library, in OneDrive, or in some other type of cloud-based storage location. If you try to scan one of these files, the file shows up as "Cloud-based" in the report. For a possible workaround, see How to scan cloud-based files.

  • The Readiness Report Creator lists each issue with an Office document in a separate row in an Excel worksheet. Therefore, the Readiness Report Creator can only return 1,046,575 results. If you expect to exceed these limits, we recommend that you narrow the scope of your report, such as to a specific department.

Elegir la información que se usará para crear el informe

To create a readiness report, you first need to select what information to use to create the report. The following table lists the possible options and an explanation of each option. It also specifies which type of readiness report is created with each option.

Opción Explicación Informe creado
Complementos instalados y documentos de Office usados recientemente en este equipo.
El creador de informes de preparación solo analiza los documentos de Office que están en la lista de archivos usados más recientemente del usuario. Esto le permite limitar el foco del examen a los documentos a los que accede regularmente un usuario.

Además, el Creador de informes de preparación busca complementos de Office instalados en el equipo donde se ejecuta.
VBA y complemento
Documentos de Office en una carpeta local o recurso compartido de red.
The Readiness Report Creator scans the Office documents in the folder or network share that you specify. The Readiness Report Creator automatically scans the specified location, and all the subfolders in that location.

Nota: Con esta opción, el Creador de informes de preparación no busca complementos instalados en el equipo donde se ejecuta.
Solo VBA
Anteriores resultados de preparación guardados juntos en una carpeta local o un recurso compartido de red.
Esta opción le permite crear un informe consolidado que consta de los resultados de preparación individuales desde varios equipos independientes.

For example, you might want to run the Readiness Report Creator on all the computers in the Finance department, saving the results of each scan to a network share. Then, you can use this option to create a consolidated report for the Finance department.

Para obtener más información, consulte Obtener información de preparación para varios usuarios en una empresa.
Solo VBA, o VBA y complemento, según qué resultados de preparación se estén usando.
Agregue datos desde el Panel de telemetría de Office.
Si ya está usando el Panel de telemetría de Office para evaluar la compatibilidad del complemento, puede usar la información que ya ha recopilado para crear un informe de preparación. Solo tiene que proporcionar al Creador de informes de preparación la información adecuada para tener acceso a la base de datos del Panel de telemetría de Office.

Note: With this option, the Readiness Report Creator doesn't look for VBA macros. GRANT SELECT access on the database is required for the user to run this option.
Solo complemento

Elegir entre un informe básico y uno avanzado

Después de seleccionar qué información se usa para crear el informe y especificar una ubicación para guardarlo, deberá elegir si quiere crear un informe básico o uno avanzado.

We strongly recommend that you create an advanced report because an advanced report provides additional information to help you assess the compatibility of your VBA macros and add-ins with Microsoft 365 Apps. For example, in an advanced report, you get the following additional information:

  • Remediation advice, when available, for issues found in your VBA macros. This information is shown in a separate worksheet in the report.

  • Estados de preparación de complementos. Por ejemplo, el informe puede mostrar que el proveedor de software tiene una versión compatible del complemento para Aplicaciones de Microsoft 365.

El estado de preparación de los complementos se deriva de cálculos basados en telemetría, así como de las instrucciones de compatibilidad explícita de ISV.

To provide you with the most up-to-date remediation advice and readiness status, the Readiness Report Creator contacts Microsoft when it creates the report. Some information about your VBA macros and add-ins is sent to Microsoft. For more information about what is sent, see Examples of the information sent to Microsoft when creating an advanced report.

Important: If you're creating an advanced report, make sure the computer on which you're running the Readiness Toolkit has access to the internet. The Readiness Toolkit calls a publicly available web-service, so the following URLs need to be allowed by your firewall:

  • https://officeclient.microsoft.com/serverconfig16

  • https://ready.osi.office.net/orfo/api/readinesssummary

  • https://ready.osi.office.net/orfo/api/vbareportsummary

Interpretar la información en el informe de preparación

The Readiness Report Creator creates a readiness report as an Excel file. The readiness information available in the report depends on what information you based your report on, as well as whether you chose to create a basic or advanced report.

Cada informe se inicia con una página de introducción, que proporciona información general sobre los resultados y vínculos a los informes disponibles: VBA, Complemento o ambos.

Informes de preparación de VBA

La siguiente tabla contiene una lista de las diferentes pestañas (hojas de cálculo) que se muestran en un informe de preparación de VBA.

Nombre de la hoja de cálculo Contenido
Información general de VBA
Muestra tres gráficos circulares para proporcionar una descripción general de los resultados del análisis.

Each pie chart shows different information: the status of the files scanned, the readiness status for the unique macros found during the scan, and readiness status of the unique files scanned. See the tables later in this section for more information about the file status and readiness status values that appear in these pie charts.

The Readiness Toolkit creates a unique hash of the VBA macro code to identify macros that are reused in multiple files. The Readiness Toolkit does something similar to identify duplicate files. The Readiness Toolkit does this to provide you with a more realistic assessment of how many unique VBA macros and unique files need to be evaluated.

Nota: Si tiene previsto implementar la versión de 64 bits de Aplicaciones de Microsoft 365, asegúrese de que está seleccionada la casilla "Incluir datos de preparación de 64 bits" y que se ha actualizado el informe.
Resumen de VBA
Ofrece algunas tablas dinámicas predefinidas para permitirle analizar los datos obtenidos en el análisis.

Si estas tablas dinámicas no satisfacen sus necesidades específicas, puede crear unas propias basándose en los datos en la hoja de cálculo de resultados de VBA.
Resultados de VBA
Proporciona información sobre cada archivo digitalizado por el Creador de informes de disponibilidad. Si se encuentran varios problemas en un archivo escaneado, hay una fila independiente para cada problema.

Consulte la tabla en el encabezado "Información detallada de VBA" al final de esta sección para obtener una explicación sobre la información que aparece en cada columna.
Corrección de VBA
Proporciona cambios propuestos a código de macros de VBA encontradas durante el análisis.

Consulte la tabla en el encabezado "Información detallada de VBA" al final de esta sección para obtener una explicación sobre la información que aparece en cada columna.
Referencias de VBA
List references identified in code and in the VBA project. These references are generally used to call external DLLs, linked files, and ODBC connections for use by the VBA code.

Consulte la tabla en el encabezado "Información detallada de VBA" al final de esta sección para obtener una explicación sobre la información que aparece en cada columna.

File status: The report also categorizes, by a file status, the files that were scanned. The following table lists the possible file statuses that can appear in a readiness report, and an explanation of the file status.

Estado del archivo Explicación
Sin VBA
Se ha analizado el archivo y no se ha encontrado ningún código de macros de VBA.
Tiene VBA
Se ha analizado el archivo y se ha encontrado código de macros de VBA.
Basado en la nube
No se pudo analizar el archivo porque está guardado en una biblioteca de documentos de SharePoint, en OneDrive o en algún otro tipo de ubicación de almacenamiento basado en la nube.
Protegido con contraseña
El archivo está protegido con contraseña, por lo que no se pudo analizar en busca de macros de VBA.
Inaccesible
No se pudo analizar el archivo por algún motivo, como el creador de informes de disponibilidad no tenía permiso suficiente para obtener acceso al archivo, el archivo está dañado o el archivo usa un formato de archivo de Office antiguo.
Inaccesible: controlador requerido
El archivo no se pudo analizar porque el motor de base de datos de Microsoft Access 2010 necesario no está instalado en el equipo que realiza el análisis.
Bloqueado
El archivo estaba bloqueado o en uso cuando se realizó el análisis.
Error
The VBA code stream trying to be read during the scan wasn't in a valid format. Sometimes opening, and then saving, the file in a supported Office version will allow the Readiness Report Creator to scan the file.

Severity level: The report categorizes, by a severity level, the issues found with the VBA macros to help you estimate how much effort it will take to address the issues found. If multiple issues are found with a VBA macro, the report displays the highest severity level in the pie chart.

En la tabla siguiente se enumeran los niveles de gravedad posibles que suelen aparecer en un informe de preparación y una explicación del nivel de gravedad.

Gravedad Explicación
Preparado para actualizar
No se encontraron problemas en este archivo y es compatible con Aplicaciones de Microsoft 365.
Reconocimiento de diseño de código
Aunque el código funcionará según lo esperado y no es probable que el usuario observe cambios, la característica, propiedad o método funciona de forma distinta a como lo hacía anteriormente o puede estar obsoleta con respecto a una versión más reciente.
Validación mínima recomendada
No runtime or compile time errors are expected, but the API functionality may have changed in some way. It's recommended that the user runs a spot check on the file with Microsoft 365 Apps to ensure it continues to function as expected. To minimize environmental issues, ideally run the spot check on the computer that the macro usually runs.
Corrección mínima necesaria
Será necesario refactorizar el código. Sin embargo, hay una sustitución clara y, por lo tanto, la expectativa es que el trabajo necesario para corregir la macro se reduzca significativamente.
Corrección significativa necesaria
Significant code refactoring will be required to enable the code to continue to function as it did in the legacy Office version. For example, an API that has been deprecated, but no replacement function has been provided. In this case, the only option available is to recreate the functionality.

Detailed VBA information: The VBA Results, VBA Remediation, and VBA References tabs in the VBA readiness report each contain similar columns of information. The following table provides a list of those columns, along with an explanation of what information is contained those columns.

Nombre de columna Explicación Ejemplo
Instrucciones
El criterio (regla) identificado cuando se ha analizado el documento.
Las barras de menús y las barras de herramientas del programa ya no estarán visibles en Access 2013.
Gravedad
Gravedad del problema identificado.
Corrección significativa necesaria
Ubicación de origen
Ubicación del archivo que se ha analizado.
D:\Mis documentos\Mis archivos\
Archivo de origen
Nombre del archivo que se ha analizado.
NombreDeMiArchivo.xlsx
Hash del archivo de origen
Hash generado de forma única para el archivo.
36426A0DCFC06F6425E205F107A5CA58
Extensión del archivo de origen
Extensión del archivo que se ha analizado.
.docm
Módulo
Nombre del módulo donde se ha identificado el problema de código.
mDJSCommandBars
Número de línea
Número de línea donde se ha identificado el problema de código.
112
Tipo
Tipo de problema que se ha identificado.
VBA
Miembro
Nombre de la sección del módulo de VBA donde se ha identificado el problema (es decir, la función).
CommandBars
Instrucción
La sección del código donde se ha identificado el problema.
Dim ctlName As CommandBarControl
Hash de VBA
Hash generado de forma única para el código de VBA.
CC-D2-F3-9C-58-48-04-E4-16-5B-B6-44-B3-EB-EB-FE
Referencia
Vínculo a la descripción del problema y al contenido de ayuda (si procede).
https://technet.microsoft.com/library/cc178954.aspx
FileStatus
Clasificación del estado del archivo que se procesa.
Protegido con contraseña
64 bits
Especifica si el problema identificado es específico de 64 bits.

UserHash
Usuario del archivo.
Laura Melgar
DeviceName
Nombre del equipo en el que se ha realizado el análisis.
Portátil01
Código original
El código de VBA encontrado en la macro puede causar problemas al migrar a una versión de Office de 64 bits.
Private Declare Function FindWindow Lib "user32" Alias "FindWindowA" (ByVal lpClassName As String, ByVal lpWindowName As String) As Long
Cambios propuestos
Sugerencias sobre cómo se puede actualizar el código de VBA en la macro para que funcione correctamente con una versión de 64 bits de Office.1, 2
Private Declare PtrSafe Function FindWindow Lib "user32" Alias "FindWindowA" (ByVal lpClassName As String, ByVal lpWindowName As String) As LongPtr
Etiqueta1
Value of custom label, if configured. For more information, see Use labels to categorize and filter data in reports.
Norteamérica
Etiqueta2
Value of custom label, if configured. For more information, see Use labels to categorize and filter data in reports.
San Francisco
Etiqueta3
Value of custom label, if configured. For more information, see Use labels to categorize and filter data in reports.
Finanzas
Etiqueta4
Value of custom label, if configured. For more information, see Use labels to categorize and filter data in reports.
Controlador
Referencia del archivo de origen Unique value used to identify the file name in the file-names.log file when concealing file names when doing a scan. For more information, see Manage the privacy of data collected in reports. 9FE4E090A33CDA8F4502E7E5672464C8F40E79E353DC98FF8CA84846C7D99822
Versión de RT Versión de Readiness Toolkit instalada en el equipo que ejecuta el examen 1.0.0.0

1 Para obtener más información sobre cómo escribir código VBA para versiones de 64 bits de Office, consulte Información general acerca de Visual Basic para Aplicaciones de 64 bits.

2 Important: All proposed changes are provided as is, with no warranty or guarantee. It's important to validate that all changes work as expected when you update your VBA macro code.

Informe de complemento

La siguiente tabla contiene una lista de las diferentes pestañas (hojas de cálculo) que se muestran en un informe de complemento.

Nombre de la hoja de cálculo Contenido
Resumen del complemento
Proporciona una descripción general de los complementos que encontró el Creador de informes de preparación.

Los datos en la parte superior de la hoja de cálculo están pensados para darle una evaluación rápida de cuántos complementos es probable que sean compatibles con Aplicaciones de Microsoft 365 y en cuántos deberá investigar más.
Detalles del complemento
Proporciona información de metadatos sobre los complementos encontrados (por ejemplo, el editor y el número), el número total de instalaciones de cada complemento y, si es un informe avanzado, el estado de preparación (por ejemplo, "Versión compatible disponible").
Por nombre de equipo
Proporciona información similar a lo que aparece en la hoja de cálculo Detalles del complemento, pero muestra todos los equipos en los que el complemento está instalado, en lugar de solo el número total de instalaciones del complemento.

You can adjust what information is shown in the add-in report by selecting choices from the drop-down lists on the Add-in Summary tab, and then refreshing the report. For example, you can adjust the report to only show information about Access and Excel add-ins.

By default, add-ins that are shipped by Office aren't shown. If you want to see information about those add-ins, select "Yes" from the drop-down list and refresh the report. But, most enterprises won't need to worry about application compatibility of add-ins that are shipped with Office.

Si está recopilando información sobre el uso de complementos y solo desea ver información acerca de los complementos que se usan, puede seleccionar "Sí" en la lista desplegable y actualizar el informe.

If you plan to deploy the 64-bit version of Microsoft 365 Apps, be sure to select "64-bit" from the drop-down list and refresh the report. This provides 64-bit specific readiness information about the add-ins. The default selection for reports is 32-bit.

La siguiente tabla enumera los posibles estados de preparación que puede ver en el informe de complementos y una explicación de lo que significa cada estado.

Estado de preparación Explicación
Alta adopción
Este complemento se está usando mucho en Aplicaciones de Microsoft 365 en otras organizaciones y está listo para su uso con Aplicaciones de Microsoft 365. Pero el proveedor de software no admite el complemento oficialmente en Aplicaciones de Microsoft 365.
Adoptado
Este complemento se usa en Aplicaciones de Microsoft 365 en otras organizaciones, pero el proveedor de software no admite oficialmente el complemento en Aplicaciones de Microsoft 365.
Versión adoptada disponible
Una versión diferente de este complemento se considera "Adoptado" o "Muy adoptado" en Aplicaciones de Microsoft 365.
Póngase en contacto con el proveedor de software
This add-in might have issues with Microsoft 365 Apps. You need to decide if this add-in is business critical and then contact the software provider for guidance.
Versión compatible disponible
El proveedor de software tiene disponible una versión compatible de este complemento para Aplicaciones de Microsoft 365.
Desconocido1,2
This add-in is unknown to Microsoft. For example, it could be a line-of-business add-in that your in-house application development team created.

If you create a basic report, the readiness status for all add-ins is listed as Unknown. It's only when you create an advanced report that the Readiness Report Creator contacts Microsoft to try to get readiness status of add-ins.
Datos insuficientes2
Microsoft ha visto este complemento, pero no se ha recopilado información suficiente para proporcionar el estado de preparación de este complemento.

1 Some of the add-ins that ship by default with Office are currently flagged as Unknown in an add-in readiness report. These add-ins are actually Highly Adopted and are supported by Microsoft. Here are the names of those add-ins: ActionsPane Schema for Add-Ins, Analysis ToolPak, Analysis ToolPak - VBA, Date (XML), Conversation History Add-in for Microsoft Office 2016, Euro Currency Tools, Instant Messaging Contacts (English), Measurement Converter (Measurement Converter), Microsoft Actions Pane 3, Skype Meeting Add-in for Microsoft Office 2016, Solver Add-in, Telephone Number (XML), and Time (XML).

2 Para obtener más información, consulte Posibles pasos que debe seguir para complementos clasificados como "Desconocido" o "Datos insuficientes".

Detailed add-in information: The "Add-in Details" and "By computer name" tabs in the add-in report each contain similar columns of information. The following table provides a list of those columns, along with an explanation of what information is contained in those columns.

Nombre de columna Explicación
Nombre de máquina
El nombre del equipo en el que está instalado el complemento.

Esta columna solo aparece en la pestaña "Por nombre de equipo".
Nombre de complemento
El nombre del complemento.
Editor del complemento
El nombre del editor del complemento.
Versión del complemento
La versión del complemento.
Aplicación
The Office application that the add-in is used in. For example, Word or Excel.
Instalaciones totales
El número total de instalaciones del complemento.

Esta columna solo aparece en la pestaña "Detalles del complemento".
Estado de preparación (32 bits)
The readiness status for the add-in. Advanced reports only.

Consulte la tabla anterior para obtener una lista de los estados de preparación posibles.

Nota: Si elige "64 bits" en la lista desplegable de la pestaña "Resumen de complemento", el nombre de la columna pasará a mostrase como "(64 bits)".
Comentarios
Additional information, if available, about the readiness status of the add-in. Advanced reports only.
Más información
Link to additional readiness information about the add-in. Advanced reports only.
Instalaciones totales en dispositivos Número de dispositivos en los que está instalado el complemento.

Available when collecting add-in usage information. For more information, see Collect and show add-in usage information in reports.
Número total de dispositivos en los que se usa el complemento Número de dispositivos en los que se ha usado el complemento desde que se inició la recopilación de información sobre el uso del complemento.

Available when collecting add-in usage information. For more information, see Collect and show add-in usage information in reports.
Add-in used since (complemento usado desde) {date} Indicación de si el complemento se ha usado desde que inició la recopilación de información sobre el uso del complemento.

Available when collecting add-in usage information. For more information, see Collect and show add-in usage information in reports.

Obtener información de preparación para varios usuarios en una empresa

It's easy enough to install and run the Readiness Report Creator on a single user's computer to create a readiness report. But what if you're in a large organization and need to create readiness reports for an entire department or branch office?

Junto con la versión del asistente para interfaz de usuario del creador de informes de disponibilidad, también hay un ejecutable independiente que se puede ejecutar desde la línea de comandos o usarse con scripts. Se denomina ReadinessReportCreator.exe y se encuentra en la carpeta donde está instalado el Kit de herramientas de preparación.

If you have your users run the UI wizard version of the Readiness Report Creator, you end up with separate Excel files, one for each user. That makes it difficult to see readiness from a departmental or office-wide perspective. You also have to rely on the users to run the Readiness Report Creator and follow the instructions correctly.

The better alternative might be to use the command line capabilities of the Readiness Report Creator and use a script to run the Readiness Report Creator to collect the information on behalf of the user. You can save the files created by the Readiness Report Creator to a network share. If you do this, make sure that the appropriate write permissions are given to the share.

Nota

Si ejecuta el Kit de herramientas de preparación con Microsoft Configuration Manager o herramientas de implementación de software empresarial similares, asegúrese de implementar el paquete con el contexto de usuario, en lugar del contexto del sistema. De lo contrario, Readiness Toolkit no podrá leer la información utilizada recientemente en el subárbol de registro del usuario actual en el equipo.

Para ver una lista de las opciones de línea de comandos disponibles, abra un símbolo del sistema, vaya a la carpeta donde instaló Readiness Toolkit y, después, escriba el siguiente comando:

ReadinessReportCreator.exe -help

The command line version of the Readiness Report Creator doesn't have the all the same capabilities as the UI wizard version. You can use the command line version to scan the most recently used Office documents and installed add-ins on a computer, or Office documents in a local folder or network share.

The following is an example of a command line that you can run to scan for both VBA macros and add-ins, and save the results to a network share for the Finance department. Note that you have to include addinscan option as part of the command line for the add-in scan to occur.

ReadinessReportCreator.exe -mru -addinscan -output \\server01\finance -silent

The following is an example of a command line that you can run to scan a user's most recently used Office documents and save the results to a network share for the Finance department. This only scans for VBA macros.

ReadinessReportCreator.exe -mru -output \\server01\finance -silent

The following is an example of a command line that you can run to scan a folder, and all its subfolders, and save the results to a network share for the Finance department. This only scans for VBA macros.

ReadinessReportCreator.exe -p c:\officefiles\ -r -output \\server01\finance -silent

It's important to note that when you run the Readiness Report Creator from the command line, the Readiness Report Creator doesn't create an Excel file. Instead the Readiness Report Creator creates JSON files containing VBA macro and add-in information from the scan.

To create a consolidated Excel report from these various command line scans, you need to run the UI wizard version of the Readiness Report Creator. For the information source, select "Previous readiness results saved together in a local folder or network share," and then specify the location where you saved all the files for the scans. The Readiness Report Creator then consolidates the information from the JSON files into a readiness report in a single Excel file.

Tenga en cuenta que el Creador de informes de preparación muestra cada problema con un documento de Office en una fila independiente en la hoja de cálculo de Excel. Por lo tanto, el Creador de informes de preparación solo puede devolver 1 046 575 resultados. Si tiene previsto superar estos límites, le recomendamos que restrinja el ámbito del informe, como por ejemplo, a un departamento específico. Alternativamente, la opción de exportación de SQL no tiene un límite de número de resultados que puede acomodar, por lo que esta podría ser una opción viable si espera una alta cantidad de resultados.

By default, the Readiness Toolkit will spend 2 minutes scanning a file before timing out and moving on to another file. You can use the -t option from the command line to allow the Readiness Toolkit more than 2 minutes to scan a file.

Usar SQL Server para almacenar los resultados del informe

Desde la versión 1.2.19098 (que se publicó el 9 de abril de 2019), puede exportar los datos del informe a cualquier versión compatible de SQL Server o SQL Server Express. Esta función es en base a comentarios de muchos clientes que quieren una mayor escala y mayor flexibilidad al ejecutar informes del Kit de herramientas de preparación (Readiness Toolkit).

Puede usar el Asistente de creación de informes de preparación o la línea de comandos. Si usa el Creador de informes de preparación, seleccione una de la opción Documentos de Office en un recurso compartido de red o una carpeta local o Anteriores resultados de preparación guardados juntos en una carpeta local o un recurso compartido de red. A continuación, en la página Configuración de informes, seleccione Informe de SQL Server. Proporcione las credenciales necesarias y el nombre de la base de datos que quiere usar. Si no existe la base de datos, se creará.

En lugar de crear un archivo de Excel, se crea un informe de Power BI, con la misma información, para que pueda revisar los resultados. Puede expandir o cambiar este informe de Power BI como prefiera. Tiene una extensión de archivo .pbit y se guarda en la carpeta donde está instalado el Readiness Toolkit, que suele ser C:\Archivos de programa (x86)\Microsoft Readiness Toolkit para Office. Si se le solicita en Power BI, seleccione el modo de acceso a datos Consulta directa.

Si usa la versión de línea de comandos del Creador de informes de preparación, escriba ReadinessReportCreator.exe -help para ver los comandos apropiados para usar una base de datos de SQL Server. Por ejemplo, puede usar el siguiente comando para crear un informe de resultados de preparación anteriores para el departamento de finanzas, con una base de datos local de SQL llamada Readiness, y usar la autenticación de SQL Server en lugar de la autenticación de Windows.

ReadinessReportCreator.exe -sqlimport “C:\Reports\Finance” -server localhost/SQLEXPRESS -database Readiness -username Officeadmin -password seCRet123$%^

Usar etiquetas para clasificar y filtrar datos en informes

You can specify up to four custom labels to categorize and filter data in reports created by the Readiness Toolkit. Labels are available in reports that are based on scans of the most recently used Office documents and installed add-ins on the user’s computer.

You can specify any string for the custom labels. For example, you can use a label to indicate the user’s department, title, or geographic location. When the Readiness Toolkit runs on the user’s computer, the custom labels are collected and are made available in the reports that are created. For example, you can filter the report to show only data from the Finance Department or only data from offices in Africa. Assign labels in a consistent manner, such as always using Label 1 for department.

You can specify these labels by using the Specify custom labels to use with the Readiness Toolkit Group Policy setting. You can find this policy setting under User Configuration\Policies\Administrative Templates\Microsoft Office 2016\Readiness Toolkit. Be sure to download the latest Administrative Template files (ADMX/ADML) for Office.

Nota

If you're using the Office Telemetry Dashboard and have already configured tags (labels), the Readiness Toolkit automatically collects those labels during its scan of the user's computer and will make them available in its reports. But, labels you specify for the Readiness Toolkit won't appear in the Office Telemetry Dashboard.

Administrar la privacidad de los datos recopilados en informes

It’s common for users in an organization to save Office files using file names that contain sensitive or confidential information. To protect the privacy of users and to help prevent revealing sensitive information, the Readiness Toolkit allows you to create a report that conceals the file paths and names of documents identified during a scan. You can create a report that conceals this information either by running the Readiness Report Creator from the UI wizard or from the command line.

If you're using the UI wizard, begin by selecting either "Most recently used Office documents and installed add-ins on this computer" or "Office documents in a local folder or network share" as the type of report that you want to create. Then, on the next page of the wizard, select the Conceal file names and paths check box, before continuing on.

Si usa la línea de comandos para crear un informe, use la opción -ConcealNames tal y como se muestra en el siguiente ejemplo.

ReadinessReportCreator.exe -mru -addinscan -output \\server01\finance -silent -concealnames

When you create a report that conceals the file paths and names of documents, the only characters that remain are the drive letter, the first two characters of the file name, and the file extension. The other characters of the file path, up to 8 characters, and of the file name are replaced with asterisks (*). For example, "c:\mergersinfo\Q4\companyx.docx" will appear as "c:\********\co******.docx."

When the report is created, a file named file-names.log is created on the computer that ran the scan. This file contains a complete list of the file paths and names that were scanned, without any of the information concealed. The log file also includes a reference code for each file listed. This reference code appears in a column of the report that's created. This allows you to identify the specific file in the report, in case a VBA macro or add-in issue that needs further investigation is identified in the report. The file-names.log file is saved to a temp folder in the user's AppData folder. For example, for user01, the file is saved to the C:\Users\user01\AppData\Local\Readiness Toolkit Temp\ folder.

Recopilar y mostrar información sobre el uso de complementos en informes

Si desea obtener información más completa sobre qué complementos se usan con más frecuencia en su organización y quién los usa, puede usar las Herramientas de preparación para recopilar información sobre el uso de complementos e incluirla en un informe de preparación.

To collect add-in usage information, install the most current version of the Readiness Toolkit on each computer that you want to capture add-in usage information from. To enable the agent that generates and collects the add-in usage information, you need to enable the "Allow add-in usage data to be generated and collected by the Readiness Toolkit" Group Policy setting. This policy setting is available in the most current version of the Administrative Template files (ADMX/ADML) for Office that are available on the Microsoft Download Center. This policy setting is found under User Configuration\Policies\Administrative Templates\Microsoft Office 2016\Readiness Toolkit.

The data generated and collected includes when the add-in is loaded and used, and if the add-in crashes. This information is stored in the registry of the computer on which the usage agent runs.

We recommend that you allow the usage agent to run for at least 30 days, to ensure you have good coverage of your users and their usage behavior. Once the monitoring period is complete, create a readiness report to collect the information and display it in a report. After you have the information you need, turn off the usage agent by changing the Group Policy setting.

Nota

En esta versión de las Herramientas de preparación, no se recopila información sobre el uso de complementos en los equipos que ejecuten Office 2016.

Detectar controles de Silverlight o Flash

Silverlight, Shockwave Flash, and Macromedia Flash controls are blocked from activating in Microsoft 365 Apps. For more information about this, read this Tech Community post.

To identify Office files that contain these controls, you can choose to scan all Office documents when you create a readiness report. This will scan all Office files, even if those files don't contain macros. Because more files are scanned, report creation will take longer.

Cómo examinar archivos en la nube

By default, the Readiness Report Creator can't scan files that are saved in a SharePoint document library, in OneDrive, or in some other type of cloud-based storage location. If you try to scan one of these files, the file shows up as "Cloud-based" in the report.

One possible workaround is to scan the local cache of these cloud-based files on the user's computer. If the files are only stored in a cloud-based location, you can create a mapped network drive to a OneDrive or SharePoint share. Then, you can have Readiness Report Creator scan that drive. But, when this location is scanned, the files must be downloaded in memory to perform the scan. Depending on the number and size of those files, this could result in the scan taking significantly longer and using up a considerable amount of network bandwidth.

Examinar documentos de Office para detectar problemas con la firma de macros

Para mejorar la seguridad de la firma del proyecto de macros de VBA de Office, Microsoft proporciona una versión más segura del esquema de firma de proyectos de VBA: la firma V3. Recomendamos que las organizaciones apliquen la firma V3 a todas las macros para eliminar el riesgo de manipulación.

Puede usar el Kit de herramientas de preparación para buscar los archivos de VBA firmados de su organización que debería actualizar para usar la firma de V3.

Para encontrar estos archivos, ejecute el Creador del informe de disponibilidad desde un símbolo del sistema con privilegios elevados y use la opción análisis de la firma. La línea de comandos del ejemplo siguiente analizará los archivos de la carpeta vba_files y creará un archivo JSON en la carpeta vba_results con los resultados del análisis.

ReadinessReportCreator.exe -sigscan -p C:\vba_files -r -output C:\vba_results

Para ver los resultados en Excel, ejecute el Kit de herramientas de preparación y, en la página Crear un informe de preparación, seleccione Resultados anteriores de preparación guardados juntos en una carpeta local o en un recurso compartido de red. Después, especifique el archivo JSON que ha creado usando esta herramienta de la línea de comandos y finalice los pasos del asistente del Kit de herramientas de preparación.

Nota

Para usar el análisis de firma, debe tener al menos la versión 1.2.21067 del Kit de herramientas de preparación, que se lanzó el 19 de marzo de 2021.

Para obtener más información, incluido cómo actualizar esos archivos para usar la firma V3, vea Actualizar los proyectos de macro de VBA de Office firmados a la firma V3.

Información adicional

Extensiones de archivo analizadas de macros de VBA

La siguiente tabla enumera, por aplicación, las extensiones de archivo que se analizan cuando el Creador de informes de preparación busca macros de VBA en documentos de Office.

Application Extensión de archivo
Access
accdb, accdt, mdb
Excel
xla, xlam, xls, xlsm, xlsx, xlt, xltm, xltx
Outlook
otm
PowerPoint
pot, potm, potx, ppa, ppam, pps, ppsm, ppt, pptm, pptx, sldx, sldm
Project
mpp, mpt
Publisher
pub
Visio
vsd, vsdx, vsdm
Word
doc, docm, docx, dot, dotm, dotx

Tipos de complementos de los que recopilará datos el Creador de informes de preparación

La tabla siguiente enumera los tipos de complementos de los que el Creador de informes de preparación recopila datos. Se identifican complementos para todas las aplicaciones de Office, pero no incluye complementos web. La información de preparación se proporciona para los complementos COM que hemos visto en ejecución en Aplicaciones de Microsoft 365.

Tipo de complemento Aplicaciones de Office Descripción
Automatización
Excel
Complementos de automatización compatibles con Excel, que están basados en complementos COM. Desde las fórmulas de las hojas de cálculo de Excel se puede llamar a las funciones de los complementos de automatización.
COM
Excel, Outlook, PowerPoint y Word
Los complementos COM incluyen complementos normalmente escritos en C++ y Visual Studio Tools para Office (VSTO) desarrolladas mediante código administrado.
VBA
Excel, PowerPoint y Word
VBA add-ins are application-specific files that contain VBA code. These include macro-enabled Word templates (.dotm), Excel add-ins (.xla, .xlam), and PowerPoint add-ins (.ppa, .ppam).
WLL
Word
Los complementos WLL (.wll) son específicos de Word y se crean con cualquier compilador compatible que permita compilar DLL.
XLL
Excel
XLL add-ins (.xll) are specific to Excel and are built with any compiler that supports building DLLs (dynamic-link libraries). They do not have to be installed or registered. XLL add-ins also include DLLs that contain user-defined commands and functions.
XLS RTD
Excel
Los complementos de datos en tiempo real (RTD) XLS son hojas de cálculo de Excel que usan la función de la hoja de cálculo RealTimeData para llamar a un servidor de automatización y recuperar datos en tiempo real.

Ejemplos de la información que se envía a Microsoft al crear un informe avanzado

Si decide crear un informe avanzado, se enviará alguna información a Microsoft.

La tabla siguiente contiene una lista de la información que se envía a Microsoft sobre las macros de VBA que se encuentren durante el análisis, junto con ejemplos.

Datos Descripción Ejemplo
DevicesScanned
Número de equipos que se analizaron.
DevicesScanned: 23
UniqueUsers
Número de usuarios incluidos en el análisis.
UniqueUsers: 14
Rule
Count of how many times a specific rule was found to apply to the VBA macros scanned. A GUID is used to uniquely identify the rule.
48f05b1d-c8ad-4d0c-9453-1abdf007b2db: 23

74db65ab-76f3-43fb-997d-0d9750efb527: 2
FilesWithIssues
Número de archivos únicos con problemas de compatibilidad.
FilesWithIssues: 320
FilesWithDuplicateVBA
Número de archivos únicos que contienen macros duplicadas.
FilesWithDuplicateVBA: 233
FilesWithNoIssuesFound
Número de archivos únicos sin problemas.
FilesWithNoIssuesFound: 12
InaccessibleFiles
Número de archivos únicos inaccesibles.
InaccessibleFiles: 4
FilesPasswordProtected
Número de archivos únicos que estaban protegidos con contraseña.
FilesPasswordProtected: 123
FilesLocked
Número de archivos bloqueados únicos.
FIlesLocked: 0
FilesWithVBA
Número de archivos únicos con VBA.
FilesWithVBA: 122
FilesWithoutVBA
Número de archivos únicos sin VBA.
FilesWithoutVBA: 11
Significantremediationrequired
Número de archivos únicos que requieren corrección importante.
Significantremediationrequired: 12
Limitedremediationrequired
Número de archivos únicos que requieren corrección limitada.
Limitedremediationrequired: 12
Minimalvalidationrequired
Número de archivos únicos que requieren validación mínima.
Minimalvalidationrequired: 22
CodeDesignChanges
Número de archivos únicos que contienen el uso de las características para las que se recomiendan cambios.
CodeDesignChanges: 1
DevicesWithNoMacros Número de dispositivos que no tienen archivos con macros habilitadas. DevicesWithNoMacros: 12
DevicesWithDeclares Número de dispositivos examinados que contienen macros que usan instrucciones Declare. DevicesWithDeclares: 12
DevicesWhichRequireSignificantRemediation Número de dispositivos que contienen archivos de macro que requieren correcciones importantes. DevicesWhichRequireSignificantRemediation: 12
DevicesBlockedFromUpgrade Número de dispositivos que contienen macros que deben ser desbloqueadas para actualizar a Aplicaciones de Microsoft 365. DevicesBlockedFromUpgrade: 1
DevicesWithMacrosWithIssues Número de dispositivos con problemas de compatibilidad con macros. DevicesWithMacrosWithIssues: 2
DevicesWhichRequireLimitedRemediation Número de dispositivos que contienen archivos de macro que requieren correcciones limitadas. DevicesWhichRequireLimitedRemediation: 12
DevicesWhichRequireMinimalValidation Número de dispositivos que contienen archivos de macro que requieren validación mínima. DevicesWhichRequireMinimalValidation: 12
DevicesWithMacrosWithoutIssues Número de dispositivos que contienen macros, pero no tienen problemas de compatibilidad. DevicesWithMacrosWithoutIssues: 12
DevicesWithMacros Número de dispositivos que contienen archivos de macro. DevicesWithMacros: 12
DevicesSafeToUpgrade Número de dispositivos listos para actualizar a Aplicaciones de Microsoft 365. DevicesSafeToUpgrade: 12
DevicesWithOlderToolVersion Número de dispositivos que usan una versión anterior de Readiness Toolkit. DevicesWithOlderToolVersion: 12

La tabla siguiente contiene una lista de la información que se envía a Microsoft sobre los complementos que se encuentren durante el análisis, junto con ejemplos.

Datos Ejemplo
Id. del programa del complemento
UCAddin.LyncAddin.1
Nombre descriptivo
Complemento Difusión de reunión de Skype para Microsoft Office 2016(Outlook)
Descripción
Complemento Difusión de reunión de Skype para Microsoft Office 2016
Nombre de archivo
UCADDIN.DLL
CLSID de complemento
{A6A2383F-AD50-4D52-8110-3508275E77F7}
Proveedor
Microsoft Corporation
Marca de tiempo del archivo
1499940832
Versión de archivo
16.0.8326.2044
Aplicación de Office
Outlook
Número de dispositivos
35

Cambiar la configuración de macros para ver la información en el informe de preparación

The report created by the Readiness Report Creator uses macros and active content to display the information in the report. Therefore, to see the VBA macro compatibility and the add-in readiness information in the report, you need to allow macros and active content in Excel. If macros and active content aren't enabled in Excel, you see a Getting started message on the Overview worksheet when you open the report. On that page are instructions on how to enable macros and active content. This can be as simple as clicking Enable Content in the Message Bar.

In some cases, you might not see the Message Bar and the Enable Content choice. This is most likely because Excel is configured to disable all macros without notification. You can check this setting by going to File > Options > Trust Center > Trust Center Settings… > Macro Settings. There, in the Trust Center dialog box, you can change the setting to Disable all macros with notification. After you do that, choose OK to save the change and close the Trust Center dialog box, then choose OK to close the Excel Options dialog box, and then close the report file. When you open the report file again, you should see the Message Bar and the Enable Content choice.

If the macro settings choices are grayed out in the Trust Center dialog box, an administrator has configured these settings by using Group Policy and the settings can't be changed manually. In this case, the simplest solution is to open the report file on a different computer where the macro settings for Excel allow you to enable macros by selecting the Enable Content choice in the Message Bar.

Para obtener más información sobre las opciones de configuración de macros, consulte Habilitar o deshabilitar macros en archivos de Office.

Posibles pasos que debe seguir para complementos clasificados como "Desconocido" o "Datos insuficientes"

If an add-in is classified as "Unknown" or "Insufficient data" this means that Microsoft doesn't yet have sufficient information regarding the add-in to provide a readiness status. If this is an add-in that is business critical for your organization, you can do the following:

  • Póngase en contacto con el proveedor de software que desarrolló este complemento para ver si el complemento es compatible con Aplicaciones de Microsoft 365.

  • Contact us at ReadyForOffice@microsoft.com. We'll do our best to add the readiness status of the add-in to our database. Please provide as much information about the add-in as possible including, but not limited to, the following:

    • Nombre descriptivo

    • Versión de archivo

    • Proveedor de software

    • Vínculo de descarga o cualquier información sobre cómo descargar e instalar el complemento.

    • Otros detalles, como el tipo de complemento, con qué aplicación de Office se usa, el identificador de programa o el CLSID.

Información enviada en un informe de errores a Microsoft

Si hay un problema al mostrar los informes de preparación, recibirá un mensaje en el que se le pregunta si quiere enviar un informe de errores a Microsoft. Por ejemplo, si hay un problema al crear un gráfico en el informe o consultar los datos recopilados.

By sending an error report to Microsoft, you can help us improve the Readiness Toolkit. The error report sent to Microsoft doesn't contain any personally identifiable information. The following table provides a list of what information is sent to Microsoft in the error report.

Datos enviados Descripción
Módulo El módulo de VBA en el que se produjo el error.
Nombre de la función o del procedimiento Sub El nombre de la función o el procedimiento Sub en el que se produjo el error.
Identificador de la línea El identificador colocado al principio de la última línea de código ejecutada correctamente.
Mensaje de error The user message normally output by the error. May be localized for some errors.
Número de error El número de identificación del error.
Nombre de origen The name of the object that raised the error. This is not the variable name.
Versión de la herramienta La versión de Readiness Toolkit que se usó.
GUID de informe Un GUID generado para cada informe para ayudar a filtrar los errores repetidos.
Id. de sesión El identificador de sesión cuando se creó el informe para ayudar a establecer una correlación con los errores registrados por Readiness Toolkit.
Versión de Excel La versión de Excel que se usó para ver los informes de preparación.