> 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/gestao-de-aplicacoes/packages/package-details.md).
# Detalhes do pacote
A página de detalhes do pacote do RealmJoin mostra as propriedades de um único pacote e gere as respetivas atribuições de utilizador e atualizações.
Página de detalhes do pacote
Esta página mostrará informações detalhadas de um único pacote no seu ambiente e permite-lhe gerir a respetiva atribuição a utilizadores e atualizações.
Esta página é semelhante à [Detalhes da Package Store](/pt/gestao-de-aplicacoes/packages/package-store/package-store-details.md) página, mas fornece detalhes sobre um pacote que já está importado para o seu ambiente. Não reflete a entrada genérica da loja de pacotes.
## Tipos de pacote
Esta página pode exibir qualquer pacote que seja reconhecido pelo RealmJoin Portal; isto inclui
* **Geridos** e **Básicos** pacotes da loja de pacotes
* **Não geridos** pacotes no Intune (não provenientes da loja de pacotes)
* **RealmJoin Classic** "Choco" e "Craft"
Diferentes tipos de pacotes têm diferentes níveis de suporte para serem geridos através do RealmJoin Portal neste momento. Este guia irá focar-se em **Geridos** e **Básicos** pacotes da loja de pacotes, pois são atualmente os mais bem suportados.
## Propriedades do pacote
### Nome e propriedades principais
Cada página de detalhes do pacote mostrará uma visão geral das propriedades principais, como o **Nome de exibição**, **Descrição** e **ID do pacote** ("ID RJ único") no lado esquerdo do ecrã. Esta parte não faz scroll e estará sempre visível em qualquer separador.
Pode usar o botão de edição junto ao nome do pacote para dar a um pacote um nome de exibição personalizado, relevante para os seus utilizadores. Para pacotes alojados no Intune, isto também irá renomear o nome de exibição do pacote no Intune. Isto não quebrará a relação com a [entrada da loja de pacotes](/pt/gestao-de-aplicacoes/packages/package-store/package-store-details.md) para pacotes provenientes da [loja de pacotes](/pt/gestao-de-aplicacoes/packages/package-store.md).
#### Descrição breve
Para pacotes implantados através do RealmJoin Agent, também pode substituir a **Descrição breve**, que é o texto que os utilizadores veem para o pacote no [Catálogo de aplicações](/pt/agente-realmjoin/client-menu/self-service-portal.md#app-catalog-tab). A descrição fornecida com o pacote é escrita a partir de uma perspetiva de empacotamento e muitas vezes explica o seu contexto técnico. Uma descrição personalizada permite-lhe dizer aos utilizadores o que o pacote significa para eles, por exemplo *"Liga a impressora no 2.º andar do edifício de escritórios 5"* para um pacote de mapeamento de impressoras.
Editar a descrição breve de um pacote existente
* Use o botão de edição junto a **Descrição** para abrir o editor. A descrição do próprio pacote é apresentada abaixo do campo de texto para referência.
* Uma descrição personalizada pode ter até 1000 caracteres.
* Enquanto uma descrição personalizada estiver definida, o pacote mostra um emblema **Personalizado** junto a **Descrição**, e o Catálogo de aplicações mostra o seu texto em vez da descrição do pacote.
* Use **Repor para o padrão do pacote** (ou guarde um texto vazio) para voltar à descrição do pacote. Guardar a descrição do pacote inalterada não cria uma descrição personalizada, por isso o pacote continuará a acompanhar futuras alterações à descrição do pacote.
* A descrição personalizada aplica-se apenas ao seu tenant e é mantida quando um pacote gerido é atualizado para uma nova versão. A descrição longa do pacote não é afetada.
### Campos de estado
Também apresentados no lado esquerdo do ecrã estão quatro campos de estado de um pacote, apresentados como etiquetas abaixo do nome do pacote e do nome do editor.
Estes campos são binários — são definidos para um de dois valores possíveis. O texto de cada campo muda em conformidade. Alguns dos campos também usam código de cores para facilitar a identificação à primeira vista.
* **Mantido / Não mantido:** O RealmJoin fornecerá novas versões / atualizações de pacotes mantidos regularmente.\
A gestão automática de pacotes pode ser aplicada para manter o software entregue por estes pacotes permanentemente atualizado no seu ambiente.
* **Genérico / Personalizado:** Pacotes genéricos estão disponíveis para todos os clientes / ambientes. Pacotes personalizados não estão globalmente disponíveis para todos os clientes. Na maioria dos casos, trata-se de um pacote de software personalizado criado especificamente para o seu ambiente.
* **Cobrável / Não cobrável:** O provisionamento deste pacote contará para a sua quota de utilização de pacotes — se tiver uma. Atualmente, todos os pacotes disponíveis publicamente são cobrados.
* **Livre para usar / Requer licença:** Este software precisa de uma licença comercial para ser utilizado?
* **Gerido no Intune / Não gerido no Intune:** Estas etiquetas indicam pacotes que são oferecidos via Intune.
* **Gerido no Intune**: Pacotes Geridos e Básicos da loja de pacotes, entregues via Intune
* **Não gerido no Intune**: Pacotes não geridos no Intune (não provenientes da loja de pacotes)
## Separadores
O lado direito do ecrã mostra o conteúdo do separador atual.
Estão disponíveis os seguintes separadores:
### Visão geral
Separador Visão geral
#### Título, descrição e outras informações
Este separador mostrará a descrição longa, a licença e as informações de ajuda técnica de um pacote.
#### Atualização
Se a Package Store oferecer uma versão mais recente do que a implantada no seu ambiente, a *Atualização* secção mostra as ações disponíveis. Para pacotes geridos, estas são *Aplicar a atualização mais recente ao principal*, *Iniciar a atualização mais recente com pré-visualização*, *Aplicar a pré-visualização ao principal* e *Aplicar a atualização à pré-visualização*; Os pacotes Básicos apenas oferecem *Aplicar atualização*. Consulte [Versão e pré-visualização](/pt/gestao-de-aplicacoes/packages/package-management.md#version-and-preview) para o procedimento de atualização faseada.
**Escolher outra versão**
Por predefinição, uma atualização visa sempre a versão mais recente na Package Store. Se quiser saltar uma versão ou precisar de uma específica, clique em *Escolher outra versão* por baixo dos botões de atualização. Uma lista pendente apresenta as versões elegíveis, sendo a mais recente assinalada com "(latest)"; selecione uma e confirme com *Atualização*. Para pacotes geridos, existe uma linha por destino: *Principal*, *Pré-visualização* (iniciar uma pré-visualização) e *Atualizar a pré-visualização* (mover uma pré-visualização existente).
A opção só é apresentada quando todas as seguintes condições se verificam:
* O pacote foi subscrito na Package Store e existe uma atualização disponível (a *Atualização* secção está visível).
* Neste momento não está a decorrer qualquer atualização ou outra operação para este pacote.
* A Package Store contém pelo menos **duas** versões mais recentes do que a versão atualmente implantada nessa posição (Principal ou Pré-visualização). Com apenas uma versão mais recente, o botão de atualização normal já a visa.
* Para *Principal*: **Automatizar Canal Principal** está desativado. Para *Pré-visualização*: **Automatizar Canal de Pré-visualização** está desativado (ver [Automação](/pt/gestao-de-aplicacoes/packages/package-settings.md#automation)). A atualização de uma pré-visualização já em execução não é afetada pela automação.
* Você possui as `CanSubscribeApp` e `CanUpgradeApp` [permissões](/pt/administracao-e-definicoes/permission/custom-roles/available-permissions.md).
* Para *Principal*, pelo menos um grupo Principal deve ser atribuído; para *Pré-visualização*, o grupo de pré-visualização deve existir.
{% hint style="warning" %}
**Não são possíveis regressões de versão.** A lista pendente apenas apresenta versões mais recentes do que a atualmente implantada, e o backend rejeita qualquer atualização que vise uma versão mais antiga. Para implantar uma versão mais antiga, abra a entrada dessa versão na Package Store — o [separador Versões](/pt/gestao-de-aplicacoes/packages/package-store/package-store-details.md#versions) liga cada linha do registo de alterações à respetiva entrada na loja — e subscreva a partir daí. Como cada ID de pacote só pode ser subscrito uma vez, isto requer remover primeiro a subscrição existente.
Independentemente da versão atribuída, o RealmJoin Agent não substituirá uma versão mais recente que já esteja instalada num dispositivo, a menos que a política de cliente [Permitir regressão de versão de pacotes](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/pages/854e748158ff7a16fa914fc0ae603c179af03eb6#softwarepackaging.autoupgradecandowngrade) esteja definida. Tal como em qualquer alteração de versão, as instalações existentes só seguem a nova versão se [Atualização automática](/pt/gestao-de-aplicacoes/packages/package-settings.md#expert-settings) estiver ativada para o pacote.
{% endhint %}
#### Atribuições e estado de implementação
Use estas tabelas para atribuir grupos adicionais e verificar o estado de implementação das aplicações para dispositivos e/ou utilizadores. Se um dispositivo e o respetivo utilizador acabarem em grupos conflitantes do mesmo pacote, consulte [Prioridade de atribuição e conflitos](/pt/gestao-de-aplicacoes/packages/package-deployment.md#assignment-priority-and-conflicts) para saber como isto é resolvido.
#### Utilização
{% hint style="warning" %}
A função de Utilização requer que o RealmJoin Agent preencha corretamente os dados.
{% endhint %}
Use a tabela de utilização para determinar a distribuição das versões implantadas na sua frota de dispositivos, bem como a sua contagem de licenças. Clicar nos números em Contagem de clientes ou Contagem de utilizadores mostrará os dispositivos/utilizadores que usam a respetiva versão do pacote.
### Histórico
O histórico do pacote mostra quando o pacote foi atualizado no repositório do RealmJoin.
Separador Histórico
Há dois tipos de alterações monitorizadas no registo de alterações.
 Alterações à instância do pacote no seu ambiente, especificamente no Intune. Por exemplo, publicar uma versão mais recente do pacote para os seus utilizadores.
 Alterações à entrada da loja de pacotes.
---
# 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/gestao-de-aplicacoes/packages/package-details.md?ask=&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.
