Ironfang Render (preview)

Ironfang Render zet webpagina's en HTML om in schermafbeeldingen en PDF-documenten. Leg een pagina vast als PNG, JPEG of WebP, druk een URL of uw eigen HTML naar PDF af of plaats een rendertaak in de wachtrij en verzamel het bestand wanneer het klaar is. Er kan geen browser worden uitgevoerd of onderhouden.

Deze connector is beschikbaar in de volgende producten en regio's:

Service Class Regions
Copilot Studio Premium Alle Power Automate regio's behalve:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logische apps Standard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps regio's behalve:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate regio's behalve:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contact
Name Ironfang
URL https://ironfang.com/contact
E-mailadres hello@ironfang.com
Connectormetagegevens
Publisher Ironfang
Website https://ironfang.com/render
Privacybeleid https://ironfang.com/legal/privacy
Categories Inhoud en bestanden; Productiviteit

Ironfang Render

Ironfang Render zet webpagina's en HTML om in schermafbeeldingen en PDF-documenten. Met deze connector kan een stroom een pagina vastleggen als een afbeelding, een URL of een eigen HTML naar PDF afdrukken of een rendertaak in de wachtrij plaatsen en het bestand verzamelen wanneer het klaar is, zonder een browser uit te voeren.

Publisher: Ironfang

Prerequisites

U hebt een Ironfang-account en een API-sleutel nodig. Accounts zijn gratis te maken op https://portal.ironfang.com, en elk account bevat een maandelijkse gratis vergoeding voor renders. Gebruik buiten de vergoeding wordt gefactureerd aan uw Ironfang-account; huidige tarieven zijn tegen https://ironfang.com/pricing.

Ondersteunde bewerkingen

Een schermopname vastleggen

Geeft een webpagina of een blok HTML weer en retourneert de afbeelding als PNG, JPEG of WebP. Kies de venstergrootte, leg de hele schuifbare pagina of één element vast, emuleert een telefoon of tablet, gebruik het donkere kleurenschema en verberg cookiebanners of blokadvertenties.

Een PDF maken

Hiermee wordt een webpagina of een blok HTML afgedrukt naar een PDF-document van maximaal 100 pagina's en wordt het bestand geretourneerd. Kies het papierformaat, de afdrukstand, marges, achtergronden en kop- en voettekstsjablonen.

Een schermopnametaak starten

Hiermee wordt een schermopname in de wachtrij geplaatst als een duurzame taak en wordt de id in één keer geretourneerd. Gebruik deze functie wanneer een stroom niet moet wachten op de weergave of om het bestand beschikbaar te houden voor latere stappen.

Een PDF-taak starten

Hiermee wordt een PDF in een wachtrij geplaatst als een duurzame taak en wordt de id in één keer geretourneerd.

Een rendertaak ophalen

Retourneert een taak met de status: in de wachtrij geplaatst, uitgevoerd, geslaagd, mislukt of geannuleerd. Een geslaagde taak bevat de grootte en het type van het bestand en een ondertekende downloadkoppeling; een mislukte taak bevat de reden.

Een taakresultaat downloaden

Retourneert het bestand een geslaagde taak die is geproduceerd.

Referenties verkrijgen

De connector wordt geverifieerd met een Ironfang-API-sleutel.

  1. Meld u aan bij https://portal.ironfang.com, of maak daar een gratis account.
  2. Open API-sleutels en maak een sleutel. Een sleutel met alleen het bereik render:render is voldoende voor elke actie in deze connector.
  3. Kopieer de sleutel, die begint met if_live_. Het wordt één keer weergegeven.
  4. Wanneer u een verbinding maakt, plakt u de sleutel in het veld API-sleutel.

Getting Started

Een PDF van uw eigen HTML opslaan in SharePoint:

  1. Voeg de actie Een PDF maken toe en plaats uw HTML in het HTML-veld. Stel papierformaat in op a4.
  2. Voeg de actie SharePoint Bestand maken toe. Gebruik een bestandsnaam die eindigt op .pdfen gebruik de PDF-inhoudsuitvoer van Een PDF maken als bestandsinhoud.

Ga als volgende te werk om een pagina vast te leggen op basis van een schema:

  1. Begin met een terugkeerpatroontrigger.
  2. Voeg een schermopname toe met de pagina-URL en schakel volledige pagina in als u de hele pagina wilt.
  3. Voeg de actie OneDrive Bestand maken toe met een bestandsnaam die eindigt op .png en de uitvoer van de afbeeldingsinhoud als de bestandsinhoud.

Voor een lange batch gebruikt u Een schermopnametaak starten of Een PDF-taak starten, vervolgens een Do-taak die een vertraging van ten minste 5 seconden uitvoert en een rendertaak ophalen totdat de status is geslaagd, mislukt of geannuleerd en eindigt met het downloaden van een taakresultaat.

Volledige API-documentatie bevindt zich op https://ironfang.com/render/docs.

Bekende problemen en beperkingen

  • Verzend een pagina-URL of HTML in een aanvraag, niet beide.
  • Elke render is beperkt tot 30 seconden. Een pagina die langer duurt, mislukt met een weergavefout.
  • Een PDF kan maximaal 100 pagina's bevatten en een afbeelding van maximaal 4096 pixels in breedte of hoogte. Een volledige pagina-opname is maximaal 20000 pixels hoog.
  • Het bestand van een taak wordt 24 uur nadat de taak is voltooid bewaard en de ondertekende downloadkoppeling in Een renderingtaak ophalen werkt 15 minuten. Download een taakresultaat kan binnen 24 uur opnieuw worden aangeroepen.
  • Een account kan twee renders tegelijk uitvoeren. Een verzoek buiten dat wordt geweigerd met status 429 en moet na een korte wachttijd opnieuw worden geprobeerd; taken wachten in plaats daarvan in de wachtrij.
  • Een identieke aanvraag binnen 10 minuten kan de eerdere render retourneren. Schakel De cache overslaan in om een nieuwe af te dwingen.
  • Pagina's achter een aanmelding kunnen nog niet worden vastgelegd via deze connector.

Veelgestelde vragen

Is er iets toegevoegd aan mijn bestanden?

No. Bestanden die via de API worden weergegeven, bevatten geen Ironfang-badge of watermerk.

Waar krijg ik hulp?

Neem contact op met Ironfang op https://ironfang.com/contact of hello@ironfang.com. De servicestatus bevindt zich op https://status.ironfang.com.

Implementatie-instructies

Gebruik de Power Platform CLI om deze connector als een aangepaste connector te implementeren:

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

Maak vervolgens een verbinding met uw Ironfang API-sleutel.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

Default Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Name Type Description Required
API-sleutel beveiligde string Uw Ironfang API-sleutel, die begint met if_live_. True

Acties

Een PDF maken

Hiermee wordt een webpagina of een blok HTML afgedrukt naar een PDF-document van maximaal 100 pagina's en wordt het bestand geretourneerd. Een pagina-URL of HTML verzenden, niet beide.

Een PDF-taak starten

Wachtrijen van een PDF als een duurzame taak en worden in één keer geretourneerd. Controleer de taak met Een rendertaak ophalen en gebruik vervolgens Een taakresultaat downloaden. Het voltooide bestand wordt 24 uur bewaard.

Een rendertaak ophalen

Retourneert een rendertaak met de bijbehorende status. Een geslaagde taak bevat details van het resultaat en een mislukte taak voert de fout uit.

Een schermopname vastleggen

Geeft een webpagina of een blok HTML weer in een browser en retourneert de afbeelding. Een pagina-URL of HTML verzenden, niet beide.

Een schermopnametaak starten

Hiermee wordt een schermopname in een wachtrij geplaatst als een duurzame taak en wordt deze in één keer geretourneerd. Controleer de taak met Een rendertaak ophalen en gebruik vervolgens Een taakresultaat downloaden. Het voltooide bestand wordt 24 uur bewaard.

Een taakresultaat downloaden

Retourneert het bestand een geslaagde taak die is geproduceerd. Resultaten worden 24 uur bewaard nadat de taak is voltooid.

Een PDF maken

Hiermee wordt een webpagina of een blok HTML afgedrukt naar een PDF-document van maximaal 100 pagina's en wordt het bestand geretourneerd. Een pagina-URL of HTML verzenden, niet beide.

Parameters

Naam Sleutel Vereist Type Description
Pagina-URL
url string

Het adres van de pagina dat moet worden afgedrukt. Laat leeg wanneer u HTML verzendt.

HTML
html string

De HTML-opmaak die moet worden afgedrukt. Laat leeg wanneer u een pagina-URL verzendt.

Papierformaat
paper_format string

Het benoemde papierformaat. Als het leeg is, wordt Letter gebruikt.

Landschap
landscape boolean

Of u wilt afdrukken in de afdrukstand Liggend.

Achtergronden afdrukken
print_background boolean

Of u achtergrondkleuren en -afbeeldingen wilt opnemen, zoals een dialoogvenster voor het afdrukken van een browser.

Bovenmarge (inches)
top float

De bovenste marge in inches.

Rechtermarge (inches)
right float

De rechtermarge in inches.

Ondermarge (inches)
bottom float

De onderste marge in inches.

Linkermarge (inches)
left float

De linkermarge in inches.

HTML-header
header_html string

De HTML-sjabloon wordt boven aan elke pagina afgedrukt.

HTML voor voettekst
footer_html string

De HTML-sjabloon wordt onderaan elke pagina afgedrukt.

Scale
scale float

De afdrukschaal, waarbij 1 de werkelijke grootte is.

Wacht totdat
wait_until string

Wanneer de pagina als gereed wordt geteld. Netwerk inactief wacht tot het netwerkverkeer is gestopt.

Cookiebanners verbergen
block_cookie_banners boolean

Of u algemene cookietoestemmingsbanners wilt verbergen. Ze zijn verborgen, nooit geaccepteerd.

Advertenties blokkeren
block_ads boolean

Hiermee wordt aangegeven of aanvragen naar bekende reclame- en traceringsnetwerken moeten worden geblokkeerd.

Retouren

De inhoud van het PDF-bestand.

PDF-inhoud
binary

Een PDF-taak starten

Wachtrijen van een PDF als een duurzame taak en worden in één keer geretourneerd. Controleer de taak met Een rendertaak ophalen en gebruik vervolgens Een taakresultaat downloaden. Het voltooide bestand wordt 24 uur bewaard.

Parameters

Naam Sleutel Vereist Type Description
Idempotentiesleutel
Idempotency-Key string

Een unieke waarde voor deze aanvraag, zoals de uitvoerings-id van de stroom. Als dezelfde sleutel opnieuw wordt verzonden, wordt nooit een tweede render gemaakt.

Pagina-URL
url string

Het adres van de pagina dat moet worden afgedrukt. Laat leeg wanneer u HTML verzendt.

HTML
html string

De HTML-opmaak die moet worden afgedrukt. Laat leeg wanneer u een pagina-URL verzendt.

Papierformaat
paper_format string

Het benoemde papierformaat. Als het leeg is, wordt Letter gebruikt.

Landschap
landscape boolean

Of u wilt afdrukken in de afdrukstand Liggend.

Achtergronden afdrukken
print_background boolean

Of u achtergrondkleuren en -afbeeldingen wilt opnemen, zoals een dialoogvenster voor het afdrukken van een browser.

Bovenmarge (inches)
top float

De bovenste marge in inches.

Rechtermarge (inches)
right float

De rechtermarge in inches.

Ondermarge (inches)
bottom float

De onderste marge in inches.

Linkermarge (inches)
left float

De linkermarge in inches.

HTML-header
header_html string

De HTML-sjabloon wordt boven aan elke pagina afgedrukt.

HTML voor voettekst
footer_html string

De HTML-sjabloon wordt onderaan elke pagina afgedrukt.

Scale
scale float

De afdrukschaal, waarbij 1 de werkelijke grootte is.

Wacht totdat
wait_until string

Wanneer de pagina als gereed wordt geteld. Netwerk inactief wacht tot het netwerkverkeer is gestopt.

Cookiebanners verbergen
block_cookie_banners boolean

Of u algemene cookietoestemmingsbanners wilt verbergen. Ze zijn verborgen, nooit geaccepteerd.

Advertenties blokkeren
block_ads boolean

Hiermee wordt aangegeven of aanvragen naar bekende reclame- en traceringsnetwerken moeten worden geblokkeerd.

Uw verwijzing
external_id string

Uw eigen verwijzing voor de taak, maximaal 120 tekens.

Retouren

Body
Job

Een rendertaak ophalen

Retourneert een rendertaak met de bijbehorende status. Een geslaagde taak bevat details van het resultaat en een mislukte taak voert de fout uit.

Parameters

Naam Sleutel Vereist Type Description
Job-ID
id True string

De id van de rendertaak, zoals geretourneerd toen deze werd gestart.

Retouren

Body
Job

Een schermopname vastleggen

Geeft een webpagina of een blok HTML weer in een browser en retourneert de afbeelding. Een pagina-URL of HTML verzenden, niet beide.

Parameters

Naam Sleutel Vereist Type Description
Pagina-URL
url string

Het adres van de pagina die moet worden vastgelegd. Laat leeg wanneer u HTML verzendt.

HTML
html string

De HTML-markering die moet worden weergegeven. Laat leeg wanneer u een pagina-URL verzendt.

Afbeeldingsindeling
format string

De bestandsindeling van de afbeelding. PNG is verliesloos en WebP is meestal het kleinste bestand.

Volledige pagina
full_page boolean

Of u de hele schuifbare pagina wilt vastleggen in plaats van alleen het zichtbare gebied.

Breedte
width integer

De breedte van het browservenster in pixels, tot 4096.

Hoogte
height integer

De hoogte van het browservenster in pixels, tot 4096. Het wordt genegeerd voor een volledige pagina-opname.

Apparaat
device string

Leg de pagina vast als een telefoon of tablet, met een overeenkomende schermgrootte en gebruikersagent.

Donkere modus
dark_mode boolean

Of de pagina met het donkere kleurenschema moet worden weergegeven.

Quality
quality integer

De beeldkwaliteit van 1 tot 100 voor JPEG en WebP. Het wordt genegeerd voor PNG.

Elementkiezer
selector string

De CSS-selector van één element dat moet worden vastgelegd in plaats van het hele venster.

Vertraging (milliseconden)
delay_ms integer

Hoe lang moet worden gewacht nadat de pagina is geladen voordat de pagina wordt vastgelegd, tot 10000 milliseconden.

Wacht totdat
wait_until string

Wanneer de pagina als gereed wordt geteld. Netwerk inactief wacht tot het netwerkverkeer is gestopt.

Cookiebanners verbergen
block_cookie_banners boolean

Of u algemene cookietoestemmingsbanners wilt verbergen. Ze zijn verborgen, nooit geaccepteerd.

Advertenties blokkeren
block_ads boolean

Hiermee wordt aangegeven of aanvragen naar bekende reclame- en traceringsnetwerken moeten worden geblokkeerd.

De cache overslaan
no_cache boolean

Of u een nieuwe render wilt afdwingen in plaats van een identieke weergave opnieuw te gebruiken uit de afgelopen 10 minuten.

Retouren

De inhoud van het schermopnamebestand.

Afbeeldingsinhoud
binary

Een schermopnametaak starten

Hiermee wordt een schermopname in een wachtrij geplaatst als een duurzame taak en wordt deze in één keer geretourneerd. Controleer de taak met Een rendertaak ophalen en gebruik vervolgens Een taakresultaat downloaden. Het voltooide bestand wordt 24 uur bewaard.

Parameters

Naam Sleutel Vereist Type Description
Idempotentiesleutel
Idempotency-Key string

Een unieke waarde voor deze aanvraag, zoals de uitvoerings-id van de stroom. Als dezelfde sleutel opnieuw wordt verzonden, wordt nooit een tweede render gemaakt.

Pagina-URL
url string

Het adres van de pagina die moet worden vastgelegd. Laat leeg wanneer u HTML verzendt.

HTML
html string

De HTML-markering die moet worden weergegeven. Laat leeg wanneer u een pagina-URL verzendt.

Afbeeldingsindeling
format string

De bestandsindeling van de afbeelding. PNG is verliesloos en WebP is meestal het kleinste bestand.

Volledige pagina
full_page boolean

Of u de hele schuifbare pagina wilt vastleggen in plaats van alleen het zichtbare gebied.

Breedte
width integer

De breedte van het browservenster in pixels, tot 4096.

Hoogte
height integer

De hoogte van het browservenster in pixels, tot 4096. Het wordt genegeerd voor een volledige pagina-opname.

Apparaat
device string

Leg de pagina vast als een telefoon of tablet, met een overeenkomende schermgrootte en gebruikersagent.

Donkere modus
dark_mode boolean

Of de pagina met het donkere kleurenschema moet worden weergegeven.

Quality
quality integer

De beeldkwaliteit van 1 tot 100 voor JPEG en WebP. Het wordt genegeerd voor PNG.

Elementkiezer
selector string

De CSS-selector van één element dat moet worden vastgelegd in plaats van het hele venster.

Vertraging (milliseconden)
delay_ms integer

Hoe lang moet worden gewacht nadat de pagina is geladen voordat de pagina wordt vastgelegd, tot 10000 milliseconden.

Wacht totdat
wait_until string

Wanneer de pagina als gereed wordt geteld. Netwerk inactief wacht tot het netwerkverkeer is gestopt.

Cookiebanners verbergen
block_cookie_banners boolean

Of u algemene cookietoestemmingsbanners wilt verbergen. Ze zijn verborgen, nooit geaccepteerd.

Advertenties blokkeren
block_ads boolean

Hiermee wordt aangegeven of aanvragen naar bekende reclame- en traceringsnetwerken moeten worden geblokkeerd.

De cache overslaan
no_cache boolean

Of u een nieuwe render wilt afdwingen in plaats van een identieke weergave opnieuw te gebruiken uit de afgelopen 10 minuten.

Uw verwijzing
external_id string

Uw eigen verwijzing voor de taak, maximaal 120 tekens.

Retouren

Body
Job

Een taakresultaat downloaden

Retourneert het bestand een geslaagde taak die is geproduceerd. Resultaten worden 24 uur bewaard nadat de taak is voltooid.

Parameters

Naam Sleutel Vereist Type Description
Job-ID
id True string

De id van de rendertaak, zoals geretourneerd toen deze werd gestart.

Retouren

Het bestand dat de taak heeft geproduceerd.

Bestandsinhoud
binary

Definities

Job

Naam Pad Type Description
Job-ID
id string

De ID van de taak.

Kind
kind string

Het type render, zoals schermafbeelding of pdf.

Status
status string

De taakstatus. Een taak is voltooid wanneer deze is voltooid, mislukt of geannuleerd.

Uw verwijzing
external_id string

De verwijzing die is opgegeven toen de taak werd gestart.

Attempts
attempts integer

Hoe vaak de taak is uitgevoerd.

Gemaakt om
created_at date-time

Toen de taak werd geaccepteerd.

Gestart bij
started_at date-time

Wanneer de taak voor het laatst is uitgevoerd.

Voltooid op
completed_at date-time

Wanneer de taak is voltooid.

Foutcode
error.code string

Een stabiele code voor de fout.

Foutbericht
error.message string

Een leesbare beschrijving van de fout.

Inhoudstype
result.content_type string

Het mediatype van het resultaatbestand.

Grootte (bytes)
result.bytes integer

De grootte van het resultaatbestand in bytes.

SHA256-hash
result.sha256 string

De SHA-256-hash van het resultaatbestand.

Available
result.available boolean

Of het resultaatbestand nog steeds kan worden gedownload.

Resultaat verloopt op
result.expires_at date-time

Wanneer het gehoste resultaatbestand wordt verwijderd.

Downloadlink
result.url string

Een ondertekende koppeling naar het resultaatbestand waarvoor geen API-sleutel nodig is.

Downloadkoppeling verloopt op
result.url_expires_at date-time

Wanneer de ondertekende downloadkoppeling niet meer werkt.

binair

Dit is het basisgegevenstype 'binair'.