Durchsuchbare Dokumentation aufrufen

Zurück zur Dokumentationsübersicht

agorum core pdf annotate konfigurieren

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plug-ins. Aktualisieren Sie das hier beschriebene Plug-in, um die Dokumentation verwenden zu können.

Sie können das Verhalten des Plug-ins über diverse Konfigurationen steuern. Sie können etwa einstellen, welche Dateiendungen / Dokumente kommentiert oder bearbeitet werden dürfen.

So finden Sie die Einstellungen zum Plug-in:

  1. Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.
  2. Öffnen Sie den Pfad:
    MAIN_MODULE_MANAGEMENT/customers/agorum.pdf.annotate/settings
    

Im Ordner settings befindet sich eine Konfiguration namens [ sample ]. In dieser finden Sie weitere Konfigurationen als Beispiel:

Diese Beispiele sind noch deaktiviert, erkennbar an dem # vor der jeweiligen Konfiguration.

Hinweis: Die Konfiguration #description dient als Information, wie Sie mit den hier beschriebenen Beispiele arbeiten sollen, und muss nicht kopiert werden.

Eine eigene Konfiguration anlegen


Damit die Beispiele unberührt bleiben, erstellen Sie eine eigene Konfiguration:

  1. Klicken Sie im Ordner settings oben auf  .
  2. Vergeben Sie einen Namen, etwa [ Projektname ].
  3. Speichern Sie die Einstellung.

Beispiele kopieren

Kopieren Sie die Beispiele aus der Konfiguration [ sample ]:

  1. Kopieren Sie die Beispiele #details.selectors und #convert.query und fügen Sie diese in den Ordner [ sample ] ein.
  2. Schneiden Sie die Dateien aus.
  3. Öffnen Sie Ihre soeben erstellte Property-Group.
  4. Fügen Sie die Konfigurationen ein.
  5. Benennen Sie die Konfigurationen um oder entfernen Sie die #.

Nachfolgend erfahren Sie, was die einzelnen Konfigurationen bewirken und wie Sie diese anpassen.

details.selectors

Dient dazu, bestimmt Dateiendungen vom Kommentieren / von der Bearbeitung auszuschließen.


Eingetragene Werte im Standard

Wert Beschreibung
[convertible(pdf)] Definiert, dass die angegebenen Dokumente kommentiert / bearbeitet werden können.

Wenn keine nameExtension angegeben ist, können alle Dokumente bearbeitet werden, die in agorum core in eine PDF-Datei wandelbar sind.
[!isFolder] Definiert, dass keine Ordner kommentiert / bearbeitet werden können.

Sollen Benutzer etwa nur rtf-Dokumente oder PDF-Dateien kommentieren / bearbeiten können, setzen Sie zusätzlich folgenden Wert:

[nameExtension=/rtf|pdf/i]

Kompletter Wert:

[nameExtension=/rtf|pdf/i][convertible(pdf)][!isFolder]

Wenn Sie durch diese Konfiguration bestimmte Dateiendungen zur Bearbeitung ausschließen, werden die Schaltflächen zum Kommentieren / Bearbeiten und zum Anzeigen des Originals ausgeblendet:

Fehlende Schaltflächen bei ausgeschlossenen Dateiendungen (hier: docx)

Fügen Sie hingegen die Dateiendung (hier: docx) in die Konfiguration ein, werden die Schaltflächen wieder eingeblendet:

[nameExtension=/docx|pdf|rtf/i][convertible(pdf)][!isFolder]
Eingeblendete Schaltflächen bei erlaubten Dateiendungen (hier: docx)
 

Für weitere Informationen zu den Selektoren siehe Selektoren.

convert.query

Dient als Suchmuster zur Anzeige der PDF-Ansicht.

Lädt ein Benutzer ein Dokument in einen Ordner und wird dann das Dokument angeklickt, dauert es je nach Dateigröße eine Weile, bis die PDF-Ansicht dargestellt wird. Diesen Vorgang können Sie beschleunigen, sodass das System die Dokumente bereits vorher intern konvertiert und die PDF-Ansicht schneller erzeugt.


Eingetragene Werte im Standard

Wert Beschreibung
inpath:${ID:/agorum/roi/Files} Berücksichtigt alle Dokumente unter diesem Pfad für die Konvertierung, die im Wert nameextension genannt sind.
nameextension:(docx OR doc OR xls OR xlsx OR pdf) Definiert, welche Dokumente für die Konvertierung berücksichtigt werden.
createdate_date_range:[2021-03-09 TO *] Definiert, welches Erstelldatum die Dokumente haben müssen, um für die Konvertierung berücksichtigt zu werden.

Tipp: Kopieren Sie den kompletten Wert und fügen Sie ihn in die Suche ein, um zu erkennen, welche Dokumente von dem Suchmuster / von der Konvertierung berücksichtigt werden.

 

Das System zeigt hier nur Dokumente an, für die die Generierung bisher nicht durchgeführt wurde.

Konvertierte Dokumente mithilfe der Hintergrundaktivitäten prüfen


Sie können mit der Funktion Zeige Hintergrundaktivitäten (siehe Hintergrundaktivitäten manuell öffnen) überprüfen, welche Dokumente bereits für die PDF-Ansicht konvertiert wurden.

Hintergrundaktivitäten prüfen

Die hochgeladenen Dokumente werden dabei in einer Queue nacheinander abgearbeitet.

Konvertierte Dokumente für die PDF-Ansicht

Generierte Metadaten nach Konvertierung


Nach dem Abschluss der Konvertierung setzt das System Metadaten auf das jeweilige Dokument. Sie können nach diesen Metadaten suchen, um sich alle Dokumente anzeigen zu lassen, die dieses Metadatum gesetzt haben.

Metadatum Beschreibung Anzeige in Oberfläche
agorum_pdf_annotate_create_date Definiert, dass das Dokument erfolgreich für die PDF-Ansicht konvertiert wurde. PDF Ansicht Erstelldatum
agorum_pdf_annotate_conversion_failed Definiert, dass das Dokument für die PDF-Ansicht nicht konvertiert werden konnte und auf Fehler gelaufen ist. Konvertierung fehlgeschlagen


Auf Fehler gelaufene Dokumente finden

Mit folgender Suche können Sie alle Dokumente finden, die auf einen Fehler gelaufen sind. Kopieren Sie die folgende Zeile und fügen Sie sie in die Suche ein:

agorum_pdf_annotate_conversion_failed:true

Sie finden die gesetzten Metadaten auch in der Registerkarte Objekt-Info des jeweiligen Dokuments mit einer anderen Benennung (siehe obige Tabelle, Spalte Anzeige in Oberfläche):

Gesetztes Metadatum PDF Ansicht Erstelldatum nach Konvertierung