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.

  1. Logga in på https://portal.ironfang.comeller skapa ett kostnadsfritt konto där.
  2. Ö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.
  3. Kopiera nyckeln, som börjar med if_live_. Den visas en gång.
  4. 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:

  1. Lägg till åtgärden Skapa en PDF och placera HTML i HTML-fältet. Ange Pappersstorlek till a4.
  2. 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:

  1. Börja med en upprepningsutlösare.
  2. Lägg till Avbilda en skärmbild med sid-URL:en och aktivera Hel sida om du vill ha hela sidan.
  3. 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".