> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-pt-br/organizacoes/organizacoes-individuais/recuperando-metadados-da-organizacao.md).

# Recuperando metadados da organização

## ![](https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Visão geral

No Flosum Cloud DevOps, um **Recuperar** job recupera a versão mais recente dos metadados da sua organização: os componentes que formam uma branch. Cada job de Recuperação busca apenas os componentes que mudaram desde a última recuperação.

Esses metadados são recuperados automaticamente a cada hora para mantê-lo atualizado sobre as alterações. Ainda assim, é recomendável recuperar manualmente os metadados antes de fazer commit ou implantar uma branch que use esta organização, para que você trabalhe com os dados mais recentes.

Com uma recuperação manual, você pode configurar um filtro declarativo para recuperar apenas os componentes que correspondem ao filtro. Isso reduz o tempo que um job de Recuperação leva quando muitos componentes desnecessários mudaram na organização.

Este guia explica como recuperar manualmente os metadados de uma organização.

{% hint style="info" %}

#### Componentes Excluídos das Configurações de Recuperação

Se você configurou as **Configurações de Recuperação** para excluir quaisquer componentes dos jobs de Recuperação, os componentes excluídos também são omitidos de uma recuperação manual, mesmo quando um **Filtro Declarativo** normalmente os incluiria. Veja o seguinte artigo para mais detalhes sobre as Configurações de Recuperação.

* [Alterando as configurações da organização - Recuperar configurações](/devops/devops-pt-br/organizacoes/organizacoes-individuais/alterando-as-configuracoes-da-organizacao-recuperar-configuracoes.md)
  {% endhint %}

{% hint style="info" %}

#### O que são metadados?

Leia o seguinte artigo da Salesforce para saber mais sobre o que são os metadados do Salesforce e como eles são usados.

* <https://www.salesforce.com/data/what-is-metadata/>
  {% endhint %}

## Recuperar Metadados

{% stepper %}
{% step %}

### Iniciar Recuperação

1. Clique em **Organizações** no menu lateral esquerdo.
2. Clique na organização da qual recuperar os metadados.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Fvvsg1J1yF1YK5wRyj26o%2FRetrievingOrganizationMetadata-S01-01.png?alt=media&amp;token=334f8535-5390-4981-b50c-d1bc2685e144" alt="" width="563"><figcaption></figcaption></figure></div>
3. Clique em **Recuperar**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F1RwllXGcRkgC7HyTOJTT%2FRetrievingOrganizationMetadata-S01-02.png?alt=media&amp;token=4807ba53-5535-4765-9015-ecadb3667c74" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### (Opcional) Adicionar Filtro Declarativo

1. Clique na **Filtro declarativo** botão de alternância.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FcyA7TaYlIjQLgKeARDpK%2FRetrievingOrganizationMetadata-S02-01.png?alt=media&amp;token=43acd0ae-a5b9-48e7-9b57-81fae9fe592b" alt="" width="563"><figcaption></figcaption></figure></div>
2. Clique na **Selecionar campo** menu suspenso.
3. Selecione o campo a ser usado para a condição do filtro.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FivQ2Pi2Wkmnlthls4NJN%2FRetrievingOrganizationMetadata-S02-02.png?alt=media&amp;token=605f8d1b-8bea-4eb7-b4a4-a9968c4d1fdb" alt="" width="563"><figcaption></figcaption></figure></div>
4. Clique na **Selecionar opção** menu suspenso.
5. Selecione a operação lógica a ser usada para a condição do filtro.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Frj9WbYVOZ99p9En9edRr%2FRetrievingOrganizationMetadata-S02-03.png?alt=media&amp;token=8f92958c-5de4-4afa-9e6f-42b4a92780c5" alt="" width="563"><figcaption></figcaption></figure></div>
6. Insira um filtro **Valor** na última caixa de filtro da condição do filtro.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F014FiJ5JwLnoXln2NaRS%2FRetrievingOrganizationMetadata-S02-04.png?alt=media&amp;token=b9adaf3c-40f5-4f66-b807-9da19b5dacdc" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
A última caixa de filtro da condição de filtro se adapta ao tipo de **Campo** selecionado na primeira caixa de filtro. Por exemplo, na captura de tela acima, **lastModifiedDate** está selecionado, então clicar na última caixa de filtro abre um seletor de data onde você pode selecionar uma data válida.
{% endhint %}
{% endstep %}

{% step %}

### (Opcional) Adicionar Vários Filtros Declarativos

Você pode adicionar várias condições de filtro declarativas e combiná-las de duas maneiras:

<table><thead><tr><th width="140.333251953125"></th><th></th></tr></thead><tbody><tr><td><strong>Lógica Básica</strong></td><td>Todas as condições de filtro são combinadas com uma <strong>E</strong> operação, o que significa que todas as condições de filtro devem ser atendidas.</td></tr><tr><td><strong>Lógica Personalizada</strong></td><td>Você pode combinar condições de filtro definindo sua própria lógica usando <strong>E</strong>, <strong>OU</strong>, e <strong>()</strong> operações. As condições de filtro são referenciadas pelo número da linha. Por exemplo, <code>2 E (1 OU 3)</code> significa que o filtro é verdadeiro se a condição 2 for atendida e se a condição 1 ou a condição 3 for atendida.</td></tr></tbody></table>

1. Clique em **Adicionar Filtro** para adicionar outra condição de filtro.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FOFmnaMR1ayHks2zpXxZS%2FRetrievingOrganizationMetadata-S03-01.png?alt=media&amp;token=890852e6-2b11-41e5-b1e8-9fa043d0bec6" alt="" width="563"><figcaption></figcaption></figure></div>
2. Conclua o filtro seguindo as instruções da seção acima.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FIjUYt5qbA0QspZJTYUuh%2FRetrievingOrganizationMetadata-S03-02.png?alt=media&amp;token=303e864e-f6d1-4e29-9d93-216dc61362e0" alt="" width="563"><figcaption></figcaption></figure></div>
3. Repita esse processo para adicionar quantas condições de filtro forem necessárias.
4. Determine como você deseja que as condições de filtro sejam combinadas. Consulte a tabela acima para uma explicação das opções. Se **Lógica Básica** for usado, nenhuma outra ação é necessária.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F09XgRsV4ECDHEIPqLeJD%2FRetrievingOrganizationMetadata-S03-03.png?alt=media&amp;token=0fd0557d-5d26-4521-9e4b-147f303eb061" alt="" width="563"><figcaption></figcaption></figure></div>

**Usar Lógica Personalizada**

1. Selecione o **Personalizado** opção para ativar a lógica personalizada.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FoAqUvhsWv1Eks9shWLni%2FRetrievingOrganizationMetadata-S03-04.png?alt=media&amp;token=4a478b2f-3f0b-456c-a2a0-4d0b22c612a3" alt="" width="563"><figcaption></figcaption></figure></div>
2. Insira sua lógica personalizada na caixa de texto à direita do menu suspenso.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F7s4lydjuyU1EGDSKi88t%2FRetrievingOrganizationMetadata-S03-05.png?alt=media&amp;token=e8b7a240-3dd2-448c-9ef2-dfa453ddf545" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
A lógica personalizada pode usar **E**, **OU**, e **()** operações para combinar condições de filtro pelo número da linha.
{% endhint %}
{% endstep %}

{% step %}

### Executar Recuperação

1. Clique em **Executar** depois que você terminar de configurar o job de Recuperação.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FWY6gOZni79WAzhOcD4Cz%2FRetrievingOrganizationMetadata-S04-01.png?alt=media&amp;token=36f6936e-f9d1-4322-bcdb-76962db647e4" alt="" width="563"><figcaption></figcaption></figure></div>
2. Depois de iniciar o job de Recuperação, você será levado para a **Atividades** guia, onde você pode ver o status dele.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F4s8GbI2yezeQLT0RgEN6%2FRetrievingOrganizationMetadata-S04-02.png?alt=media&amp;token=3152369c-c5cc-4c54-ae68-728fe3ae866f" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}

#### Status da Recuperação

O job de Recuperação pode levar vários minutos para ser concluído, dependendo de quantos componentes ele está recuperando. O job começa como **Na fila**, depois muda para **Em andamento** quando começa a funcionar. Clique no botão de atualizar para atualizar o status do job.

Para jobs de Recuperação grandes, o status pode mostrar **Parcialmente concluída**. Isso significa que alguns componentes já foram recuperados e estão disponíveis para uso enquanto o job continua recuperando o restante em segundo plano.
{% endhint %}

3. Aguarde até que o status do job mostre **Concluído**.
   {% endstep %}

{% step %}

### Ver Registro

{% hint style="info" %}
No registro do job de Recuperação, você pode acompanhar as ações realizadas, incluindo componentes adicionados ou excluídos desde a última recuperação. Ele também destaca erros, o que é crucial para a solução de problemas. Para mais detalhes sobre os resultados e registros do job de Recuperação, veja o artigo a seguir.

* [Visualizando a atividade de uma organização](/devops/devops-pt-br/organizacoes/organizacoes-individuais/visualizando-a-atividade-de-uma-organizacao.md)
  {% endhint %}

1. Clique no **Recuperar** link do job para ver o registro.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F5KoPlubKa595E854C0aC%2FRetrievingOrganizationMetadata-S05-01.png?alt=media&amp;token=d0ccda9c-d38a-4c9a-a477-12f690966592" alt="" width="563"><figcaption></figcaption></figure></div>
2. A captura de tela a seguir mostra um exemplo de um job Parcialmente Concluído que ainda não detectou nenhum componente alterado.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F3bEjXfw47UB171PksCPz%2FRetrievingOrganizationMetadata-S05-02.png?alt=media&amp;token=4287d4d7-0752-473c-a8f1-c80c32391bcc" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}


---

# 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.flosum.com/devops/devops-pt-br/organizacoes/organizacoes-individuais/recuperando-metadados-da-organizacao.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.