Gerenciar arquivos no modelo de dados de configuração usando nós de arquivo

Adicione e gerencie arquivos usando nós de arquivo no modelo de dados de configuração de um app CDM ou em uma biblioteca de componentes.

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

Quando você anexa um arquivo a um nó aplicável, um nó de arquivo é criado nesse nó. O nó do arquivo contém um link para o arquivo anexado que armazena dados de configuração. Por exemplo, um arquivo de propriedades ou um arquivo de imagem de logotipo.

• Em um aplicativo, você pode adicionar o nó do arquivo a um nó no componente, na coleção ou na pasta implantável. Os nós de arquivo em um componente também são incluídos quando você inclui um componente em uma coleção e a coleção no implantável em um app. Você pode substituir os nós de arquivo incluídos no nível de coleção ou implantável, como qualquer outro item de dados de configuração.
• Em uma biblioteca de componentes, você pode adicionar um nó de arquivo a um nó em um componente compartilhado. Quando o componente compartilhado é usado em um app, os nós do arquivo são copiados junto com o arquivo anexado a eles.

Os desenvolvedores de apps e os membros do grupo de criação do app podem acessar os nós de arquivo e também baixar os arquivos anexados. Eles podem validar manualmente o conteúdo do arquivo e publicar o snapshot. Os usuários do DevOps podem exportar os dados de configuração validados, incluindo nós de arquivo com URLs para os arquivos anexados hospedados na instância ServiceNow em que a exportação foi executada.

Procedimento

1. Navegar até Tudo > Configuração de DevOps > Espaço da Configuração de DevOps.
2. Abra um app de configuração de DevOps ou uma biblioteca de componentes para adicionar um nó de arquivo ao seu modelo de dados de configuração.

   Opção	Etapas
   Como adicionar um nó de arquivo em uma aplicação	Selecione o ícone de apps ( ) no painel de navegação esquerdo. Selecione um app na lista Aplicações. Selecione Editar dados de configuração para abrir um changeset.
   Como adicionar um nó de arquivo em uma biblioteca de componentes	Selecione o ícone de bibliotecas de componentes ( ) no painel de navegação esquerdo. Selecione uma biblioteca de componentes para abrir ou criar uma. Selecione Editar para abrir um changeset.

   Um changeset é aberto com a guia Dados de configuração selecionada.
3. Na árvore de dados de configuração, selecione o ícone de mais ações ( ) ao lado de um nó ao qual você deseja adicionar um nó de arquivo e selecione Adicionar arquivo no menu.
   Nota:

   Em um app, você pode adicionar um nó de arquivo a um nó no componente, coleção ou implantável, mas não diretamente ao componente, coleção ou pasta de implantação em um app. Em uma biblioteca compartilhada, você pode adicionar um nó de arquivo a um nó em um componente compartilhado.
4. Adicione um arquivo para criar um nó de arquivo.
   1. Na caixa de diálogo Adicionar arquivo, pesquise e selecione um arquivo do seu sistema e clique em Adicionar arquivo.
      Você pode adicionar um arquivo do tipo MIME compatível com Now Platform com um tamanho máximo de arquivo de 5 MB.
   2. No campo Nome do nó, forneça um nome para o nó do arquivo.
      Por padrão, o nome do arquivo anexado é preenchido como o nome do nó do arquivo. O campo Tipo de conteúdo também é preenchido com o tipo de conteúdo do arquivo anexado.
   3. Selecione Adicionar arquivo.
   O nó do arquivo é adicionado ao nó selecionado. Selecione o nó do arquivo na árvore de dados de configuração para exibir seus metadados no painel Informações do arquivo e visualizar o conteúdo do arquivo no painel Conteúdo do arquivo.

   Nota:

   A visualização de conteúdo está disponível para os arquivos com os seguintes tipos MIME: text/yaml,text/css,text/csv,text/html,text/javascript,text/plain,text/richtext,text/x-vcard,text/ x-vcalendar,application/xml,application/javascript,application/json. Para exibir o conteúdo de arquivos do tipo MIME adicionais, adicione-os como uma lista separada por vírgulas à propriedade do sistema sn_cdm.attachment.display_mime_types. A visualização não está disponível para tipos MIME de arquivo binário, como áudio, imagem e vídeo.

   

5. Opcional: Depois que o nó do arquivo for adicionado aos dados de configuração, você poderá executar as seguintes ações no nó do arquivo ou no anexo do arquivo dentro dele.
   Nota:

   Todas as ações no nó do arquivo ou seu anexo de arquivo só podem ser feitas por meio do menu Mais ações no nó do arquivo.

   Ação	Etapas
   Renomear o nó do arquivo	Selecione o ícone de mais ações ao lado do nó do arquivo e selecione Renomear no menu. Na caixa de diálogo Renomear, insira um novo nome do nó do arquivo no campo Nome do nó. Se o nó do arquivo estiver incluído na coleção, ele também será renomeado lá.
   Extrair variáveis	Selecione o ícone de mais ações ao lado do nó do arquivo e selecione Extrair variáveis no menu. Na caixa de diálogo Extrair variáveis, especifique o caminho do arquivo para o qual você deseja extrair as variáveis. Todas as variáveis no nó do arquivo marcadas como @@<variableName> @@ são extraídos para o caminho de arquivo que você especificou. A variável é modificada para incluir também o caminho do arquivo. Você pode resolver todas as variáveis extraídas. Defina as variáveis extraídas e selecione Aplicar variáveis no menu de contexto do formulário. Esta ação substitui todas as variáveis extraídas no conteúdo do arquivo pelos valores de variáveis definidos.
   Excluir o nó do arquivo	Selecione o ícone de mais ações ao lado do nó do arquivo e selecione Excluir no menu. No pop-up Excluir, selecione Excluir. A exclusão do nó do arquivo tem o seguinte efeito sobre ele e seu anexo de arquivo: Se o nó do arquivo estiver incluído na coleção, ele também será excluído de lá. Qualquer nó de arquivo substituído se torna um nó de arquivo direto. Se o nó do arquivo for criado no changeset aberto no momento que ainda não foi confirmado, o nó do arquivo e seu anexo de arquivo serão excluídos permanentemente. Se o nó do arquivo tiver sido criado em um changeset confirmado anteriormente e for excluído no changeset aberto no momento, o nó do arquivo será excluído dos dados de configuração, mas o anexo do arquivo permanecerá no sistema.
   Baixar o anexo do arquivo	Selecione o ícone de mais ações ao lado do nó do arquivo e selecione Baixar arquivo no menu. Como alternativa, você pode baixar o arquivo selecionando o nó do arquivo e selecionando Download no painel de informações do arquivo.
   Substituir o anexo de arquivo	Selecione o ícone de mais ações ao lado do nó do arquivo e selecione Substituir arquivo no menu. Na caixa de diálogo Substituir arquivo, anexe um arquivo do seu sistema e selecione Substituir arquivo.
   Substitua um nó de arquivo incluído	Se um nó de arquivo estiver incluído em uma coleção e em um implantável, você poderá substituí-lo substituindo o arquivo anexado por um novo. Selecione o ícone de mais ações ao lado do nó do arquivo incluído na coleção ou na pasta implantável e selecione Substituir arquivo no menu. Na caixa de diálogo Substituir arquivo, anexe um arquivo do seu sistema e selecione Substituir arquivo.