# Upper Função de script e de gráfico

Upper() converte todos os caracteres na string de saída para maiúsculos em todos os caracteres de texto na expressão. Números e símbolos são ignorados.

Sintaxe:

Upper(text)

Tipo de dados de retorno: caractere

Argumentos

| Argumento | Descrição |
| --- | --- |
| text | A string a ser avaliada. |

Exemplo: expressão de gráfico

| Exemplo | Resultado |
| --- | --- |
| `Upper( ' abcD' )` | Retorna `ABCD` |

## Exemplo - Fundamentos de Upper

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Upper.htm)

#### Expressão de gráfico

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Um campo na tabela de dados chamado `InputText`.

Script de carregamento

```
Example:
Load * inline [
InputText
rHode iSland
washingTon d.C.
new york
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* ` InputText
                                   `

Crie a seguinte dimensão calculada:

* `=Upper(InputText)`, para converter todos os caracteres no `` campo InputText em maiúsculas.

Tabela de resultados

| InputText | Upper(InputText) |
| --- | --- |
| new york | NEW YORK |
| rHode iSland | RHODE ISLAND |
| washingTon d.C. | WASHINGTON D.C. |

A saída da função `Upper` converte todos os valores em letras maiúsculas.

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Upper.htm)

#### Script de carregamento

O código a seguir mostra como usar a função em um script de carregamento.

```
Load
String,Upper(String)
Inline
[String
rHode iSland
washingTon d.C.
new york];
```

Tabela de resultados

| String | Upper(String) |
| --- | --- |
| rHode iSland | RHODE ISLAND |
| washingTon d.C. | WASHINGTON D.C. |
| new york | NEW YORK |

## Exemplo - Cenário superior

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Upper.htm)

#### Expressão de gráfico

Visão geral

Um conjunto de dados contém códigos de países ISO e nomes de países em vários formatos, como tudo em letras minúsculas, tudo em letras maiúsculas ou capitalização misturada. O objetivo é limpar os dados para que o código e o nome de cada país sejam formatados para usar letras maiúsculas.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Os campos a seguir na tabela de dados:

  * `ISO CountryCode`

  * `CountryName`

Script de carregamento

```
Country:
Load  * inline [
​​ISO_CountryCode, CountryName
gbr, United kingdom
Ind, india
CAN, Canada
Are, United arab emirates
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* ` ISO_CountryCode
                                   `

* CountryName

Crie as seguintes dimensões calculadas:

* `=Upper(ISO_CountryCode)` para criar uma coluna de códigos de países que usam todos os caracteres em maiúsculas.

* `=Upper(CountryName)`, para criar uma coluna de nomes de países que usam todos os caracteres em maiúsculas.

Tabela de resultados

| ISO\_CountryCode | CountryName | Upper(ISO\_CountryCode) | Upper(CountryName) |
| --- | --- | --- | --- |
| Eau | Emirados árabes unidos | EAU | EMIRADOS ÁRABES UNIDOS |
| CAN | Canadá | CAN | CANADÁ |
| gbr | Reino Unido | GBR | REINO UNIDO |
| Ind | índia | IND | ÍNDIA |

A função `Upper` converteu todos os códigos e nomes de países para usar caracteres maiúsculos.

## Exemplo - Cenário avançado de Upper

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Upper.htm)

#### Expressão de gráfico

Visão geral

Usando o mesmo conjunto de dados do cenário anterior, este exemplo combina o nome e o código do país e formata essas strings usando as funções Capitalize e Upper.

Resultado

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* ISO\_CountryCode

* CountryName

Crie a seguinte dimensão calculada:

* =Capitalize(CountryName) & ' (' & Upper(ISO\_CountryCode) & ')' para criar uma nova dimensão que concatena CountryName e ISO\_CountryCode e formata os nomes dos países para usar letras maiúsculas no título e os códigos de país para usar letras maiúsculas.

Tabela de resultados

| ISO\_CountryCode | CountryName | Capitalize(CountryName) & '(' & Upper(ISO\_CountryCode) & ')' |
| --- | --- | --- |
| Eau | Emirados árabes unidos | Emirados Árabes Unidos (EAU) |
| CAN | Canadá | Canadá (CAN) |
| gbr | Reino Unido | Reino Unido (GBR) |
| Ind | índia | Índia (IND) |