Bevor Sie einen neuen Bericht zur Datei ReportDefinitions.xml hinzufügen, erstellen Sie in Crystal Reports Designer eine neue Berichtsvorlage.
So fügen Sie einen neuen Bericht zu ReportDefinitions.xml hinzu:
- Öffnen Sie die Datei ReportDefinitions.xml mit einem XML-Editor. Diese Datei befindet sich im Verzeichnis <IER-Installationspfad>\Config.
- Suchen Sie den Bereich für das Datenmodell, das Sie in Ihrem Aktenplan-Objektspeicher verwenden. Die XML-Datei enthält einen Bereich für DoD-Berichte, DoD-klassifizierte Berichte, PRO-Berichte und Basis-Berichte.
- Fügen Sie einen neuen Werttag <value> hinzu (z. B. <value>42</value>).
Dieser Wert ist eine ganze Zahl, die den Bericht angibt, den Sie in Crystal Reports Designer erstellt haben. Der Wert ist für jeden Bericht eindeutig. Dieser Wert entspricht der Anzahl vorhandener Berichte plus 1.
- Fügen Sie im Listenschlüssel <List key="ReportDefinitions"> einen Tag <object key="reportDefinition"> für Ihren neuen Bericht hinzu. Wenn es bereits einen Bericht gibt, der dem erstellten Bericht ähnlich ist, gehen Sie wie folgt vor:
- Kopieren Sie den gesamten Objektschlüssel <object key="reportDefinition"> des vorhandenen Berichts in der XML-Datei.
- Fügen Sie den kopierten Objektschlüssel an eine andere Stelle in die XML-Datei ein.
- Ändern Sie <object key="reportDefinition"> für Ihren neuen Bericht, indem Sie Werte für die folgenden Tags nach Bedarf ändern oder hinzufügen.
n ist die Nummer, die Sie in Schritt 3 oben eingegeben haben.
<setting key="id">n</setting>
<setting key="title" localizationKey="server.report_title.n">Berichtsname</setting>. Dabei ist Berichtsname der Titel des Berichts, den IBM® Enterprise Records anzeigt.
<setting key="desc" localizationKey="server.report_desc.n">Beschreibung</setting>. Dabei ist Beschreibung der Text, den IBM Enterprise Records anzeigt, um kurz den Zweck des Berichts zu beschreiben. Beispiel: "Dieser Bericht listet die Datenträger auf, die in einem bestimmten Zeitraum geöffnet/geschlossen wurden."
<setting key="reportName" localizationKey="server.report_name.n">Dateiname.rpt</setting>. Dabei ist Dateiname der Name der in Crystal Reports Designer erstellten Berichtsschablone.
<setting key="img">relativer_Pfad_zur_Bilddatei</setting>. Dies ist eine optionaler Wert für die Einfügung einer Grafik. Beispiel: images/action/report.gif.
- Wenn Ihr neuer Bericht von einem bestimmten Aktenplan-Objektspeicher ausgeschlossen werden soll, geben Sie die folgenden Tags ein:
<array key="excludedObjectStores"> <value>Aktenplan-Objektspeicher</value> </array>.
Dabei ist Aktenplan-Objektspeicher der Name des Aktenplan-Objektspeichers, aus dem der neue Bericht ausgeschlossen wird. Sie können weitere Werttags hinzufügen, um den Bericht aus mehreren Aktenplan-Objektspeichern auszuschließen.
- Fügen Sie Berichtskriterien wie Aktenplan-Objektspeicher-Positionen, Aktionen, Ereignisse, Zeitpläne und Daten hinzu.
- Fügen Sie unter <object key="reportDefinition"> gegebenenfalls <list key="properties"> hinzu. Wenn Sie <object key="reportDefinition"> aus einem vorhandenen Bericht kopiert haben, ist <list key="properties"> bereits vorhanden.
- Fügen Sie unter <list key="properties"> entsprechend den Berichtskriterien den Einstellungsschlüssel <setting key="symbolicname"> für den symbolischen Namen hinzu oder ändern Sie diesen. Wenn Sie neue Kriterien erstellen haben, fügen Sie auch die Einstellungsschlüssel für die symbolischen Namen für die neuen Kriterien hinzu.
Fügen Sie jedem Einstellungsschlüssel <setting key="symbolicname"> den Tag <setting key="required"> 0 oder 1</setting> hinzu, um anzugeben, ob ein Wert erforderlich ist. 1 gibt an, dass der Benutzer eine Auswahl treffen bzw. einen Wert eingeben muss, während bei Angabe von 0 dies nicht erforderlich ist.
Schließen Sie jedes Paar von <setting key="symbolicname"> und <setting key="required"> in das Tag <object key="property"> </object> ein.
Beispiel:
<object key="property">
<setting key="symbolicname">symbolischer_Name</setting>
<setting key="required">1</setting>
</object>
Dabei gilt Folgendes: symbolischer_Name ist die neu erstellte Bedingungen oder einer der folgenden Einstellungsschlüssel <setting key>:
- fileplan_browse - Weist IBM Enterprise Records an, dem Benutzer das Navigieren zu einer Position im Aktenplan-Objektspeicher zu erlauben.
- ros_browse - Weist IBM Enterprise Records an, dem Benutzer das Navigieren zu einer Position im Objektspeicher für Schriftstücke zu erlauben.
- start_date - Gibt das Startdatum der Berichtskriterien an.
- end_date - Gibt das Enddatum der Berichtskriterien an.
- application_type - Gibt den Typ von Schriftstück an, der als Bedingung zu verwenden ist, z. B. PDF, DOC, XLS u. a.
- security_category - Gibt die Berechtigungskennzeichnung, z. B. Klassifiziert, Geheim, Vertraulich u. a., in Abhängigkeit des Datenmodells an.
- review_decision - Gibt die Prüfungsentscheidung an, einschließlich Genehmigt oder Abgelehnt.
- action - Gibt die Aktion an einer Entität an, z. B. Öffnen oder Schließen.
- disposal_schedule - Gibt den einer Entität zugeordneten Aussonderungszeitplan an.
- disposal_action - Gibt die Aussonderungsaktion an einer Entität an, z. B. Übertragen, Prüfen, Zwischenübertragung oder Vernichten.
- disposal_action_export - Gibt die Aussonderungsaktion an einer Entität nach einem Export an.
- report_type - Weist IBM Enterprise Records an, die Optionsfelder Zusammenfassung oder Detailliert anzuzeigen.
- disposal_trigger - Gibt das Ereignis an, das die Aussonderung einer Entität auslöst, z. B. ein Datum, das Schließen eines Containers oder ein externes Ereignis.
Bei ros_browse, security_category, disposal_action, disposal_action_export, review_decision und disposal_trigger ruft IBM Enterprise Records die Standardwerte von Content Engine zur Laufzeit ab und zeigt diese in einem Menü an, aus dem Sie einen Wert auswählen können.
- Wenn Ihr Bericht Entitätstypen als Kriterien verwendet, gehen Sie wie folgt vor:
- Fügen Sie unter dem Objektschlüssel <object key="property"> den Einstellungsschlüssel <setting key="symbolicname">entity_type</setting> gefolgt vom Einstellungsschlüssel <setting key="required"> (1=erforderlich, 0=nicht erforderlich) hinzu. Beispiel:
<object key="property">
<setting key="symbolicname">Entitätstyp</setting>
<setting key="required">1</setting>
- Fügen Sie <list key="values"> hinzu, wobei Sie die Entitätstypen eingeben, die ein Benutzer zur Aufnahme in den Bericht auswählen kann. Beispiel:
<list key="values">
<object key="value">
<setting key="id">Entitätstyp</setting>
<setting key="value" localizationKey=serve.report_n.Entitätstyp">Entität</setting>
</object>
Dabei gilt Folgendes:
- Entitätstyp ist RecordCategory, RecordFolder oder Record.
Sie können alle drei Entitätstypen einschließen. Sie müssen sie dazu jedoch in getrennte Tags <object key="value"> aufnehmen.
- n ist die Nummer, die Sie in Schritt 3 oben eingegeben haben.
- Entität ist RecordCategory, RecordFolder oder Record.
Für lokalisierte Umgebungen ist localizationKey erforderlich.
Wenn Ihr Bericht z. B. Statistikdaten zu Schriftstückkategorien oder Schriftstückordnern umfasst, wird dieser Abschnitt der XML-Datei etwa folgendermaßen aussehen:
<object key="property">
<setting key="symbolicname">Entitätstyp</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">Schriftstückkategorie</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">Record Folder</setting>
</object>
</list>
</object>
- Wenn Ihr Bericht Klassifikationsaktionen verwendet, gehen Sie wie folgt vor:
Fügen Sie unter dem Listenschlüssel
<list key="properties"> den Tag
<setting key="symbolicname">Klassifikationsaktion</setting> gefolgt vom Tag
<setting key="required">0/1</setting> (1=erforderlich, 0=nicht erforderlich) hinzu.
Beispiel:
<object key="property">
<setting key="symbolicname">Klassifikationsaktion</setting>
<setting key="required">1</setting>
Fügen Sie
<list key="values"> hinzu, wobei Sie die Klassifikationsaktionen eingeben, die ein Benutzer zur Aufnahme in einen Bericht auswählen kann. Beispiel:
<list key="values">
<object key="value">
<setting key="id">Klassifikationsaktion</setting>
<setting key="value" localizationKey=serve.report_n.Klassifikationsaktion">Klassifikationsaktion</setting>
</object>
Dabei gilt Folgendes:
- Klassifikationsaktion ist Upgrading, Downgrading oder Declassification. Sie können alle drei Klassifikationsaktionen einschließen. Sie müssen sie dazu jedoch in getrennte Tags <object key="value"> aufnehmen.
- n ist der ID-Wert dieses Berichts im Bereich für das Datenmodell.
Für lokalisierte Umgebungen ist
localizationKey erforderlich.
Wenn Ihr Bericht z. B. Statistikdaten zu Downgrade- oder Deklassifikationsaktionen umfasst, wird dieser Abschnitt der XML-Datei etwa folgendermaßen aussehen:
<object key="property">
<setting key="symbolicname">Klassifikationsaktion</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">Deklassifikation</setting>
</object>
</list>
</object>
- Nachdem Sie alle Berichtskriterien eingegeben haben, gehen Sie wie folgt vor:
- Schließen Sie <list key="properties"> mit </list>.
- Schließen Sie <object key="reportDefinition"> mit </object>.
- Speichern Sie die XML-Datei.
- Starten Sie den Webanwendungsserver erneut, auf dem IBM Enterprise Records ausgeführt wird, damit die Änderungen wirksam werden.
Wenn Sie mit den Änderungen fertig sind, sollte der Abschnitt <object key="reportDefinition"> etwa folgendermaßen aussehen:
<object key="reportDefinition">
<setting key="id">22</setting>
<setting key="title" localizationKey="server.report_title.42">Records Manager - Klassifikationsaktualisierungsbericht</setting>
<setting key="desc" localizationKey="server.report_desc.42">Dieser Bericht listet Entitäten auf,
deren Klassifikation in einem definierten Zeitraum geändert wurde.</setting>
<setting key="url">RMViewReport.jsp</setting>
<setting key="img">images/action/report.gif</setting>
<setting key="reportName" localizationKey="server.report_name.42">Klassifikationsaktualisierung.rpt</setting>
<list key="properties">
<object key="property">
<setting key="symbolicName">fileplan_browse</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicName">start_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">end_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">report_type</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicname">Entitätstyp</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">Schriftstückkategorie</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">Schriftstückordner</setting>
</object>
<object key="property">
<setting key="symbolicname">Klassifikationsaktion</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">Deklassifikation</setting>
</object>
</list>
</object>
</list>
</object>
</list>
</object>