StarTeam Handbuch für neue Funktionen

StarTeam
Handbuch für neue Funktionen
StarTeam ®

Borland Software Corporation
100 Enterprise Way
Scotts Valley, California 95066-3249, USA
www.borland.de
Die Borland Software Corporation verfügt möglicherweise über Patente und/oder anhängige
Patentanmeldungen, die den Inhalt dieser Dokumentation betreffen. Eine Liste vorhandener Patente
finden Sie auf der Produkt-CD im Dialogfeld „Info“. Durch die Bereitstellung dieses Dokuments
erhalten Sie keine Lizenz für diese Patente.
COPYRIGHT © 1995 - 2005 Borland Software Corporation. Alle Rechte vorbehalten. Alle Marken- und
Produktnamen von Borland sind Marken oder eingetragene Marken der Borland Software
Corporation in den USA und anderen Ländern. Alle anderen Marken sind Eigentum der jeweiligen
Inhaber.
Die Bedingungen und Haftungsausschlüsse für Drittanbieterprodukte finden Sie in den
Versionshinweisen auf Ihrer Produkt-CD.
Gedruckt in Irland.

Inhalt
Kapitel 1
Vorwort 5
Support bei Borland. . . . . . . . . . . . . . . . . . 5
Konventionen in der Dokumentation . . . . . . . . . 6
Kapitel 2
Neue Funktionen in StarTeam 2005
Release 2 7
Spezielle JRE . . . . . . . . . . . . . . . . . . . . . 7
Client/Server-Kompatibilität . . . . . . . . . . . . . . 7
StarTeam-Server für Windows . . . . . . . . . . . . 8
Datenbankunterstützung. . . . . . . . . . . . . . 8
Serveradministration. . . . . . . . . . . . . . . . 8
Lizenzserver-Support . . . . . . . . . . . . . . . 8
Vorhandenen Benutzern Lizenzen
zuweisen . . . . . . . . . . . . . . . . . . . 9
Neuen Benutzern Lizenzen zuweisen . . . . . 10
Alle Clients . . . . . . . . . . . . . . . . . . . . . . 10
StarTeam Windows- und Cross-Platform-Clients . . . 10
StarTeam Cross-Platform Client . . . . . . . . . . . 10
Diagramme . . . . . . . . . . . . . . . . . . . . 10
URLs verwenden . . . . . . . . . . . . . . . . . 11
Setup . . . . . . . . . . . . . . . . . . . . . . 11
URL- und HTML-Darstellung erstellen
und kopieren . . . . . . . . . . . . . . . . . 12
URLs in StarTeam verwenden . . . . . . . . . 12
Im linken Teilfenster verfügbare neue
Operationen . . . . . . . . . . . . . . . . . . . 13
Im oberen Teilfenster verfügbare neue
Operationen . . . . . . . . . . . . . . . . . . . 14
Hinzugefügte Auscheckstatistiken . . . . . . . . . 14
Verfügbarkeit von Visual Diff und
Visual Merge auf Windows-Plattformen . . . . . 15
StarTeamMPX. . . . . . . . . . . . . . . . . . . . . 15
Dateien aus spezifischen Projekten an
Remote-Cache-Agenten weiterleiten . . . . . . 15
Mehrere Dienste einrichten . . . . . . . . . . . . 17
Neue Parameter . . . . . . . . . . . . . . . . . . 18
StarTeam Extensions . . . . . . . . . . . . . . . . . 20
StarTeam-Integrationen . . . . . . . . . . . . . . . . 20
Borland LDAP QuickStart Manager. . . . . . . . . . 20
Der Import/Export-Manager in StarTeam . . . . . . . 21
Unterstützung von StarTeam 2005 . . . . . . . . . . 21
Index 23
iii

Kapitel
Kapitel 1Vorwort
Support bei Borland
Dieses Handbuch enthält Details zu den neuen Funktionen von StarTeam 2005.
Die Online-Handbücher werden im Adobe Acrobat Format (.PDF) ausgeliefert und
können in Adobe Acrobat Reader 4.0 oder höheren Versionen angezeigt werden. Das
Installationsprogramm für den Adobe Acrobat Reader befindet sich im Ordner „\Docs“
auf der StarTeam-Installations-CD. Der Reader kann auch von der Adobe-Website
heruntergeladen werden: www.adobe.de.
Borland Software Corporation bietet Ihnen hervorragenden Service in den Bereichen
Consulting und technische Unterstützung. Unser Unternehmen verfügt über mehr als
15 Jahre Erfahrung in der Unterstützung von Entwicklern und Unternehmen.
Qualifizierte Fachleute für technische Unterstützung stehen bereit, um Ihre einzelnen
Support-Anfragen zu bearbeiten oder Ihnen Unterstützung im Rahmen einer dauerhaften
Partnerschaft zu bieten. Borland stellt seinen Support weltweit zur Verfügung.
Wir liefern unseren Service rechtzeitig und zuverlässig, damit dem wirtschaftlichen
Erfolg unserer Kunden nichts im Wege steht.
Weitere Informationen über den Support von Borland finden Sie auf der Borland-
Website unter http://support.borland.com.
Auf dieser Website stehen Ihnen auch viele Newsgroups zur Verfügung, in denen
StarTeam-Benutzer Informationen, Tipps und Vorgehensweisen austauschen. Unter
http://info.borland.com/newsgroups/ finden Sie die neueste Liste mit kostenlosen
Produkt-Newsgroups. Sie können im Internet zudem auf das Borland Developer
Network unter http://community.borland.com zugreifen. Die Borland Community bietet
Ihnen Zugriff auf produktspezifische Informationen, Artikel, Beispiel-Code und
Produktneuigkeiten.
Wenn Sie den technischen Support anrufen, sollten Sie alle Informationen zu Ihrer
Systemumgebung, zur Produktversion und eine genaue Beschreibung des Problems
bereithalten.
Unterstützung für Tools von Drittanbietern oder Dokumentationen dazu erhalten Sie
vom Vertreiber des Tools.
Kapitel 1: Vorwort 5

Konventionen in der Dokumentation
Konventionen in der Dokumentation
In der StarTeam-Dokumentation werden folgende Dokumentationskonventionen
verwendet.
Wählen Sie
„Datei > Beenden“
Schrift mit fester
Breite
Kursiv
Steht für eine Menüauswahl, gefolgt von der Auswahl eines Untermenüs.
Das Größer-als-Zeichen (>) steht zwischen den Einträgen,
die in aufeinander folgenden Menüs gewählt werden. In diesem Fall
klicken Sie in der Menüleiste auf „Datei“ und wählen dann im
Dropdown-Menü „Beenden“.
Text in der Schriftart Courier wird für Informationen, die Sie eingeben
müssen, und für Systemmeldungen verwendet.
Syntax in Kursivschrift wird für Informationen verwendet, die Sie durch
die Namen von Dateien, Unterordnern usw. ersetzen müssen.
Kursivschrift wird auch für die Namen von Dialogfeldern, Büchern und
zur Betonung verwendet.
Hinweis
Tipp
Wichtig
Achtung
Wird für zusätzliche Informationen verwendet.
Beschreibt alternative Vorgehensweisen oder andere hilfreiche Informationen.
Enthält Informationen, die für die Ausführung einer Aufgabe erforderlich sind.
Wird für Aktionen verwendet, die zu einem Datenverlust führen können, oder für
Schritte, die ausgeführt werden müssen, damit Daten nicht verloren gehen.
6 StarTeam - Handbuch für neue Funktionen

Kapitel
2Neue Funktionen in StarTeam 2005
Kapitel
Release 2
In diesem Kapitel erhalten Sie einen Überblick über die neuen Funktionen von
StarTeam SDK, StarTeam Server und verschiedenen StarTeam-Clients in
StarTeam 2005 Release 2.
StarTeam 2005 Release 2 ist die Folgeversion zu StarTeam 2005. Da der interne Name
StarTeam 8.0 lautet, werden an einigen Stellen in Registrierungsschlüsseln, Build-
Nummern und Dateinamen möglicherweise die Zahlen 8.0 oder 80 verwendet.
Nach der Installation dieser Version müssen Sie alle Serverkonfigurationen aktualisieren.
Beachten Sie bei der Installation des StarTeam-Server- oder Windows-Clients, dass die
Person, die das Installationsprogramm ausführt, über Administratorrechte für diesen
Computer verfügen muss.
Lesen Sie vor der Installation und Aktualisierung der StarTeam-Produkte das
StarTeam-Installationshandbuch.
Serverkonfigurationen der Versionen 6.0 und 2005 können auf 2005 Release 2
aktualisiert werden. Ältere Versionen müssen zunächst auf eine Zwischenversion
aktualisiert werden, bevor das Upgrade auf StarTeam 2005 Release 2 ausgeführt
werden kann. Weitere Informationen finden Sie im StarTeam-Installationshandbuch.
Spezielle JRE
Client/Server-Kompatibilität
StarTeam 2005 Release 2 verwendet eine spezielle JRE, die zusammen mit dem SDK,
der SDK Runtime und StarTeam-Clientanwendungen installiert wird. Diese spezielle
JRE stellt sicher, dass alle StarTeam-Produkte eine gleichbleibende Leistung aufweisen
und bietet die bestmögliche Produktleistung. Die StarTeam 2005 Release 2-
Produkte verwenden die JRE Version 1.5.0_03 von Sun Microsystems.
Die StarTeam-Windows- und Cross-Platform-Clients der Version 2005 Release 2
können auf 2005- und 2005-Release-2-Server zugreifen. So können Sie Ihren Client
einfach aktualisieren, nachdem der StarTeam Server 2005 installiert wurde.
Kapitel 2: Neue Funktionen in StarTeam 2005 Release 2 7

StarTeam-Server für Windows
StarTeam-Server für Windows
In den nächsten Abschnitten werden die in StarTeam Server 2005 Release 2 vorgenommenen
Änderungen beschrieben.
Datenbankunterstützung
Neben den aktuell unterstützten Microsoft-SQL-Server-, MSDE- und Oracle-Datenbanken
werden nun auch IBM DB2 UDB 8.1.9 und 8.2.2 unterstützt.
Serveradministration
Ein neues Dienstprogramm für die Serveradministration, das die Funktionen der
bekannten Dienstprogramme „Server-Tools“ und „Serveradministration“ in einem Tool
kombiniert:
■
die lokale Serveradministration, die zuvor mit dem Serverprogramm ausgeführt
wurde (z. B. das Starten und Stoppen von Serverkonfigurationen)
■
die Remote-Administration von Servern, die zuvor mit dem alten Dienstprogramm
„Serveradministration“ ausgeführt wurde (z. B. das Ändern der Benachrichtigungsoptionen
für Serverkonfigurationen, Zeitlimits und andere Konfigurationseinstellungen)
Wählen Sie im Windows-Startmenü „Programme > StarTeam > StarTeam
Server 2005 R2> StarTeam-Server“, um das Dienstprogramm „Serveradministration“
zu öffnen. Auf diese Weise wurde auch das ehemalige Serverprogramm gestartet.
Einige Funktionen der 2005er Version des Dienstprogramms „Serveradministration“,
die für den Windows-Client verfügbar waren, sind bisher noch nicht Teil des neuen
Dienstprogramms. Hierbei handelt es sich um die Funktion zum Importieren von
Benutzern und Gruppen, mit der Benutzer aus einer Windows-Domäne importiert
werden konnten. Kunden, die diese Importfunktion verwenden müssen, wird der
StarTeam-Windows-Client der Version 2005 zur Verfügung gestellt. Sie können jedoch
auch den Borland LDAP QuickStart Manager verwenden und Benutzer- und Gruppeninformationen
aus einem Verzeichnisdienst importieren.
Lizenzserver-Support
Anmerkungen
Sie können nun Borland License Server oder FLEXlm für StarTeam-Server einsetzen.
So können Sie zwischen der Verwendung eines Lizenzservers und der bereits aus
anderen Versionen bekannten StarTeam-Lizenzierung wählen.
Wenn Sie einen Lizenzserver einsetzen, müssen die Benutzer ihre Netzwerk-
Anmeldenamen als StarTeam-Benutzernamen verwenden.
In den FLEXlm-Konfigurationsdateien unter Solaris muss die Groß-/Kleinschreibung
beachtet werden.
Für die Verwendung von Borland-Lizenzen für Lizenzserver muss der Administrator die
folgenden Schritte ausführen:
1 Er erhält Lizenzdaten von Borland per E-Mail (durch einen Vertriebsmitarbeiter
veranlasst).
2 Er installiert den Lizenzserver (Vorgehensweise wird in der Lizenzserver-
Dokumentation beschrieben).
3 Er verwaltet die von Borland mitgesendeten Lizenzen. (Dazu muss er auf eine
Borland-Website zugreifen und die Borland-Lizenzdateien mit der Erweiterung „.slip“
herunterladen.)
8 StarTeam - Handbuch für neue Funktionen

StarTeam-Server für Windows
4 Er speichert die .slip-Dateien im Ordner „/license“, einem Unterordner des
Installationsordners von StarTeam-Server.
5 Er konfiguriert den Lizenzserver für die Benutzer (Vorgehensweise wird in der
Lizenzserver-Dokumentation beschrieben).
6 Er kann mit dem StarTeam-Server-Administrations-Tool folgende Aktionen
durchführen:
a
Benutzernamen in Netzwerk-Anmeldenamen ändern
b Benutzern bestimmte Lizenzen zuweisen (über den StarTeam-Windows-Client ist
dies nicht möglich).
Beim Programmstart sucht StarTeam-Server nach .slip-Dateien und legt die gefundenen
Daten im Speicher ab. Neue .slip-Dateien werden erst beim nächsten Programmstart
erkannt.
Wenn sich ein Benutzer über eine StarTeam-Client-Anwendung anmeldet, teilt
StarTeam-Server der Client-Anwendung mit, auf welche Funktionen der Benutzer
gemäß seiner Lizenz zugreifen darf.
Wenn dem Benutzer eine Lizenz per .slip-Datei zugewiesen wurde, sich diese jedoch
nicht mehr im Lizenzordner befindet, zeigt StarTeam-Server eine Fehlermeldung an.
Wenn der Lizenztyp des Benutzers „Nicht zugewiesen“ ist, kann sich dieser nicht
anmelden und StarTeam-Server gibt eine Exception zurück.
Im Folgenden wird beschrieben, wie Sie bestimmten Benutzern Lizenzen zuweisen.
Sobald die .slip-Dateien im Ordner „/license“ gespeichert wurden, können im Benutzer-
Manager Informationen zu diesen Dateien angezeigt werden und der Administrator
kann den Benutzern die Lizenzen aus diesen Dateien zuweisen.
Anmerkungen
Vorhandenen Benutzern Lizenzen zuweisen
So weisen Sie vorhandenen Benutzern Lizenzen zu:
1 Führen Sie das Serveradministrations-Tool über den Cross-Platform-Client oder als
eigenständigen Prozess auf dem Computer aus, auf dem der StarTeam-Server
installiert ist.
2 Klicken Sie auf „Benutzer-Manager“ und melden Sie sich an.
Das Fenster „Benutzer-Manager“ wird geöffnet.
3 Wählen Sie die gewünschten Benutzer aus.
4 Wählen Sie „Benutzer > Lizenz zuweisen“, um eine Liste der Lizenzen anzuzeigen,
die zugewiesen werden können.
Die folgenden Lizenztypen sind verfügbar:
■
Lizenzen aus .slip-Dateien. In der oben dargestellten Abbildung sehen Sie
„slip 9954“ mit personengebundenen Lizenzen. Die .slip-Dateien können sowohl
personengebundene Lizenzen als auch Lizenzen für gleichzeitige Benutzer
enthalten.
■
■
■
Personengebundene Lizenz für StarTeam. Diese Art der Lizenz ist bereits aus
früheren StarTeam-Versionen bekannt.
Lizenzen für gleichzeitige Benutzer für StarTeam. Diese Art der Lizenz ist bereits
aus früheren StarTeam-Versionen bekannt.
Nicht zugewiesene Lizenz. Wählen Sie diesen „Lizenztyp“, wenn ein Benutzer
keine Lizenz hat.
In der Statusleiste im unteren Bereich des Benutzer-Manager-Fensters wird eine
Lizenzstatistik angezeigt.
Möglicherweise müssen Sie die Eigenschaften für den Benutzer bearbeiten, um den
Benutzernamen in den Netzwerk-Anmeldenamen zu ändern.
Kapitel 2: Neue Funktionen in StarTeam 2005 Release 2 9

Alle Clients
Neuen Benutzern Lizenzen zuweisen
So weisen Sie einem neuen Benutzer eine Lizenz zu:
1 Wählen Sie im Benutzer-Manager die Option „Benutzer > Neu“. Das Dialogfeld
„Eigenschaften für den neuen Benutzer“ wird angezeigt.
2 Wählen Sie im Register „Allgemein“ im Dropdown-Listenfeld „Lizenz“ einen
Lizenztyp aus.
Der Standardlizenztyp ist „StarTeam - Lizenz für gleichzeitige Benutzer“.
3 Geben Sie die restlichen Daten in das Register „Allgemein“ und die anderen Register
ein. Vergessen Sie nicht, im Textfeld „Benutzername“ des Registers „Anmeldung“
den Netzwerk-Anmeldenamen anzugeben.
4 Klicken Sie auf „OK“, um das Dialogfeld „Eigenschaften für den neuen Benutzer“ zu
schließen.
Alle Clients
Den meisten Clients wurden in dieser Version neue Symbole zugewiesen. Dies gilt
insbesondere für den StarTeam-Windows-Client, den Cross-Platform-Client und die
Web Edition.
StarTeam Windows- und Cross-Platform-Clients
Am Dienstprogramm für die StarTeam-Serveradministration wurden Änderungen
vorgenommen. Es wird nicht mehr als Teil der StarTeam-Windows- oder Cross-
Platform-Clients installiert. Sie können es jedoch bei Auswahl der entsprechenden
benutzerdefinierten Option während des Installationsprozesses installieren. Wählen Sie
im Windows-Startmenü „Programme > StarTeam > StarTeam Cross-Platform
Client 2005 R2 > Serveradministration“, um das Dienstprogramm zu starten.
Wenn es über den Client gestartet wird, kann es die vorhanden lokalen Serverkonfigurationen
nicht erkennen und kann nur für die Remote-Administration der Server eingesetzt
werden. Dies ist jedoch nicht neu, denn das alte Dienstprogramm für die Serveradministration
konnte auch nur für die Remote-Administration verwendet werden.
Die Verwaltung einzelner Benutzerkonten innerhalb der Clients wurde dahin gehend
vereinfacht, dass nun nur noch die Daten für den aktuellen Benutzer angezeigt werden.
Sie können Ihre Benutzerinformationen und Ihr Passwort nun im Tools-Menü über
„Eigenes Konto“ aktualisieren.
StarTeam Cross-Platform Client
In diesem Abschnitt werden nur die neuen Funktionen des StarTeam-Cross-Platform-
Clients beschrieben.
Diagramme
Der Cross-Platform-Client enthält in dieser Version ähnlich wie der Windows-Client
neue Diagramm-Funktionen.
Der Cross-Platform-Client bietet ebenso eine Vielzahl an unterschiedlichen
Diagrammen. Sie können Daten im oberen Fenster filtern, um nur die Daten anzuzeigen,
die im Diagramm berücksichtigt werden sollen. Außerdem können Sie bestimmte
Elemente aus den gefilterten Daten auswählen, um diese im Diagramm darzustellen.
10 StarTeam - Handbuch für neue Funktionen

StarTeam Cross-Platform Client
Diagramme basieren auf den im oberen Teilfenster angezeigten Daten. Im oberen
Fenster können maximal 60 Felder angezeigt werden.
Weitere Informationen zu Diagrammen im Cross-Platform-Client finden Sie in der
Online-Hilfe oder im Star Team-Benutzerhandbuch.
URLs verwenden
Der Cross-Platform-Client kann nun URL-Links auf Projekte, Ansichten, Ordner und
Elemente (Dateien, Änderungsanforderungen, Anforderungen, Tasks und Themen)
öffnen. Dies ermöglicht es Benutzern, problemlos auf bestimmte Elemente in einem
Projekt zuzugreifen.
Benutzer können außerdem URLs und HTMP-Darstellungen für Elemente erstellen und
diese in die Windows-Zwischenablage kopieren. Je nach Anwendung werden entweder
die URL- oder die HTML-Daten durch Einfügen in die Anwendung übernommen. So
können beispielsweise die Namen einer Dateiliste mithilfe der HTML-Darstellung in eine
Microsoft Excel-Tabellenkalkulation kopiert werden. Sie können URLs für mehrere
Dateien an andere Teammitglieder senden und in StarTeam verwenden, wenn Ihre
E-Mail-Anwendung diese beim Einfügen nicht in HTML konvertiert.
Hinweis
Die URL kann ID- oder namensbasiert sein. ID-basiert ist der ursprüngliche Standard
für alle Elementtypen. Die im Folgenden aufgeführten Beispiel-URLs zeigen die
grundlegenden Unterschiede zwischen ID- und namensbasierten URLs. Beide stellen
eine Datei in der Stammansicht eines Projekts dar. Die erste der beiden ist die IDbasierte
URL.
starteam://hostname:49201/12;ns=Project;scheme=id/154;ns=View;scheme=id/
869958;ns=File;scheme=id;scope=full;
starteam://hostname:49201/myproject/myview/path to myfile;scope full;
ID-basierte URLs bieten den Vorteil, dass ein Element in einen anderen Ordner
verschoben (oder der Name einer Datei geändert) werden kann und das Element
weiterhin auffindbar bleibt. Namensbasierte URLs bieten den Vorteil, dass die URL zu
unterschiedlichen Zeitpunkten in unterschiedliche StarTeam-Objekte aufgelöst werden
kann. Wenn beispielsweise eine Datei gelöscht und dann erneut hinzugefügt wird (mit
einer neuen ID), kann sie weiterhin gefunden werden.
Wie andere URLs enthalten die StarTeam-URLs den Namen des Servers für die
Verbindung. Dieser lautet „hostname“ in den oben aufgeführten Beispielen. In
einigen Organisationen kann der Zugriff auf die StarTeam-Server über das Internet
und das unternehmenseigene Intranet erfolgen. In solchen Fällen weist ein Server
möglicherweise zwei unterschiedliche IP-Adressen auf. Wenn der Benutzer die
Serverliste so konfiguriert, dass Sie über eine IP-Adresse auf einen Server verweist
und nicht über einen DNS-Namen, funktionieren die vom Client generierten URLs nur
über das Netzwerk, in dem diese IP-Adresse vorhanden ist.
Setup
Der von Ihrem StarTeam-Client erstellte URL-Typ für ein Element wird pro Element in
den entsprechenden Registern des Dialogfelds Persönliche Optionen eingerichtet.
Hiervon gibt es eine Ausnahme. Da es keine Möglichkeit gibt, den URL-Typ für einen
Ordner einzurichten, verwenden Ordner immer den ID-basierten URL-Typ. Im
Dialogfeld Persönliche Optionen können Sie die Vorlagen zum Erstellen der HTML-
Darstellung eines Elements angeben. Für Projekte, Ansichten und Ordner gibt es keine
HTML-Darstellung.
Kapitel 2: Neue Funktionen in StarTeam 2005 Release 2 11

StarTeam Cross-Platform Client
So geben Sie den URL-Typ und die HTML-Vorlage an:
1 Wählen Sie im Menü „Tools“ die Option „Persönliche Optionen“.
2 Wählen Sie das Register für den entsprechenden Elementtyp aus. Wählen Sie
beispielsweise „Datei“, um den URL-Typ für Dateien zu ändern.
■
■
Geben Sie die Vorlage, die zum Generieren der HTML-Darstellung eines Elements
verwendet wird, im Textfeld „Anzeigevorlage“ ein, wenn die URL des Elements in die
Zwischenablage kopiert wird. Wenn Sie keine Formatierung verwenden, steht eine
Standard-HTML-Darstellung zur Verfügung, die den Elementtyp angibt und diesen
anhand seines Namens und seiner Nummer identifiziert. Beispielsweise
„Änderungsanforderung 34,132“.
Wenn der Text von der Vorlage generiert wird, werden die Variablen in ~~*~~
durch die angegebenen Eigenschaftswerte ersetzt. Die Variablen können durch
die in den Berichtsvorlagen verwendeten Namen sowie durch den Anzeigenamen
der Eigenschaft referenziert werden. Bei Verwendung des Anzeigenamens sind
Leerzeichen nicht erforderlich und zwischen Groß-/Kleinschreibung wird nicht
unterschieden.
Wenn Sie beispielsweise die folgende Beispielvorlage für eine Datei verwenden:
~~Ordnerpfad~~~~Name~~
wird in der HTML-Darstellung der StarTeam-Pfad zur ausgewählten Datei
angegeben.
Diese Vorlage bildet die Obermenge dessen, was von der Berichtsfunktion auf
dem Client verwendet wurde.
Aktivieren Sie die Option „ID-basierte URLs generieren“. Wenn diese Option
ausgewählt ist, wird die URL nach ID und nicht nach Namen angegeben.
Hinweis
URL- und HTML-Darstellung erstellen und kopieren
So kopieren Sie die URL- oder HTML-Darstellung in die Zwischenablage:
1 Wählen Sie ein oder mehrere Elemente aus.
2 Wählen Sie in der Menüleiste oder im Kontextmenü des Elements „URL in die
Zwischenablage kopieren“. Dadurch wird für die ausgewählten Elemente eine
einfache Textversion der URL und eine HTML-Darstellung in die Zwischenablage
kopiert.
3 Fügen Sie die URL oder die HTML-Darstellung aus der Zwischenablage in eine
ausgewählte Anwendung ein.
Nicht alle Anwendungen unterstützen die HTML-Darstellung. Microsoft Word,
Excel und Outlook sind Beispiele hierfür. In StarTeam und im Editor kann die URL
nach dem Einfügen jedoch angezeigt werden.
URLs in StarTeam verwenden
So öffnen Sie ein Element mithilfe einer URL in StarTeam:
1 Wählen Sie im Projektmenü die Option zum Öffnen einer URL in StarTeam.
2 Geben Sie im Dialogfeld zum Öffnen einer URL in StarTeam eine gültige URL für ein
Projekt, eine Ansicht, einen Ordner oder ein Element ein oder kopieren Sie diese. Die
URL kann ID- oder namensbasiert sein.
12 StarTeam - Handbuch für neue Funktionen

StarTeam Cross-Platform Client
■
■
Wenn es sich bei der URL um eine Referenz auf ein Projekt handelt, wird die
Standardansicht des Projekts geöffnet. Wenn es sich bei der URL um eine
Referenz auf eine Ansicht oder einen Ordner handelt, wird die Ansicht bzw. der
Ordner geöffnet.
Wenn es sich bei der URL um eine Referenz auf ein Element handelt, wird die
Ansicht des Elements geöffnet, der übergeordnete Ordner des Elements wird in
der Baumstruktur ausgewählt, der Elementtyp wird ausgewählt und das Element
selbst ist in der Elementliste bzw. in der Baumstruktur im oberen Fenster
ausgewählt.
Im linken Teilfenster verfügbare neue Operationen
Im Kontextmenü des linken Teilfensters wurden verschiedene Befehle hinzugefügt.
Mithilfe dieser Befehle können Sie Operationen für Elemente ausführen, die mit einem
Element in derselben Ansicht verknüpft sind. Angenommen, Sie wählen im oberen Teilfenster
eine Änderungsanforderung aus und klicken dann auf das Register „Link“ im
unteren Teilfenster. Im Teilfenster „Link“ gibt es drei Links, zwei für Dateien und einen
für einen Task, alle drei befinden sich in derselben Ansicht wie das ausgewählte
Element. Über das Untermenü „Verknüpfte Datei“ können Sie Dateioperationen in den
Dateien ausführen, die durch die Links dargestellt werden. Über den Befehl „Verknüpftes
Element auswählen“ können Sie nach allen verknüpften Elementen suchen.
Die Option „Verknüpfte Datei“ ist ein neues Untermenü des Kontextmenüs und enthält
die Befehle „Einchecken“, „Auschecken“, „Label anhängen“, „Label lösen“ und „Inhalt
vergleichen“. Diese Befehle werden aktiviert, wenn Sie eine oder mehrere Dateien aus
der aktuellen Ansicht im Teilfenster „Link“ ausgewählt haben.
■
■
■
■
■
Einchecken
Wenn diese Option ausgewählt ist, wird das Standarddialogfeld „Einchecken“
angezeigt und die Arbeitsdateien können eingecheckt werden. Verknüpfen oder
Anheften ist bei diesem Eincheckvorgang nicht möglich.
Auschecken
Wenn diese Option ausgewählt ist, wird eine geänderte Version des Dialogfelds
„Auschecken“ angezeigt. Die mit dem ausgewählten Element verknüpften Dateien
werden ausgecheckt. Wenn der Link an eine spezifische Revision angeheftet wird,
wird diese Revision ausgecheckt. Wenn es sich um einen unverankerten Link
handelt, wird die aktuelle Revision ausgecheckt.
Label anhängen
Wenn diese Option ausgewählt ist, wird eine geänderte Version des Standarddialogfelds
für die Label-Auswahl angezeigt. Das ausgewählte Label wird der Revision der
verknüpften Datei zugeordnet, entweder zur angehefteten Revision oder zur
aktuellen Revision, wenn der Link unverankert ist.
Label lösen
Wenn diese Option ausgewählt ist, wird das Standarddialogfeld „Label lösen“ angezeigt.
Das ausgewählte Label wird der Revision der verknüpften Datei zugeordnet,
entweder zur angehefteten Revision oder zur aktuellen Revision, wenn der Link
unverankert ist.
Inhalt vergleichen
Wenn diese Option ausgewählt ist, vergleicht das Standarddienstprogramm
„Visual Diff“ die Arbeitsdatei mit der Revision der verknüpften Datei, d. h. entweder
mit der angehefteten Revision oder mit der aktuellen Revision, wenn der Link
unverankert ist.
Kapitel 2: Neue Funktionen in StarTeam 2005 Release 2 13

StarTeam Cross-Platform Client
Der Befehl „Verknüpftes Element auswählen“ ist aktiviert, wenn ein Element aus der
aktuellen Ansicht im Teilfenster „Link“ ausgewählt wurde. Bei einem ausgewählten
Element wählt StarTeam den übergeordneten Ordner des Elements in der Ordnerhierarchie,
und das richtige Register im oberen Teilfenster aus und aktiviert anschließend
das verknüpfte Element. Wenn das Element aufgrund der aktuellen Filter- und
Abfrageeinstellungen im oberen Teilfenster nicht ausgewählt werden kann, erhalten Sie
eine Warnmeldung, dass die Auswahl nicht abgeschlossen werden konnte.
Im oberen Teilfenster verfügbare neue Operationen
Hinweis
Im Kontextmenü des oberen Teilfensters wurde das Untermenü „Verknüpfte Dateien“
hinzugefügt. Mithilfe der Optionen im Untermenü können Sie Dateioperationen für
Dateien auswählen und ausführen, die mit dem im oberen Teilfenster ausgewählten
Element verknüpft sind.
Angenommen, Sie wählen eine Änderungsanforderung im oberen Teilfenster aus.
Unabhängig davon, ob das Register „Link“ ausgewählt ist, können Sie Operationen mit
den Dateien ausführen, die mit dieser Änderungsanforderung verknüpft sind. Diese
Befehle sind aktiviert, wenn das ausgewählte Element mit einer oder mehreren Dateien
in der aktuellen Ansicht verknüpft ist.
■
■
■
■
Alle einchecken
Wenn diese Option ausgewählt ist, wird das Standarddialogfeld „Einchecken“
angezeigt und Sie können die Arbeitsdateien für alle Dateien einchecken, die mit
dem ausgewählten Element verknüpft sind. Verknüpfen oder Anheften ist bei diesem
Eincheckvorgang nicht möglich.
Alle auschecken
Wenn diese Option ausgewählt ist, wird eine geänderte Version des Dialogfelds
„Auschecken“ angezeigt. Sie können die Dateirevisionen auschecken, die mit dem
ausgewählten Element verknüpft sind. Wenn der Link unverankert ist, handelt es sich
bei der ausgecheckten um die aktuelle Revision.
Alle auswählen
Wenn diese Option ausgewählt ist, wechselt der Fokus zum Dateiregister und alle
verknüpften Dateien sind ausgewählt. Wenn die verknüpfte Datei aufgrund der
aktuellen Filter- und Abfrageeinstellungen nicht ausgewählt werden kann, erhalten
Sie eine Warnmeldung, dass die Auswahl nicht abgeschlossen werden konnte.
Zur Auswahl hinzufügen:
Wenn diese Option ausgewählt ist, wechselt der Fokus zum Dateiregister und es
werden alle verknüpften Dateien zu den aktuell ausgewählten Dateien hinzugefügt.
Wenn die verknüpfte Datei aufgrund der aktuellen Filter- und Abfrageeinstellungen
nicht ausgewählt werden kann, erhalten Sie eine Warnmeldung, dass die Auswahl
nicht abgeschlossen werden konnte.
Wenn sich eine der verknüpften Dateien, die mit diesen neuen Optionen bearbeitet
werden soll, nicht in der aktuellen Ansicht befindet, wird vor dem Abschluss der Operation
eine Warnmeldung angezeigt. Diese Warnmeldung wird nur angezeigt, wenn Sie
unter „Persönliche Optionen“ die Einstellung zum Bestätigen von Warnhinweisen ausgewählt
haben. Diese befindet sich im Register „Arbeitsbereich“ des Dialogfelds
„Persönliche Optionen“.
Hinzugefügte Auscheckstatistiken
Das Dialogfeld zum Auschecken von Statistiken enthält nun die Gesamtanzahl der
Dateien, die nicht ausgecheckt und die Gesamtanzahl der Dateien, die während des
Auscheckens übersprungen wurden.
14 StarTeam - Handbuch für neue Funktionen

StarTeamMPX
Verfügbarkeit von Visual Diff und Visual Merge auf Windows-
Plattformen
Die StarTeam-Dienstprogramme „Visual Diff“ und „Visual Merge“ sind nun in der
Standardinstallation des Cross-Platform-Clients unter Windows verfügbar. Sie können
über den Client und den Ansichts-Manager aufgerufen werden.
StarTeamMPX
Die einzigen StarTeamMPX-Komponenten mit neuen Funktionen sind der Cache-Agent
und der Datei-Transmitter.
Der Datei-Transmitter ist für die Verwaltung der vom Root-Cache-Agenten verwendeten
Datei „CacheJournal.dat“ zuständig. Die Datei ist in dieser neuen Version kompakter,
da der Datei-Transmitter Dateien überspringt, deren Erstellungs-Zeitstempel älter als
der letzte Datensatz der Journal-Datei ist. Zudem verfügt sie über einen neuen
Parameter mit dem Namen „JournalTrimInterval“, über den Sie festlegen können, wie
oft (in Stunden) Datensätze aus der Journaldatei entfernt werden, die das maximale
Alter überschritten haben. Wenn Sie keinen Wert eingeben, werden 24 Stunden
vorgegeben. Veraltete Datensätze werden beim ersten Start des Servers und
anschließend anhand des festgelegten Zeitintervalls entfernt.
Der Cache-Agent wurde um einige neue Parameter ergänzt. Hierzu zählen beispielsweise
Parameter, die dem Remote-Cache-Agenten das Abrufen von Dateien aus
spezifischen Projekten in einer Serverkonfiguration ermöglichen. Außerdem können
mehr Instanzen des Cache-Agenten als Dienste auf einem bestimmten Computer
ausgeführt werden, als dies in der vorherigen Version der Fall war.
In den folgenden Abschnitten finden Sie weitere Details zu den Änderungen, die am
Cache-Agenten vorgenommen wurden.
Dateien aus spezifischen Projekten an Remote-Cache-Agenten
weiterleiten
In früheren Versionen hat der Remote-Cache-Agent den Inhalt aller Dateien von mehreren
StarTeam-Servern zwischengespeichert. In StarTeamMPX 2005 Release 2 kann
der Remote-Cache-Agent so konfiguriert werden, dass er den Inhalt für jeden von ihm
verfolgten StarTeam-Server projektspezifisch zwischenspeichert.
Diese projektspezifisch einsetzbare Funktion kann aktiviert werden, indem die Option
in der entsprechenden -Option der Cache-Agent-Konfigurationsdatei
hinzugefügt wird. Die Option enthält anschließend die entsprechenden
Optionen, von denen jede einen spezifischen Projektnamen oder ein Projektnamensmuster
angibt, der bzw. das verfolgt werden soll.
Beispiel:
bd1352a8-68a3-4ac1-9f28-0604b3d9267a
FelixTools
Bank*
Insurance*West*
Kapitel 2: Neue Funktionen in StarTeam 2005 Release 2 15

StarTeamMPX
In diesem Beispiel speichert der Remote-Cache-Agent den Dateiinhalt von dem Server
im Cache, dessen GUID „bd1352a8-68a3-4ac1-9f28-0604b3d9267a“ lautet. Das
Element bedeutet, dass der Inhalt auf bestimmte Projekte beschränkt ist.
Die -Werte des Beispiels bedeuten, dass ein Projektname ein eindeutiger
Name oder ein Projektnamensmuster mit Platzhalterzeichen sein kann:
■
■
„FelixTools“ ist ein spezifischer Projektname.
„Bank*“ sorgt dafür, dass alle Projekte verfolgt werden, die mit „Bank“ beginnen.
■
„Insurance*West*“ sorgt dafür, dass alle Projekte verfolgt werden, die mit „Insurance“
beginnen und nachfolgend das Wort „West“ im Namen haben.
Bei StarTeam-Projektnamen wird die Groß-/Kleinschreibung nicht berücksichtigt.
Weitere Hinweise zur Verwendung dieser projektspezifisch einsetzbaren Funktion
finden Sie im Folgenden:
■
■
■
■
■
Jede StarTeam-Serverkonfiguration mit mindestens einem Remote-Cache-Agenten,
der die projektspezifisch einsetzbare Funktion verwendet, muss auf 2005 Release 2
aktualisiert werden. Dies gilt für die StarTeam-Server-Version sowie für die Ereignis-
Transmitter und Datei-Transmitter-Komponenten von StarTeamMPX .
Die Verwendung der projektspezifisch einsetzbaren Funktion ist optional. Wenn die
-Option nicht hinzugefügt wird, speichert der Remote-Cache-Agent
weiterhin alle Dateirevisionen für den StarTeam-Server, der von der entsprechenden
-Gruppe angegeben wird. Die Remote-Cache-Agenten der
Version StarTeam 2005 verfolgen weiterhin den Inhalt aller Projekte, auch wenn die
von ihnen verfolgten StarTeam-Serverkonfigurationen auf 2005 Release 2
aktualisiert wurden.
Die projektspezifisch einsetzbare Funktion unterstützt Projektnamen mit
Sternchen (*). Da das Sternchen jedoch als Platzhalterzeichen interpretiert wird,
können Dateien aus zusätzlichen Projekten hinzugefügt werden. Wenn ein Projekt
beispielsweise den Namen „Info*Exec“ hat und ein Remote-Cache-Agent diesen
Projektnamen abonniert, erhält er den Inhalt aller Projekte, die mit „Info“ beginnen
und mit „Exec“ enden.
Für den Zweck der Speicherung ist es wichtig, dass jede Dateirevision zu dem
Projekt „gehört“, in das es eingecheckt wird. In der Praxis sieht das so aus, dass eine
Datei in mehreren Projekten gemeinsam genutzt werden kann und ein bestimmter
Eincheckvorgang dafür sorgt, dass die entsprechende Dateirevision in mehreren
Projekten angezeigt werden kann. Da der Dateiinhalt zusammen mit dem Projekt
verbreitet (Broadcast) wird, in das er eingecheckt wurde, kann die Datei nur von den
Remote-Cache-Agenten gespeichert werden, die das Projekt verfolgen. Angenommen,
eine Datei wird in den Projekten P1 und P2 gemeinsam genutzt und eine neue
Revision der Datei wird in Projekt P1 eingecheckt. Die neue Dateirevision wird von
den Remote-Cache-Agenten gespeichert, die Projekt P1 verfolgen. Ein Remote-
Cache-Agent, der nur Projekt P2 verfolgt, erhält diesen Broadcast nicht. Mit dem „pull
through“-Caching, das weiter unten beschrieben wird, kann ein Remote-Cache-
Agent, der nur Projekt P2 verfolgt, die Dateirevision jedoch beziehen.
Die „catch-up“-Funktion des Remote-Cache-Agenten wird weiterhin serverweit und
nicht projektspezifisch ausgeführt. Wenn beispielsweise ein Remote-Cache-Agent,
der eine projektspezifische Verfolgung ausführt, zum Zeitpunkt T1 gestoppt oder
vom Netzwerk getrennt wird, und dann zum Zeitpunkt T2 eine erneute Verbindung
aufbaut, fordert er die Dateien an, die seit dem Zeitpunkt T1 hinzugefügt werden. Er
erhält jedoch eine Liste mit allen Dateien, die seit T1 hinzugefügt wurden, nicht nur
mit den Dateien, die für die von ihm verfolgten Projekte hinzugefügt wurden. Daher
werden mit der „catch-up“-Funktion möglicherweise mehr Dateien hinzugefügt als
basierend auf den vom Remote-Cache-Agenten betreuten Projekten tatsächlich
notwendig wäre. Ähnliches gilt für die „pre-charge“-Funktion (ursprünglich catch-up)
des Cache-Agenten: die Verfolgung erfolgt auch serverweit und nicht
projektspezifisch.
16 StarTeam - Handbuch für neue Funktionen

StarTeamMPX
■
Wenn ein Remote-Cache-Agent für die Verfolgung von spezifischen Projekten
konfiguriert ist, akzeptiert er weiterhin die Anforderungen für Dateien. Wenn sich eine
angeforderte Datei nicht im lokalen Cache befindet, leitet der Remote-Cache-Agent
die Anforderung an den entsprechenden Root-Cache-Agenten weiter und speichert
sie für spätere Anforderungen lokal, unabhängig davon, zu welchen Projekten die
Datei gehört. Die projektspezifisch einsetzbare Funktion begrenzt also den Umfang
der für Remote-Cache-Agenten sichtbaren Dateien durch Push-Caching, aber nicht
den Umfang der Dateien, die vom Remote-Cache-Agenten über „pull through“-
Caching (request forwarding) gespeichert werden können.
Mehrere Dienste einrichten
Zuvor konnte immer nur ein Cache-Agent pro Computer als Windows-Dienst ausgeführt
werden. Nun können Sie mehrere Cache-Agenten als Dienste auf demselben Windows-
System registrieren. Jede Instanz eines Cache-Agent-Dienstes muss über einen
eindeutigen „Dienstnamen“ verfügen, der den Dienst im Bedienfeld „Windows-Dienst“
identifizierbar macht. Es können bis zu 25 Root- und Remote-Cache-Agenten auf
demselben System konfiguriert werden. Cache-Agenten-Dienste können über ein
Konsolenfenster des Programms „CacheAgentService.exe“ registriert bzw. deren
Registrierung entfernt werden.
Die Syntax für „CacheAgentService.exe“ lautet wie folgt:
CacheAgentService -start [ KonfigDatei ] [ -log Protokolldatei ] [ -verbose ]
CacheAgentService -register [ Manual | Auto] [ KonfigDatei]
[ -dependson Liste ] [ -log Protokolldatei ] [ -name Dienstname ]
[ -verbose ]
CacheAgentService -unregister
Parameter
KonfigDatei
-dependson Liste
-log Protokolldatei
-name Dienstname
Beschreibung
Der Name der Standard-Konfigurationsdatei lautet „RootCAConfig.xml“
oder „RemoteCAConfig.xml“, je nachdem welcher Cache-Agent-Typ
verwendet wird. Wenn Sie mehrere Konfigurationsdateien verwenden,
müssen „CachePath“ und „RequestPort“ jeweils eindeutige Werte
haben, damit sich die Cache-Agent-Dienste nicht gegenseitig
beeinträchtigen.
Gibt die Dienstabhängigkeiten für den neuen Cache-Agent-Dienst an.
Die Liste muss in Anführungszeichen gesetzt werden und durch
Leerzeichen getrennte interne Namen (keine Anzeigenamen) der
Dienste enthalten, von denen der Cache-Agent-Dienst abhängig ist.
(Der interne Name eines Dienstes ist sein Registrierungsschlüssel in
der Windows-Registrierung.)
Am häufigsten besteht eine Abhängigkeit zwischen dem Cache-
Agenten und dem Message-Broker-Dienst, der auf demselben
Computer ausgeführt wird. Der Anzeigename des Message-Broker-
Dienstes ist in der Regel „StarTeam Message Broker 6.4“, sein interner
Name lautet jedoch meistens „StarTeamMessageBroker6.4“.
Um eine Abhängigkeit zwischen dem Cache-Agent und dem Message-
Broker-Dienst auf demselben Computer anzugeben, würden Sie also
den folgenden Befehl verwenden:
-dependson "StarTeamMessageBroker6.4
Ein anderer Protokolldateiname als der Standardname
„CacheAgentService.log“.
Gibt den Anzeigenamen des Dienstes an, der in der Systemsteuerung
unter „Dienste“ erscheint. Der Standardname lautet „StarTeamMPX
Cache Agent“.
Dies ist nicht der interne Name. Dieser lautet standardmäßig
„CacheAgentService“ (oder wenn dieser bereits verwendet wird:
CacheAgentService1 bis CacheAgentService25).
Kapitel 2: Neue Funktionen in StarTeam 2005 Release 2 17

StarTeamMPX
Parameter
-register
-start
_unregister
-verbose
Beschreibung
Registriert den Dienst mit dem angegebenen Startmodus („Manuell“
oder „Automatisch“) und verwendet die angegebene Konfigurationsdatei
beim Programmstart (optional).
Startet den Dienst, optional auch mit einer spezifischen
Konfigurationsdatei.
Entfernt einen Dienst. Wenn Sie die Ausführung des Cache-Agenten
beispielsweise von „Manual“ in „Auto“ ändern, entfernen Sie ihn zuerst
aus der Registrierung und fügen ihn anschließend erneut hinzu. Ein
Dienst muss zuerst gestoppt werden, bevor er aus der Registrierung
entfernt werden kann.
Sorgt dafür, dass ein weiteres detaillierteres Protokoll generiert wird.
Der Name lautet standardmäßig „CacheAgentService-debug.log“.
Tabelle 2.1
Neue Parameter
Der Cache-Agent wurde um mehrere neue Parameter ergänzt.
Parameter, die von beliebigen Remote-Cache-Agenten verwendet werden
Parameter
Beschreibung
CacheCheckInterval Ganzzahl; Anzahl der Sekunden. Der Standardwert ist 60.
Gibt an, wie häufig der Cache-Agent seine Cache-Größe mit dem konfigurierten Cache-Limit
(MaxCacheSize) abgleicht. Wenn die Cache-Größe die konfigurierte Grenze überschreitet,
werden die am längsten nicht verwendeten Dateien aus dem Cache entfernt, bis die Cache-
Größe unter der Größenbeschränkung liegt. Nach der Konvertierung des Native-I-Datenspeichers
in das Native-II-Format fügen die Root-Cache-Agenten zu deren lokalem Cache
keine Dateien mehr hinzu.
Der Mindestwert ist Null (0), die Funktion wird hierdurch deaktiviert.
InitialRequestThreads Ganzzahl; Anzahl der Verbindungen. Der Standardwert ist 10. Der zulässige Bereich liegt
zwischen 1 und MaxConnections.
Die ursprüngliche Anzahl der Request-Handler-Threads, die beim Start des Cache-Agenten
aktiviert werden. Weitere Request-Handler-Threads können bei Bedarf bis zu dem unter
„MaxConnections“ angegebenen Wert gestartet werden, wenn alle aktuellen Threads aktiven
Verbindungen zugewiesen werden.
MaxCatchupSize Ganzzahl; Anzahl der Byte. Der Standardwert ist 100 MB. Der Wert muss zwischen 0 und
100000000 liegen.
Dieser Parameter beschränkt die Höchstanzahl der bei einer catch-up-Anforderung zurückgegebenen
Dateien. Bei einem Remote-Cache-Agenten beschränkt dieser Parameter die
Höchstanzahl der bei einer catch-up-Anforderung angeforderten Dateien. In beiden Fällen
gibt der Wert die Gesamtgröße der Dateien, die an der catch-up-Operation beteiligt sind, in
Byte an. Wenn dieser Wert 0 ist, ist für die catch-up-Anforderung keine Größenbeschränkung
vorhanden. Es wird immer der kleinere Wert des Rquesters und des Requestees verwendet,
um die Anforderung einzuschränken.
RequestReadTimeout Ganzzahl; Anzahl der Sekunden. Der Standardwert ist 30.
Gibt die Zeitspanne an, in der ein Cache-Agent auf das Lesen der nächsten Anforderung von
einem Client wartet, bevor er die entsprechende Verbindung schließt. Wenn die Verbindung
geschlossen wurde, wird der Request-Handler-Thread für andere Verbindungen
freigegeben.
Der Mindestwert ist Null (0), die Funktion wird hierdurch deaktiviert.
18 StarTeam - Handbuch für neue Funktionen

StarTeamMPX
Tabelle 2.2
Parameter
Parameter, die nur vom Remote-Cache-Agenten verwendet werden
Beschreibung
CatchupCheckInterval Ganzzahl; Anzahl der Sekunden. Der Standardwert ist 300.
Das Intervall, in dem ein Remote-Cache-Agent prüft, ob für eine seiner Cache-Quellen ein
catch-up-Vorgang ausgeführt werden muss, da die Message-Broker-Verbindung getrennt
wurde. Wenn ein catch-up-Vorgang erforderlich ist, bleiben die auszuführenden catch-up-
Zyklen bestehen, bis die normale Message-Broker-Konnektivität wiederhergestellt wird.
Die „catch-up“-Funktion des Remote-Cache-Agenten wird weiterhin serverweit und nicht
projektspezifisch ausgeführt. Wenn beispielsweise ein Remote-Cache-Agent, der eine
projektspezifische Verfolgung ausführt, zum Zeitpunkt T1 gestoppt oder vom Netzwerk
getrennt wird, und dann zum Zeitpunkt T2 eine erneute Verbindung aufbaut, fordert er die
Dateien an, die seit dem Zeitpunkt T1 hinzugefügt werden. Er erhält jedoch eine Liste mit
allen Dateien, die seit T1 hinzugefügt wurden, nicht nur mit den Dateien, die für die von
ihm verfolgten Projekte hinzugefügt wurden. Daher werden mit der „catch-up“-Funktion
möglicherweise mehr Dateien hinzugefügt als basierend auf den vom Remote-Cache-
Agenten betreuten Projekten tatsächlich notwendig wäre. Ähnliches gilt für die „precharge“-Funktion
(ursprünglich catch-up) des Cache-Agenten: die Verfolgung erfolgt auch
serverweit und nicht projektspezifisch.
Der Mindestwert ist Null (0), die Funktion wird hierdurch deaktiviert.
ContentSource
Die ContentSource-Gruppe ist nicht neu, sie hat jedoch zwei zusätzliche Parameter.
Projects
Wenn dieser Parameter angegeben wird, zeigt dieser Gruppenwert an, dass nicht alle
Inhalte des entsprechenden StarTeam-Servers zurückverfolgt werden müssen. Es wird
nur der Inhalt der Project-Parameter in der Gruppe „Projects“ zurückverfolgt und
gespeichert. Die Gruppe kann mehrere Project-Parameter enthalten.
Project
Jeder Project-Parameter definiert einen Projektnamen oder ein Namensmuster. Alle
Dateien, die in ein Projekt eingecheckt werden, dessen Name mit dem definierten Namen
oder Muster übereinstimmen, werden vom Cache-Agenten gespeichert. Ein Muster ist ein
Name mit einem oder mehreren Sternchen (*) als Platzhalterzeichen.
Für den Zweck der Speicherung ist es wichtig, dass jede Dateirevision zu dem Projekt
„gehört“, in das es eingecheckt wird. In der Praxis sieht das so aus, dass eine Datei in
mehreren Projekten gemeinsam genutzt werden kann und ein bestimmter Eincheckvorgang
dafür sorgt, dass die entsprechende Dateirevision in mehreren Projekten angezeigt
werden kann. Da der Dateiinhalt zusammen mit dem Projekt verbreitet (Broadcast) wird,
in das er eingecheckt wurde, kann die Datei nur von den Remote-Cache-Agenten
gespeichert werden, die das Projekt verfolgen. Angenommen, eine Datei wird in den
Projekten P1 und P2 gemeinsam genutzt und eine neue Revision der Datei wird in Projekt
P1 eingecheckt. Die neue Dateirevision wird von den Remote-Cache-Agenten gespeichert,
die Projekt P1 verfolgen. Ein Remote-Cache-Agent, der nur Projekt P2 verfolgt,
erhält diesen Broadcast nicht. Mit dem „pull through“-Caching, das weiter unten beschrieben
wird, kann ein Remote-Cache-Agent, der nur Projekt P2 verfolgt, die Dateirevision
jedoch beziehen.
Wenn ein Remote-Cache-Agent für die Verfolgung von spezifischen Projekten konfiguriert
ist, akzeptiert er weiterhin die Anforderungen für Dateien. Wenn sich eine angeforderte
Datei nicht im lokalen Cache befindet, leitet der Remote-Cache-Agent die Anforderung an
den entsprechenden Root-Cache-Agenten weiter und speichert sie für spätere Anforderungen
lokal, unabhängig davon, zu welchen Projekten die Datei gehört. Die projektspezifisch
einsetzbare Funktion begrenzt also den Umfang der für Remote-Cache-
Agenten sichtbaren Dateien durch Push-Caching, aber nicht den Umfang der Dateien, die
vom Remote-Cache-Agenten über „pull through“-Caching (request forwarding)
gespeichert werden können.
PrechargeSize
Ganzzahl; Der Standardwert ist MaxCatchupSize.
Gibt die maximale Größe der ersten catch-up-Operation eines Remote-Cache-Agenten
an, die dazu verwendet wird, den Cache-Speicher vorab zu laden. Standardmäßig wird
der Wert MaxCatchupSize des Cache-Agenten verwendet. Sie können aber auch einen
größeren oder kleineren Wert angeben. Wenn dieser Wert Null (0) ist, führt der Remote-
Cache-Agent die „precharge“-Operation nicht aus.
Kapitel 2: Neue Funktionen in StarTeam 2005 Release 2 19

StarTeam Extensions
StarTeam Extensions
StarTeam-Integrationen
Das Dienstprogramm für den Import von Anforderungen (impreq), das CaliberRM-
Anforderungen in StarTeam importiert, wurde durch den CaliberRM StarTeam
Requirements Publisher ersetzt. Wenn Sie das alte Dienstprogramm noch einige Zeit
weiter einsetzen müssen, können Sie die Kopie verwenden, die mit StarTeam
Extensions 2005 geliefert wird. Das alte Dienstprogramm wird bis auf weiteres auf der
Website von Borland Code Central (http://cc.borland.com/) verfügbar sein. Weitere
Informationen zum CaliberRM StarTeam Requirements Publisher finden Sie weiter
unten im Abschnitt zu den Integrationen.
Vollständig neue oder veränderte StarTeam-Integrationen sind die StarTeam Visual
Studio .NET-Integration, die StarTeam Eclipse-Integration und der CaliberRM
StarTeam Requirements Publisher.
In vorherigen StarTeam-Versionen wurde die Integration in Visual Studio mithilfe der
Microsoft SCC APIs durchgeführt. Die neue Visual Studio-.NET-Integration von
StarTeam verwendet das .NET-SDK von StarTeam und bietet weitaus mehr
Funktionen. Der Funktionsumfang ist mit der JBuilder-Integration und den Eclipse-
Integrationen von StarTeam vergleichbar.
Die StarTeam Eclipse-Integration unterstützt nun alternative Eigenschaftseditoren
(APEs), benutzerdefinierte Formulare, die mit den StarTeam Enterprise Advantage-
Funktionen verwendet werden können.
Der CaliberRM StarTeam Requirements Publisher ersetzt das Dienstprogramm für den
Import von Anforderungen (impreq), das zuvor in StarTeam Extensions integriert war.
Er verwendet das CaliberRM- und das StarTeam-SDK für den Zugriff auf CaliberRM-
Anforderungen und um diese in ein StarTeam-Projekt zu kopieren. Der Requirements
Publisher ist nicht Teil der StarTeam Extensions. Er kann als Integration unter
http://www.borland.com/downloads/download_starteam.html heruntergeladen werden.
Die folgenden Komponenten wurden nicht geändert (und verwenden daher noch die
Versionsnummer 2005), wurden aber mit StarTeam Server 2005 Release 2 getestet
und funktionieren problemlos:
■
■
■
■
■
Mercury TestDirector Synchronizer
Versionskontroll-Add-In für Mercury TestDirector
Versionskontroll-Add-In für Mercury Quality Center
Microsoft SCC-Integration
Microsoft Visual Studio .NET Web Projects
Borland LDAP QuickStart Manager
Mit dem Borland LDAP QuickStart Manager können Sie jetzt die folgenden
Standardoptionen einstellen:
■
■
■
Vorhandene Benutzereigenschaften überschreiben
Passwörter validieren und initialisieren
Lizenztypen festlegen
Um die Standardeinstellungen für die Importoptionen einzurichten, wählen Sie
„nfigure > Default Import Options“.
20 StarTeam - Handbuch für neue Funktionen

Der Import/Export-Manager in StarTeam
In vorherigen Versionen mussten diese Einstellungen mit dem Experten geändert
werden. Jetzt können Sie diese Optionen vor Drag-and-Drop-Importvorgängen
konfigurieren. Um die Optionen während des Imports einzustellen, aktivieren Sie das
Auswahlfeld „Show this dialog automatically before importing users“. Dieses Dialogfeld
erinnert Sie vor jedem Importvorgang daran, die Einstellungen zu überprüfen.
Borland LDAP QuickStart Manager unterstützt sowohl StarTeam-Lizenzen als auch
Borland-Lizenzen für Lizenzserver.
Der Import/Export-Manager in StarTeam
Aufgrund einiger am SDK vorgenommenen Ergänzungen kann der StarTeam Import/
Export Manager gemeinsam genutzte und verschobene Elemente jetzt viel schneller
erkennen.
Außerdem ist die Eingabe eines Benutzernamens und Kennworts in den Import- und
Export-Dateien (.cdl) nicht mehr erforderlich. Wenn Sie die Paramerter USERNAME
und PASSWORD aus diesen Dateien löschen, werden Sie an der Befehlszeile
aufgefordert, Ihren Benutzernamen und Ihr Kennwort einzugeben.
Unterstützung von StarTeam 2005
Die nachfolgend aufgeführten StarTeam-Anwendungen wurden aktualisiert und unter
StarTeam Server 2005 Release 2 getestet. Sie enthalten nicht viele neue Funktionen,
es wurden jedoch viele Probleme behoben und einige neue Symbole hinzugefügt.
■
■
■
■
■
■
■
■
StarTeam SDK (Weitere Informationen finden Sie in der SDK-Dokumentation.)
StarDisk
Web Edition
Workflow Designer
Notification Agent
Die meisten IDE-Integrationen
StarTeam Datamart
StarTeam Quality Center Synchronizer
Kapitel 2: Neue Funktionen in StarTeam 2005 Release 2 21

22 StarTeam - Handbuch für neue Funktionen

Index
A
Alle auschecken
Verknüpfte Dateien 14
Alle auswählen
Verknüpfte Dateien 14
Alle einchecken
Verknüpfte Dateien 14
Änderungsanforderungen
Diagramm 10
Anforderungen
Veröffentlichen 20
APEs
Verwendung in der StarTeam Eclipse-Integration 20
Audit-Einträge
Diagramm 10
Auschecken
Verknüpfte Dateien 13
Auscheck-Statistiken 14
B
Benutzer importieren 8
C
Cache Agent (Parameter)
CacheCheckInterval 18
CatchupCheckInterval 19
ContentSource 19
InitialRequestThreads 18
MaxCatchupSize 18
PrechargeSize 19
Project 19
Projects 19
RequestReadTimeout 18
CacheCheckInterval
Cache Agent (Parameter) 18
CaliberRM StarTeam Requirements Publisher 20
CatchupCheckInterval
Cache Agent (Parameter) 19
Client/Server-Kompatibilität 7
Clients
Neue Symbole 10
Serveradministration (Dienstprogramm) 10
ContentSource
Cache Agent (Parameter) 19
D
Dateien
Alle mit Element verknüpften Dateien
auschecken 14
Alle mit Element verknüpften Dateien auswählen 14
Alle mit Element verknüpften Dateien
einchecken 14
Alle verknüpften Dateien zur Auswahl
hinzufügen 14
Arbeitsdatei mit verknüpfter Datei vergleichen 13
Diagramm 10
Label an mit Elementen verknüpfte Dateien
anhängen 13
Label von mit Elementen verknüpfte Dateien
lösen 13
Mit Element verknüpfte Dateien auschecken 13
Mit Element verknüpfte Dateien einchecken 13
Dateioperationen 13, 14
DB2 8
Diagramm
Änderungsanforderungen 10
Audit-Einträge 10
Dateien 10
Erstellen 10
Tasks 10
Themen 10
Dienstprogramm zum Importieren von
Anforderungen 20
Ersetzt durch CaliberRM StarTeam Requirements
Publisher 20
E
Einchecken
Verknüpfte Dateien 13
Entwicklersupport 5
Erstellen
Diagramm 10
G
Gruppen importieren 8
I
ID-basierte URLs 11
impreq 20
Inhalt vergleichen
Verknüpfte Dateien 13
InitialRequestThreads
Cache Agent (Parameter) 18
K
Kontextmenü
Weitere Befehle im Link-Fenster 13
Weitere Befehle im oberen Teilfenster 14
Konventionen
Kursivschrift 6
Menüauswahl 6
Schriftart mit fester Breite 6
Konventionen in der Dokumentation 6
Kursivschrift (Konvention) 6
L
Label anhängen
Verknüpfte Dateien 13
Label lösen
Verknüpfte Dateien 13
M
MaxCatchupSize
Cache Agent (Parameter) 18
Menüauswahl (Konvention) 6
Microsoft Visual Studio .NET 20
Index 23

N
Namenbasierte URLs 11
Neue Clientfunktionen 10
Neue Funktionen
StarTeam-Cross-Platform-Client 10
StarTeamMPX-Server 15
StarTeam-Server 8
StarTeam-Windows-Client 10
Übersicht 7
Neue Funktionen für StarTeam Extensions 20
Neue Funktionen für StarTeam StarDisk 21
Neue Serverfunktionen 8
P
PrechargeSize
Cache Agent (Parameter) 19
Produktsupport 5
Project
Cache Agent (Parameter) 19
Projects
Cache Agent (Parameter) 19
R
RequestReadTimeout
Cache Agent (Parameter) 18
S
Schriftart mit fester Breite (Konvention) 6
Serveradministration (Dienstprogramm) 8, 10
Server-Tools 8
StarTeam Eclipse-Integration 20
StarTeam Visual Studio .NET-Integration 20
StarTeam-Cross-Platform-Client
Erstellen von URLs 12
Neue Funktionen 10
Öffnen von URLs 12
StarTeamMPX-Server
Neue Funktionen 15
StarTeam-Server
Neue Funktionen 8
StarTeam-Windows-Client
Neue Funktionen 10
Statistiken
Auschecken 14
Support 5
Symbole 10
Syntax-Konventionen
Variablen 6
T
Tasks
Diagramm 10
Technischer Support 5
Themen
Diagramm 10
U
Übersicht über neue Funktionen 7
URLs
Anzeige in Drittanbieter-Anwendungen 11
Erstellt in StarTeam 12
HTML-Darstellung 11
ID-basiert 11
In StarTeam öffnen 12
Kopieren in Drittanbieter-Anwendung 12
Namensbasiert 11
URL-Verwendung einrichten 11
V
Verknüpfte Dateien (Operation) 13, 14
Visual Diff 15
Visual Merge 15
Visual Studio .NET 20
Z
Zur Auswahl hinzufügen
Verknüpfte Dateien 14
24 StarTeam - Handbuch für neue Funktionen