Arquivo Config.xml no Office System 2007

Sintaxe

<Configuration [Product="productID"] >

   ...

</Configuration>

Atributos

Comentários

O atributo Product identifica o produto afetado por esse arquivo Config.xml. O productID é definido no arquivo Setup.xml localizado na pasta principal para o produto, no atributo ID do elemento Setup.

O atributo Product é opcional, a menos que você defina o atributo Elemento de exibiçãoLevel como "Basic" ou "None". Nesse caso, o atributo Product será obrigatório. Se o produto especificado pelo atributo Product não existir no ponto de instalação de rede, o programa de instalação terminará a instalação.

Exemplo

O productID para o Office Enterprise 2007 está localizado em Enterprise.WW\Setup.xml, na seguinte linha:

<Setup Id="Enterprise" Type="Product" ... >

Você usa esse productID no arquivo Config.xml para especificar o Office Enterprise 2007 digitando o seguinte:

<Configuration Product="Enterprise">
   ...
</Configuration>

Sintaxe

< AddLanguage

ID = " ii-cc " | "correspondência"

   [ShellTransform="Yes"]

/>

Atributos

Comentários

O idioma deve estar disponível no ponto de instalação de rede.

Você pode ter vários elementos AddLanguage e Elemento RemoveLanguage. Se os elementos Elemento RemoveLanguage e AddLanguage especificarem o mesmo idioma, o elemento AddLanguage terá precedência e o idioma será instalado.

Observação:
Se mais de um elemento AddLanguage for especificado, um (e somente um) idioma deverá especificar que o elemento ShellTransform ou a Instalação terminará a instalação.

Há três conceitos de idioma diferente, que você deve conhecer ao instalar o 2007 Office system:

• Interface do usuário da Instalação: o idioma da instalação.

• Interface do usuário do shell: o idioma de atalhos, menus de contexto de dois cliques e dicas de ferramentas.

• Interface do usuário do Office: o idioma da interface do usuário e menus do Office.

Quando houver vários idiomas do Office, esses três valores serão determinados da seguinte maneira:

Por padrão, a interface do usuário de configuração depende do conjunto de recursos disponíveis para instalação e a capacidade de coincidir com a localidade do usuário. A interface do usuário de Instalação corresponderá à localidade do usuário por padrão. A interface do usuário do shell depende do conjunto de idiomas que está sendo instalado e por padrão, ele segue a interface do usuário de Instalação. O idioma de interface do usuário do Office padrão depende na localidade do usuário e de configurações de usuário atuais. O padrão é usar a localidade do usuário do Windows definida no computador de cada usuário. Isso significa que no caso padrão, a interface do usuário de instalação, a interface do usuário do shell e a interface do usuário do Office serão iguais.

Uma localidade nos sistemas operacionais Windows é um conjunto de informações relacionadas ao idioma, ambiente e convenções culturais do usuário. Essa informação é representada como uma lista de valores usados para determinar o idioma de entrada correto, layout de teclado, ordem de classificação e os formatos usados para números, datas, moedas e tempo. A localidade do usuário é uma configuração feita por usuário que determina os formatos usados por padrão para exibir datas, horas, moeda e números e a ordem de classificação do texto. Uma localidade de usuário é especificada para cada conta criada em um computador.

Se o administrador especificar vários idiomas para a instalação no arquivo Config.xml, o idioma UI do shell deverá ser escolhido no conjunto de idiomas de instalação. Para fazer isso, os administradores especificam o atributo ShellTransform do elemento AddLanguage no arquivo Config.xml. Isso especifica o idioma de instalação que deve ser usado para a interface do usuário do shell. No entanto, isso não afetará necessariamente a opção da interface do usuário da Instalação ou da interface do usuário do Office na instalação do computador do usuário.

Por exemplo, se você tiver uma imagem do Office com inglês, francês, alemão e espanhol, para especificar que o programa de instalação instale suporte de idioma completo para esses idiomas e fazer com a interface do usuário do shell execute opções regionais do usuário padrão, adicione os seguintes elementos ao arquivo Config.xml:

<AddLanguage Id="match" ShellTransform="yes"/> <AddLanguage Id="en-us" /> <AddLanguage Id="fr-fr" /> <AddLanguage Id="de-de" /> <AddLanguage Id="es-es" />

No exemplo anterior, o programa instala todos os idiomas especificados e a interface do usuário do shell corresponde ao idioma da localidade do usuário. Se houvesse mais idiomas disponíveis na imagem de origem, o valor de correspondência no exemplo anterior poderia instalar um idioma adicional no caso em que o idioma de correspondência não fosse resolvido para um dos outros quatro idiomas explicitamente chamados. Por exemplo, se japonês também fosse incluído na origem, este exemplo instalaria japonês juntamente com os outros quatro idiomas em um computador com a localidade do usuário definida como japonês.

Exemplo

<AddLanguage Id="en-us" ShellTransform="Yes" />

Sintaxe

<ARP atributo =" valor " [atributo**="valor"**] ... />

Atributos

Sintaxe

<CCP_DRIVE Value=" valor " />

Atributos

Exemplo

<CCP_DRIVE Value="\\server\office2003" />

Sintaxe

<Command

   Path="caminho"

[QuietArg="argumentos"]

[Args="argumentos"]

   [ChainPosition="Before" | "After"(padrão)]

[Wait="milissegundos"]

[Execute="Install"(padrão) | "Uninstall"]

[Platform="x86"(padrão) | "x64"]

/>

Atributos

A tabela a seguir descreve os atributos do elemento Comando.

Comentários

O elemento Command do arquivo Config.xml e a opção Adicionar instalações e executar programas da OCT (linhas de comando inseridas nas caixas de diálogo Adicionar Entrada de Programae Modificar Entrada de Programa) foram criados para serem usados somente por instalações e desinstalações iniciais do produto. Os comandos do elemento Command são processados somente durante instalações e desinstalações iniciais. Se os comandos do elemento Command forem usados para personalizações após a instalação inicial, eles serão ignorados.

A linha de comando pode ser especificada para executar um comando arbitrário ou um executável leve a ser executado quando esse produto for instalado.

O elemento Command do Config.xml e a opção Adicionar instalações e executar programas da OCT não fornecem os recursos de implantação de software que uma ferramenta de implantação e gerenciamento de software fornece. Por isso, é recomendável limitar o uso do elemento Command do Config.xml e da opção Adicionar instalações e executar programas da OCT, definindo a execução só de executáveis leves ou de comandos arbitrários que não façam alterações no computador ou que não exijam entrada do usuário. Por exemplo, você pode executar um utilitário para copiar ou um comando para iniciar a página de boas-vindas no final da instalação.

Importante:

O encadeamento não é tão confiável quando a instalação de cada produto é feita separadamente. Por exemplo, se você encadear duas instalações e um dos produtos falhar ou encontrar um erro inesperado, a instalação principal e a instalação encadeada poderão não ser concluídas com êxito. Portanto, não é recomendável o uso da abordagem de encadeamento. O método recomendado para instalar vários produtos juntos em ambientes empresariais é usar, em vez do encadeamento, um programa de gerenciamento de implantações, como o Microsoft System Center Configuration Manager 2007 ou o SMS (Microsoft Systems Management Server) 2003, ou ainda uma ferramenta de terceiros.

A utilização de Args e de QuietArg ocorre da seguinte maneira:

• O atributo Args sempre é anexado ao comando. Isso pode incluir chaves como, por exemplo, "/install" ou **"Company=**MyCorporation".

• O atributo QuietArg também será anexado se a instalação for executada silenciosamente (com Display definido como Display="none"). Nesses casos, você pode especificar o atributo QuietArg com a chave "/quiet"; por exemplo, é possível usar: QuietArg="/quiet".

As instruções a seguir são aplicáveis ao atributo Wait:

• A definição do atributo Wait como 0 milissegundo indica que não haverá nenhuma espera depois que você executar o programa e antes de continuar a instalação; o comando será executado e movido imediatamente.

  Os códigos de retorno só serão respeitados se o valor de Wait não for zero. Se você especificar 0, a Instalação não esperará para continuar a instalação após a execução do programa especificado, portanto, não haverá nenhum código de retorno a ser relatado nesse caso.

• A definição do atributo Wait com um valor positivo diferente de zero esperará exatamente o número de milissegundos especificado. Se o processo for concluído antes do tempo especificado, a Instalação continuará. Se o processo não terminar no tempo especificado, a Instalação falhará.

• A definição do atributo Wait como -1 indica uma espera interminável. Isso pode ser problemático, pois se o processo de comando parar de responder (paradas), a Instalação não responderá mais e ficará indefinidamente à espera da execução do comando.

Se houver dois ou mais elementos Command no arquivo Config.xml, eles serão executados na ordem em que foram especificados no arquivo Config.xml.

Exemplos

<Command Path="\\server\share\myscript.exe" Args='/id "123 abc"' QuietArg="/q" Wait="30000" />

Sintaxe

< valor COMPANYNAME = " companyname " / >

Atributos

Exemplo

<COMPANYNAME Value="Microsoft Corporation" />

Sintaxe

<Display

Level="None" | "Basic" | "Full"(padrão)

   CompletionNotice="Yes" | "No"(padrão)

SuppressModal="Yes" | "No"(padrão)

NoCancel="Yes" | "No"(padrão)

AcceptEula="Yes" | "No"(padrão)

/>

Atributos

Comentários

Se esse elemento não for definido, as configurações padrão serão usadas. Se um valor inválido for especificado, a Instalação será encerrada.

Se o atributo Level for definido como "Basic" ou "None" e se você fornecer uma chave do produto usando o elemento Elemento PIDKEY, a Instalação vai supor que você também aceita os termos de licença em nome do usuário.

Observação:

Em implantações corporativas, é recomendável que você defina o valor de Display level como None para fazer com que a Instalação seja executada silenciosamente, impedir a solicitação de informações aos usuários e evitar que a instalação precise aguardar qualquer interação do usuário, inclusive quando os arquivos estiverem em uso. Definir Display level como None pressupõe que os atributos SuppressModal e CompletionNotice sejam silenciados e que o EULA seja aceito. Os administradores também devem assegurar que não haja aplicativos do Office em execução durante a instalação do 2007 Office system. Se você definir o valor Display level como basic e SuppressModal como yes, os usuários poderão ser avisados caso qualquer arquivo do Office esteja em uso. Definir Display level como none impede o aviso aos usuários em tais casos. O atributo SuppressModal não impede que mensagens arquivos em uso sejam exibidas; somente Display level definido como nenhum impede sua exibição. O elemento Display é usado pelo programa de instalação somente se a instalação encontrar o arquivo Config.xml na mesma pasta do setup.exe, ou se você especificar o arquivo Config.xml, usando a opção de linha de documento /config da Instalação. Se a Instalação usar o arquivo Config.xml na pasta do produto, usará as opções de exibição padrão.

Exemplo

<Display Level="none" AcceptEula="Yes" />

Sintaxe

< DistributionPoint Location = " caminho " / >

Atributos

Comentários

Se isso não for especificado, a Instalação suporá que o arquivo Setup.exe está localizado na raiz do ponto de instalação de rede.

Observação:
O elemento DistributionPoint é usado pela Instalação somente se ela encontrar o arquivo Config.xml na mesma pasta do setup.exe, ou se você especificar o arquivo Config.xml usando a opção de linha de comando /config. Se a Instalação usar o arquivo Config.xml na pasta produto, ignorará esse elemento, pois o ponto de instalação de rede já terá sido encontrado.

Exemplo

<DistributionPoint Location="\\server1\office" />

Sintaxe

<INSTALLLOCATION Value=" caminho " />

Atributos

Comentários

Você pode usar variáveis de ambiente do sistema no caminho. Se este elemento não for especificado, o Office será instalado em %ProgramFiles%\Microsoft Office.

Exemplo

<INSTALLLOCATION VALUE="%ProgramFiles%\MyApps" />

Sintaxe

< LIS

[CACHEACTION = "CacheOnly" | "RemoveCacheOnly"]

SOURCELIST = " delimitada por ponto-e-vírgula-caminho-lista "]

/>

Atributos

Comentários

Por padrão, o recurso LIS é criado na pasta \MsoCache\All users na raiz da unidade na qual o Office está instalado. Arquivos de personalização de instalação e as atualizações de software na pasta Updates no ponto de instalação de rede também são copiados.

Se você especificar Elemento INSTALLLOCATION, a designação de unidade no caminho será usada para determinar em qual unidade o LIS é criado. Por exemplo, se o caminho Elemento INSTALLLOCATION for E:\office\files, o recurso LIS produto é criado na unidade e. As fontes listadas pelo atributo SOURCELIST são mantidas com o produto instalado e são usadas pelo programa de instalação se a origem de instalação local (LIS) no computador do usuário está faltando ou corrompido.

Exemplo

<LIS CACHEACTION="CacheOnly" />   
<LIS SOURCELIST="\\server1\office;\\server2\corpdata" />

Sintaxe

<Logging

Type="Off" | "Standard"(padrão) | "Verbose"

   Path="caminho"

   Template="nome_de_arquivo.txt"

/>

Atributos

Comentários

Você pode especificar um * em qualquer lugar no valor de Template. A Instalação insere uma cadeia de caracteres nesse local com o seguinte formato:

AAAAMMDDHHMMSS xxx

em que:

1. AAAA = Ano

2. MM = Mês

3. DD = Dia

4. HH = Hora

5. MM = Minuto

6. SS = Segundos

7. xxx = uma cadeia de caracteres exclusiva gerada pela Instalação

Observação:
O elemento Logging só será usado pelo programa de instalação se a instalação encontrar o arquivo Config.xml na mesma pasta do setup.exe, ou se você especificar o arquivo Config.xml usando a opção de linha de comando /config da Instalação. Se a Instalação usar o arquivo Config.xml na pasta do produto, usará as opções de log padrão.

Exemplo

<Logging Type="standard" Path="%temp%" 
   Template="MyLog(*).txt" 
/>

Com esse exemplo, a Instalação cria um arquivo de log cada vez que instala o produto. A Instalação usa nomes de arquivo exclusivos, como os seguintes:

%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt

Sintaxe

< MinOSRequirement

VersionNT = " versão "

   WindowsBuild="número"

   ServicePackLevel="número"

/>

Atributos

Os seguintes valores podem ser usados.

Comentários

A instalação não continuará se o computador do usuário já tiver um sistema operacional com uma versão anterior à especificada aqui (ou o padrão do Office se este elemento não for especificado). Não é possível especificar uma versão do Microsoft Windows aqui que seja anterior à versão exigida pelo 2007 Office system.

Para obter informações sobre requisitos do sistema, consulte Guia de introdução do 2007 Office system.

Sintaxe

<OptionState

   Id="ID_da_opção"

   State="Absent" | "Advertise" | "Default" | "Local"

   [Children="force"]

/>

Atributos

Comentários

Um recurso é um item que o usuário pode optar por instalar. O valor Id para um recurso é definido no elemento Option do arquivo Setup.xml na pasta do produto principal.

Para obter uma lista de Valores de Id de OptionState, consulte Valores de Id de OptionState do arquivo Config.xml. Para obter informações sobre a modificação do elemento OptionState em Config.xml, consulte a seção Modificando o elemento OptionState do arquivo Config.xml de Usar a Diretiva de Grupo de Instalação de Software para implantar o sistema 2007 Office.

Exemplo

<OptionState Id="ExcelAddinFiles" 
   State="Absent" 
   Children="force" 
/>

Sintaxe

<PIDKEY Value=" chave de 25 caracteres " />

Atributos

Comentários

Quando o valor de PIDKEY for definido, os usuários não precisarão inserir uma chave do produto ao executarem a Instalação.

Exemplo

<PIDKEY Value="1234512345123451234512345" />

Observação:

Se o atributo Level do elemento Elemento de exibiçãofor definido como "Basic" ou "None" e se você fornecer uma chave do produto usando o elemento PIDKEY, a Instalação vai supor que você também aceita os termos de licença em nome do usuário. Nesse caso, a despeito da forma como o atributo AcceptEULA do elemento Elemento de exibição for definido, não será solicitado que o usuário aceite os termos de licença durante a instalação.

Sintaxe

<RemoveLanguage Id=" ii - cc " />

Atributos

Comentários

Se o idioma não estiver instalado no computador do usuário, o elemento RemoveLanguage será ignorado.

Você pode ter vários elementos Elemento AddLanguage e RemoveLanguage. Se ambos os elementos RemoveLanguage e Elemento AddLanguage especificarem o mesmo idioma, o elemento Elemento AddLanguage terá precedência e o idioma será instalado.

Exemplo

<RemoveLanguage Id="en-us" />

Sintaxe

<Setting Id=" nome " Value=" valor " />

Atributos

Comentários

Nem todas as propriedades do Windows Installer podem ser especificadas no elemento Setting. Se uma propriedade bloqueada for especificada, a Instalação será encerrada. Se uma propriedade com suporte for especificada, a Instalação a passará diretamente para o Windows Installer. Para obter uma lista completa de propriedades do Windows Installer, incluindo uma explicação sobre propriedades com suporte e bloqueadas, consulte Propriedades da instalação no Office System 2007.

O elemento Setting oferece suporte à configuração REMOVEPREVIOUS. Essa configuração remove o aplicativo especificado da instalação e usa a seguinte sintaxe:

<Setting Id="REMOVEPREVIOUS" Value="Option Id" />

onde ID de opção é o valor de identificador para o aplicativo de sistema do Office de 2007. Para especificar vários aplicativos, use uma lista separada por vírgulas para indicar os valores de ID de opção apropriados. Para obter uma lista completa de valores de ID de opção, consulte Valores de Id de OptionState do arquivo Config.xml.

Observação:
Se você estiver instalando o Outlook, uma versão instalada anteriormente do Outlook será sempre removida, independentemente de preferência do usuário.

Se você especificar REMOVEPREVIOUS com um valor de ID de opção, somente os aplicativos especificados serão removidos.

Se você não especificar REMOVEPREVIOUS, todos os aplicativos do Office instalados anteriormente e para os quais uma substituição esteja sendo instalada serão removidos. Esse é o comportamento padrão.

Se você especificar REMOVEPREVIOUS com um valor em branco (REMOVEPREVIOUS = " "), nenhum aplicativo será removido.

O elemento Setting também oferece suporte à propriedade SETUP_REBOOT. SETUP_REBOOT inicia uma reinicialização após a instalação e usa a seguinte sintaxe:

<Setting Id="SETUP_REBOOT" Value="value" />

onde valor pode ser um destes procedimentos:

• AutoAlways-- sempre inicia uma reinicialização. Não avisa o usuário.

• Always-- sempre solicita uma reinicialização no final da instalação.

• IfNeeded-- solicita uma reinicialização no final da instalação se a instalação assim o exigir (Padrão).

• AutoIfNeeded-- inicia uma reinicialização se a instalação assim o exigir. Não avisa o usuário.

• Never-- nunca inicia ou solicita uma reinicialização.

Exemplos

<Setting Id="SETUP_REBOOT" Value="NEVER" />
<Setting Id="REMOVEPREVIOUS" Value="WORDFiles" />

Sintaxe

< SetupUpdates

CheckForSUpdates = "Sim"(padrão) | "não"

SUpdateLocation = " caminho-lista "

/>

Atributos

Comentários

A instalação examina todas as pastas especificadas para arquivos de personalização da Instalação que foram criados para o produto que está sendo instalado e as aplica em ordem alfabética por nome de arquivo. Se um arquivo de personalização da Instalação for especificado na linha de comando do programa de instalação, será aplicado primeiro, seguido de quaisquer arquivos encontrados na pasta especificada por este elemento.

Exemplo

<SetupUpdates
   CheckForSUpdates="Yes"
   SUpdateLocation="\\server1\office\updates;\\server2\corpdata\updates"
/>

Sintaxe

<USERINITIALS Value=" valor " />

Atributos

Exemplo

<USERINITIALS Value="JD" />

Sintaxe

<USERNAME Value=" valor " />

Atributos

Comentários

Os dados de elemento Username do Office 2007 são preenchidos da seguinte maneira.

Se o usuário que está executando o Office for o mesmo que instalou o Office, as informações de Username e Initials fornecidas durante a instalação serão usadas. O usuário não será avisado quando o Office for iniciado pela primeira vez. Esse caso acontece mais para usuários domésticos que instalam o Office por conta própria.

Se o usuário que está executando o Office não for o mesmo usuário que instalou o Office, o Office solicitará que ele confirme seu Nome de usuário e Iniciais quando o Office iniciar pela primeira vez. Esse caso acontece mais em um ambiente corporativo, onde um administrador instala o Office em nome do usuário.

O valor do elemento Username mostrado ao usuário na primeira inicialização pode ser será preenchido previamente com um valor de padrão de uma versão instalada anteriormente do Office ou do usuário conectado no momento. Observe que o valor padrão é não usado a menos que ele é confirmado pelo usuário. Se houver uma versão anterior do Office instalado no computador, a chave de registro criada pela versão anterior do Office é usada. Por exemplo, se a instalação do Office anterior for Office 2003, a chave do Registro é fornecida no HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\UserInfo.

Exemplo

<USERNAME Value="John Doe" />