Ironfang Render (förhandsversion)
Ironfang Render omvandlar webbsidor och HTML till skärmbilder och PDF-dokument. Avbilda en sida som PNG, JPEG eller WebP, skriv ut en URL eller din egen HTML till PDF eller köa ett återgivningsjobb och samla in filen när den är klar. Ingen webbläsare att köra eller underhålla.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Service | Class | Regioner |
|---|---|---|
| Copilot Studio | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Standard | Alla Logic Apps-regioner utom följande: - Azure Government regioner - Azure kinaregioner - US Department of Defense (DoD) |
| Power Apps | Premium | Alla Power Apps regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Ironfang |
| URL | https://ironfang.com/contact |
| E-postmeddelande | hello@ironfang.com |
| Metadata för anslutningsprogram | |
|---|---|
| Publisher | Ironfang |
| Website | https://ironfang.com/render |
| Sekretesspolicy | https://ironfang.com/legal/privacy |
| Categories | Innehåll och filer; Produktivitet |
Ironfang Render
Ironfang Render omvandlar webbsidor och HTML till skärmbilder och PDF-dokument. Med den här anslutningsappen kan ett flöde avbilda en sida som en bild, skriva ut en URL eller sin egen HTML till PDF eller köa ett renderingsjobb och samla in filen när den är klar, utan att köra en webbläsare.
Publisher: Ironfang
Prerequisites
Du behöver ett Ironfang-konto och en API-nyckel. Konton är kostnadsfria att skapa på https://portal.ironfang.com, och varje konto innehåller en månatlig kostnadsfri ersättning för renderingar. Användning utöver ersättningen debiteras till ditt Ironfang-konto. aktuella priser är på https://ironfang.com/pricing.
Åtgärder som stöds
Ta en skärmbild
Renderar en webbsida eller ett html-block och returnerar bilden som PNG, JPEG eller WebP. Välj fönsterstorlek, samla in hela den rullningsbara sidan eller ett enda element, emulera en telefon eller surfplatta, använd det mörka färgschemat och dölj cookiebanderoller eller blockera annonser.
Skapa en PDF-fil
Skriver ut en webbsida eller ett HTML-block till ett PDF-dokument på upp till 100 sidor och returnerar filen. Välj pappersstorlek, orientering, marginaler, bakgrunder och mallar för sidhuvud och sidfot.
Starta ett skärmbildsjobb
Köar en skärmbild som ett varaktigt jobb och returnerar dess ID på en gång. Använd det när ett flöde inte ska vänta på återgivningen eller för att hålla filen tillgänglig för senare steg.
Starta ett PDF-jobb
Köar en PDF som ett varaktigt jobb och returnerar sitt ID på en gång.
Hämta ett återgivningsjobb
Returnerar ett jobb med dess status: i kö, körs, lyckades, misslyckades eller avbröts. Ett slutfört jobb innehåller storleken och typen av fil och en signerad nedladdningslänk. ett misslyckat jobb innehåller orsaken.
Ladda ned ett jobbresultat
Returnerar filen som ett slutfört jobb har skapats.
Hämta autentiseringsuppgifter
Anslutningsappen autentiseras med en Ironfang API-nyckel.
- Logga in på https://portal.ironfang.comeller skapa ett kostnadsfritt konto där.
- Öppna API-nycklar och skapa en nyckel. En nyckel med endast render:render-omfånget räcker för varje åtgärd i den här anslutningsappen.
- Kopiera nyckeln, som börjar med if_live_. Den visas en gång.
- När du skapar en anslutning klistrar du in nyckeln i FÄLTET API-nyckel.
Getting Started
Så här sparar du en PDF av din egen HTML-kod för att SharePoint:
- Lägg till åtgärden Skapa en PDF och placera HTML i HTML-fältet. Ange Pappersstorlek till a4.
- Lägg till åtgärden SharePoint Skapa fil. Använd ett filnamn som slutar i .pdfoch använd PDF-innehållsutdata för Skapa en PDF som filinnehåll.
Så här registrerar du en sida enligt ett schema:
- Börja med en upprepningsutlösare.
- Lägg till Avbilda en skärmbild med sid-URL:en och aktivera Hel sida om du vill ha hela sidan.
- Lägg till åtgärden OneDrive Skapa fil med ett filnamn som slutar .png och bildinnehållet som utdata som filinnehåll.
För en lång batch använder du Starta ett skärmbildsjobb eller Starta ett PDF-jobb, sedan en Do until-loop som kör en fördröjning på minst 5 sekunder och Hämta ett återgivningsjobb tills statusen har slutförts, misslyckats eller avbrutits och slutförs med Ladda ned ett jobbresultat.
Fullständig API-dokumentation finns på https://ironfang.com/render/docs.
Kända problem och begränsningar
- Skicka antingen en sid-URL eller HTML i en begäran, inte båda.
- Varje återgivning är begränsad till 30 sekunder. En sida som tar längre tid att bli klar misslyckas med ett återgivningsfel.
- En PDF-fil kan ha högst 100 sidor och en bild högst 4 096 bildpunkter i bredd eller höjd. En helsidesfångst är högst 2 0000 bildpunkter hög.
- Ett jobbs fil sparas i 24 timmar efter att jobbet har slutförts och den signerade nedladdningslänken i Hämta ett renderingsjobb fungerar i 15 minuter. Ladda ned ett jobbresultat kan anropas igen inom 24 timmar.
- Ett konto kan köra två renderingar i taget. En begäran utöver denna avslås med status 429 och bör prövas på nytt efter en kort väntan. jobb väntar i kön i stället.
- En identisk begäran inom 10 minuter kan returnera den tidigare återgivningen. Aktivera Hoppa över cachen för att framtvinga en ny.
- Det går inte att hämta sidor bakom en inloggning via den här anslutningsappen ännu.
Vanliga frågor och svar
Läggs något till i mina filer?
No. Filer som återges via API:et har inget Ironfang-märke eller vattenstämpel.
Var får jag hjälp?
Kontakta Ironfang på https://ironfang.com/contact eller hello@ironfang.com. Tjänstens status är på https://status.ironfang.com.
Distributionsinstruktioner
Använd Power Platform CLI för att distribuera den här anslutningsappen som en anpassad anslutningsapp:
pac connector create --api-definition-file apiDefinition.swagger.json --api-properties-file apiProperties.json --icon-file icon.png
Skapa sedan en anslutning med din Ironfang API-nyckel.
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Standard | Parametrar för att skapa anslutning. | Alla regioner | Går inte att dela |
Standard
Tillämpligt: Alla regioner
Parametrar för att skapa anslutning.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Name | Type | Description | Required |
|---|---|---|---|
| API-nyckel | securestring | Din Ironfang API-nyckel, som börjar med if_live_. | True |
Åtgärder
| Hämta ett återgivningsjobb |
Returnerar ett återgivningsjobb med dess status. Ett slutfört jobb innehåller information om resultatet och ett misslyckat jobb bär felet. |
| Ladda ned ett jobbresultat |
Returnerar filen som ett slutfört jobb har skapats. Resultaten sparas i 24 timmar efter att jobbet har slutförts. |
| Skapa en PDF-fil |
Skriver ut en webbsida eller ett HTML-block till ett PDF-dokument på högst 100 sidor och returnerar filen. Skicka en sid-URL eller HTML, inte båda. |
| Starta ett PDF-jobb |
Köar en PDF som ett varaktigt jobb och returnerar på en gång. Kontrollera jobbet med Hämta ett återgivningsjobb och använd sedan Ladda ned ett jobbresultat. Den färdiga filen sparas i 24 timmar. |
| Starta ett skärmbildsjobb |
Köar en skärmbild som ett varaktigt jobb och returnerar samtidigt. Kontrollera jobbet med Hämta ett återgivningsjobb och använd sedan Ladda ned ett jobbresultat. Den färdiga filen sparas i 24 timmar. |
| Ta en skärmbild |
Renderar en webbsida eller ett HTML-block i en webbläsare och returnerar bilden. Skicka en sid-URL eller HTML, inte båda. |
Hämta ett återgivningsjobb
Returnerar ett återgivningsjobb med dess status. Ett slutfört jobb innehåller information om resultatet och ett misslyckat jobb bär felet.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Jobb-ID
|
id | True | string |
ID:t för återgivningsjobbet, som returnerades när det startades. |
Returer
- Body
- Job
Ladda ned ett jobbresultat
Returnerar filen som ett slutfört jobb har skapats. Resultaten sparas i 24 timmar efter att jobbet har slutförts.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Jobb-ID
|
id | True | string |
ID:t för återgivningsjobbet, som returnerades när det startades. |
Returer
Filen som jobbet skapade.
- Filinnehåll
- binary
Skapa en PDF-fil
Skriver ut en webbsida eller ett HTML-block till ett PDF-dokument på högst 100 sidor och returnerar filen. Skicka en sid-URL eller HTML, inte båda.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sid-URL
|
url | string |
Adressen till sidan som ska skrivas ut. Lämna tomt när du skickar HTML. |
|
|
HTML
|
html | string |
HTML-koden som ska skrivas ut. Lämna tom när du skickar en sid-URL. |
|
|
Pappersstorlek
|
paper_format | string |
Den namngivna pappersstorleken. När den är tom används Letter. |
|
|
Landskap
|
landscape | boolean |
Om du vill skriva ut i liggande orientering. |
|
|
Skriva ut bakgrunder
|
print_background | boolean |
Om du vill inkludera bakgrundsfärger och bilder, som en dialogruta för webbläsarutskrift kan. |
|
|
Övre marginal (tum)
|
top | float |
Den övre marginalen i tum. |
|
|
Högermarginal (tum)
|
right | float |
Högermarginalen i tum. |
|
|
Nedre marginal (tum)
|
bottom | float |
Den nedre marginalen i tum. |
|
|
Vänstermarginal (tum)
|
left | float |
Vänstermarginalen i tum. |
|
|
HTML-rubrik
|
header_html | string |
HTML-mallen som skrivs ut överst på varje sida. |
|
|
HTML-sidfot
|
footer_html | string |
HTML-mallen som skrivs ut längst ned på varje sida. |
|
|
Scale
|
scale | float |
Utskriftsskalan, där 1 är faktisk storlek. |
|
|
Vänta tills
|
wait_until | string |
När sidan räknas som klar. Nätverksaktiv väntar på att nätverkstrafiken ska stoppas. |
|
|
Dölj cookiebanderoll
|
block_cookie_banners | boolean |
Om du vill dölja vanliga banderoller för cookiemedgivande. De är dolda, accepterade aldrig. |
|
|
Blockera annonser
|
block_ads | boolean |
Om du vill blockera begäranden till kända reklam- och spårningsnätverk. |
Returer
PDF-filinnehållet.
- PDF-innehåll
- binary
Starta ett PDF-jobb
Köar en PDF som ett varaktigt jobb och returnerar på en gång. Kontrollera jobbet med Hämta ett återgivningsjobb och använd sedan Ladda ned ett jobbresultat. Den färdiga filen sparas i 24 timmar.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Idempotensnyckel
|
Idempotency-Key | string |
Ett unikt värde för den här begäran, till exempel flödeskörnings-ID:t. Om du skickar samma nyckel igen skapas aldrig en andra återgivning. |
|
|
Sid-URL
|
url | string |
Adressen till sidan som ska skrivas ut. Lämna tomt när du skickar HTML. |
|
|
HTML
|
html | string |
HTML-koden som ska skrivas ut. Lämna tom när du skickar en sid-URL. |
|
|
Pappersstorlek
|
paper_format | string |
Den namngivna pappersstorleken. När den är tom används Letter. |
|
|
Landskap
|
landscape | boolean |
Om du vill skriva ut i liggande orientering. |
|
|
Skriva ut bakgrunder
|
print_background | boolean |
Om du vill inkludera bakgrundsfärger och bilder, som en dialogruta för webbläsarutskrift kan. |
|
|
Övre marginal (tum)
|
top | float |
Den övre marginalen i tum. |
|
|
Högermarginal (tum)
|
right | float |
Högermarginalen i tum. |
|
|
Nedre marginal (tum)
|
bottom | float |
Den nedre marginalen i tum. |
|
|
Vänstermarginal (tum)
|
left | float |
Vänstermarginalen i tum. |
|
|
HTML-rubrik
|
header_html | string |
HTML-mallen som skrivs ut överst på varje sida. |
|
|
HTML-sidfot
|
footer_html | string |
HTML-mallen som skrivs ut längst ned på varje sida. |
|
|
Scale
|
scale | float |
Utskriftsskalan, där 1 är faktisk storlek. |
|
|
Vänta tills
|
wait_until | string |
När sidan räknas som klar. Nätverksaktiv väntar på att nätverkstrafiken ska stoppas. |
|
|
Dölj cookiebanderoll
|
block_cookie_banners | boolean |
Om du vill dölja vanliga banderoller för cookiemedgivande. De är dolda, accepterade aldrig. |
|
|
Blockera annonser
|
block_ads | boolean |
Om du vill blockera begäranden till kända reklam- och spårningsnätverk. |
|
|
Din referens
|
external_id | string |
Din egen referens för jobbet, upp till 120 tecken. |
Returer
- Body
- Job
Starta ett skärmbildsjobb
Köar en skärmbild som ett varaktigt jobb och returnerar samtidigt. Kontrollera jobbet med Hämta ett återgivningsjobb och använd sedan Ladda ned ett jobbresultat. Den färdiga filen sparas i 24 timmar.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Idempotensnyckel
|
Idempotency-Key | string |
Ett unikt värde för den här begäran, till exempel flödeskörnings-ID:t. Om du skickar samma nyckel igen skapas aldrig en andra återgivning. |
|
|
Sid-URL
|
url | string |
Adressen till sidan som ska avbildas. Lämna tomt när du skickar HTML. |
|
|
HTML
|
html | string |
HTML-koden som ska återges. Lämna tom när du skickar en sid-URL. |
|
|
Bildformat
|
format | string |
Bildfilformatet. PNG är förlustfri och WebP är vanligtvis den minsta filen. |
|
|
Hel sida
|
full_page | boolean |
Om hela den rullningsbara sidan ska avbildas i stället för bara det synliga området. |
|
|
Bredd
|
width | integer |
Webbläsarfönstrets bredd i bildpunkter, upp till 4 096. |
|
|
Höjd
|
height | integer |
Webbläsarens fönsterhöjd i bildpunkter, upp till 4 096. Den ignoreras för en helsidesinsamling. |
|
|
Apparat
|
device | string |
Avbilda sidan som en telefon eller surfplatta skulle visa den, med matchande skärmstorlek och användaragent. |
|
|
Mörkt läge
|
dark_mode | boolean |
Om sidan ska återges med dess mörka färgschema. |
|
|
Quality
|
quality | integer |
Bildkvaliteten från 1 till 100 för JPEG och WebP. Det ignoreras för PNG. |
|
|
Elementväljare
|
selector | string |
CSS-väljaren för ett element som ska avbildas i stället för hela fönstret. |
|
|
Fördröjning (millisekunder)
|
delay_ms | integer |
Hur lång tid det tar att vänta efter att sidan har lästs in innan den hämtas, upp till 1 0000 millisekunder. |
|
|
Vänta tills
|
wait_until | string |
När sidan räknas som klar. Nätverksaktiv väntar på att nätverkstrafiken ska stoppas. |
|
|
Dölj cookiebanderoll
|
block_cookie_banners | boolean |
Om du vill dölja vanliga banderoller för cookiemedgivande. De är dolda, accepterade aldrig. |
|
|
Blockera annonser
|
block_ads | boolean |
Om du vill blockera begäranden till kända reklam- och spårningsnätverk. |
|
|
Hoppa över cacheminnet
|
no_cache | boolean |
Om du vill framtvinga en ny återgivning i stället för att återanvända en identisk från de senaste 10 minuterna. |
|
|
Din referens
|
external_id | string |
Din egen referens för jobbet, upp till 120 tecken. |
Returer
- Body
- Job
Ta en skärmbild
Renderar en webbsida eller ett HTML-block i en webbläsare och returnerar bilden. Skicka en sid-URL eller HTML, inte båda.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sid-URL
|
url | string |
Adressen till sidan som ska avbildas. Lämna tomt när du skickar HTML. |
|
|
HTML
|
html | string |
HTML-koden som ska återges. Lämna tom när du skickar en sid-URL. |
|
|
Bildformat
|
format | string |
Bildfilformatet. PNG är förlustfri och WebP är vanligtvis den minsta filen. |
|
|
Hel sida
|
full_page | boolean |
Om hela den rullningsbara sidan ska avbildas i stället för bara det synliga området. |
|
|
Bredd
|
width | integer |
Webbläsarfönstrets bredd i bildpunkter, upp till 4 096. |
|
|
Höjd
|
height | integer |
Webbläsarens fönsterhöjd i bildpunkter, upp till 4 096. Den ignoreras för en helsidesinsamling. |
|
|
Apparat
|
device | string |
Avbilda sidan som en telefon eller surfplatta skulle visa den, med matchande skärmstorlek och användaragent. |
|
|
Mörkt läge
|
dark_mode | boolean |
Om sidan ska återges med dess mörka färgschema. |
|
|
Quality
|
quality | integer |
Bildkvaliteten från 1 till 100 för JPEG och WebP. Det ignoreras för PNG. |
|
|
Elementväljare
|
selector | string |
CSS-väljaren för ett element som ska avbildas i stället för hela fönstret. |
|
|
Fördröjning (millisekunder)
|
delay_ms | integer |
Hur lång tid det tar att vänta efter att sidan har lästs in innan den hämtas, upp till 1 0000 millisekunder. |
|
|
Vänta tills
|
wait_until | string |
När sidan räknas som klar. Nätverksaktiv väntar på att nätverkstrafiken ska stoppas. |
|
|
Dölj cookiebanderoll
|
block_cookie_banners | boolean |
Om du vill dölja vanliga banderoller för cookiemedgivande. De är dolda, accepterade aldrig. |
|
|
Blockera annonser
|
block_ads | boolean |
Om du vill blockera begäranden till kända reklam- och spårningsnätverk. |
|
|
Hoppa över cacheminnet
|
no_cache | boolean |
Om du vill framtvinga en ny återgivning i stället för att återanvända en identisk från de senaste 10 minuterna. |
Returer
Skärmbilden av filinnehållet.
- Bildinnehåll
- binary
Definitioner
Job
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Jobb-ID
|
id | string |
Jobbets ID. |
|
Kind
|
kind | string |
Typ av återgivning, till exempel skärmbild eller pdf. |
|
Status
|
status | string |
Jobbstatus. Ett jobb har slutförts när det har slutförts, misslyckats eller avbrutits. |
|
Din referens
|
external_id | string |
Referensen som angavs när jobbet startades. |
|
Attempts
|
attempts | integer |
Hur många gånger jobbet har körts. |
|
Skapat vid
|
created_at | date-time |
När jobbet accepterades. |
|
Startade på
|
started_at | date-time |
När jobbet senast började köras. |
|
Har slutförts kl.
|
completed_at | date-time |
När jobbet är klart. |
|
Felkod
|
error.code | string |
En stabil kod för felet. |
|
Felmeddelande
|
error.message | string |
En läsbar beskrivning av felet. |
|
Innehållstyp
|
result.content_type | string |
Medietypen för resultatfilen. |
|
Storlek (byte)
|
result.bytes | integer |
Storleken på resultatfilen i byte. |
|
SHA256-hashvärde
|
result.sha256 | string |
SHA-256-hashen för resultatfilen. |
|
Available
|
result.available | boolean |
Om resultatfilen fortfarande kan laddas ned. |
|
Resultatet upphör att gälla
|
result.expires_at | date-time |
När den värdbaserade resultatfilen tas bort. |
|
Nedladdningslänk
|
result.url | string |
En signerad länk till resultatfilen som inte behöver någon API-nyckel. |
|
Nedladdningslänken upphör att gälla kl.
|
result.url_expires_at | date-time |
När den signerade nedladdningslänken slutar fungera. |
binary
Det här är den grundläggande datatypen "binär".