> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/administracao-e-definicoes/app-categories.md).

# Categorias de aplicações

Gerir as categorias de aplicações de um Tenant no RealmJoin Portal e utilizá-las para agrupar pacotes no RealmJoin Tray e no Intune Company Portal.

As categorias de apps determinam sob qual cabeçalho os utilizadores finais veem um pacote. O RealmJoin Portal mantém uma lista de categorias por locatário e usa-a para ambos os métodos de implementação:

* **Implementação do RealmJoin:** a categoria é o **nome do grupo**. O [RealmJoin Tray](https://docs.realmjoin.com/pt/agente-realmjoin/client-menu/realmjoin-tray.md) menu lista o pacote sob este grupo, e o **Categoria** filtro do [Catálogo de Apps](https://docs.realmjoin.com/pt/agente-realmjoin/client-menu/self-service-portal.md#app-catalog-tab) filtra por ele. Cada pacote tem exatamente um nome de grupo; no menu da bandeja, os pacotes sem um aparecem em **Outros**.
* **Implementação do Intune:** as categorias são categorias de apps do Intune (`mobileAppCategory` no Microsoft Graph) atribuídas à app. O Portal da Empresa usa-as para filtrar apps. Uma app do Intune pode ter várias categorias.

Gere a lista em **Configurações** > **Categorias de Apps**.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-e58b4e4a5a59b096b7a3015b5ff742c91ce3332a%2Fsettings-app-categories.png?alt=media" alt="App Categories tab in the RealmJoin Portal settings with New Category, Rename and Delete buttons"><figcaption><p>separador Categorias de Apps</p></figcaption></figure>

## De onde a lista vem

A lista é a união das categorias armazenadas para o locatário no RealmJoin e de todas as categorias de apps no Intune do locatário, comparadas de forma independente de maiúsculas e minúsculas. Assim, uma categoria criada diretamente no Intune também aparece aqui.

Se ainda não houver categorias armazenadas para o locatário, o RealmJoin Portal preenche a lista na primeira vez que ela é carregada, a partir de:

* os nomes dos grupos dos pacotes RealmJoin do locatário,
* as categorias do Package Store (apenas se o locatário já tiver pacotes RealmJoin),
* as categorias de apps no Intune.

{% hint style="info" %}
As categorias de apps do Intune são lidas e gravadas com a permissão Graph `DeviceManagementApps.ReadWrite.All`. Sem ela, a lista contém apenas as categorias armazenadas no RealmJoin e a eliminação de uma categoria falha. A renomeação precisa da permissão quando a implementação do Intune está ativada para o locatário.
{% endhint %}

## Adicionar uma categoria

{% stepper %}
{% step %}

### Abra a lista

Vá para **Configurações** > **Categorias de Apps**.
{% endstep %}

{% step %}

### Criar a categoria

Selecione **Nova Categoria**, introduza um nome (até 127 caracteres) e selecione **Submeter**.
{% endstep %}
{% endstepper %}

Os nomes são comparados de forma independente de maiúsculas e minúsculas: não pode adicionar uma categoria que difira de uma existente apenas em maiúsculas e minúsculas.

Uma nova categoria é armazenada apenas no RealmJoin. A categoria de app correspondente no Intune é criada na primeira vez que a categoria é atribuída a uma app do Intune.

## Renomear uma categoria

Selecione **Renomear** junto da categoria, introduza o novo nome e selecione **Submeter**. O RealmJoin Portal altera o nome nesta ordem:

1. A categoria de app correspondente no Intune, se a implementação do Intune estiver ativada para o locatário. As apps do Intune referenciam a categoria pelo ID, pelo que as respetivas atribuições de categoria permanecem intactas.
2. O nome do grupo de cada pacote RealmJoin que usa a categoria.
3. A lista de categorias armazenada no RealmJoin.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-1d7190cd18b3673653566fb6f0b17ee23a84df42%2Fapp-categories-rename.png?alt=media" alt="Rename Category dialog"><figcaption><p>Caixa de diálogo Renomear Categoria</p></figcaption></figure>

Os três armazenamentos não são atualizados numa única transação. Se uma etapa falhar, o nome antigo permanece na lista; renomeá-lo novamente conclui as etapas restantes.

A renomeação é recusada se já existir uma categoria com o novo nome, ou se a categoria for uma categoria incorporada do Intune (uma das predefinições que o Intune cria, que não pode ser alterada). Cada renomeação é registada no [Registo de Auditoria](https://docs.realmjoin.com/pt/monitorizacao-e-registos/audit-log.md) juntamente com o número de pacotes RealmJoin alterados.

## Eliminar uma categoria

Selecione **Eliminar** junto da categoria e confirme com **Confirmar eliminação**. A categoria é removida da lista armazenada no RealmJoin e, se existir aí, do Intune.

Uma categoria só pode ser eliminada enquanto nenhum pacote a usar. A eliminação é recusada se

* um pacote RealmJoin usa a categoria como o seu nome de grupo, ou
* uma app do Intune tem a categoria atribuída, ou
* a categoria é uma categoria incorporada do Intune.

Se um pacote ainda usar a categoria, a mensagem indica o primeiro pacote encontrado. Atribua uma categoria diferente a todos os pacotes que a usam antes de a eliminar, ou [renomeie](#rename-a-category) a categoria em vez disso.

## Atribuir categorias a pacotes

### Ao subscrever um pacote

Ao subscrever um pacote a partir do [Package Store](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-store/package-store-details.md#app-categories), a caixa de diálogo de subscrição permite-lhe escolher a partir da lista de categorias:

* **Implementação do RealmJoin:** selecione uma **nome do grupo**.
* **Implementação do Intune:** selecione uma ou mais **Categorias**.

### Para um pacote existente

Abra o [detalhes do pacote](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-details.md) e selecione **Definições de especialista**:

* **Pacote RealmJoin:** escolha o **nome do grupo**. Veja [Definições de Especialista](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-settings.md#expert-settings) para as outras definições nesta caixa de diálogo.
* **App do Intune:** adicione ou remova **Categorias**. Uma categoria selecionada que ainda não existe no Intune é criada lá quando guardar.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-784d96e77fd5f8be8ae0e2928147eb5fadbd2389%2Fapp-categories-group-name.png?alt=media" alt="Group name field in the expert settings of a RealmJoin package"><figcaption><p>Nome do grupo de um pacote RealmJoin</p></figcaption></figure>

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-61a60d58944df5bda46022e077cd3a1b9f0bbfff%2Fapp-categories-intune-expert-settings.png?alt=media" alt="Categories field in the expert settings of an Intune app"><figcaption><p>Categorias de uma app do Intune</p></figcaption></figure>

## Permissões

| Ação                                      | Permissão                                                                                                                                          | Funções predefinidas      |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| Ver a lista de categorias                 | [`CanReadAppCategories`](https://docs.realmjoin.com/pt/administracao-e-definicoes/permission/custom-roles/available-permissions.md#app-categories) | Admin, Auditor            |
| Adicionar, renomear e eliminar categorias | [`CanEditAppCategories`](https://docs.realmjoin.com/pt/administracao-e-definicoes/permission/custom-roles/available-permissions.md#app-categories) | Admin                     |
| Alterar as categorias de um único pacote  | [`CanEditAppExpertSettings`](https://docs.realmjoin.com/pt/administracao-e-definicoes/permission/custom-roles/available-permissions.md)            | Admin, Agente de Software |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/pt/administracao-e-definicoes/app-categories.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
