Visualizzare il contenuto XML nei file di personalizzazione dello Strumento di personalizzazione di Office

Aggiornamento: giugno 2008

Si applica a: Office Resource Kit

 

Ultima modifica dell'argomento: 2015-03-09

Gli amministratori utilizzano lo Strumento di personalizzazione di Office per personalizzare un'installazione di Microsoft Office System 2007. Le personalizzazioni vengono salvate in un file di personalizzazione dell'installazione (MSP) che utilizza il formato XML (Extensible Markup Language). In questo articolo viene riportato uno script di Microsoft Visual Basic che viene utilizzato dagli amministratori per visualizzare le impostazioni archiviate nei file MSP dello Strumento di personalizzazione di Office.

Panoramica di Windows Script Host

Per eseguire lo script, utilizzare Microsoft Windows Script Host (WSH), un host di scripting indipendente dal linguaggio per motori di script compatibili con Windows Script. WSH consente di eseguire script sia dal desktop di Windows che dal prompt dei comandi.

Per eseguire script da Windows, WScript.exe prevede una finestra di dialogo basata su Windows per l'impostazione delle proprietà degli script. Per eseguire script dal prompt dei comandi, CScript.exe prevede opzioni della riga di comando per l'impostazione delle proprietà degli script.

WSH prevede il supporto del trascinamento della selezione per gli script. Questo significa che è possibile trascinare file in uno script WSH. I nomi dei file vengono convertiti in argomenti sulla riga di comando.

Per ulteriori informazioni su WSH, vedere le risorse seguenti sul sito Web MSDN:

Script ExtractOctXml.vbs di esempio

Nelle sezioni seguenti vengono riportati uno script di Visual Basic di esempio, ExtractOctXml.vbs, e le istruzioni da seguire per utilizzarlo per estrarre metadati XML dai file di personalizzazione MSP dello Strumento di personalizzazione di Office.

Per salvare lo script di esempio, aprire un editor di testo come Blocco note e copiare e incollare in un file il codice dello script riportato in questa sezione. Salvare il file di script come ExtractOctXml.vbs.

' Utility to extract the metadata from an Office 2007 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 2007 OCT Metadata Extract utility" & _
        vbNewLine & " You must supply the location of the Office 2007 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

Esecuzione dello script

Il file ExtractOctXml.vbs può essere archiviato in qualsiasi punto del computer. Per utilizzare lo script ExtractOctXml.vbs basta trascinare il file di personalizzazione MSP dello Strumento di personalizzazione di Office sullo script. Lo script estrarrà i metadati XML nella cartella Temp dell'utente come <nome della patch dello Strumento di personalizzazione di Office>.xml. Il file XML verrà quindi passato a Internet Explorer per la visualizzazione.

Eseguire lo script

  1. Utilizzare Esplora risorse per aprire la cartella contenente il file ExtractOctXml.vbs.

  2. Trascinare una copia del file MSP che si desidera visualizzare nel file ExtractOctXml.vbs visualizzato nella finestra di Esplora risorse.

  3. Dopo l'apertura del file XML, è possibile espandere e comprimere le diverse sezioni per visualizzare le impostazioni contenute nel file di personalizzazione MSP.

    L'elemento <UserSettings> del file metadata.xml contiene le impostazioni utente configurate nel file di personalizzazione MSP, mentre l'elemento <Options> contiene le impostazioni relative agli stati delle caratteristiche.

Eseguire lo script utilizzando la riga di comando

  1. Fare clic sul pulsante Start, scegliere Esegui e quindi digitare cmd.

  2. Nella finestra di comando digitare:

    cscript <percorso script> \ExtractOCTXml.vbs <nome e percorso file MSP dello Strumento di personalizzazione di Office>

    -oppure-

    wscript <percorso script> \ExtractOCTXml.vbs <nome e percorso file MSP dello Strumento di personalizzazione di Office>

    Il file XML viene caricato in Internet Explorer per la visualizzazione.

Visualizzazione del contenuto XML da un file di personalizzazione MSP

Lo Strumento di personalizzazione di Office utilizza file di impostazioni (OPA) per popolare l'interfaccia utente di Modifica impostazioni utente nello Strumento di personalizzazione di Office e aggiungere le chiavi del Registro di sistema appropriate e i relativi valori durante l'installazione. I file di impostazioni OPA di Office 2007 vengono archiviati nella cartella Admin ubicata nella radice del percorso dei file di origine di Office 2007 o del CD.

Nella tabella seguente vengono descritte le sezioni di livello superiore incluse nel file MSP metadata.xml.

Sezione Descrizione

<Customization baseFolder>

Include informazioni sul nome e il percorso del file di personalizzazione MSP. Questi elementi vengono utilizzati internamente dal codice e non rappresentano le personalizzazioni effettive.

<Product id>

Include informazioni sui pacchetti di origine dell'installazione locale, lo stato dell'installazione (ad esempio Installa sempre), i pacchetti MUI di lingua, gli ID dei prodotti, le caratteristiche e gli ID, i collegamenti e le applicazioni aggiornabili.

Questi elementi vengono utilizzati internamente dal codice e non rappresentano le personalizzazioni effettive.

<SecurityApps>

Elenca le applicazioni che possono avere percorsi di protezione specifici, come indicato nell'elenco a discesa disponibile nell'area Installazione\Impostazioni di protezione di OfficeAggiungi i percorsi seguenti all'elenco dei percorsi attendibili dello Strumento di personalizzazione di Office.

Questi elementi vengono utilizzati internamente dal codice e non rappresentano le personalizzazioni effettive.

<SecurityAppSettings>

Elenca le impostazioni di protezione che vengono visualizzate nell'area Installazione\Impostazioni di protezione di Office dello Strumento di personalizzazione di Office. Le personalizzazioni di questo elenco vengono visualizzate nel successivo elemento <SecuritySettings>.

Questi elementi vengono utilizzati internamente dal codice e non rappresentano le personalizzazioni effettive.

<SecurityPossibleSettingValues>

Elenca le opzioni di protezione disponibili per <SecurityAppSettings>.

Questi elementi vengono utilizzati internamente dal codice e non rappresentano le personalizzazioni effettive.

<GlobalSettings>

Fornisce informazioni sulle proprietà di installazione presenti nella sezione Installazione\Modifica proprietà installazione dello Strumento di personalizzazione di Office.

<UserSettings>

Fornisce informazioni e dati sulle chiavi del Registro di sistema relative a eventuali impostazioni configurate nella sezione Caratteristiche\Modifica impostazioni utente dello Strumento di personalizzazione di Office.

<File>

Fornisce informazioni su eventuali file aggiunti o rimossi utilizzando le opzioni Contenuto aggiuntivo\Aggiungi file o Rimuovi file dello Strumento di personalizzazione di Office.

<Registry>

Fornisce informazioni su eventuali chiavi del Registro di sistema aggiunte o rimosse utilizzando le opzioni Contenuto aggiuntivo\Aggiungi voci del Registro di sistema o Rimuovi voci del Registro di sistema dello Strumento di personalizzazione di Office.

<Shortcuts>

Fornisce informazioni sui collegamenti aggiunti utilizzando le opzioni Contenuto aggiuntivo\Configura collegamenti dello Strumento di personalizzazione di Office.

<Install>

Fornisce informazioni sulle impostazioni di installazione presenti nelle opzioni Installazione\Percorso di installazione e nome organizzazione, Installazione\Origini di rete aggiuntive e Installazione\Licenze e interfaccia utente dello Strumento di personalizzazione di Office.

<ChildInstalls>

Fornisce informazioni sulle ulteriori azioni successive all'installazione presenti nelle opzioni Installazione/Aggiungi installazioni ed esegui programmi dello Strumento di personalizzazione di Office.

<Options>

Contiene impostazioni relative agli stati delle caratteristiche delle applicazioni.

<SecuritySettings>

Fornisce informazioni sulle modifiche apportate alle impostazioni di protezione predefinite utilizzando la sezione Installazione\Impostazioni di protezione di Office\Impostazioni di protezione predefinite dello Strumento di personalizzazione di Office.

<SecurityTrustedLocations>

Fornisce informazioni sui percorsi attendibili aggiunti in Aggiungi i percorsi seguenti all'elenco dei percorsi attendibili nelle opzioni Installazione\Impostazioni di protezione di Office dello Strumento di personalizzazione di Office.

<SecurityCertificates>

Fornisce informazioni sui certificati aggiunti in Aggiungi i certificati digitali seguenti all'elenco degli editori attendibili nelle opzioni Installazione\Impostazioni di protezione di Office nello Strumento di personalizzazione di Office.

<Outlook>

Fornisce informazioni sulla personalizzazione del Profilo di Outlook eseguita nelle opzioni Outlook dello Strumento di personalizzazione di Office.

Nell'esempio seguente viene illustrato come individuare impostazioni nel file XML generato, che viene aperto in Internet Explorer, quando si esegue lo script ExtractOctXml.vbs con un file di personalizzazione MSP dello Strumento di personalizzazione di Office.

Esempio

Nell'esempio viene utilizzato un file di personalizzazione MSP di Microsoft Office Professional 2007 Plus. È installato solo Microsoft Office Access 2007 ed è configurato il formato di file predefinito per Access, Access 2007. L'impostazione utente Formato di file predefinito per Access si trova nel nodo Microsoft Office Access 2007\Varie della schermata Modifica impostazioni utente dello Strumento di personalizzazione di Office.

Utilizzare un editor di testo come Blocco note per aprire il file delle impostazioni OPA di Access 2007, access12.opa, disponibile nella radice del percorso dei file di origine di Office 2007, nella cartella Admin. Ricercare la stringa visualizzata nello Strumento di personalizzazione di Office per l'impostazione utente Formato di file predefinito, ovvero "Default file format". Verrà così visualizzata la sezione seguente del file access12.opa:

KEYNAME Software\Microsoft\Office\12.0\Access\Settings

PART !!L_Empty DROPDOWNLIST

VALUENAME "Default File Format"

ITEMLIST

NAME !!L_Access2007 VALUE NUMERIC 12 DEFAULT

NAME !!L_Access20022003 VALUE NUMERIC 10

END ITEMLIST

Con queste informazioni sull'impostazione utente è possibile determinare la chiave del Registro di sistema per l'impostazione, in questo caso Software\Microsoft\Office\12.0\Access\Settings, e i possibili valori del Registro di sistema. Se il valore di Default File Format è 12, il formato di file predefinito viene impostato su Access 2007, mentre se il valore di Default File Format è 10, il formato di file predefinito viene impostato su Access 2002-2003.

Dopo aver ottenuto queste informazioni dal file access12.opa, è possibile ricercare, nel file di personalizzazione metadata.xml, la chiave o il valore del Registro di sistema desiderato, ad esempio Software\Microsoft\Office\12.0\Access\Settings. Verrà così visualizzata la sezione seguente del file metadata.xml:

<AddRegistries>

<AddRegistry root="HKCU" key="Software\Microsoft\Office\12.0\Access\Settings" name="Default File Format" emptykey="false" flags="0" type="0" value="12" guid="{2A044E97-7BB1-4644-BF84-A35A5B2E5D51}" />

Utilizzando le informazioni del file OPA, è possibile notare che la chiave Default File Format ha valore 12 e imposta quindi il formato di file predefinito su Access 2007.

Di seguito è riportato un estratto della sezione <Options> del file XML dell'esempio:

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

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

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

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

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

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

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

<Option id="EXCELFiles" installState="1" />

.

.

<Option id="OUTLOOKFiles" installState="1" />

.

.

<Option id="PPTFiles" installState="1" />

Per ulteriori informazioni sugli ID di OptionState, vedere la sezione Elemento OptionState dell'articolo File Config.xml in Office System 2007.