Implementando Sistemas de Gerenciamento de Controle de Origem com o Ponto de Extensão do Adaptador da Interface com o Usuário

É possível usar o ponto de extensão do adaptador da interface com o usuário de gerenciamento de controle de origem para implementar esses vários sistemas de gerenciamento de controle de origem: CVS, IBM® Rational ClearCase (Base e UCM ClearCase), e IBM Rational Team Concert.

Sobre Esta Tarefa

É possível usar o ponto de extensão do adaptador da interface com o usuário de gerenciamento de controle de origem para integrar a interface com o usuário de gerenciamento de controle de origem com o Rational Asset Manager Eclipse Client. Quando um sistema de gerenciamento de controle de origem gerencia os artefatos de recursos de um ativo enviado, um contribuidor é determinado. O contribuidor está baseado no teamRepositoryProviderID dos artefatos de recursos e nas informações de artifactReferenceKind que estão registradas em cada artefato. Para que você possa enviar um recurso, o contribuidor determina quais arquivos terão o registro de saída efetuado e efetua o registro de entrada de todos os arquivos. Os arquivos precisam ser enviados para o sistema de gerenciamento de controle de origem para que as informações de gerenciamento de controle de origem possam ser gravadas para rastreabilidade. O contribuidor também cria conexões com o sistema de gerenciamento de controle de origem que permitem que os arquivos sejam verificados a partir do gerenciamento de controle de origem na área de trabalho do Eclipse. Você pode escolher entre opções para selecionar a filial da qual o recurso foi enviado, selecionar outras filiais apropriadas ou criar uma nova filial.

É possível usar o ponto de extensão do adaptador de interface com o usuário de gerenciamento de controle de origem para definir decorações e propriedades para os artefatos, determinar quais ramificações estão disponíveis para uma importação de ativo e permitir que os usuários criem conexões para os repositórios de gerenciamento do controle de origem respectivos.

Para fornecer integração completa com um sistema de gerenciamento de controle de origem, também é necessário usar o ponto de extensão com.ibm.ram.rich.core.teamContributor. Para obter mais informações sobre o uso do ponto de extensão com.ibm.ram.rich.core.teamContributor, consulte Usando o ponto de extensão do adaptador de gerenciamento de controle de origem.

Informações da API:

É possível usar o ponto de extensão do adaptador de interface com o usuário de gerenciamento de controle de origem para definir vários contribuidores teamUIContributor. Cada contribuidor precisa fornecer uma classe que seja estendida para com.ibm.ram.rich.ui.scm.TeamUIContributor.

Cada contribuidor deve fornecer um ou mais elementos artifactReferenceKind. Esse elemento é anexado a cada artefato para identificar o sistema de gerenciamento de controle de origem a partir do qual o artefato é proveniente. Você deve utilizar o recurso para determinar o teamUIContributor que precisa utilizar para os artefatos desse recurso. Os contribuidores precisam selecionar um nome completo globalmente exclusivo para esse atributo, como org.organization.product.ram.myscm, para que o atributo não interfira em outros contribuidores.

Cada contribuidor deve fornecer um elemento teamRepositoryProviderID. Esse elemento identifica o sistema de gerenciamento de controle de origem para esse recurso na área de trabalho. Você pode obter um provedor de repositório com org.eclipse.team.core.RepositoryProvider.getProvider(IProject). O ID de cada provedor de repositório pode ser obtido com org.eclipse.team.core.RepositoryProvider.getID(). Forneça esse ID no atributo repositoryProviderID do elemento teamRepositoryProviderID.

Marcação de Configuração:

<!ELEMENT extension (teamUIContributor+)>
<!ATTLIST extension  
 point CDATA #REQUIRED 
 id CDATA #IMPLIED
 name  CDATA#IMPLIED>

<!ELEMENT teamUIContributor (artifactReferenceKind+ ,teamRepositoryProviderID)>
<!ATTLIST extension
 point CDATA#REQUIRED
 id CDATA #IMPLIED
 name CDATA #REQUIRED>
Utilize o seguinte ponto de extensão para contribuir com artefatos da interface com o usuário:
<!ELEMENT artifactReferenceKindEmpty>
<!ATTLIST artifactReferenceKind
kind CDATA #REQUIRED>
O seguinte atributo é anexado a cada artefato e identifica o sistema de gerenciamento de controle de origem onde o artefato é originado. Utilize esse atributo quando consumir o recurso para determinar o teamUIContributor ou teamContributor que você precisa utilizar para artefatos. Os contribuidores devem selecionar um nome completo globalmente exclusivo para esse atributo, como org.organization.product.ram.myscm, para que o atributo não interfira em outros contribuidores.
<!ELEMENT teamRepositoryProviderID EMPTY>
<!ATTLIST teamRepositoryProviderID
repositoryProviderID CDATA #REQUIRED>
Esse código identifica o sistema de gerenciamento de controle de origem para um recurso na área de trabalho. Você pode obter um provedor de repositório para um recurso com org.eclipse.team.core.RepositoryProvider.getProvider(IProject). Um ID para cada provedor de repositório pode ser obtido com org.eclipse.team.core.RepositoryProvider.getID(). Forneça esse ID no atributo repositoryProviderID do elemento teamRepositoryProviderID.

Exemplo

<extension id="com.ibm.ram.rich.ui.teamUIContributor" 
 name="Team UI Contributor" 
 point="com.ibm.ram.rich.ui.extension.teamUIContributor">

<teamUIContributor class="com.ibm.ram.internal.rich.ui.scm.CVSArtifactUIContributorWrapper"
 id="com.ibm.ram.rich.core.teamContributor.cvs"
 name="Team UI Contributor">

<artifactReferenceKind kind="CVS">

<teamRepositoryProviderID repositoryProviderID="org.eclipse.team.cvs.core.cvsnature">

</teamRepositoryProviderID>
</teamUIContributor>
</extension>

Feedback