---
sourceDocument: Xanadu IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-service-management

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Xanadu IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Definir ou atualizar uma coleção

# Definir ou atualizar uma coleção {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

Defina ou atualize uma coleção enquanto trabalha em um changeset de uma aplicação.

## Antes de Iniciar

Importante:  
A partir da versão Washington DC, o Configuração de DevOps está sendo preparado para descontinuação futura. Ele ficará oculto e não será mais instalado em novas instâncias, mas continuará sendo compatível. Para obter detalhes, consulte o artigo [Deprecation Process (Processo de descontinuação) \[KB0867184\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) na Base de conhecimento do Now Support.

Função necessária: cdm_editor ou 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 da guia Dados de configuração.

## Procedimento

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

   | Seleção | Ação |
   | Criar coleção | Adicione um componente individual à coleção. |
   | Criar CDI | Adicione um item de dados de configuração (CDI) individual 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. * Substituir: 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 e CDIs herdados da coleção secundária. Os nós e CDIs substituídos 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 uma 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. Este número é 5 por padrão. Exemplo: a Coleção1 é herdada pela Coleção2. A Coleção2 é herdada pela Coleção3. Esta cadeia de herança não pode continuar para a Coleção6. Você pode alterar o comprimento válido da cadeia editando a propriedade do sistema sn_cdm.max_inheritance_chain_length. {#cdm-collection-define__ul_j4x_thk_d1c} |
   | Incluir nos implantáveis | Incluir a coleção selecionada no implantáveisespecificado. Na caixa de diálogo Incluir em implantáveis, selecione o implantáveis que deve incluir a coleção e selecione Incluir. Nota: Somente implantáveis que não incluem a coleção aparecem na lista. |
   | Renomear | Renomeie a coleção selecionada. |
   | Excluir | Exclua a coleção selecionada. |
   | Detalhes | Exibir as informações administrativas associadas à coleção. |
   | Exibir relacionamentos | Exibir relacionamentos diretos com o nó. Relacionamentos diretos são formados entre nós por herança ou por inclusão. |
   |-|-|

   {#cdm-collection-define__choicetable_hkz_r4h_tpb}
3. Adicionar um CDI: selecione o ícone de mais ações ( ícone de ![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 par de `chave direta: valor`. * Você pode definir uma variável e especificar seu valor padrão. As definições de variável têm o seguinte formato: @@<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. Essas são 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. Por exemplo, 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 a função Segredos do CDM \[sn_cdm.cdm_secrets\]. Depois de criar o CDI, o valor aparecerá em todas as exibições como `*******`. Para exibir o valor em qualquer guia que exiba o CDI, os usuários com a função Segredos do CDM \[sn_cdm.cdm_secrets\] podem selecionar a opção de menu Exibir dados criptografados. |
   [Tabela 1. Criar CDI]

   {#cdm-collection-define__table_h53_jmt_spb}
4. **Opcional:** Adicione configurações de CDI que substituirão ou sobreporão configurações nas coleções.  
   Para obter mais informações, consulte [Definir ou atualizar um componente](https://servicenow-prod.fluidtopics.net/twLDZ32fmIHcwUQ8objEYg "Defina ou atualize um componente enquanto trabalha em um changeset.").
**Conceitos relacionados**   

* [Exibição e edição de dados de configuração](https://servicenow-prod.fluidtopics.net/kVGzulYDKUnGAWjPffVuzQ "Você pode atualizar os dados de configuração de uma aplicação criando ou abrindo um changeset na guia 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://servicenow-prod.fluidtopics.net/M7LKP20JUy5COBLa~Xklyw "Por padrão, os valores criptografados aparecem em todas as exibições como *******. Somente usuários com a função Segredos do CDM [sn_cdm.cdm_secrets] podem exibir, criar, atualizar e excluir valores criptografados em dados de configuração. O sistema valida e exporta dados criptografados corretamente.")  
**Tarefas relacionadas**   

* [Criar ou atualizar um CDI de variável](https://servicenow-prod.fluidtopics.net/5TwV2uYCC~u4OnqEufMQlA "Defina variáveis e defina seus valores em componentes, coleções e implantáveis.")  
**Referência relacionada**   

* [Modelo de dados de CDM](https://servicenow-prod.fluidtopics.net/~yq7Eendxe1WNN8dlEGskA "O modelo de dados CDM é 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 definidas por você e exporta dados de configuração válidos para o pipeline DevOps existente da sua organização para implementar aplicações, serviços e infraestrutura.")

