Adobe PDF Services
Mit den Adobe PDF Services von Adobe Workfront Fusion können Sie Daten aus einer PDF-Datei extrahieren oder aus von Ihnen bereitgestellten Daten eine neue PDF-Datei generieren. Darüber hinaus können Sie eine Vielzahl von Dateitypen in PDFs oder PDFs in andere Dateitypen konvertieren. Mit PDF Services können Sie außerdem Metadaten einer PDF-Datei kombinieren, komprimieren oder lesen sowie den Kennwortschutz für die Datei steuern.
Anweisungen zum Erstellen eines Szenarios finden Sie in den Artikeln unter Erstellen von Szenarios: Artikelindex.
Informationen zu Modulen finden Sie in den Artikeln unter Module: Artikelindex.
Informationen über die für PDF Services verwendete API finden Sie unter Adobe Document Generation-API.
Sicherheitshinweise bei der Verwendung der Adobe PDF Services
Die Adobe PDF Services können Ihre Dateien lesen, konvertieren oder ändern, aber weder Adobe noch Workfront Fusion speichern Ihre Dateien oder Daten. Das bedeutet:
- Sie behalten die Kontrolle über Ihre Dateien, einschließlich ihrer Sicherheit
- Sie benötigen kein Adobe-Speicher- oder Cloud-Speicherkonto, um PDF Services zu verwenden.
Zugriffsanforderungen
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront-Paket |
Ein beliebiges Adobe Workfront Workflow- und Adobe Workfront Automation and Integration-Paket Workfront Ultimate Workfront Prime- und Select-Pakete bei zusätzlichem Kauf von Workfront Fusion. |
| Adobe Workfront-Lizenzen |
Standard Work oder höher |
| Adobe Workfront Fusion-Lizenz |
Betriebsbasiert: keine Workfront Fusion-Lizenz erforderlich Connector-basiert (veraltet): Workfront Fusion for Work Automation and Integration |
| Produkt | Wenn Ihre Organisation über ein Workfront Select- oder Prime-Paket ohne Workfront Automation and Integration verfügt, muss Ihre Organisation Adobe Workfront Fusion erwerben. |
Weitere Details zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.
Informationen zu Adobe Workfront Fusion-Lizenzen finden Sie unter Adobe Workfront Fusion-Lizenzen.
Voraussetzungen
Um eine OAuth-Server-zu-Server-Verbindung zu erstellen, müssen Sie die Adobe PDF Services-API in Ihrer Adobe Developer Console hinzufügen. Wählen Sie beim Hinzufügen der API die OAuth-Server-zu-Server-Option aus.
Anweisungen finden Sie unter Hinzufügen einer API zu einem Projekt mithilfe von OAuth-Benutzerauthentifizierungs-Anmeldeinformationen in der Entwicklerdokumentation von Adobe.
Informationen zur Adobe PDF Services-API
Der Adobe PDF Services-Connector verwendet Folgendes:
Erstellen einer Verbindung zu den Adobe PDF Services
So erstellen Sie eine Verbindung für Ihre Adobe PDF Services-Module:
-
Klicken Sie in einem beliebigen Adobe PDF Services-Modul neben dem Feld „Verbindung“ auf Hinzufügen.
-
Füllen Sie die folgenden Felder aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header Verbindungstyp Wählen Sie aus, ob eine Server-zu-Server-Verbindung oder eine JWT-Verbindung erstellt werden soll. Verbindungsname Geben Sie einen Namen für die Verbindung ein. Client-ID Geben Sie Ihre Adobe-Client-ID ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen der Adobe Developer Console.
Anweisungen zum Auffinden von Anmeldeinformationen finden Sie unter Anmeldeinformationen in der Entwicklerdokumentation von Adobe.
Client-Geheimnis Geben Sie Ihr Adobe-Client-Geheimnis ein. Dieses finden Sie im Abschnitt mit den Anmeldeinformationen der Adobe Developer Console.
Anweisungen zum Auffinden von Anmeldeinformationen finden Sie unter Anmeldeinformationen in der Entwicklerdokumentation von Adobe.
ID des technischen Kontos (nur JWT) Geben Sie Ihre Adobe ID des technischen Kontos ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen-Details der Adobe Developer Console.
Anweisungen zum Auffinden von Anmeldeinformationen finden Sie unter Anmeldeinformationen in der Entwicklerdokumentation von Adobe.
Organisations-ID (nur JWT) Geben Sie Ihre Adobe Organisations-ID ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen der Adobe Developer Console.
Anweisungen zum Auffinden von Anmeldeinformationen finden Sie unter Anmeldeinformationen in der Entwicklerdokumentation von Adobe.
Metabereiche (nur JWT) Geben Sie alle für die Verbindung erforderlichen Metabereiche ein. Privater Schlüssel Wenn Sie eine JWT-Verbindung ausgewählt haben, geben Sie den privaten Schlüssel ein, der beim Erstellen Ihrer Anmeldeinformationen in der Adobe Developer Console generiert wurde.
So extrahieren Sie Ihren privaten Schlüssel oder Ihr Zertifikat:
-
Klicken Sie auf Extrahieren.
-
Wählen Sie den zu extrahierenden Dateityp aus.
-
Wählen Sie die Datei aus, die den privaten Schlüssel oder das Zertifikat enthält.
-
Geben Sie das Kennwort für die Datei ein.
-
Klicken Sie auf Speichern, um die Datei zu extrahieren und zur Verbindungseinrichtung zurückzukehren.
-
-
Klicken Sie auf Weiter, um die Verbindung zu speichern und zum Modul zurückzukehren.
Adobe PDF Services-Module und ihre Felder
Beim Konfigurieren der PDF Services werden in Workfront Fusion die unten aufgeführten Felder angezeigt. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der Anwendung oder im Service weitere Felder angezeigt werden. Ein fett formatierter Titel in einem Modul kennzeichnet ein Pflichtfeld.
Wenn die Schaltfläche „Zuordnung“ über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen zwischen Modulen.
- PDF-Dateien kombinieren
- PDF-Dateien komprimieren
- Dokument in PDF-Datei konvertieren
- HTML in PDF-Datei konvertieren
- Bild in PDF-Datei konvertieren
- PDF in Dokument konvertieren
- PDF in Bild konvertieren
- Text/Tabelle extrahieren
- Dokument generieren
- PDF-Datei linearisieren
- Benutzerdefinierten API-Aufruf erstellen
- OCR für PDF-Datei
- Seitenbearbeitung
- PDFs für Barrierefreiheit automatisch taggen
- PDF-Dateieigenschaften
- PDF-Datei schützen
- Schutz einer PDF-Datei aufheben
- PDF-Datei teilen
PDF-Dateien kombinieren
Dieses Aktionsmodul kombiniert mehrere PDF-Dateien in einer PDF-Datei. Beispielsweise könnten Sie mit diesem Modul alle Dokumente in einem Workfront-Projekt nach Abschluss des Projekts in einem einzigen PDF kombinieren.
Wählen Sie die Verbindung aus, die für dieses Modul verwendet werden soll.
Anweisungen zum Erstellen einer Verbindung zu den Adobe PDF Services finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe PDF Services.
Sie können ein Aggregatormodul verwenden, um Dokumente zu sammeln, die in einer PDF-Datei kombiniert werden sollen. Sie können die Dokumente aber auch manuell hinzufügen.
Es wird empfohlen, ein Array-Aggregator-Modul zu verwenden, um eine Ausgabe aus einem vorherigen Modul zu aggregieren. Bei Verwendung eines Aggregators müssen Sie Namen, Speicherorte oder Anzahl der zu kombinierenden Dateien nicht kennen. Ein Aggregator ist daher gegenüber der manuellen Eingabe der zu kombinierenden Dokumente deutlich flexibler und skalierbarer.
Um das Dateimodul „PDF kombinieren“ mit einem Aggregator verwenden zu können, müssen Sie die Zuordnung für das Feld „Dokumente“ aktivieren.
In diesem Beispiel identifiziert das Modul „Verwandte Einträge lesen“ die mit einem Projekt verknüpften Dokumente, die dann vom Modul „Dokumente herunterladen“ jeweils heruntergeladen werden. Alle PDFs werden in einem Array aggregiert, das an das Dateimodul „PDF kombinieren“ übergeben wird.
Sie können Dokumente auch manuell eingeben.
Gehen Sie für jedes Dokument, das in die kombinierte PDF-Datei eingeschlossen werden soll, wie folgt vor:
-
Klicken Sie auf „Dokument hinzufügen“.
-
Wählen Sie im Feld „Quelldatei“ das Modul aus, das das einzuschließende Dokument ausgibt, oder ordnen Sie den Namen und die Daten der Quelldatei zu.
-
(Optional) Wenn Sie nur bestimmte Seiten aus der Quelldatei einschließen möchten, klicken Sie für jeden hinzuzufügenden Seitenbereich im Feld „Seiten“ auf Element hinzufügen. Geben Sie anschließend die erste und letzte Seite des einzuschließenden Seitenbereichs ein und klicken Sie auf Hinzufügen. Sie können mehrere Seitenbereiche aus einem einzelnen Dokument einschließen.
-
Klicken Sie auf Hinzufügen.
PDF-Dateien komprimieren
Dieses Aktionsmodul komprimiert eine PDF-Datei. Dies kann nützlich sein, um Bandbreite oder Speicher einzusparen.
Dokument in PDF-Datei konvertieren
Dieses Tool konvertiert ein Dokument in eine PDF-Datei. Die Quelldatei muss eines der folgenden Dokumentformate aufweisen:
- DOC
- XLS
- PPT
- TXT
- RTF
HTML in PDF-Datei konvertieren
Dieses Tool konvertiert eine HTML-Datei in eine PDF-Datei.
Bild in PDF-Datei konvertieren
Dieses Tool konvertiert ein Bild in eine PDF-Datei.
PDF in Dokument konvertieren
Dieses Tool konvertiert eine PDF-Datei in ein Dokument. Sie können eines der folgenden Formate für die Ausgabedatei auswählen.
- DOC
- DOCX
- PPTX
- XLSX
- RTF
PDF in Bild konvertieren
Dieses Tool konvertiert eine PDF-Datei in ein Bild im PNG- oder JPEG-Format, das dann als Liste ausgegeben oder in einer ZIP-Datei kombiniert wird.
Wenn sie als ZIP-Datei ausgegeben wird, wird die PDF-Datei in ein Bild pro Seite konvertiert, und jedes Bild endet mit der Seitenzahl. Die Bilddateien werden dann in einer ZIP-Datei kombiniert.
Beispielsweise werden bei einer Datei namens „Testdatei“ mit acht Seiten acht Bilder erzeugt: „Testdatei_1“ bis „Testdatei_8“. Die Ausgabe des Moduls ist eine ZIP-Datei mit den acht Bildern.
Text/Tabelle extrahieren
Mit diesem Aktionsmodul können Sie Daten aus einer PDF-Datei extrahieren. Das Modul gibt einzelne Textelemente aus, z. B. einen Absatz oder den Text in einer einzelnen Zelle einer Tabelle.
Dokument generieren
Das Modul Dokument generieren liefert eine leistungsstarke Methode, um eine PDF-Datei mit den von Ihnen ausgewählten Daten zu erstellen. Sie können sie mit einer Microsoft Word-Vorlage formatieren oder Daten im JSON-Format bereitstellen.
Weitere Informationen zur Adobe PDF Services-Funktionalität „Dokument generieren“ finden Sie in der Adobe Document Services-Dokumentation unter Überblick über die Dokumenterstellung.
Verwenden des Moduls Dokument generieren mit einer Microsoft Word-Vorlage
Um das Modul Dokument generieren mit einer Microsoft Word-Vorlage zu verwenden, müssen Sie zunächst die Vorlage erstellen. Anweisungen hierzu finden Sie in der Microsoft Office-Dokumentation unter „Erstellen einer Vorlage“.
Füllen Sie die Modulfelder Dokument generieren wie folgt aus:
Wählen Sie die Verbindung aus, die für dieses Modul verwendet werden soll.
Anweisungen zum Erstellen einer Verbindung zu den Adobe PDF Services finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe PDF Services.
Wählen Sie eine Quelldatei aus einem vorherigen Modul aus oder ordnen Sie den Namen und die Daten der Quelldatei zu.
Diese Quelldatei ist die Microsoft Word-Vorlage, die das Modul zum Generieren der neuen PDF-Datei verwendet.
Es wird empfohlen, ein Projekt in Workfront für die Microsoft Word-Vorlagen zu erstellen, die Sie in Workfront Fusion verwenden. Anschließend können Sie das Modul unter „Workfront“ > „Dokument herunterladen“ verwenden, um die entsprechende Vorlage in Ihr Szenario einzufügen.
Wählen Sie das Format für das generierte Dokument aus:
-
PDF
-
DOCX
Geben Sie für jedes in Ihrer Vorlage durch Text zu ersetzende Wert-Tag Folgendes an:
-
Schlüssel
Geben Sie einen Schlüssel ein. In der Vorlage entspricht der Schlüssel dem Text, der im Wert-Tag angezeigt wird. Wenn Sie beispielsweise Text im Wert-Tag
{{name}}platzieren möchten, geben Sienamein das Feld „Schlüssel“ ein. -
Werttyp
Wählen Sie aus, ob es sich bei den Daten im Wertfeld um einen Wert, ein Objekt oder ein Array von Objekten handelt.
-
Wert
Geben Sie den Text ein, der im generierten Dokument anstelle des Wert-Tags angezeigt werden soll, oder ordnen Sie diesen zu.
Verwenden des Moduls Dokument generieren mit JSON
Um das Modul Dokument generieren mit JSON zu verwenden, füllen Sie die nachstehenden Felder wie folgt aus:
PDF-Datei linearisieren
Dieses Tool linearisiert ein PDF-Dokument, um ein Web-optimiertes PDF-Dokument zu erstellen. Ein linearisiertes PDF-Dokument kann seitenweise angezeigt werden, ohne dass dazu das gesamte Dokument heruntergeladen werden muss.
Benutzerdefinierten API-Aufruf erstellen
Dieses Aktionsmodul erstellt eine benutzerdefinierte HTTP-Anfrage an die PDF Services-API.
Wählen Sie die Verbindung aus, die für dieses Modul verwendet werden soll.
Anweisungen zum Erstellen einer Verbindung zu den Adobe PDF Services finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe PDF Services.
Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.
Beispiel: {"Content-type":"application/json"}
Workfront Fusion fügt die Autorisierungs-Header automatisch hinzu.
Fügen Sie die Abfrage für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Beispiel: {"name":"something-urgent"}
Klicken Sie für jedes dem API-Aufruf hinzufügende Feld auf Element hinzufügen und geben Sie den Schlüssel und den optionalen Wert des Felds ein.
Hinweis:
Wenn Sie bedingte Anweisungen wie if in Ihrem JSON-Objekt verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.
OCR für PDF-Datei
Mit diesem Tool wird die optische Zeichenerkennung (Optical Character Recognition, OCR) auf eine Datei angewendet und eine PDF-Datei erstellt.
Seitenbearbeitung
Mit diesem Modul können Sie Seiten in einem PDF-Dokument selektiv drehen oder löschen. Sie können beispielsweise eine Ansicht im Hochformat in eine Ansicht im Querformat ändern oder bestimmte Seiten aus dem PDF-Dokument entfernen.
PDFs für Barrierefreiheit automatisch taggen
Dieses Aktionsmodul erstellt eine PDF-Datei, die für Anwendungsfälle mit Barrierefreiheit getaggt ist. Außerdem wird ein optionaler Microsoft Excel-Bericht erstellt, in dem Probleme aufgelistet sind und Fehlerbehebungen vorschlagen werden.
PDF-Dateieigenschaften
Dieses Tool extrahiert grundlegende Informationen zum Dokument, z. B.:
- Seitenzahl
- PDF-Version
- ob die Datei verschlüsselt ist
- ob die Datei linearisiert ist
- ob die Datei eingebettete Dateien enthält
PDF-Datei schützen
Dieses Tool schützt ein PDF-Dokument mit einem Benutzer- oder Besitzerkennwort. Außerdem werden Einschränkungen für bestimmte Funktionen wie Drucken, Bearbeiten und Kopieren im PDF-Dokument festgelegt. Sie bestimmen den Typ des zu verschlüsselnden Inhalts und den Verschlüsselungsalgorithmus.
Schutz einer PDF-Datei aufheben
Dieses Tool hebt die Sicherheit (den Kennwortschutz) eines PDF-Dokuments auf.
PDF-Datei teilen
Dieses Aktionsmodul teilt ein PDF-Dokument in mehrere kleinere Dokumente auf. Geben Sie an, ob es nach der Anzahl der Dateien, der Seiten pro Datei oder Seitenbereichen geteilt werden soll.