49.6 Macros de variáveis de idioma

Para minimizar o número de objetos Aplicativo necessários para distribuir o mesmo aplicativo em idiomas diferentes, use as variáveis de idioma para representar as informações relacionadas ao idioma nos objetos do Aplicativo MSI. Essas variáveis de idioma não são suportadas para aplicativos simples, aplicativos AOT/AXT, aplicativos de servidor de terminal ou aplicativos da Web.

Por exemplo, você deseja distribuir versões apropriadas para cada idioma do Agente do ZENworks Desktop Management, que tem um arquivo .msi individual para cada idioma. Por padrão, os arquivos .msi do Agente do Desktop Management são instalados no diretório sys:\public\zenworks\zfdagent\language do servidor do Desktop Management, onde o idioma representa os vários idiomas suportados. No objeto Aplicativo do Agente do Desktop Management, você pode incluir uma variável de idioma no campo de origem para o diretório idioma. Por exemplo:

\\server\sys\public\zenworks\zfdagent\%LOCALE_SYS_NATIVE_LANG%\zfdagent.msi

Durante a distribuição, o Disparador de Aplicativos recupera as informações do idioma solicitado do sistema da estação de trabalho e substitue-as pela variável de idioma.

Como no outro exemplo, suponha que você tem um arquivo .msi como app1.msi. Na instalação de um idioma específico, aplique um arquivo (.mst) de transformação para o idioma específico. Para atender a essa necessidade, crie diretórios de idioma para cada um dos arquivos .mst e, em seguida, utilize uma variável para o diretório de idioma ao especificar o caminho da transformação.

\\server\sys\public\zenworks\zfdagent\%LOCALE_SYS_NATIVE_LANG%\zfdagent.msi

As variáveis de idioma podem ser usadas nas mesmas propriedades do objeto Aplicativo MSI que as outras variáveis de macro (macros especiais do Windows, variáveis de ambiente e assim por diante). Para conhecer uma lista dessas localizações, consulte Seção 49.8, Propriedades de objetos Aplicativo nas quais é possível utilizar macros

A tabela a seguir descreve as variáveis de idioma disponíveis:

Tabela 49-6 Macros de variáveis de idioma

Variáveis de Idioma

Descrição

%LOCALE_SYS_DEFAULT_ANSI_CP%

Recupera a página de código ANSI (American National Standards Institute) associada ao local do sistema. Se o local não usar uma página de código ANSI, o valor será 0.

Exemplo: 1252

%LOCALE_SYS_DEFAULT_OEM_CP%

Recupera a página de código OEM (Original Equipment Manufacturer - Fabricante de Equipamentos Originais) associada ao local do sistema. Se o local não usar uma página de código OEM, o valor será 1.

Exemplo: 437

%LOCALE_SYS_LANGID%

Recupera o identificador de idioma no sistema local. O identificador de idioma é a abreviação numérica internacional padrão do idioma no país ou em uma região geográfica.

Exemplo: 0409

%LOCALE_SYS_ABBR_LANG%

Especifica o nome abreviado do idioma do sistema. Na maior parte dos casos, é criado pela abreviação de duas letras do idioma de acordo com a ISO (International Organization for Standardization), padrão 639 e pelo acréscimo de uma terceira letra, como apropriado, para indicar um subidioma.

Exemplo: PTB

%LOCALE_SYS_ENG_LANG%

Especifica o nome completo em inglês do idioma do sistema, de acordo com a ISO, padrão 639. Está restrito sempre a caracteres que podem ser mapeados no subconjunto de caracteres ASCII 127.

Exemplo: Português

%LOCALE_SYS_LANG%

Especifica o nome totalmente localizado do idioma do sistema. Este nome está baseado na localização do produto e pode variar de acordo com a versão localizada.

Exemplo: Português (Brasil)

%LOCALE_SYS_ISO639_LANG%

Especifica o nome abreviado do idioma do sistema com base apenas na ISO, padrão 639.

Exemplo: pt

%LOCALE_SYS_NATIVE_LANG%

Especifica o nome nativo do idioma do sistema.

Exemplo: Português

%LOCALE_USER_DEFAULT_ANSI_CP%

Recupera a página de código ANSI (American National Standards Institute) associada ao local do usuário. Se o local não usar uma página de código ANSI, o valor será 0.

Exemplo: 1252

%LOCALE_USER_DEFAULT_OEM_CP%

Recupera a página de código OEM associada ao local do usuário. Se o local não usar uma página de código OEM, o valor será 1.

Exemplo: 850

%LOCALE_USER_LANGID%

Recupera o identificador de idioma no local do usuário. O identificador de idioma é a abreviação numérica internacional padrão do idioma no país ou em uma região geográfica.

Exemplo: 0c09

%LOCALE_USER_ABBR_LANG%

Especifica o nome abreviado do idioma do usuário. Na maior parte dos casos, é criado pela abreviação de duas letras do idioma de acordo com a ISO (International Organization for Standardization), padrão 639 e pelo acréscimo de uma terceira letra, como apropriado, para indicar um subidioma.

Exemplo: PTB

%LOCALE_USER_ENG_LANG%

Especifica o nome completo em inglês do idioma do usuário, de acordo com a ISO, padrão 639. Está restrito sempre a caracteres que podem ser mapeados no subconjunto de caracteres ASCII 127.

Exemplo: Português

%LOCALE_USER_LANG%

Especifica o nome totalmente localizado do idioma do usuário. Este nome está baseado na localização do produto e pode variar de acordo com a versão localizada.

Exemplo: Português (Brasil)

%LOCALE_USER_ISO639_LANG%

Especifica o nome abreviado do idioma do usuário com base apenas na ISO, padrão 639.

Exemplo: pt

%LOCALE_USER_NATIVE_LANG%

Especifica o nome nativo do idioma do usuário.

Exemplo: Português