Visualización de contenido XML de los archivos de personalización de la Herramienta de personalización de Office

 

Se aplica a: Office 2010

Última modificación del tema: 2016-11-29

Los administradores usan la Herramienta de personalización de Office (OCT) para personalizar una instalación de Microsoft Office 2010. Las personalizaciones se guardan en un archivo de personalización del programa de instalación (archivo .msp) que utiliza el formato de lenguaje de marcado extensible (XML). Este artículo contiene un script de ejemplo de Microsoft Visual Basic que los administradores pueden utilizar para ver la configuración que se almacena en los archivos de personalización de instalación .msp.

En este artículo:

  • Información general sobre Windows Script Host

  • Script de ejemplo ExtractOctXml.vbs

  • Ejecución del script

  • Visualización de contenido XML desde un archivo de personalización .msp

Información general sobre Windows Script Host

Para ejecutar el script, use Windows Script Host (WSH), un host de scripts independiente del lenguaje para motores de scripts compatibles con Windows Script. WSH permite ejecutar scripts desde el escritorio de Windows y en el símbolo del sistema.

Para ejecutar los scripts desde Windows, WScript.exe proporciona un cuadro de diálogo basado en Windows para establecer las propiedades de los scripts. Para ejecutar los scripts desde el símbolo del sistema, CScript.exe proporciona modificadores de la línea de comandos para establecer las propiedades de los scripts.

WSH proporciona compatibilidad con la característica de arrastrar y colocar para los scripts. Esto significa que puede arrastrar archivos a un script de WSH. Los nombres de archivo se traducen en argumentos en la línea de comandos.

Para obtener más información acerca de WSH, consulte los siguientes recursos en el sitio Web de MSDN:

Script de ejemplo ExtractOctXml.vbs

Las siguientes secciones proporcionan un script de ejemplo de Visual Basic (ExtractOctXml.vbs) e instrucciones para utilizar el script para extraer los metadatos XML de los archivos de personalización .msp de OCT.

Para guardar el script de ejemplo, abra un editor de texto, como Bloc de notas, y copie y pegue el código del script de esta sección en un archivo. Guarde el archivo del script como ExtractOctXml.vbs.

' Utility to extract the metadata from an Office 2010 customization patch 
' For use with Windows Scripting Host, CScript.exe or WScript.exe
' Copyright (c) Microsoft Corporation. All rights reserved.
'
Option Explicit

Const msiOpenDatabaseModePatchFile = 32
Const msiOpenDatabaseModeReadOnly     = 0
Const msiReadStreamBytes = 1

Const ForWriting = 2
Const TristateTrue = -1

Dim pathOCT_Patch 'As String
Dim pathMetadataXml 'As String
Dim sMetadata 'As String
Dim wshShell 'As Wscript.Shell
Dim fso 'As FileSystemObject
Dim fileOutput 'As File
Dim sErrSection ' As String


sErrSection = "ArgCheck"
' Check arg count, and display help if argument not present or contains ?
Dim argCount:argCount = Wscript.Arguments.Count
If argCount > 0 Then If InStr(1, Wscript.Arguments(0), "?", vbTextCompare) > 0 Then argCount = 0
If (argCount = 0) Then
    Wscript.Echo "Office 2010 OCT Metadata Extract utility" & _
        vbNewLine & " You must supply the location of the Office 2010 customization patch " & _
        vbNewLine & _
        vbNewLine & "Copyright (C) Microsoft Corporation.  All rights reserved."
    Wscript.Quit 1
Else
    pathOCT_Patch = Trim(Wscript.Arguments(0))
End If


sErrSection = "FSO"
' Create FileSystemObject and verify file exists
Set fso = CreateObject("Scripting.FileSystemObject") : CheckError
If Not fso.FileExists(pathOCT_Patch) Then Err = 2 : CheckError


sErrSection = "WI"
' Connect to Windows Installer object
On Error Resume Next
Dim wi : Set wi = Nothing
Set wi = Wscript.CreateObject("WindowsInstaller.Installer") : CheckError


sErrSection = "Read Metadata"
' Open OCT patch and read the metadata stream
Dim wiStorage, vw, rec
Set wiStorage = wi.OpenDatabase(pathOCT_Patch, msiOpenDatabaseModePatchFile) : CheckError
Set vw = wiStorage.OpenView("SELECT * FROM _Streams WHERE `Name`='metadata' ") : CheckError
vw.Execute
Set rec = vw.Fetch
If Not rec Is Nothing Then
    sMetadata = rec.ReadStream(2, rec.DataSize(2), msiReadStreamBytes)
Else
    Wscript.Echo "No Metadata stream was found in this file: " & pathOCT_Patch
    Wscript.Quit 2
End If

Set wiStorage = Nothing
Set rec = Nothing: Set vw = Nothing
Set wi = Nothing


sErrSection = "Write Metadata"
' Write the metadata stream to a temp file
Set wshShell = CreateObject("WScript.Shell") : CheckError
pathMetadataXml = wshShell.ExpandEnvironmentStrings("%temp%") & "\" & fso.GetFileName(pathOCT_Patch) & ".xml"
Set fileOutput = fso.OpenTextFile(pathMetadataXml, ForWriting, True, -1) : CheckError
fileOutput.WriteLine sMetadata 
fileOutput.Close

Set fileOutput = Nothing: Set fso = Nothing

sErrSection = "Show Metadata"
' Launch Metadata in IE
wshShell.Run "iexplore.exe " & pathMetadataXml 

    
    
Sub CheckError
Dim sMsg, errRec
    If Err = 0 Then Exit Sub
    sMsg = sErrSection & vbNewLine & Err.Source & " " & Hex(Err) & ": " & Err.Description
    If Not wi Is Nothing Then
    Set errRec = wi.LastErrorRecord
        If Not errRec Is Nothing Then sMsg = sMsg & vbNewLine & errRec.FormatText
    End If
    Wscript.Echo sMsg
    Wscript.Quit 2
End Sub

Sub NoMetadata
End Sub

Ejecución del script

El archivo ExtractOctXml.vbs puede almacenarse en cualquier lugar del equipo. Para usar el script ExtractOctXml.vbs, puede arrastrar el archivo de personalización .msp de OCT cuyas opciones configuradas desea ver y colóquelo en el script. El script extrae los metadatos XML en la carpeta temporal del usuario como <nombre de la actualización de OCT>.xml (por ejemplo, Access.MSP.xml). El archivo XML luego se pasa a Internet Explorer para su visualización.

Para ejecutar el script

  1. Use el Explorador de Windows para abrir la carpeta que contiene el archivo ExtractOctXml.vbs.

  2. Arrastre y coloque una copia del archivo de personalización del programa de instalación .msp que desea ver en ExtractOctXml.vbs, que se muestra en la ventana del Explorador de Windows.

  3. Una vez abierto el archivo XML, puede expandir y contraer las distintas secciones para ver las configuraciones contenidas en el archivo de personalización .msp.

    El elemento <Configuración del usuario> del archivo metadata.xml, Access.MSP.xml, contiene la configuración del usuario establecida en el archivo de personalización .msp y el elemento <Opciones> del archivo metadata.xml, Access.MSP.xml, contiene la configuración relacionada con los estados de características.

Para ejecutar el script mediante el uso de la línea de comandos

  1. Haga clic en Inicio, en Ejecutar y, a continuación, escriba cmd.

  2. En la ventana del símbolo del sistema, escriba:

    cscript <ruta del script> \ExtractOCTXml.vbs <nombre de archivo y ruta de MSP de OCT>

    O bien,

    wscript <ruta del script> \ExtractOCTXml.vbs <nombre de archivo y ruta de MSP de OCT>

    El archivo XML se carga en Internet Explorer para su visualización.

Visualización de contenido XML desde un archivo de personalización .msp

La herramienta OCT usa los archivos de configuración (.opax) para rellenar la interfaz de usuario de Modificar la configuración de usuario en OCT y agrega los valores y claves de Registro apropiados durante la instalación. Los archivos de configuración .opax de Office 2010 se almacenan en la carpeta Admin que se encuentra en la raíz de la ubicación del archivo de origen de Office 2010 o en el CD.

La siguiente tabla describe las secciones de nivel superior incluidas en el archivo metadata.xml del .msp.

Sección Descripción

<Customization platform - baseFolder>

Proporciona la información de nombre y ruta del archivo de personalización .msp. El código utiliza internamente estos elementos. No representan las personalizaciones reales.

<Product id>

Proporciona información acerca de los paquetes de origen de instalación local, el estado de la instalación (por ejemplo, Siempre instalado), paquetes de idioma MUI, identificadores de productos, características e identificadores, accesos directos y aplicaciones que se pueden actualizar.

El código usa internamente estos elementos. No representan las personalizaciones reales.

<SecurityApps>

Enumera las aplicaciones que pueden tener ubicaciones de seguridad específicas, como se indica en la lista desplegable Agregar las rutas de acceso siguientes a la listade ubicaciones de confianza que se encuentra en el área Configurar\Configuración de seguridad de Office en la herramienta OCT.

El código usa internamente estos elementos. No representan las personalizaciones reales.

<SecurityAppSettings>

Muestra la configuración de seguridad que aparece en el área Configurar\Configuraciones de seguridad de Office en la herramienta OCT. Las personalizaciones para esta lista aparecen en el elemento <SecuritySettings>.

El código usa internamente estos elementos. No representan las personalizaciones reales.

<SecurityPossibleSettingValues>

Muestra las opciones de seguridad que están disponibles para <SecurityAppSettings>.

El código usa internamente estos elementos. No representan las personalizaciones reales.

<GlobalSettings>

Proporciona información acerca de las propiedades de configuración que se encuentran en la sección Configurar\Modificar propiedades de configuración de la herramienta OCT.

<UserSettings>

Proporciona datos de la clave del Registro e información acerca de cualquier configuración establecida en la sección Características\Modificar configuración de usuario de la herramienta OCT.

<File>

Proporciona información acerca de todos los archivos que se agregan o quitan mediante el uso de las opciones Contenido adicional\Agregar archivos o Quitar archivos en la herramienta OCT.

<Registry>

Proporciona información acerca de las claves del Registro que se han agregado o eliminado mediante el uso de las opciones Contenido adicional\Agregar entradas del Registro o Quitar entradas del Registro en la herramienta OCT.

<Shortcuts>

Proporciona información acerca de los accesos directos que se agregan mediante el uso de las opciones Contenido adicional\Configurar accesos directos en la herramienta OCT.

<Install>

Proporciona información acerca de la configuración de la instalación que se encuentra en las opciones Configurar\Ubicación de instalación y nombre de la organización, Configurar\Orígenes de redes adicionales y Configurar\Licencia e interfaz de usuario en la herramienta OCT.

<ChildInstalls>

Proporciona información acerca de las acciones adicionales posteriores a la instalación que se encuentra en las opciones Configurar/Agregar instalaciones y ejecutar programas en la herramienta OCT.

<Options>

Contiene configuraciones relacionadas con los estados de las características de la aplicación.

<SecuritySettings>

Proporciona información acerca de los cambios realizados a la configuración de seguridad predeterminada mediante el uso de la sección Configurar\Secciones de seguridad de Office\Configuración de seguridad predeterminada de la herramienta OCT.

<SecurityTrustedLocations>

Proporciona información acerca de las ubicaciones de confianza agregadas a las opciones Configurar\Configuración de seguridad de Office en la herramienta OCT (en Agregar las siguientes rutas a la lista de ubicaciones de confianza).

<SecurityCertificates>

Proporciona información acerca de los certificados agregados a las opciones Configurar\Configuración de seguridad de Office en la herramienta OCT (en Agregue los siguientes certificados digitales a la lista de editores de confianza).

<Outlook>

Proporciona información sobre la personalización del Perfil de Outlook realizada en las opciones Outlook de la herramienta OCT.

En el ejemplo siguiente se muestra cómo buscar configuraciones en el archivo XML resultante (Access.MSP.xml en este ejemplo) que se abre en Internet Explorer al ejecutar el script ExtractOctXml.vbs con un archivo de personalización .msp de OCT.

Ejemplo

Este ejemplo usa un archivo de personalización .msp de Office 2010. Solamente está instalado Microsoft Access 2010 y está habilitado el formato de archivo de Microsoft Office Access 2007. La configuración de usuario de Formato de archivo predeterminado para Access se encuentra en el nodo Microsoft Office Access 2010\Varios de la sección Modificar configuración del usuario de la herramienta OCT.

En el archivo metadata.xml de personalización, Access.MSP.xml, busque el valor o la clave del Registro, como Default file format. La búsqueda de “Default file format” en este ejemplo ofrecería la siguiente sección del archivo metadata.xml, Access.MSP.xml:

<AddRegistries>

<AddRegistry root="HKCU" key="software\microsoft\office\14.0\access\settings" name="default file format" emptykey="false" flags="0" type="2" value="12" guid="{39478C45-8DBA-403C-B4BB-1F1D07CE85D7}" />

Use un editor de texto, como el Bloc de notas, para abrir el archivo de configuración .opax de Access 2010, access14.opax (que se encuentra en la raíz de la ubicación del archivo de origen de Office 2010, en la carpeta Admin). Busque la cadena DefaultFileFormat (que corresponde a la configuración del usuario Formato de archivo predeterminado). Si lo hace, se mostrará la siguiente sección del archivo access14.opax:

<policy name="L_DefaultFileFormat" class="User" displayName="$(string.L_DefaultFileFormat)" explainText="$(string.L_DefaultFileFormatExplain)" presentation="$(presentation.L_DefaultFileFormat)" key="software\policies\microsoft\office\14.0\access\settings">

<parentCategory ref="L_Miscellaneous" />

<supportedOn ref="windows:SUPPORTED_WindowsVista" />

<elements>

<enum id="L_empty87" valueName="Default File Format">

<item displayName="$(string.L_Access2007)">

<value>

<decimal value="12" />

</value>

</item>

<item displayName="$(string.L_Access20022003)">

<value>

<decimal value="10" />

</value>

</item>

<item displayName="$(string.L_Access2000)">

<value>

<decimal value="9" />

</value>

</item>

</enum>

</elements>

</policy>

En esta información de configuración del usuario, puede determinar la clave del Registro para la configuración (software\directivas\microsoft\office\14.0\access\configuración en este caso) y los valores posibles del Registro. Un valor Default File Format de 12 establece el formato de archivo predeterminado en Access 2007, mientras que un valor Default File Format de 10 establece el formato de archivo predeterminado en Access 2002-2003.

Mediante la información del archivo .opax, verá que la clave Default File Format tiene un valor de 12, lo que establece el formato de archivo predeterminado en Access 2007.

Los siguientes fragmentos muestran algunos de los valores de Option id de Access que aparecen en la sección <Options> del archivo Access.MSP.xml en este ejemplo:

<Option id="ACCESSFiles" installState="3" />

<Option id="Access_PIA" installState="3" />

<Option id="AccessWizards" installState="3" />

<Option id="DeveloperWizards" installState="3" />

<Option id="AccessHelpFiles" installState="3" />

<Option id="AccessTemplatesIntl" installState="3" />

Para obtener más información acerca de los identificadores de OptionState, vea Elemento OptionState en Archivo Config.xml de 2010 Office.