Ironfang Render (Vorschau)

Ironfang Render wandelt Webseiten und HTML in Screenshots und PDF-Dokumente um. Erfassen Sie eine Seite als PNG, JPEG oder WebP, drucken Sie eine URL oder Ihren eigenen HTML-Code in PDF, oder stellen Sie einen Renderauftrag in die Warteschlange und erfassen Sie die Datei, wenn sie bereit ist. Es kann kein Browser ausgeführt oder verwaltet werden.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Service Class Regions
Copilot Studio Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Standard Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure Government Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Ironfang
URL https://ironfang.com/contact
E‑Mail hello@ironfang.com
Connectormetadaten
Herausgeber Ironfang
Website https://ironfang.com/render
Datenschutzrichtlinie https://ironfang.com/legal/privacy
Categories Inhalt und Dateien; Produktivität

Ironfang Render

Ironfang Render wandelt Webseiten und HTML in Screenshots und PDF-Dokumente um. Mit diesem Connector kann ein Fluss eine Seite als Bild erfassen, eine URL oder einen eigenen HTML-Code in PDF drucken oder einen Renderauftrag in die Warteschlange stellen und die Datei erfassen, wenn sie bereit ist, ohne einen Browser auszuführen.

Publisher: Ironfang

Prerequisites

Sie benötigen ein Ironfang-Konto und einen API-Schlüssel. Konten können kostenlos erstellt https://portal.ironfang.comwerden, und jedes Konto enthält ein monatliches kostenloses Kontingent an Rendern. Die Nutzung über das Kontingent hinaus wird Ihrem Ironfang-Konto in Rechnung gestellt; Die aktuellen Kurse liegen bei https://ironfang.com/pricing.

Unterstützte Vorgänge

Aufnehmen eines Screenshots

Rendert eine Webseite oder einen HTML-Block und gibt das Bild als PNG, JPEG oder WebP zurück. Wählen Sie die Fenstergröße aus, erfassen Sie die gesamte bildlauffähige Seite oder ein einzelnes Element, emulieren Sie ein Smartphone oder Tablet, verwenden Sie das dunkle Farbschema, und blenden Sie Cookiebanner oder Blockanzeigen aus.

Erstellen einer PDF-Datei

Druckt eine Webseite oder einen HTML-Block in ein PDF-Dokument von bis zu 100 Seiten und gibt die Datei zurück. Wählen Sie das Papierformat, die Ausrichtung, Ränder, Hintergründe und Kopf- und Fußzeilenvorlagen aus.

Starten eines Screenshotauftrags

Stellt einen Screenshot als dauerhaften Auftrag in die Warteschlange und gibt seine ID gleichzeitig zurück. Verwenden Sie ihn, wenn ein Fluss nicht auf das Rendern warten soll, oder um die Datei für spätere Schritte verfügbar zu halten.

Starten eines PDF-Auftrags

Stellt eine PDF-Datei als dauerhaften Auftrag in die Warteschlange und gibt ihre ID gleichzeitig zurück.

Abrufen eines Renderauftrags

Gibt einen Auftrag mit seinem Status zurück: in die Warteschlange eingereiht, ausgeführt, erfolgreich, fehlgeschlagen oder abgebrochen. Ein erfolgreicher Auftrag enthält die Größe und den Typ der Datei und einen signierten Downloadlink. Ein fehlgeschlagener Auftrag enthält den Grund.

Herunterladen eines Auftragsergebnisses

Gibt die Datei zurück, die einen erfolgreichen Auftrag erstellt hat.

Abrufen von Anmeldeinformationen

Der Connector authentifiziert sich mit einem Ironfang-API-Schlüssel.

  1. Melden Sie sich bei https://portal.ironfang.com, oder erstellen Sie dort ein kostenloses Konto.
  2. Öffnen Sie API-Schlüssel, und erstellen Sie einen Schlüssel. Ein Schlüssel mit nur dem render:render-Bereich reicht für jede Aktion in diesem Connector aus.
  3. Kopieren Sie den Schlüssel, der mit if_live_ beginnt. Es wird einmal angezeigt.
  4. Wenn Sie eine Verbindung erstellen, fügen Sie den Schlüssel in das API-Schlüsselfeld ein.

Getting Started

So speichern Sie eine PDF-Datei ihres eigenen HTML-Codes in SharePoint:

  1. Fügen Sie die AKTION "PDF erstellen" hinzu, und fügen Sie Ihren HTML-Code in das HTML-Feld ein. Legen Sie das Papierformat auf a4 fest.
  2. Fügen Sie die SharePoint Dateiaktion erstellen hinzu. Verwenden Sie einen Dateinamen, der auf .pdfendet, und verwenden Sie die PDF-Inhaltsausgabe von "PDF erstellen" als Dateiinhalt.

So erfassen Sie eine Seite in einem Zeitplan:

  1. Beginnen Sie mit einem Serientrigger.
  2. Fügen Sie einen Screenshot mit der Seiten-URL hinzu, und aktivieren Sie die ganze Seite, wenn Sie die gesamte Seite verwenden möchten.
  3. Fügen Sie die OneDrive Dateiaktion erstellen mit einem Dateinamen hinzu, der auf .png endet, und die Bildinhaltsausgabe als Dateiinhalt.

Verwenden Sie für einen langen Batch einen Screenshotauftrag starten oder einen PDF-Auftrag starten, dann eine Aufgabe, bis eine Schleife ausgeführt wird, die eine Verzögerung von mindestens 5 Sekunden ausführt, und rufen Sie einen Renderauftrag ab, bis der Status erfolgreich ist, fehlgeschlagen oder abgebrochen wurde, und beenden Sie das Ergebnis "Auftrag herunterladen".

Vollständige API-Dokumentation finden Sie unter https://ironfang.com/render/docs.

Bekannte Probleme und Einschränkungen

  • Senden Sie entweder eine Seiten-URL oder HTML in einer Anforderung, nicht beide.
  • Jedes Rendern ist auf 30 Sekunden begrenzt. Eine Seite, die länger dauert, um bereit zu werden, schlägt mit einem Renderfehler fehl.
  • Eine PDF-Datei kann höchstens 100 Seiten und ein Bild mit höchstens 4096 Pixeln Breite oder Höhe aufweisen. Eine Ganzseitenaufnahme beträgt höchstens 20000 Pixel.
  • Die Datei eines Auftrags wird 24 Stunden lang aufbewahrt, nachdem der Auftrag erfolgreich war, und der signierte Downloadlink in "Renderauftrag abrufen" funktioniert 15 Minuten lang. Ein Auftragsergebnis kann innerhalb der 24 Stunden erneut aufgerufen werden.
  • Ein Konto kann zwei Renderungen gleichzeitig ausführen. Ein Antrag darüber hinaus wird mit Status 429 abgelehnt und sollte nach einer kurzen Wartezeit wiederholt werden; Aufträge warten stattdessen in der Warteschlange.
  • Eine identische Anforderung innerhalb von 10 Minuten kann das frühere Rendern zurückgeben. Aktivieren Sie den Cache überspringen, um eine neue zu erzwingen.
  • Seiten hinter einer Anmeldung können noch nicht über diesen Connector erfasst werden.

Häufig gestellte Fragen

Werden meine Dateien etwas hinzugefügt?

No. Dateien, die über die API gerendert werden, tragen kein Ironfang-Signal oder Wasserzeichen.

Wo erhalte ich Hilfe?

Kontaktieren Sie Ironfang bei https://ironfang.com/contact oder hello@ironfang.com. Der Dienststatus befindet sich bei https://status.ironfang.com.

Bereitstellungsanweisungen

Verwenden Sie die Power Platform CLI, um diesen Connector als benutzerdefinierten Connector bereitzustellen:

pac connector create --api-definition-file apiDefinition.swagger.json --api-properties-file apiProperties.json --icon-file icon.png

Erstellen Sie dann eine Verbindung mit Ihrem Ironfang-API-Schlüssel.

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:

Standard Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Beschreibung Required
API-Schlüssel securestring Ihr Ironfang-API-Schlüssel, der mit if_live_ beginnt. True

Aktionen

Abrufen eines Renderauftrags

Gibt einen Renderauftrag mit seinem Status zurück. Ein erfolgreicher Auftrag enthält Details des Ergebnisses, und ein fehlgeschlagener Auftrag trägt den Fehler.

Aufnehmen eines Screenshots

Rendert eine Webseite oder einen HTML-Block in einem Browser und gibt das Bild zurück. Senden Sie eine Seiten-URL oder HTML, nicht beide.

Erstellen einer PDF-Datei

Druckt eine Webseite oder einen HTML-Block in ein PDF-Dokument mit höchstens 100 Seiten und gibt die Datei zurück. Senden Sie eine Seiten-URL oder HTML, nicht beide.

Herunterladen eines Auftragsergebnisses

Gibt die Datei zurück, die einen erfolgreichen Auftrag erstellt hat. Die Ergebnisse werden 24 Stunden lang aufbewahrt, nachdem der Auftrag erfolgreich war.

Starten eines PDF-Auftrags

Stellt eine PDF-Datei als dauerhaften Auftrag in die Warteschlange und gibt sie gleichzeitig zurück. Überprüfen Sie den Auftrag mit "Abrufen eines Renderauftrags", und verwenden Sie dann das Ergebnis "Auftrag herunterladen". Die fertige Datei wird 24 Stunden lang aufbewahrt.

Starten eines Screenshotauftrags

Stellt einen Screenshot als dauerhaften Auftrag in die Warteschlange und gibt auf einmal zurück. Überprüfen Sie den Auftrag mit "Abrufen eines Renderauftrags", und verwenden Sie dann das Ergebnis "Auftrag herunterladen". Die fertige Datei wird 24 Stunden lang aufbewahrt.

Abrufen eines Renderauftrags

Gibt einen Renderauftrag mit seinem Status zurück. Ein erfolgreicher Auftrag enthält Details des Ergebnisses, und ein fehlgeschlagener Auftrag trägt den Fehler.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Auftrags-ID
id True string

Die ID des Renderauftrags, wie beim Starten zurückgegeben.

Gibt zurück

Body
Job

Aufnehmen eines Screenshots

Rendert eine Webseite oder einen HTML-Block in einem Browser und gibt das Bild zurück. Senden Sie eine Seiten-URL oder HTML, nicht beide.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Seiten-URL
url string

Die Adresse der zu erfassenden Seite. Lassen Sie leer, wenn Sie HTML senden.

HTML
html string

Das html-Markup, das gerendert werden soll. Lassen Sie leer, wenn Sie eine Seiten-URL senden.

Bildformat
format string

Das Bilddateiformat. PNG ist verlustfrei, und WebP ist in der Regel die kleinste Datei.

Ganzseitige Seite
full_page boolean

Gibt an, ob die gesamte bildlauffähige Seite anstelle des sichtbaren Bereichs erfasst werden soll.

Breite
width integer

Die Breite des Browserfensters in Pixeln bis zu 4096.

Höhe
height integer

Die Höhe des Browserfensters in Pixeln bis zu 4096. Sie wird für eine Ganzseitenerfassung ignoriert.

Gerät
device string

Erfassen Sie die Seite als Smartphone oder Tablet mit einer übereinstimmenden Bildschirmgröße und einem Benutzer-Agent.

Dunkler Modus
dark_mode boolean

Gibt an, ob die Seite mit ihrem dunklen Farbschema gerendert werden soll.

Quality
quality integer

Die Bildqualität von 1 bis 100 für JPEG und WebP. Es wird für PNG ignoriert.

Elementauswahl
selector string

Die CSS-Auswahl eines Elements, das anstelle des gesamten Fensters erfasst werden soll.

Verzögerung (Millisekunden)
delay_ms integer

Wie lange gewartet werden muss, nachdem die Seite geladen wurde, bevor sie erfasst wird, bis zu 10000 Millisekunden.

Warten, bis
wait_until string

Wenn die Seite als bereit zählt. Im Leerlauf wird gewartet, bis der Netzwerkdatenverkehr beendet wird.

Cookiebanner ausblenden
block_cookie_banners boolean

Gibt an, ob allgemeine Cookie-Zustimmungsbanner ausgeblendet werden sollen. Sie sind ausgeblendet, niemals akzeptiert.

Blockieren von Anzeigen
block_ads boolean

Gibt an, ob Anforderungen an bekannte Werbe- und Tracking-Netzwerke blockiert werden sollen.

Überspringen des Caches
no_cache boolean

Gibt an, ob ein neuer Render erzwungen werden soll, anstatt ein identisches Rendern aus den letzten 10 Minuten wiederzuverwenden.

Gibt zurück

Der Inhalt der Screenshotdatei.

Bildinhalt
binary

Erstellen einer PDF-Datei

Druckt eine Webseite oder einen HTML-Block in ein PDF-Dokument mit höchstens 100 Seiten und gibt die Datei zurück. Senden Sie eine Seiten-URL oder HTML, nicht beide.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Seiten-URL
url string

Die Adresse der zu druckende Seite. Lassen Sie leer, wenn Sie HTML senden.

HTML
html string

Das html-Markup, das gedruckt werden soll. Lassen Sie leer, wenn Sie eine Seiten-URL senden.

Papiergröße
paper_format string

Das benannte Papierformat. Wenn es leer ist, wird Letter verwendet.

Landschaft
landscape boolean

Gibt an, ob im Querformat gedruckt werden soll.

Drucken von Hintergründen
print_background boolean

Ob Hintergrundfarben und Bilder als Browserdruckdialogfeld einbezogen werden sollen.

Oberer Rand (Zoll)
top float

Der obere Rand in Zoll.

Rechter Rand (Zoll)
right float

Der rechte Rand in Zoll.

Unterer Rand (Zoll)
bottom float

Der untere Rand in Zoll.

Linker Rand (Zoll)
left float

Der linke Rand in Zoll.

Header-HTML
header_html string

Die HTML-Vorlage wird oben auf jeder Seite gedruckt.

Fußzeilen-HTML
footer_html string

Die HTML-Vorlage wird unten auf jeder Seite gedruckt.

Skalieren
scale float

Der Druckmaßstab, wobei 1 die tatsächliche Größe hat.

Warten, bis
wait_until string

Wenn die Seite als bereit zählt. Im Leerlauf wird gewartet, bis der Netzwerkdatenverkehr beendet wird.

Cookiebanner ausblenden
block_cookie_banners boolean

Gibt an, ob allgemeine Cookie-Zustimmungsbanner ausgeblendet werden sollen. Sie sind ausgeblendet, niemals akzeptiert.

Blockieren von Anzeigen
block_ads boolean

Gibt an, ob Anforderungen an bekannte Werbe- und Tracking-Netzwerke blockiert werden sollen.

Gibt zurück

Der INHALT der PDF-Datei.

PDF-Inhalt
binary

Herunterladen eines Auftragsergebnisses

Gibt die Datei zurück, die einen erfolgreichen Auftrag erstellt hat. Die Ergebnisse werden 24 Stunden lang aufbewahrt, nachdem der Auftrag erfolgreich war.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Auftrags-ID
id True string

Die ID des Renderauftrags, wie beim Starten zurückgegeben.

Gibt zurück

Die Datei, die der Auftrag erstellt hat.

Dateiinhalt
binary

Starten eines PDF-Auftrags

Stellt eine PDF-Datei als dauerhaften Auftrag in die Warteschlange und gibt sie gleichzeitig zurück. Überprüfen Sie den Auftrag mit "Abrufen eines Renderauftrags", und verwenden Sie dann das Ergebnis "Auftrag herunterladen". Die fertige Datei wird 24 Stunden lang aufbewahrt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Idempotency-Taste
Idempotency-Key string

Ein eindeutiger Wert für diese Anforderung, z. B. die Ablauflauf-ID. Wenn Sie denselben Schlüssel erneut senden, wird nie ein zweites Rendern erstellt.

Seiten-URL
url string

Die Adresse der zu druckende Seite. Lassen Sie leer, wenn Sie HTML senden.

HTML
html string

Das html-Markup, das gedruckt werden soll. Lassen Sie leer, wenn Sie eine Seiten-URL senden.

Papiergröße
paper_format string

Das benannte Papierformat. Wenn es leer ist, wird Letter verwendet.

Landschaft
landscape boolean

Gibt an, ob im Querformat gedruckt werden soll.

Drucken von Hintergründen
print_background boolean

Ob Hintergrundfarben und Bilder als Browserdruckdialogfeld einbezogen werden sollen.

Oberer Rand (Zoll)
top float

Der obere Rand in Zoll.

Rechter Rand (Zoll)
right float

Der rechte Rand in Zoll.

Unterer Rand (Zoll)
bottom float

Der untere Rand in Zoll.

Linker Rand (Zoll)
left float

Der linke Rand in Zoll.

Header-HTML
header_html string

Die HTML-Vorlage wird oben auf jeder Seite gedruckt.

Fußzeilen-HTML
footer_html string

Die HTML-Vorlage wird unten auf jeder Seite gedruckt.

Skalieren
scale float

Der Druckmaßstab, wobei 1 die tatsächliche Größe hat.

Warten, bis
wait_until string

Wenn die Seite als bereit zählt. Im Leerlauf wird gewartet, bis der Netzwerkdatenverkehr beendet wird.

Cookiebanner ausblenden
block_cookie_banners boolean

Gibt an, ob allgemeine Cookie-Zustimmungsbanner ausgeblendet werden sollen. Sie sind ausgeblendet, niemals akzeptiert.

Blockieren von Anzeigen
block_ads boolean

Gibt an, ob Anforderungen an bekannte Werbe- und Tracking-Netzwerke blockiert werden sollen.

Ihre Referenz
external_id string

Ihr eigener Verweis für den Auftrag, bis zu 120 Zeichen.

Gibt zurück

Body
Job

Starten eines Screenshotauftrags

Stellt einen Screenshot als dauerhaften Auftrag in die Warteschlange und gibt auf einmal zurück. Überprüfen Sie den Auftrag mit "Abrufen eines Renderauftrags", und verwenden Sie dann das Ergebnis "Auftrag herunterladen". Die fertige Datei wird 24 Stunden lang aufbewahrt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Idempotency-Taste
Idempotency-Key string

Ein eindeutiger Wert für diese Anforderung, z. B. die Ablauflauf-ID. Wenn Sie denselben Schlüssel erneut senden, wird nie ein zweites Rendern erstellt.

Seiten-URL
url string

Die Adresse der zu erfassenden Seite. Lassen Sie leer, wenn Sie HTML senden.

HTML
html string

Das html-Markup, das gerendert werden soll. Lassen Sie leer, wenn Sie eine Seiten-URL senden.

Bildformat
format string

Das Bilddateiformat. PNG ist verlustfrei, und WebP ist in der Regel die kleinste Datei.

Ganzseitige Seite
full_page boolean

Gibt an, ob die gesamte bildlauffähige Seite anstelle des sichtbaren Bereichs erfasst werden soll.

Breite
width integer

Die Breite des Browserfensters in Pixeln bis zu 4096.

Höhe
height integer

Die Höhe des Browserfensters in Pixeln bis zu 4096. Sie wird für eine Ganzseitenerfassung ignoriert.

Gerät
device string

Erfassen Sie die Seite als Smartphone oder Tablet mit einer übereinstimmenden Bildschirmgröße und einem Benutzer-Agent.

Dunkler Modus
dark_mode boolean

Gibt an, ob die Seite mit ihrem dunklen Farbschema gerendert werden soll.

Quality
quality integer

Die Bildqualität von 1 bis 100 für JPEG und WebP. Es wird für PNG ignoriert.

Elementauswahl
selector string

Die CSS-Auswahl eines Elements, das anstelle des gesamten Fensters erfasst werden soll.

Verzögerung (Millisekunden)
delay_ms integer

Wie lange gewartet werden muss, nachdem die Seite geladen wurde, bevor sie erfasst wird, bis zu 10000 Millisekunden.

Warten, bis
wait_until string

Wenn die Seite als bereit zählt. Im Leerlauf wird gewartet, bis der Netzwerkdatenverkehr beendet wird.

Cookiebanner ausblenden
block_cookie_banners boolean

Gibt an, ob allgemeine Cookie-Zustimmungsbanner ausgeblendet werden sollen. Sie sind ausgeblendet, niemals akzeptiert.

Blockieren von Anzeigen
block_ads boolean

Gibt an, ob Anforderungen an bekannte Werbe- und Tracking-Netzwerke blockiert werden sollen.

Überspringen des Caches
no_cache boolean

Gibt an, ob ein neuer Render erzwungen werden soll, anstatt ein identisches Rendern aus den letzten 10 Minuten wiederzuverwenden.

Ihre Referenz
external_id string

Ihr eigener Verweis für den Auftrag, bis zu 120 Zeichen.

Gibt zurück

Body
Job

Definitionen

Job

Name Pfad Typ Beschreibung
Auftrags-ID
id string

Die ID des Jobs.

Kind
kind string

Die Art des Renderns, z. B. Screenshot oder PDF.

Status
status string

Der Auftragsstatus. Ein Auftrag ist abgeschlossen, wenn er erfolgreich war, fehlgeschlagen oder abgebrochen wurde.

Ihre Referenz
external_id string

Die Referenz, die angegeben wurde, als der Auftrag gestartet wurde.

Versuche
attempts integer

Wie oft der Auftrag ausgeführt wurde.

Erstellt am
created_at date-time

Als der Auftrag angenommen wurde.

Gestartet am
started_at date-time

Wenn der Auftrag zuletzt ausgeführt wurde.

Abgeschlossen bei
completed_at date-time

Nach Abschluss des Auftrags.

Fehlercode
error.code string

Ein stabiler Code für den Fehler.

Fehlermeldung
error.message string

Eine lesbare Beschreibung des Fehlers.

Inhaltstyp
result.content_type string

Der Medientyp der Ergebnisdatei.

Größe (Bytes)
result.bytes integer

Die Größe der Ergebnisdatei in Byte.

SHA-256-Hash
result.sha256 string

Der SHA-256-Hash der Ergebnisdatei.

Available
result.available boolean

Gibt an, ob die Ergebnisdatei weiterhin heruntergeladen werden kann.

Das Ergebnis läuft ab bei
result.expires_at date-time

Wenn die gehostete Ergebnisdatei gelöscht wird.

Herunterladen-Link
result.url string

Ein signierter Link zur Ergebnisdatei, die keinen API-Schlüssel benötigt.

Downloadlink läuft ab unter
result.url_expires_at date-time

Wenn der signierte Downloadlink nicht mehr funktioniert.

binary

Dies ist der grundlegende Datentyp "binary".