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.
- Meld u aan bij https://portal.ironfang.com, of maak daar een gratis account.
- Open API-sleutels en maak een sleutel. Een sleutel met alleen het bereik render:render is voldoende voor elke actie in deze connector.
- Kopieer de sleutel, die begint met if_live_. Het wordt één keer weergegeven.
- 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:
- Voeg de actie Een PDF maken toe en plaats uw HTML in het HTML-veld. Stel papierformaat in op a4.
- 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:
- Begin met een terugkeerpatroontrigger.
- Voeg een schermopname toe met de pagina-URL en schakel volledige pagina in als u de hele pagina wilt.
- 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'.