Os administradores de repositórios podem criar tipos de recurso, que incluem o nome e a descrição do tipo de recurso. Ao criar um tipo de recurso, os administradores de repositórios
devem considerar quem utiliza o recurso, em que contexto ele é utilizado, quais
artefatos os recursos devem incluir, quais outros recursos estão relacionados e como
e quais informações descritivas os usuários precisam localizar para utilizar o
recurso com eficácia. Os administradores podem
definir outros níveis de restrições, como em artefatos, categorias ou
atributos.
Antes de Iniciar
Para criar um tipo de recurso, você deve ser um administrador de repositório.
Se você for um administrador de comunidade, para criar um tipo de recurso para sua comunidade, consulte
Criando Tipos de Recursos da Comunidade.
Sobre Esta Tarefa
Aprenda mais sobre os tipos de recursos: Usuários e administradores utilizam tipos de recursos com vários propósitos, dentre eles:
- Para alinhar à estrutura interna de uma organização.
- Permitir que usuários filtrem
uma procura por tipo de recurso.
- Colocar uma restrição em um
ativo. Por exemplo, é possível requerer que um recurso
tenha um tipo de arquivo específico como um artefato ou seja relacionado
a outro recurso em uma determinada maneira.
- Designar automaticamente categorias para o ativo com base no
conteúdo de artefatos XML.
- Criar regras que permitem que os artefatos XML sejam indexados
e localizados por procuras feitas por palavras-chaves.
- Visualizar métricas do número de recursos que existem por tipo no repositório.
- Acionar um processo de revisão customizado que seja designado
a tipos de ativos específicos em uma comunidade.
- Designar funções de comunidade a serem aplicadas aos ativos
de um tipo específico.
Quando criar um tipo de recurso, considere as
seguintes questões:
- Quem utilizará o recurso?
- Como o ativo será usado?
- Quais artefatos o recurso deve incluir?
- Quais informações descritivas o recurso deve incluir?
- Quais informações os usuários precisam para localizar e usar o ativo?
- Quais ativos estão relacionados ao ativo e quais são os relacionamentos?
- Os artefatos do recurso incluirão conteúdo XML? Se sim, deseja designar automaticamente
as categorias com base nesse conteúdo XML?
Para criar um
tipo de recurso que seja semelhante ao tipo de recurso existente,
clique em Duplicar.
Essa ação duplica o tipo de ativo existente e, em seguida, é possível modificar o nome e os
detalhes existentes do tipo de ativo clicando no nome do tipo do ativo e editando os detalhes.
Importante: Os tipos de recurso no repositório
são exibidos em ordem alfabética. Quando você cria tipos de recurso que correspondem a
uma necessidade ou departamento de negócios específico, nomeie os tipos de recurso semelhantes
com os mesmos prefixos para que os usuários possam localizar os tipos de recurso na lista facilmente. Por exemplo, para os tipos de recurso de serviço, é possível
criar os seguintes nomes de tipo de recurso:
- Serviço
- Design do Serviço
- Modelo de Serviço
- Implementação do Serviço
- Teste do Serviço
- Resultados do Teste do Serviço
Essas etapas devem ser executadas por um usuário com permissões de administração.
Procedimento
- Efetue login no aplicativo da Web .
- Clique em Administração.
- Na barra lateral Administração de Repositório, clique em
Tipos de Recurso.
- Clique em Novo Tipo de Recurso.
- Descreva o tipo de recurso:
- No campo Nome, digite um nome.
- No campo Descrição, digite uma descrição
significativa. Quando um usuário está submetendo um novo ativo usando o assistente para Submeter
um Ativo, essa descrição é exibida quando o usuário seleciona esse tipo de ativo e clica no
ícone da ajuda do campo Tipo da página Descrever.
- Opcional: Selecione as comunidades que conterão esse tipo de ativo. Se o tipo de ativo não for
restrito a determinadas comunidades, ele estará disponível para todas as comunidades no
repositório.
- Clique na guia Definição de Escopo.
- Para limitar as comunidades que podem conter esse tipo de recurso, na seção
Definição de Escopo de Comunidades, selecione Restringir para Comunidades Selecionadas e, em seguida, selecione uma ou mais comunidades.
- Opcional: Defina o esquema de categoria disponível para o tipo de ativo. É possível permitir uma
seleção total ou limitada de categorias que estão disponíveis no
repositório.
- Clique na guia Definição de Escopo.
- Para permitir que todas as categorias sejam aplicadas ao recurso, na seção Definição
de Escopo da Categoria, selecione Utilizar Todos os Esquemas de Categoria.
- Para permitir apenas uma subseção de esquemas de categoria, selecione Utilizar
Apenas os Esquemas de Categoria Selecionados e, em seguida, selecione um ou
mais esquemas de categoria.
- Opcional: Defina uma restrição de artefato especificando um intervalo quantificável de artefatos
necessários que estão em conformidade com uma extensão, formato ou rótulo.
- Clique na guia Restrições.
- Na seção Restrições de Artefato, clique em Nova Restrição de
Artefato.
- Selecione o intervalo de artefatos necessários, escolha o tipo de
restrição e, em seguida, digite um valor para o tipo de artefato necessário. Por
exemplo, se criar um recurso com um tipo de recurso denominado
"Apresentação", poderá especificar que o recurso contém pelo menos um
artefato com a extensão de arquivo .ppt. O formato é o contexto do arquivo, por exemplo uma apresentação ou um modelo de processo. Extensão de arquivo é o tipo de arquivo, por exemplo .txt, .xml ou .ppt. O formato é automaticamente definido com base no tipo MIME do arquivo.
- Opcional: Defina restrições de relacionamento.
- Clique na guia Restrições.
- Na seção Restrições de Relacionamento, clique em Nova Restrição de
Relacionamento.
- Especifique um intervalo quantificável e, em seguida, escolha o tipo de recurso
que deve estar de acordo com o relacionamento escolhido.
- Se desejar limitar ativos desse tipo para que usem apenas as restrições de relacionamento
definidas aqui, selecione Permitir apenas esses relacionamentos. Quando os usuários submetem ou modificam ativos desse tipo, eles não podem
selecionar nenhum dos outros relacionamentos.
- Opcional: Inclua atributos de recurso para permitir que os usuários insiram informações adicionais ou
escolham valores predefinidos sobre o ativo. Esses atributos são organizados em duas colunas
que ficam visíveis na página de detalhes gerais de um ativo.
Os atributos que são movidos para a seção Atributos Ocultos não ficam visíveis na página de
detalhes gerais do ativo.
- Clique na guia Restrições.
- Inclua restrições de atributos para cada seção. As seções estão divididas em Coluna 1, Coluna 2 e Atributos Ocultos.
É possível organizar os atributos em duas colunas para agrupar os atributos na página de
detalhes gerais para um ativo. Os atributos contidos na seção Atributos Ocultos não ficam
visíveis na página de detalhes gerais dos ativos. Para incluir uma restrição de atributo:
- Passe o cursor sobre o nome da seção e clique no ícone Inserir.
- Clique em Incluir Restrições de Atributo.
- Insira um nome no filtro e selecione o atributo, ou mantenha pressionada a tecla CTRL para
selecionar diversos atributos, e clique em Incluir e Fechar.
- Escolha as restrições de atributos a serem exigidas.
- Passe o cursor sobre o nome do atributo e clique no ícone Editar.
Se o ícone Editar não aparecer, o atributo já é obrigatório e não pode ser editado.
- Marque a caixa de seleção O atributo é obrigatório.
- Clique em OK.
- Crie grupos dentro de cada seção.
- Passe o cursor sobre cada seção e clique no ícone Inserir.
- Clique em Incluir Grupo de Atributos.
- Insira um nome para o grupo e clique em Incluir e Fechar.
- Reordene os atributos em uma ordem lógica e agrupamentos para usuários do ativo. Para mover um atributo para uma seção ou grupo diferente, clique e mantenha pressionado o
atributo mova o cursor para o local desejado e libere o atributo.
- Opcional: Defina uma expressão e uma regra XPATH que aplicam categorias automaticamente a um ativo
com base no conteúdo de artefatos XML dos quais você faz upload para o ativo.
- Clique na guia Categorização Automática.
- Clique em Nova Categorização de Artefato XML.
- Para preencher a seção Mapeamentos de Namespace e testar a expressão XPATH, faça upload de
um documento XML de amostra procurando um documento de amostra no sistema de arquivos local e
clique em Fazer Upload de Amostra. Se você fizer upload de diversos documentos, apenas o mais recente poderá será usado. O arquivo de amostra pode ser reutilizado para vários recursos até que você efetue logout.
- Para incluir tipos de arquivos de artefato que contêm o conteúdo XML, clique em
Incluir Tipo de Arquivo, digite uma extensão de arquivo e clique em
OK.
- Clique em Incluir Mapeamento de Espaço de Nomes e, em seguida, digite o
prefixo e o URI dos espaços de nomes XML. Se transferiu um arquivo por upload na seção
Arquivo XML de Amostra, é possível clicar em Incluir da Amostra para
recuperar todas as informações do espaço de nomes a partir dali. É possível editar ou excluir
qualquer mapeamento da lista. O espaço de nomes padrão é listado com o prefixo
"padrão". É possível editar esse mapeamento para usar o nome de elemento real ou utilizar
"padrão" no lugar do nome de elemento na expressão XPATH.
- Para selecionar uma ou mais categorias para aplicar automaticamente aos recursos desse
tipo, se contiverem artefatos que correspondam à expressão XPATH fornecida, clique em
Incluir Categoria e selecione uma ou mais categorias na janela
Selecionar Categorizações. Clique em Excluir para
remover uma categoria.
- No campo Expressão XPATH, digite uma expressão XPATH a ser usada
para procurar documentos XML. Por exemplo: /wsdl:definitions/@targetNameSpace
- Para avaliar a expressão XPATH com seu arquivo XML de amostra, clique em
Testar Amostra. É possível visualizar os resultados da avaliação.
- No campo Contém, digite o valor ao qual você deseja que a expressão
XPATH corresponda. Por exemplo: example.com
Ao submeter esse tipo de ativo, se os resultados da expressão XPATH corresponderem
ao valor do campo Contém, as categorias especificadas serão aplicadas ao
ativo.
- Opcional: Defina como o conteúdo de artefatos XML é indexado e exibido nos resultados da procura.
- Clique na guia Regras de Índice de Procura.
- Clique em Nova Regra.
- Selecione Regra de Artefato XML e clique em OK. A página Regra de Indexação XML é aberta.
- No campo Nome, digite um nome para a
regra.
- No campo Descrição, digite uma descrição
significativa para a regra.
- No campo Extensões de Arquivo, digite uma lista de
extensões de arquivo para indexar. Separe diversas extensões com um espaço, Por exemplo: wsdl xml dita xsd
- Para definir elementos XML para indexar, na seção Configuração da Regra,
clique em Incluir Elemento.
- No campo Elemento, digite o elemento XML que deseja
indexar. Selecione Indexar todos os Atributos se você também desejar
indexar o conteúdo de todos os atributos para o elemento.
- Clique em OK.
- Opcional: Para definir um ou mais atributos de elemento específicos para indexar, clique em
Incluir Atributo, digite um nome de atributo e, em seguida, clique em
OK. Repita para todos os atributos
que deseja indexar.
- Clique em OK. A página Tipo de Recurso é reaberta. Clique no nome da regra para editá-la ou em Excluir para
removê-la.
- Clique em OK para salvar o tipo de recurso.
O que Fazer Depois
Para localizar um tipo de ativo existente para ser modificado, insira o nome do tipo
de ativo no campo Filtrar para uma identificação rápida em listas longas.