Systeme zur Quellcodeverwaltung mit dem Adaptererweiterungspunkt implementieren

Verwenden Sie den Adaptererweiterungspunkt der Quellcodeverwaltung, um diese verschiedenen Systeme zur Quellcodeverwaltung zu implementieren: CVS, IBM® Rational ClearCase (Base und UCM ClearCase) und IBM Rational Team Concert.

Informationen zu diesem Vorgang

Mithilfe des Erweiterungspunkts der Quellcodeverwaltung können Sie die Benutzerschnittstelle der Quellcodeverwaltung in den Rational Asset Manager-Eclipse-Client integrieren. Wenn die Ressourcenartefakte eines Assets, das Sie übergeben, von einem ein System zur Quellcodeverwaltung verwaltet werden, wird ein Contributor festgelegt. Der Contributor basiert auf der teamRepositoryProviderID der Ressourcenartefakte und den artifactReferenceKind-Informationen, die für jedes Artefakt aufgezeichnet werden. Bevor Sie ein Asset übergeben können, bestimmt der Contributor, welche Dateien ausgecheckt sind, und checkt alle Dateien ein. Die Dateien müssen an das System zur Quellcodeverwaltung übergeben werden, sodass die Quellcodeverwaltungsinformationen zum Zweck der Rückverfolgbarkeit aufgezeichnet werden können. Der Contributor erstellt außerdem Verbindungen zu dem System zur Quellcodeverwaltung, die es ermöglichen, Dateien aus der Quellcodeverwaltung auszuchecken und in den Eclipse-Arbeitsbereich zu stellen. Es sind verschiedene Optionen verfügbar, um die Verzweigung, aus der das Asset übergeben wurde, oder andere geeignete Verzweigungen auszuwählen oder um eine neue Verzweigung zu erstellen.

Mithilfe des Adaptererweiterungspunkts der Quellcodeverwaltung können Sie Referenzinformationen zu Artefakten bereitstellen, die sich unter der Steuerung der Quellcodeverwaltung befinden. Die Quellcodeverwaltungsinformationen befinden sich im Referenzabschnitt eines Artefakts. Mithilfe der Informationen können Contributors Ressourcen in die Quellcodeverwaltung einchecken, die Ressourcen bestimmen, die eingecheckt werden müssen, Eclipse-Projekte aus dem entsprechenden System zur Quellcodeverwaltung importieren und Unterstützung für das Verzweigen bereitstellen. Um vollständige Integration in ein System zur Quellcodeverwaltung bereitzustellen, müssen Sie auch den Erweiterungspunkt com.ibm.ram.rich.ui.extension.teamUIContributor verwenden.

API-Informationen:

Mithilfe des Adaptererweiterungspunkts der Quellcodeverwaltung können Sie mehrere Contributors teamContributor definieren. Jeder Contributor muss eine Klasse bereitstellen, die zu com.ibm.ram.rich.core.scm.TeamContributor erweitert wird.

Jeder Contributor muss mindestens ein Element artifactReferenceKind bereitstellen. Dieses Element wird an jedes Artefakt angehängt, um das System zur Quellcodeverwaltung zu identifizieren, aus dem das Artefakt stammt. Mithilfe des Assets müssen Sie den Contributor teamUIContributor bestimmen, der für die Artefakte dieses Assets verwendet werden muss. Contributors müssen einen qualifizierten, global eindeutigen Namen für dieses Attribut auswählen, wie z. B. org.organization.product.ram.myscm, damit das Attribut nicht mit anderen Contributors kollidiert.

Jeder Contributor muss exakt ein Element teamRepositoryProviderID bereitstellen. Dieses Element identifiziert das System zur Quellcodeverwaltung für diese Ressource im Arbeitsbereich. Sie können den Repository-Provider für eine Ressource mit org.eclipse.team.core.RepositoryProvider.getProvider(IProject) abrufen. Sie können die ID für jeden Repository-Provider mit org.eclipse.team.core.RepositoryProvider.getID() abrufen. Sie müssen diese ID im Attribut repositoryProviderID des Elements teamRepositoryProviderID angeben.

Konfigurationsmarkup:

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

<!ELEMENT teamContributor (artifactReferenceKind+ ,teamRepositoryProviderID)>
<!ATTLIST extension
 point CDATA#REQUIRED
 id CDATA #IMPLIED
 name CDATA #REQUIRED>
  • id: Die ID für jeden Beitrag.
  • name: Ein lesbar umgewandelter Name für jeden Beitrag.
  • class: Die Klasse stellt Beiträge für die Interaktion von Rational Asset Manager mit dem System zur Quellcodeverwaltung bereit. Sie müssen die Klasse com.ibm.ram.rich.core.scm.TeamContributor zum Bereitstellen von Beiträgen erweitern.
<!ELEMENT artifactReferenceKindEmpty>
<!ATTLIST artifactReferenceKind
kind CDATA #REQUIRED>
Dieses Attribut wird an jedes Artefakt angehängt, um das System zur Quellcodeverwaltung zu identifizieren, aus dem das Artefakt stammt. Das Attribut wird beim Verarbeiten des Assets verwendet, um zu bestimmen, welcher Contributor teamUIContributor oder teamContributor für Artefakte zu verwenden ist. Contributors müssen einen qualifizierten, global eindeutigen Namen für dieses Attribut auswählen, wie z. B. org.organization.product.ram.myscm, damit das Attribut nicht mit anderen Contributors kollidiert.
<!ELEMENT teamRepositoryProviderID EMPTY>
<!ATTLIST teamRepositoryProviderID
repositoryProviderID CDATA #REQUIRED>
Dieser Code identifiziert das System zur Quellcodeverwaltung für die Ressource im Arbeitsbereich. Sie können einen Repository-Provider für jede Ressource mit org.eclipse.team.core.RepositoryProvider.getProvider(IProject) abrufen. Jeder Repository-Provider hat eine ID, die Sie mit org.eclipse.team.core.RepositoryProvider.getID() abrufen können. Geben Sie diese ID im Attribut repositoryProviderID des Elements teamRepositoryProviderID an.

Beispiel

<extension id="com.ibm.ram.rich.core.artifactContributor" 
 name="Core Artifact Contributor" 
 point="com.ibm.ram.rich.core.teamContributor">

<teamContributor class="com.ibm.ram.internal.rich.core.scm.ccvs.CVSArtifactContributorWrapper"
 id="com.ibm.ram.rich.core.teamContributor.cvs"
 name="CVS Team Contributor">

<artifactReferenceKind kind="CVS">

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

</teamRepositoryProviderID>
</teamContributor>
</extension>

Feedback