Ironfang Render (előzetes verzió)

Az Ironfang Render képernyőképeket és PDF-dokumentumokat készít a weblapokról és a HTML-ről. PNG, JPEG vagy WebP formátumban rögzíthet egy lapot, kinyomtathat egy URL-címet vagy egy saját HTML-fájlt PDF-fájlba, vagy várólistára hozhat egy renderelési feladatot, és összegyűjtheti a fájlt, ha készen áll. Nincs futtatható vagy karbantartható böngésző.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service osztály Régiók
Copilot Studio prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások Standard Az összes Logic Apps-régió , kivéve a következőket:
     - Azure Government-régiók
     - Azure China-régiók
     - Amerikai Védelmi Minisztérium (DoD)
Power Apps prémium Az összes Power Apps-régió , kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Power Automate prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Contact
Name Ironfang
URL https://ironfang.com/contact
Email hello@ironfang.com
Összekötő metaadatai
Publisher Ironfang
Webhely https://ironfang.com/render
Adatvédelmi irányelvek https://ironfang.com/legal/privacy
Categories Tartalom és fájlok; Termelékenység

Ironfang Render

Az Ironfang Render képernyőképeket és PDF-dokumentumokat készít a weblapokról és a HTML-ről. Ezzel az összekötővel egy folyamat rögzíthet egy lapot képként, kinyomtathat egy URL-címet vagy saját HTML-fájlt PDF-fájlba, vagy várólistára helyezhet egy renderelési feladatot, és összegyűjtheti a fájlt, amikor készen áll, böngésző futtatása nélkül.

Publisher: Ironfang

Prerequisites

Szüksége van egy Ironfang-fiókra és egy API-kulcsra. A fiókok ingyenesen hozhatók létre, https://portal.ironfang.comés minden fiók havi ingyenes renderelési támogatást tartalmaz. A juttatáson túli használatot az Ironfang-fiók számlájára kell kiszámlázni; a jelenlegi árfolyamok a https://ironfang.com/pricing.

Támogatott műveletek

Képernyőkép rögzítése

Weblapot vagy HTML-blokkot jelenít meg, és PNG, JPEG vagy WebP formátumban adja vissza a képet. Válassza ki az ablak méretét, rögzítse a teljes görgethető oldalt vagy egyetlen elemet, emuláljon egy telefont vagy táblagépet, használja a sötét színsémát, és rejtse el a cookie-szalagcímeket vagy tiltsa le a hirdetéseket.

PDF létrehozása

Akár 100 oldalból álló PDF-dokumentumba nyomtat egy weblapot vagy HTML-blokkot, és visszaadja a fájlt. Válassza ki a papírméretet, a tájolást, a margókat, a háttereket, valamint az élőfej- és élőlábsablonokat.

Képernyőkép-feladat indítása

A képernyőfelvételt tartós feladatként várólistára állítja, és azonnal visszaadja az azonosítóját. Akkor használja, ha egy folyamat nem várja meg a renderelést, vagy ha a fájl elérhetővé válik a későbbi lépésekhez.

PDF-feladat indítása

Tartós feladatként várólistára állítja a PDF-fájlt, és azonnal visszaadja az azonosítóját.

Renderelési feladat lekérése

A következő állapotú feladatot adja vissza: várólistára helyezett, futtatott, sikeres, sikertelen vagy megszakított. A sikeres feladatok közé tartozik a fájl mérete és típusa, valamint egy aláírt letöltési hivatkozás; egy sikertelen feladat tartalmazza az okot.

Feladat eredményének letöltése

Egy sikeres feladat által létrehozott fájlt ad vissza.

Hitelesítő adatok beszerzése

Az összekötő egy Ironfang API-kulccsal hitelesít.

  1. Jelentkezzen be, https://portal.ironfang.comvagy hozzon létre egy ingyenes fiókot.
  2. Nyissa meg az API-kulcsokat, és hozzon létre egy kulcsot. Az összekötő minden műveletéhez elegendő egy olyan kulcs, amely csak a renderelési:renderelési hatókörrel rendelkezik.
  3. Másolja ki a kulcsot, amely a if_live_ kezdődik. Egyszer jelenik meg.
  4. Kapcsolat létrehozásakor illessze be a kulcsot az API-kulcs mezőbe.

Első lépések

Saját HTML-fájl mentése SharePoint:

  1. Adja hozzá a PDF létrehozása műveletet, és helyezze a HTML-fájlt a HTML mezőbe. Állítsa a papírméretet a4-esre.
  2. Adja hozzá a SharePoint Fájl létrehozása műveletet. Használjon egy .pdfvégződésű fájlnevet, és használja a PDF-fájl létrehozása pdf-tartalomkimenetét fájltartalomként.

Oldal rögzítése ütemezés szerint:

  1. Kezdje ismétlődési eseményindítóval.
  2. Adjon hozzá képernyőképet a lap URL-címével, és kapcsolja be a Teljes oldalt, ha az egész oldalt szeretné.
  3. Adja hozzá a OneDrive Fájl létrehozása műveletet, amelynek fájlneve .png végződik, a képtartalom kimenete pedig fájltartalomként.

Hosszú köteg esetén használja a Képernyőkép-feladat indítása vagy a PDF-feladat indítása, majd a Legalább 5 másodperces késleltetést futtató Do(k) ciklust, majd a renderelési feladat lekérése addig, amíg az állapot sikeres, sikertelen vagy megszakított, és a feladat eredményének letöltésével fejeződik be.

A teljes API-dokumentáció itt https://ironfang.com/render/docstalálható.

Ismert problémák és korlátozások

  • Lap URL-címének vagy HTML-címének elküldése kérésben, nem mindkettőben.
  • Az egyes renderelések legfeljebb 30 másodpercig lesznek korlátozva. Az a lap, amely hosszabb időt vesz igénybe, renderelési hibával meghiúsul.
  • A PDF-fájlok legfeljebb 100 oldalból állhatnak, a képek szélessége vagy magassága pedig legfeljebb 4096 képpont lehet. A teljes oldal rögzítése legfeljebb 20000 képpont magas.
  • A feladat fájlját a feladat sikeres végrehajtása után 24 órán át őrzi meg a rendszer, és a Renderelési feladat lekérése funkció aláírt letöltési hivatkozása 15 percig működik. A feladat eredményének letöltése 24 órán belül ismét meghívható.
  • Egy fiók egyszerre két renderet is futtathat. A 429-ben elutasított kérelemen túl rövid várakozás után újra meg kell próbálkozni; a feladatok inkább az üzenetsorban várakoznak.
  • Az azonos kérés 10 percen belül visszaadhatja a korábbi renderelést. Kapcsolja be a Gyorsítótár kihagyása funkciót, hogy újat kényszerítsen ki.
  • A bejelentkezés mögötti oldalak még nem rögzíthetők ezen az összekötőn keresztül.

Gyakori kérdések

Van valami hozzáadva a fájljaimhoz?

No. Az API-n keresztül megjelenített fájlok nem hordoznak Ironfang-jelvényt vagy vízjelet.

Hol kaphatok segítséget?

Lépjen kapcsolatba Ironfang-tal a (vagy) címenhttps://ironfang.com/contact.hello@ironfang.com A szolgáltatás állapota a .https://status.ironfang.com

Üzembe helyezési utasítások

Az összekötő egyéni összekötőként való üzembe helyezéséhez használja a Power Platform parancssori felületét:

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

Ezután hozzon létre egy kapcsolatot az Ironfang API-kulccsal.

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:

Alapértelmezett A kapcsolat létrehozásának paraméterei. Minden régió Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Name Típus Leírás Required
API-kulcs securestring Az Ironfang API-kulcs, amely if_live_ kezdődik. True

Műveletek

Feladat eredményének letöltése

Egy sikeres feladat által létrehozott fájlt ad vissza. Az eredmények a feladat sikerességét követő 24 órán át maradnak meg.

Képernyőkép-feladat indítása

A képernyőfelvételt tartós feladatként várólistára állítja, és azonnal visszatér. Ellenőrizze a feladatot a Renderelési feladat lekérése, majd a Feladat eredményének letöltése parancs használatával. A kész fájl 24 órán át marad meg.

Képernyőkép rögzítése

Megjelenít egy weblapot vagy egy HTML-blokkot egy böngészőben, és visszaadja a képet. A lap URL-címének vagy HTML-címének elküldése nem mindkettő.

PDF-feladat indítása

A PDF-fájlokat tartós feladatként várólistára állítja, és azonnal visszatér. Ellenőrizze a feladatot a Renderelési feladat lekérése, majd a Feladat eredményének letöltése parancs használatával. A kész fájl 24 órán át marad meg.

PDF létrehozása

Legfeljebb 100 oldalból álló PDF-dokumentumba nyomtat egy weblapot vagy EGY HTML-blokkot, és visszaadja a fájlt. A lap URL-címének vagy HTML-címének elküldése nem mindkettő.

Renderelési feladat lekérése

Az állapotával rendelkező renderelési feladatot ad vissza. A sikeres feladatok az eredmény részleteit, a sikertelen feladat pedig a hibát hordozza.

Feladat eredményének letöltése

Egy sikeres feladat által létrehozott fájlt ad vissza. Az eredmények a feladat sikerességét követő 24 órán át maradnak meg.

Paraméterek

Név Kulcs Kötelező Típus Description
Feladatazonosító
id True string

A renderelési feladat azonosítója az indításkor visszaadott módon.

Válaszok

A feladat által létrehozott fájl.

Fájl tartalma
binary

Képernyőkép-feladat indítása

A képernyőfelvételt tartós feladatként várólistára állítja, és azonnal visszatér. Ellenőrizze a feladatot a Renderelési feladat lekérése, majd a Feladat eredményének letöltése parancs használatával. A kész fájl 24 órán át marad meg.

Paraméterek

Név Kulcs Kötelező Típus Description
Idempotenciakulcs
Idempotency-Key string

A kérés egyedi értéke, például a folyamatfuttatás azonosítója. Ugyanazon kulcs ismételt elküldése soha nem hoz létre második renderelést.

Oldal URL-címe
url string

A rögzíteni kívánt oldal címe. HTML-küldéskor hagyja üresen.

HTML
html string

A megjelenítendő HTML-jelölő. A lap URL-címének elküldésekor hagyja üresen.

Képformátum
format string

A képfájl formátuma. A PNG veszteségmentes, és a WebP általában a legkisebb fájl.

Teljes oldal
full_page boolean

A teljes görgethető oldal rögzítése a látható terület helyett.

Szélesség
width integer

A böngészőablak szélessége képpontban, legfeljebb 4096.

Magasság
height integer

A böngészőablak magassága képpontban, legfeljebb 4096. Teljes oldalrögzítés esetén a rendszer figyelmen kívül hagyja.

Device
device string

Rögzítse a lapot telefonként vagy táblagépként, egyező képernyőmérettel és felhasználói ügynökkel.

Sötét mód
dark_mode boolean

Az oldal sötét színsémával való megjelenítése.

Quality
quality integer

A képminőség 1-től 100-ra a JPEG és a WebP esetében. A PNG figyelmen kívül hagyja.

Elemválasztó
selector string

Az egyik elem CSS-választója a teljes ablak helyett.

Késleltetés (ezredmásodperc)
delay_ms integer

Mennyi ideig kell várni az oldal betöltése után a rögzítés előtt, legfeljebb 10000 ezredmásodpercig.

Várjon, amíg
wait_until string

Amikor az oldal készen áll. A hálózati tétlenség megvárja, amíg a hálózati forgalom leáll.

Cookie-szalagcímek elrejtése
block_cookie_banners boolean

Az általános cookie-hozzájárulási szalagcímek elrejtése. Rejtve vannak, soha nem fogadják el őket.

Hirdetések letiltása
block_ads boolean

Tiltsa-e le az ismert hirdetési és nyomkövetési hálózatokra irányuló kérelmeket.

A gyorsítótár kihagyása
no_cache boolean

Azt határozza meg, hogy kényszerítsen-e új renderelést ahelyett, hogy újrahasználná az előző 10 perc azonosját.

Az Ön referenciája
external_id string

Saját referencia a feladathoz, legfeljebb 120 karakter hosszúságú.

Válaszok

Body
Job

Képernyőkép rögzítése

Megjelenít egy weblapot vagy egy HTML-blokkot egy böngészőben, és visszaadja a képet. A lap URL-címének vagy HTML-címének elküldése nem mindkettő.

Paraméterek

Név Kulcs Kötelező Típus Description
Oldal URL-címe
url string

A rögzíteni kívánt oldal címe. HTML-küldéskor hagyja üresen.

HTML
html string

A megjelenítendő HTML-jelölő. A lap URL-címének elküldésekor hagyja üresen.

Képformátum
format string

A képfájl formátuma. A PNG veszteségmentes, és a WebP általában a legkisebb fájl.

Teljes oldal
full_page boolean

A teljes görgethető oldal rögzítése a látható terület helyett.

Szélesség
width integer

A böngészőablak szélessége képpontban, legfeljebb 4096.

Magasság
height integer

A böngészőablak magassága képpontban, legfeljebb 4096. Teljes oldalrögzítés esetén a rendszer figyelmen kívül hagyja.

Device
device string

Rögzítse a lapot telefonként vagy táblagépként, egyező képernyőmérettel és felhasználói ügynökkel.

Sötét mód
dark_mode boolean

Az oldal sötét színsémával való megjelenítése.

Quality
quality integer

A képminőség 1-től 100-ra a JPEG és a WebP esetében. A PNG figyelmen kívül hagyja.

Elemválasztó
selector string

Az egyik elem CSS-választója a teljes ablak helyett.

Késleltetés (ezredmásodperc)
delay_ms integer

Mennyi ideig kell várni az oldal betöltése után a rögzítés előtt, legfeljebb 10000 ezredmásodpercig.

Várjon, amíg
wait_until string

Amikor az oldal készen áll. A hálózati tétlenség megvárja, amíg a hálózati forgalom leáll.

Cookie-szalagcímek elrejtése
block_cookie_banners boolean

Az általános cookie-hozzájárulási szalagcímek elrejtése. Rejtve vannak, soha nem fogadják el őket.

Hirdetések letiltása
block_ads boolean

Tiltsa-e le az ismert hirdetési és nyomkövetési hálózatokra irányuló kérelmeket.

A gyorsítótár kihagyása
no_cache boolean

Azt határozza meg, hogy kényszerítsen-e új renderelést ahelyett, hogy újrahasználná az előző 10 perc azonosját.

Válaszok

A képernyőképfájl tartalma.

Kép tartalma
binary

PDF-feladat indítása

A PDF-fájlokat tartós feladatként várólistára állítja, és azonnal visszatér. Ellenőrizze a feladatot a Renderelési feladat lekérése, majd a Feladat eredményének letöltése parancs használatával. A kész fájl 24 órán át marad meg.

Paraméterek

Név Kulcs Kötelező Típus Description
Idempotenciakulcs
Idempotency-Key string

A kérés egyedi értéke, például a folyamatfuttatás azonosítója. Ugyanazon kulcs ismételt elküldése soha nem hoz létre második renderelést.

Oldal URL-címe
url string

A nyomtatni kívánt oldal címe. HTML-küldéskor hagyja üresen.

HTML
html string

A nyomtatandó HTML-korrektúra. A lap URL-címének elküldésekor hagyja üresen.

Papírméret
paper_format string

A nevesített papírméret. Ha üres, a betűt használja a rendszer.

Táj
landscape boolean

Fekvő tájolású nyomtatás.

Hátterek nyomtatása
print_background boolean

Azt, hogy a böngésző nyomtatási párbeszédpaneljén szerepeljenek-e háttérszínek és képek.

Felső margó (hüvelyk)
top float

A felső margó hüvelykben.

Jobb margó (hüvelyk)
right float

A jobb margó hüvelykben.

Alsó margó (hüvelyk)
bottom float

Az alsó margó hüvelykben.

Bal margó (hüvelyk)
left float

A bal margó hüvelykben.

Fejléc HTML-azonosítója
header_html string

Minden oldal tetején kinyomtatott HTML-sablon.

Élőláb HTML-fájlja
footer_html string

Minden oldal alján kinyomtatott HTML-sablon.

Scale
scale float

A nyomtatási méret, ahol az 1 a tényleges méret.

Várjon, amíg
wait_until string

Amikor az oldal készen áll. A hálózati tétlenség megvárja, amíg a hálózati forgalom leáll.

Cookie-szalagcímek elrejtése
block_cookie_banners boolean

Az általános cookie-hozzájárulási szalagcímek elrejtése. Rejtve vannak, soha nem fogadják el őket.

Hirdetések letiltása
block_ads boolean

Tiltsa-e le az ismert hirdetési és nyomkövetési hálózatokra irányuló kérelmeket.

Az Ön referenciája
external_id string

Saját referencia a feladathoz, legfeljebb 120 karakter hosszúságú.

Válaszok

Body
Job

PDF létrehozása

Legfeljebb 100 oldalból álló PDF-dokumentumba nyomtat egy weblapot vagy EGY HTML-blokkot, és visszaadja a fájlt. A lap URL-címének vagy HTML-címének elküldése nem mindkettő.

Paraméterek

Név Kulcs Kötelező Típus Description
Oldal URL-címe
url string

A nyomtatni kívánt oldal címe. HTML-küldéskor hagyja üresen.

HTML
html string

A nyomtatandó HTML-korrektúra. A lap URL-címének elküldésekor hagyja üresen.

Papírméret
paper_format string

A nevesített papírméret. Ha üres, a betűt használja a rendszer.

Táj
landscape boolean

Fekvő tájolású nyomtatás.

Hátterek nyomtatása
print_background boolean

Azt, hogy a böngésző nyomtatási párbeszédpaneljén szerepeljenek-e háttérszínek és képek.

Felső margó (hüvelyk)
top float

A felső margó hüvelykben.

Jobb margó (hüvelyk)
right float

A jobb margó hüvelykben.

Alsó margó (hüvelyk)
bottom float

Az alsó margó hüvelykben.

Bal margó (hüvelyk)
left float

A bal margó hüvelykben.

Fejléc HTML-azonosítója
header_html string

Minden oldal tetején kinyomtatott HTML-sablon.

Élőláb HTML-fájlja
footer_html string

Minden oldal alján kinyomtatott HTML-sablon.

Scale
scale float

A nyomtatási méret, ahol az 1 a tényleges méret.

Várjon, amíg
wait_until string

Amikor az oldal készen áll. A hálózati tétlenség megvárja, amíg a hálózati forgalom leáll.

Cookie-szalagcímek elrejtése
block_cookie_banners boolean

Az általános cookie-hozzájárulási szalagcímek elrejtése. Rejtve vannak, soha nem fogadják el őket.

Hirdetések letiltása
block_ads boolean

Tiltsa-e le az ismert hirdetési és nyomkövetési hálózatokra irányuló kérelmeket.

Válaszok

A PDF-fájl tartalma.

PDF-tartalom
binary

Renderelési feladat lekérése

Az állapotával rendelkező renderelési feladatot ad vissza. A sikeres feladatok az eredmény részleteit, a sikertelen feladat pedig a hibát hordozza.

Paraméterek

Név Kulcs Kötelező Típus Description
Feladatazonosító
id True string

A renderelési feladat azonosítója az indításkor visszaadott módon.

Válaszok

Body
Job

Definíciók

Job

Név Elérési út Típus Description
Feladatazonosító
id string

A feladat azonosítója.

Altípus
kind string

A renderelés típusa, például képernyőkép vagy pdf.

Status
status string

A feladat állapota. A feladat akkor fejeződik be, ha sikeres, sikertelen vagy megszakított.

Az Ön referenciája
external_id string

A feladat indításakor megadott hivatkozás.

Attempts
attempts integer

Hányszor futtatták a feladatot.

Létrehozás időpontja:
created_at date-time

A feladat elfogadásakor.

Első lépések:
started_at date-time

Amikor a feladat utoljára futott.

Befejezve:
completed_at date-time

Amikor a feladat befejeződött.

Hibakód
error.code string

A hiba stabil kódja.

Hibaüzenet
error.message string

A hiba olvasható leírása.

Tartalomtípus
result.content_type string

Az eredményfájl médiatípusa.

Méret (bájt)
result.bytes integer

Az eredményfájl mérete bájtban.

SHA256 kivonat
result.sha256 string

Az eredményfájl SHA-256 kivonata.

Available
result.available boolean

Azt jelzi, hogy az eredményfájl továbbra is letölthető-e.

Az eredmény a következő időpontban jár le:
result.expires_at date-time

Az üzemeltetett eredményfájl törlésekor.

Letöltési hivatkozás
result.url string

Aláírt hivatkozás az eredményfájlra, amely nem igényel API-kulcsot.

A letöltési hivatkozás lejár:
result.url_expires_at date-time

Ha az aláírt letöltési hivatkozás nem működik.

bináris

Ez a bináris alapszintű adattípus.