# Funções do sistema

As funções do sistema fornecem funções de acesso às propriedades do sistema, dispositivo e documento do QlikView.

Use a caixa suspensa em cada função para ver uma breve descrição e a sintaxe de cada função. Para algumas das funções, você pode obter mais detalhes clicando no nome da função na descrição da sintaxe.

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### Author

Esta função de script retorna uma string contendo a propriedade do autor do documento atual. Pode ser usado no script de carregamento e em um gráfico de expressão.

Author( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### ClientPlatform

Esta função retorna a string de agente do usuário do navegador do cliente. Pode ser usado no script de carregamento e em um gráfico de expressão.

Exemplo:

`  Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.114 Safari/537.36 `

ClientPlatform( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### ComputerName

Esta função retorna uma string que contém o nome do computador, conforme retornado pelo sistema operacional. Pode ser usado no script de carregamento e em um gráfico de expressão.

ComputerName( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### DocumentName

Esta função retorna caracteres que contêm o nome do documento atual do QlikView, sem caminho, mas com extensão. Pode ser usado no script de carregamento e em um gráfico de expressão.

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)DocumentName( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### DocumentPath

Esta função retorna caracteres que contêm o caminho completo do documento atual do QlikView. Pode ser usado no script de carregamento e em um gráfico de expressão.

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)DocumentPath( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### DocumentTitle

Esta função retorna caracteres que contêm o título do documento atual do QlikView. Pode ser usado no script de carregamento e em um gráfico de expressão.

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)DocumentTitle( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetCollationLocale

Esta função retorna o nome de cultura do local de agrupamento que é utilizado. Se a variável CollationLocale não tiver sido definida, o local real da máquina do usuário é retornado.

GetCollationLocale( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetActiveSheetID

Retorna um caractere contendo a ID da pasta ativa

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)GetActiveSheetID( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetExtendedProperty

Esta função retorna o valor de uma propriedade estendida nomeada no objeto da pasta com o ID de objeto fornecido. Se objectid não for fornecido, o objeto da pasta que contém a expressão será utilizado. Uma propriedade estendida é definida para o objeto de extensão em seu arquivo de definição.

[**GetExtendedProperty**](https://help.qlik.com/pt-BR/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/GetExtendedProperty.htm)(name[, objectid])

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetObjectField

GetObjectField() retorna o nome da dimensão. Index é um inteiro opcional representando a dimensão que deve ser retornada.

[**GetObjectField**](https://help.qlik.com/pt-BR/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/GetObjectField.htm)([index])

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetRegistryString

Esta função retorna o valor de uma chave no registro do Windows. Pode ser usado no script de carregamento e em um gráfico de expressão.

GetRegistryString(path, key)

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### Input

Essa função pode ser usada somente no script e abre uma caixa de entrada que solicita ao usuário um valor durante a execução do script. Os parâmetros cue e caption são usados como textos de mensagem e legenda, respectivamente. A função retorna o valor inserido.

A função de caixa de entrada retorna NULL se o diálogo for cancelado, fechado ou não puder ser exibido.

Exemplo:

` Load 
 Input('Enter value', 'Input box') as v, Recno () as r autogenerate 3;  `

Input(str cue [, str caption])

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### IsPartialReload

Retorna -1 (True) se a recarga atual é parcial; caso contrário, retorna 0 (False). Isso só funciona no script.

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)IsPartialReload( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### MsgBox

Esta função só pode ser usada no script e abre uma caixa de entrada durante a execução do script. Os parâmetros msg e caption são usados como textos de mensagem e legenda, respectivamente. O parâmetro mb\_buttons define que botões serão exibidos na caixa de mensagem, de acordo com:

0 ou 'OK' para um único botão OK,  
1 ou 'OKCANCEL' para dois botões, OK e Cancel,  
2 ou 'ABORTRETRYIGNORE' para três botões, Abort, Retry e Ignore,  
3 ou 'YESNOCANCEL' para três botões, Yes, No e Cancel,  
4 ou 'YESNO' para dois botões, Yes e No,  
5 ou 'RETRYCANCEL' para dois botões, Retry e Cancel.

O parâmetro mb\_icons define que ícone será exibido na caixa de mensagem, de acordo com:

0 ou string vazia para nenhum ícone,  
16 ou 'ICONHAND' para um ícone com um X, usado para erros críticos,  
32 ou 'ICONQUESTION' para um ícone com um ponto de interrogação,  
48 ou 'ICONEXCLAMATION' para o ícone com um ponto de exclamação, usado para pequenos erros, precauções e avisos  
64 ou ícone 'ICONASTERISK' com um i, usado para mensagens informativas.

O parâmetro mb\_defbutton define em que botão estará o foco quando a caixa de mensagem for exibida, de acordo com:

0 ou 'DEFBUTTON1' se for necessário que o primeiro botão tenha o foco,  
256 ou 'DEFBUTTON2' se for necessário que o segundo botão tenha o foco,  
512 ou 'DEFBUTTON3' se for necessário que o terceiro botão tenha o foco,  
768 ou 'DEFBUTTON4' se for necessário que o quarto botão tenha o foco.

A função retorna um número inteiro que mostra que botão foi pressionado pelo usuário, de acordo com:

1 para OK,  
2 para Cancel,  
3 para Abort,  
4 para Retry,  
5 para Ignore,  
6 para Yes,  
7 para No,

Os parâmetros 3, 4 e 5 serão adicionados internamente, portanto, se outros valores numéricos além dos acima mencionados forem usados, pode-se obter uma combinação inesperada de ícones e botões.

A função de caixa de entrada retorna NULL se o diálogo não puder ser exibido.

Exemplo:

` Load 
 MsgBox('Message 2', 'msgbox', 'OKCANCEL', 'ICONASTERISK') as x, 2 as r 
 autogenerate 1;  `

MsgBox(str msg [, str caption [, mb\_buttons [, mb\_icons[, mb\_defbutton]]]] )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### OSUser

Esta função retorna uma string que contém o nome do usuário atual, conforme retornado pelo sistema operacional. Pode ser usado no script de carregamento e em um gráfico de expressão.

OSUser( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### QlikViewVersion

Essa função retorna a versão completa do QlikView e o número da compilação como uma string.

[QlikViewVersion – função de script e gráfico](https://help.qlik.com/pt-BR/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/QlikViewVersion.htm)()

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### QVuser

Retorna um caractere contendo o nome do usuário atual do QlikView, conforme inserido em uma seção de acesso.

QVuser( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### ReloadTime

Esta função retorna uma data/hora de conclusão da última carga de dados. Pode ser usado no script de carregamento e em um gráfico de expressão.

ReloadTime( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### StateName

Essa função de gráfico retorna o nome de estado do objeto no qual é utilizado. O desenvolvedor do QlikView pode usar essa função para obter cores e textos dinâmicos quando o estado de um objeto for alterado. É importante observar que essa função destina-se apenas a objetos. Ela não pode ser usada em uma expressão de gráfico para determinar o estado ao qual se refere a expressão.

[**StateName**](https://help.qlik.com/pt-BR/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/StateName.htm)()

## Saiba mais

* [GetFolderPath - função de script](https://help.qlik.com/pt-BR/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/FileFunctions/GetFolderPath.htm)