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 |
| 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.
- Jelentkezzen be, https://portal.ironfang.comvagy hozzon létre egy ingyenes fiókot.
- 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.
- Másolja ki a kulcsot, amely a if_live_ kezdődik. Egyszer jelenik meg.
- 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:
- 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.
- 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:
- Kezdje ismétlődési eseményindítóval.
- Adjon hozzá képernyőképet a lap URL-címével, és kapcsolja be a Teljes oldalt, ha az egész oldalt szeretné.
- 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.