Definir ou atualizar uma coleção em uma aplicação

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 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] 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çãoAçã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.
      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.
      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.
    3. Adicionar um CDI: selecione o ícone de mais ações ( ícone de mais ações) para o item e selecione Criar CDI.
      Tabela 1. Criar CDI
      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
      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.

    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.