Angepasste Richtlinien entwickeln

Um die API für angepasste Richtlinienüberprüfung zum Schreiben von Richtlinien verwenden zu können, müssen Sie zunächst einen Richtliniengovernor erstellen. Um die angepassten Richtlinien hinzufügen zu können, muss der Richtliniengovernor einen Verweis auf jede angepasste Richtlinie umfassen. Sie konfigurieren zunächst eine Richtliniengovernorklasse und eine Richtlinienimplementierung und fügen den Richtliniengovernor dann dem Repository hinzu.

Vorbereitende Schritte

Vorgehensweise

  1. Konfigurieren Sie das Projekt:
    1. Erstellen Sie ein Java-Projekt für Ihre angepasste Richtlinie. Sie können den Beispielrichtliniengovernor und die in der Datei SampleGovernor.jar enthaltenen Richtlinien für den Einstieg verwenden, indem Sie sie in Ihr Projekt importieren und ändern, um angepasste Richtlinien zu erstellen.
    2. Importieren Sie den Beispielrichtliniengovernor in das Unterverzeichnis /src des Projekts, indem Sie mit der rechten Maustaste auf das Projekt klicken und Importieren auswählen.
    3. Wählen Sie Archivdatei aus und klicken Sie auf Weiter.
    4. Klicken Sie auf Durchsuchen und wählen Sie die Archivdatei SampleGovernor aus.
    5. Klicken Sie auf Fertig stellen. Der Inhalt wird Ihrem neuen Projekt hinzugefügt.
  2. Fügen Sie die Abhängigkeit zur Datei ramclient.jar im Buildpfad hinzu.
    1. Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie Erstellungspfad > Externe Archive hinzufügen aus.
    2. Navigieren Sie zu der Position, an der Sie die Datei ramclient.zip extrahiert haben, und wählen Sie die Datei ramclient.jar aus.
  3. Schreiben Sie die Richtlinien:
    1. Sie können eine Richtlinie erstellen und dabei ggf. eine der bereitgestellten Richtlinien (z. B. MyPolicy) erweitern. Sie können Methoden in einer bereitgestellten Richtliniendatei verwenden und die Methoden ändern. In der Methode test() können Sie z. B. einen Assetrichtlinientest für eine bestimmte Gruppe von Assettypdetails für Ihr Governancemodell freigeben oder ihn als fehlgeschlagen festlegen.

      Informationen zu den APIs, die zum Schreiben angepasster Richtlinien verwendet werden können, finden Sie unter APIs zur Verwendung in angepassten Richtlinien.

      Anmerkung: Sie können Richtlinien in einer Zuordnung speichern und eine Richtlinie anhand der ID abrufen. Beispiel: private Map policies;. Um eine Richtlinie aus der Zuordnung abzurufen, geben Sie die Richtlinien-ID in der Methode getPolicies().get(id) ein.
    2. In der Governorklasse müssen Sie einen Verweis auf jede neue Richtlinie hinzufügen. Ihre Governor-Klasse muss einen Verweis auf jede angepasste Richtlinie in dem Richtliniengovernor enthalten. Für MyPolicy werden z. B. die folgenden Zeilen zur Klasse MyGovernor (in MyGovernor.java) hinzugefügt:
      	//Meine XML-Richtlinie
      		Policy policy = new MyPolicy(this);
      		policies.put(policy.getID(), policy);

      Sie können die Java-APIs von Rational Asset Manager verwenden, um mit dem aktuellen Asset und anderen Assets innerhalb einer angepassten Richtlinie zu arbeiten. Beispiele zur Verwendung der Java-APIs finden Sie unter Rational Asset Manager-Java-APIs verwenden. Beispiele und zusätzliche Informationen zu den verwendbaren APIs finden Sie auf der Wiki-Seite für angepasste Richtlinien in jazz.net.

  4. Installieren Sie die Richtlinien. Angepasste Richtlinien werden gepackt, indem Sie das Projekt als .jar-Datei exportieren und es dann als neue Richtlinienerweiterung hinzufügen.
    1. Exportieren Sie das Projekt als .jar-Datei.

      Sie können mehrere .jar-Dateien (z. B. weitere erforderliche .jar-Dateien und die Richtlinien-.jar-Datei) mit der Erweiterung .zip einbinden, wenn Sie eine Richtlinie hochladen.

    2. Melden Sie sich beim Produkt als Repository-Administrator an.
    3. Klicken Sie auf der Seite 'Administration' auf Angepasste Erweiterungen.
    4. Fügen Sie eine neue Richtlinienerweiterung hinzu.
    5. Geben Sie den vollständig qualifizierten Klassennamen (Paket und Klasse) Ihres Richtliniengovernors ein.
    6. Blättern Sie zu der .jar-Datei, die Sie in Schritt 4a exportiert haben. Ihre Richtlinie ist für die Verwendung in einem Lebenszyklus oder Richtlinienprozess verfügbar.
    Weitere Anweisungen zum Hinzufügen Ihres Governors finden Sie unter Externe Richtlinien-Governor definieren.

Nächste Schritte

Testen Sie Ihre Richtlinie und führen Sie den Debugger für sie aus. Anweisungen hierzu finden Sie unter Richtlinien testen und Debugger für Richtlinien ausführen.

Feedback