---
sourceDocument: Zurich IT Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/pt-BR/zurich/it-service-management

 Release :

    - zurich

ft:locale :

    - pt-BR

ft:publication_title :

    - Zurich IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Defina ou atualize uma coleção

# Defina ou atualize uma coleção {#ariaid-title1}

* Versão de lançamento: Zurich
* 
* Atualizado 31 de jul. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

Defina ou atualize uma coleção ao trabalhar em um conjunto de mudanças de uma aplicação.

## Antes de Iniciar

Importante:  
Configuração de DevOps agora está descontinuado e não há mais suporte ou disponível para nova ativação.

Função necessária: cdm_editorou cdm_admin

## Por Que e Quando Desempenhar Esta Tarefa

Importante:  
Salve suas mudanças sempre que tiver certeza das mudanças e antes de sair do Dados de configuração guia.

## Procedimento

1. Para adicionar uma coleção à aplicação: Ao trabalhar em um conjunto de mudanças, selecione o ícone Mais ações ( ![Ícone Mais ações.]()) para coleção nó e selecione Criar coleção .
2. Para editar itens de dados individuais, você pode trabalhar diretamente no código ou selecionar o ícone Mais ações ( ![Ícone Mais ações.]()) para um item e selecione uma ação, da seguinte forma.

   | Seleção | Ação |
   | Criar coleção | Adicione um componente individual à coleção. |
   | Criar CDI | Adicione um item de dados de configuração individual (CDI) e um valor à coleção. Consulte as instruções na próxima etapa. O CDI pode ter um valor explícito ou pode ser uma variável, substituição ou sobreposição. * Variável: O valor deste CDI definirá o valor de um CDI com nome idêntico em um componente incluído. * Substituição: O valor deste CDI substituirá o valor de um CDI com nome idêntico em um componente incluído. Você também pode substituir nós herdados e CDIs da coleção secundária. Os nós substituídos e os CDIs são rotulados como substituídos herdados. * Sobreposição: Um CDI que não aparece em nenhum componente incluído. {#cdm-collection-define__ul_onp_dtq_5pb} |
   | Herdar da coleção | Herde automaticamente as mudanças de outra coleção. Quando você marca a caixa de seleção e especifica um Coleção as mudanças feitas na coleção primária especificada são refletidas em todas as coleções secundárias. Selecione Remover herança para remover o relacionamento hereditário existente de uma coleção. Nota: A herança é considerada inválida quando: * Circular, em que o primário e o secundário herdam um do outro. * Há mais do que o número máximo de coleções em uma cadeia. Por padrão, este número é 5. Exemplo: Collection1 é herdada por Collection2. Collection2 é herdada por Collection3. Esta cadeia de herança não pode continuar para a Coleção6. Você pode mudar o comprimento válido da cadeia editando o. sn_cdm.max_inheritance_chain_lengthpropriedade do sistema. {#cdm-collection-define__ul_j4x_thk_d1c} |
   | Incluir nos implantáveis | Incluir a coleção selecionada no especificado implantáveis. Em Incluir em implantáveiscaixa de diálogo, selecione implantáveisque deve incluir a coleção e selecionar Incluir . Nota: Apenas implantáveisque não incluem a coleção no momento aparecem na lista. |
   | Renomear | Renomeie a coleção selecionada. |
   | Excluir | Exclua a coleção selecionada. |
   | Detalhes | Exiba as informações administrativas associadas à coleção. |
   | Exibir relacionamentos | Exiba relacionamentos diretos com o nó. Relacionamentos diretos são formados entre nós por herança ou por serem incluídos. |
   |-|-|

   {#cdm-collection-define__choicetable_hkz_r4h_tpb}
3. Adicionar um CDI: Selecione o ícone Mais ações ( ![Ícone Mais ações.]()) para o item e selecione Criar CDI .  
   {#cdm-collection-define__table_h53_jmt_spb__entry__2}

   |   |   |
   |-|-|
   | Nome | Nome exclusivo e significativo para o CDI. |
   | Valor | Valor que o CDI tem no contexto atual ou define uma variável. * Você pode especificar um direto `chave: valor `par. * Você pode definir uma variável e especificar seu valor padrão. As definições de variáveis têm o seguinte formulário: @@<variableName>@@: <value> * Você pode especificar um valor para uma variável usando o seguinte formulário: "<variableName>": "<value>" * Você pode especificar uma variável contextual. Variáveis definidas prontas para uso que usam o contexto do nó para definir o valor da variável. A variável usa o seguinte formulário: "<variableName>": "(#<value>#)" * Você pode usar variáveis recursivas para um valor de CDI. Variáveis recursivas usam outros valores de variáveis como parâmetros para definir o valor de CDI. Cada um desses valores de CDI pode resolver o mesmo devido a variáveis recursivas: cdi1: @(favorite_food/@(person)@)@ cdi2: @(favorite_food/@(john)@)@ cdi3: waffles {#cdm-collection-define__ul_hq3_pp4_kqb} |
   | Criptografado | Opção para especificar que o valor do CDI deve ser criptografado. Esta opção aparece somente para usuários com Segredos do CDM \[sn_cdm.cdm_secrets\]função. Depois de criar o CDI, o valor aparece em todas as exibições como `!!** `. Para exibir o valor em qualquer guia que exiba o CDI, os usuários com Segredos do CDM \[sn_cdm.cdm_secrets\]a função pode selecionar Exibir dados criptografados opção de menu. |
   [Tabela 1. Criar CDI]

   {#cdm-collection-define__table_h53_jmt_spb}
4. **Opcional:** Adicione configurações de CDI que substituirão ou sobrepõem configurações em coleções.  
   Para obter mais informações, consulte [Defina ou atualize um componente](https://www.servicenow.com/docs/4efu5krhn9WL3NmScE5rzQ "Defina ou atualize um componente ao trabalhar em um conjunto de mudanças.").
**Conceitos relacionados**   

* [Exibição e edição de dados de configuração](https://www.servicenow.com/docs/6tuW0dSGlx24dB_yjXuOuA "Você pode atualizar os dados de configuração de uma aplicação criando ou abrindo um conjunto de mudanças no Dados de configuração , onde você atualiza a estrutura e os CDIs dos dados de configuração.")
* [Como os dados criptografados são tratados](https://www.servicenow.com/docs/9aj4AEc~Ds6f1aDoPgOAaQ "Por padrão, os valores criptografados aparecem em todas as exibições como !!** . Somente usuários com Segredos do CDM [sn_cdm.cdm_secrets]a função pode exibir, criar, atualizar e excluir valores criptografados nos dados de configuração. O sistema valida e exporta dados criptografados adequadamente.")  
**Tarefas relacionadas**   

* [Crie ou atualize um CDI variável](https://www.servicenow.com/docs/KdlfAp0Zs7HjKvB96nkTqA "Defina variáveis e defina seus valores em componentes, coleções e implantáveis.")  
**Referência relacionada**   

* [Modelo de dados de CDM](https://www.servicenow.com/docs/iA3cO~cDezXH_Dj4NHcJLw ". CDM o modelo de dados é uma estrutura de dados padronizada que oferece suporte ao ciclo de vida mais amplo da entrega de software: automação, validação de qualidade e CSDM. CDM importa dados de configuração existentes, valida-os usando políticas que você define e exporta dados de configuração válidos para os existentes da sua organização DevOps pipeline para implementar aplicações, serviços e infraestrutura.")

