Criando Regras para Arquivos e Pastas

Você pode criar regras para definir o conteúdo do recurso e metadados para executar uma atualização em lote.

Sobre Esta Tarefa

Depois de especificar os diretórios que contêm os arquivos e pastas dos quais você deseja criar recursos, crie regras que definam o conteúdo e os metadados do recurso. Você pode definir essas informações criando um arquivo manifest.rmd que contém definições de regras ou criando uma série de regras. Para saber como criar um arquivo manifest.rmd, consulte o seguinte tópico: Criando um Arquivo manifest.rmd
Quando você cria regras, pode geralmente especificar um arquivo de texto em um diretório que é ocupado com dados que criam a regra para você. Use o seguinte guia para ajudá-lo a criar arquivos de texto para cada tipo de regra. Esses arquivos de texto podem ter qualquer nome.
Tabela 1. Referência de Arquivo de Texto
Tipos de Metadados do Recurso Descrição Exemplo
Atributos Este arquivo de texto deve conter a seguinte sintaxe: one name=value pair por linha. Tempo de Execução context=Eclipse v3.3

Servidor context=WebSphere Application Server v6.1

Categorias Este arquivo de texto deve conter a seguinte sintaxe: one schema/category/subcategory por linha. Elas devem conter um esquema, uma categoria e pelo menos uma entrada de subcategoria. Automobile/Model/Foreign/Honda/Civic
Descrição Todo o conteúdo do arquivo de texto torna-se a descrição para o recurso. Este recurso traça todos os requisitos de software para o release v8.0.
Proprietários Este arquivo de texto deve conter um ID exclusivo por linha. Este ID não é igual a um ID de usuário. O ID exclusivo pode ser um código ou número designado que descreve sua identidade em um registro de usuário. jsmith ou

3F4467A

Recursos Relacionados Este arquivo de texto deve conter um relationshipType:guid/version por linha. Contêiner:{0000-1111-2222-3333}/1.0

Contém:{1111-2222-3333-4444}/1.1

Comunidade, Nome, Breve Descrição, Tipo de Recurso, Versão A primeira linha do arquivo de texto para cada um desses elementos de recursos deve ser o valor para o elemento correspondente. Minha Comunidade

Procedimento

Para criar regras sobre o conteúdo e os metadados de um recurso:

  1. Clique com o botão direito do mouse no caminho de diretório e clique em Incluir Regra. Você pode criar um recurso ou uma regra de comunidade para o diretório. Essas regras serão aplicadas a todas as pastas e arquivos no diretório.
  2. Crie uma regra de recurso, uma regra de comunidade ou os dois tipos de regras para o diretório. Use a seguinte tabela para aprender como criar regras de recursos e comunidades.
    Opção Descrição
    Regra de Recurso
    1. Na seção Tipo de Regra, selecione Recurso e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Criar Recursos Usando Todos os Arquivos e Pastas para criar recursos de arquivos e pastas primários no diretório
      • Opção 2: Clique em Criar Recursos Usando Arquivos e Pastas que Correspondam a esse Filtro e digite um valor para o filtro. O conteúdo de um arquivo de texto com um nome que contém esse valor torna-se recursos. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. Um arquivo ou pasta que contém esse valor no nome torna-se um recurso. Uma pasta ou arquivo que atende ao critério de filtro torna-se um recurso
    3. Clique em Concluir.
    Regra de Comunidade -

    Se você estiver incluindo uma regra de comunidade no diretório-raiz, então todas as pastas ou archives-filho serão incluídos nesta comunidade.

    1. Na seção Tipo de Regra, selecione Comunidade e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Criar comunidades Usando Todos os Arquivos e Pastas para definir comunidades por todos os arquivos e pastas neste diretório. As comunidades utilizam o nome das pastas ou archives no diretório.
      • Opção 2: Clique em Criar Comunidades Usando Arquivos e Pastas que Correspondam a esse Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. Um arquivo ou pasta que contém esse valor no nome torna-se uma comunidade. O conteúdo de um arquivo de texto com um nome que contenha esse valor torna-se a comunidade do recurso.
      • Opção 3: Clique em Especificar uma Comunidade na qual Todos os Recursos Serão Colocados e digite o nome da comunidade à qual você deseja que todos os recursos no diretório pertençam.
    3. Clique em Concluir.
  3. Depois de criar regras para o diretório, continue a criar regras para os arquivos e pastas que estão nos diretórios. Use a seguinte tabela para ajudá-lo a criar outras regras.
    Opção Descrição
    Regra de Artefato -

    Crie regras de artefato individuais para cada arquivo, pasta ou archive. Crie o máximo de regras de artefato necessárias para atingir a especificidade que deseja definir para seu recurso. Também é possível definir um artefato de URL.

    1. Na seção Tipo de Regra, selecione Artefato e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Criar Artefatos Usando Todos os Arquivos e Pastas para criar artefatos de todos os arquivos e pastas no recurso.
      • Opção 2: Clique em Criar Artefatos Usando Arquivos e Pastas que Correspondam a esse Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. Um arquivo ou pasta que contenha esse valor no nome torna-se um artefato.
      • Opção 3: Clique em Especificar um Artefato de URL que Será Incluído em Todos os Recursos para incluir um artefato de URL. Digite um nome para a URL e digite a URL que deseja incluir como um artefato. O artefato utiliza o nome que você define.
    3. Clique em Concluir.
    Regra de Tipo de Recurso -

    Você pode fornecer um tipo de recurso para cada recurso que define no diretório.

    1. Na seção Tipo de Regra, selecione Tipo de Recurso e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Configurar o Tipo de Recurso Usando um Arquivo que Corresponda a um Filtro e digite um valor para o filtro. O conteúdo de um arquivo de texto com um nome que contenha esse valor torna-se o tipo de recurso do recurso. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. Um arquivo ou pasta que contém esse valor no nome torna-se um tipo de recurso.
      • Opção 2: Clique em Especificar um Tipo de Recurso que Será Aplicado a Todos os Recursos e digite um nome para o tipo de recurso que você deseja aplicar para os recursos no diretório no qual você está definindo regras.
    3. Clique em Concluir.
    Regra de Atributo -

    Os atributos especificam o tipo de informações que os usuários poderão incluir ao enviarem um recurso.

    1. Na seção Tipo de Regra, selecione Atributo e clique em Avançar.
    2. Configure o valor clicando em Incluir Atributos Usando um Arquivo que Corresponda a um Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. Um arquivo ou pasta que contém esse valor no nome torna-se um atributo.

      O conteúdo de um arquivo de texto com um nome que contenha esse valor torna-se os atributos do recurso. Este arquivo de texto deve conter os seguintes dados com esta sintaxe: Keyword1 =Keyword2, em que keyword1 é o nome do atributo e keyword2 é o valor do atributo.

    3. Clique em Concluir.
    Regra de Categoria -

    Os esquemas de categoria ajudam a organizar recursos no repositório para que os usuários possam localizá-los e reutilizá-los.

    Se quiser classificar o recurso utilizando mais de uma categoria, é necessário criar mais de uma regra de categoria para esse recurso.

    1. Na seção Tipo de Regra, selecione Categoria e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Incluir Categorias Usando um Arquivo que Corresponda a um Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório.

        Um arquivo ou pasta que contém esse valor no nome torna-se uma categoria. O conteúdo de um arquivo de texto com um nome que contenha esse valor torna-se a categoria do recurso.

        Este arquivo de texto deve conter os seguintes dados com esta sintaxe: Category1/Category2/Category3.

        Por exemplo, onde Category1 é Automobile, Category 2 é Model e Category3 é Foreign, a categorização desse recurso é Automobile/Model/Foreign.

      • Opção 2: Clique em Especificar uma Categoria que Será Aplicada a Todos os Recursos e digite valores neste campo.
        • Esquema: A categoria de nível mais alto
        • Categoria: O filho do esquema
        • Subcategorias: O filho da categoria
        Por exemplo:
        • Esquema: Automobile
        • Categoria: Model
        • Subcategorias: Foreign/Honda
    3. Clique em Concluir.
    Regra de Comunidade -

    Se você estiver incluindo uma regra de comunidade no diretório-raiz, então todas as pastas ou archives-filho serão incluídos nesta comunidade.

    1. Na seção Tipo de Regra, selecione Comunidade e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Criar comunidades Usando Todos os Arquivos e Pastas para definir comunidades por todos os arquivos e pastas neste diretório. As comunidades utilizam o nome das pastas ou archives no diretório.
      • Opção 2: Clique em Criar Comunidades Usando Arquivos e Pastas que Correspondam a esse Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. Um arquivo ou pasta que contém esse valor no nome torna-se uma comunidade. O conteúdo de um arquivo de texto com um nome que contenha esse valor torna-se a comunidade do recurso.
      • Opção 3: Clique em Especificar uma Comunidade na qual Todos os Recursos Serão Colocados e digite o nome da comunidade à qual você deseja que todos os recursos no diretório pertençam.
    3. Clique em Concluir.
    Regra de Descrição -

    Esta regra define a descrição do recurso.

    1. Na seção Tipo de Regra, selecione Descrição e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Selecione Configurar a Descrição Usando um Arquivo que Corresponda a um Filtro e digite um valor para o filtro. O conteúdo de um arquivo com este filtro torna-se a descrição do recurso.
      • Opção 2: Selecione Especificar uma Descrição que Será Aplicada a Todos os Recursos e digite a descrição para esse recurso.
    3. Clique em Concluir.
    Regra de Nome -

    Esta regra define o nome do recurso.

    1. Na seção Tipo de Regra, selecione Nome e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Configurar o Nome Usando um Arquivo que Corresponda a um Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. O conteúdo de um arquivo de texto com um nome que contém esse valor torna-se um nome para o recurso.
      • Opção 2: Clique em Especificar um Nome que Será Aplicado a Todos os Recursos e digite um nome para o recurso.
    3. Clique em Concluir.
    Regra de Proprietário-

    Esta regra define os nomes dos proprietários de recursos. Se você especificar proprietários de um recurso que não existam no repositório, esses proprietários serão criados como usuários do repositório.

    1. Na seção Tipo de Regra, selecione Proprietário e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Configurar os Proprietários Usando um Arquivo que Corresponda a um Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. Um arquivo ou pasta que contém esse valor no nome torna-se um proprietário. O conteúdo de um arquivo que atenda a este critério de filtragem define os proprietários do recurso. É necessário definir os proprietários utilizando seu identificador exclusivo definido em um diretório do usuário do sistema de arquivo ou em um diretório LDAP. Esse arquivo deve conter apenas um identificador exclusivo por linha.
      • Opção 2: Clique em Especificar um Usuário que Se Tornará o Proprietário de Todos os Recursos e digite um identificador exclusivo que é definido em um diretório de usuário do sistema de arquivos ou em um diretório LDAP.
    3. Clique em Concluir.
    Regra de Recurso Relacionado -

    Esta regra define todos os recursos relacionados.

    1. Na seção Tipo de Regra, selecione Recurso Relacionado e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Incluir Recursos Relacionados Usando um Arquivo que Corresponda a um Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório.

        O conteúdo de um arquivo de texto com um nome que contenha esse valor torna-se o recurso relacionado do recurso. Este arquivo de texto contém os seguintes dados com esta sintaxe: RelationshipType:{GUID}/Version. Por exemplo, onde RelationshipType é dependente, GUID é 000–111–222 e Version é 1.0, os recursos relacionados dependem do recurso no qual você está definindo regras na seção de origem do editor. Os recursos relacionados possuem o identificador exclusivo designado anteriormente pelo Rational Asset Manager como 000–111–222 e são a versão 1.0 desse recurso.

      • Opção 2: Clique em Especificar um Tipo de Relacionamento e Recursos para Relacionar a Todos os Recursos e digite valores em cada um dos seguintes campos.
        • Tipo de Relacionamento é o tipo de relacionamento dos recursos que você está relacionando ao recurso com o qual está trabalhando na seção de origem do editor de atualização em lote.
        • ID Exclusivo é o GUID, ou o identificador exclusivo, do recurso relacionado.
        • Versão é a versão dos recursos relacionados.
        Por exemplo:
        • Tipo de Relacionamento: Dependente
        • ID Exclusivo: 000–111–222
        • Versão: 1.0
    3. Clique em Concluir.
    Regra de Breve Descrição -

    Esta regra define a descrição curta do recurso.

    1. Na seção Tipo de Regra, selecione Breve Descrição e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Configurar a Breve Descrição Usando um Arquivo que Corresponda a um Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. Um arquivo ou pasta que contém esse valor no nome torna-se uma descrição abreviada. O conteúdo de um arquivo que contenha esse valor torna-se a descrição curta do recurso.
      • Opção 2: Clique em Especificar uma Breve Descrição que Será Aplicada a Todos os Recursos e digite uma breve descrição para o recurso.
    3. Clique em Concluir.
    Regra de Versão-

    Esta regra define a versão do recurso.

    1. Na seção Tipo de Regra, selecione Versão e clique em Avançar.
    2. Configure o valor para a regra usando uma dessas opções:
      • Opção 1: Clique em Configurar a Versão Usando um Arquivo que Corresponda a um Filtro e digite um valor para o filtro. Esse valor pode incluir os seguintes caracteres especiais: '*' representa zero ou mais caracteres, '?' representa um caractere e '**' representa tudo em uma árvore de diretório. Um arquivo ou pasta que contém esse valor no nome torna-se a versão. O conteúdo de um arquivo que contenha esse valor torna-se a versão do recurso.
      • Opção 2: Clique em Especificar uma Versão que Será Aplicada a Todos os Recursos e digite uma versão para o recurso.
    3. Clique em Concluir.

O que Fazer Depois

Depois de definir as regras para o conteúdo e os metadados do recurso, você pode corrigir todos os problemas que existem com os recursos, selecionar o repositório e atualizar os recursos para o repositório.

Feedback