Renderowanie ironfang (wersja zapoznawcza)
Funkcja renderowania Ironfang zamienia strony internetowe i HTML na zrzuty ekranu i dokumenty PDF. Przechwyć stronę jako PNG, JPEG lub WebP, wydrukuj adres URL lub własny kod HTML do formatu PDF lub umieść zadanie renderowania w kolejce i zbierz plik, gdy jest gotowy. Brak przeglądarki do uruchomienia lub obsługi.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Contact | |
|---|---|
| Name | Kły żelaza |
| adres URL | https://ironfang.com/contact |
| hello@ironfang.com |
| Metadane łącznika | |
|---|---|
| Publisher | Kły żelaza |
| Website | https://ironfang.com/render |
| Zasady ochrony prywatności | https://ironfang.com/legal/privacy |
| Categories | Zawartość i pliki; Produktywność |
Renderowanie ironfang
Funkcja renderowania Ironfang zamienia strony internetowe i HTML na zrzuty ekranu i dokumenty PDF. Za pomocą tego łącznika przepływ może przechwytywać stronę jako obraz, drukować adres URL lub własny kod HTML do formatu PDF lub kolejkować zadanie renderowania i zbierać plik, gdy jest gotowy, bez uruchamiania przeglądarki.
Publisher: Ironfang
Prerequisites
Potrzebujesz konta Ironfang i klucza interfejsu API. Konta są bezpłatne do utworzenia na https://portal.ironfang.com, a każde konto zawiera miesięczny bezpłatny zasiłek renderów. Użycie wykraczające poza zasiłek jest rozliczane na koncie Ironfang; bieżące stawki są na poziomie https://ironfang.com/pricing.
Obsługiwane operacje
Przechwytywanie zrzutu ekranu
Renderuje stronę internetową lub blok HTML i zwraca obraz jako PNG, JPEG lub WebP. Wybierz rozmiar okna, przechwyć całą stronę przewijaną lub pojedynczy element, emulować telefon lub tablet, użyć ciemnego schematu kolorów i ukryć banery cookie lub reklamy blokowe.
Tworzenie pliku PDF
Drukuje stronę internetową lub blok HTML do dokumentu PDF z maksymalnie 100 stron i zwraca plik. Wybierz szablony rozmiaru papieru, orientacji, marginesów, tła i nagłówka i stopki.
Uruchamianie zadania zrzutu ekranu
Kolejkuje zrzut ekranu jako trwałe zadanie i zwraca jego identyfikator jednocześnie. Użyj go, gdy przepływ nie powinien czekać na renderowanie lub zachować plik dostępny na potrzeby dalszych kroków.
Uruchamianie zadania w formacie PDF
Kolejkuje plik PDF jako trwałe zadanie i zwraca jego identyfikator jednocześnie.
Pobieranie zadania renderowania
Zwraca zadanie ze swoim stanem: w kolejce, uruchomiono, powiodło się, nie powiodło się lub zostało anulowane. Zadanie zakończone pomyślnie zawiera rozmiar i typ jego pliku oraz podpisany link pobierania; zadanie, które zakończyło się niepowodzeniem, zawiera przyczynę.
Pobieranie wyniku zadania
Zwraca plik utworzone zadanie zakończone pomyślnie.
Uzyskiwanie poświadczeń
Łącznik uwierzytelnia się za pomocą klucza interfejsu API Ironfang.
- Zaloguj się w witrynie https://portal.ironfang.comlub utwórz bezpłatne konto.
- Otwórz klucze interfejsu API i utwórz klucz. Klucz z tylko zakresem render:render wystarczy dla każdej akcji w tym łączniku.
- Skopiuj klucz rozpoczynający się od if_live_. Jest on wyświetlany raz.
- Podczas tworzenia połączenia wklej klucz do pola Klucz interfejsu API.
Wprowadzenie
Aby zapisać plik PDF własnego kodu HTML w celu SharePoint:
- Dodaj akcję Utwórz plik PDF i umieść kod HTML w polu HTML. Ustaw rozmiar papieru na wartość a4.
- Dodaj akcję SharePoint Utwórz plik. Użyj nazwy pliku kończącej się na .pdfi użyj danych wyjściowych zawartości PDF w obszarze Utwórz plik PDF jako zawartość pliku.
Aby przechwycić stronę zgodnie z harmonogramem:
- Rozpocznij od wyzwalacza Cykl.
- Dodaj zrzut ekranu z adresem URL strony i włącz opcję Pełna strona, jeśli chcesz uzyskać całą stronę.
- Dodaj akcję OneDrive Utwórz plik z nazwą pliku kończącą się na .png i danymi wyjściowymi zawartości obrazu jako zawartością pliku.
W przypadku długiej partii użyj polecenia Uruchom zadanie zrzutu ekranu lub Uruchom zadanie PDF, a następnie pętlę Wykonaj do uruchomienia co najmniej 5 sekund i Pobierz zadanie renderowania do momentu pomyślnego, zakończonego niepowodzeniem lub anulowanego stanu, a następnie zakończ ciąg Pobierz wynik zadania.
Pełna dokumentacja interfejsu API znajduje się pod adresem https://ironfang.com/render/docs.
Znane problemy i ograniczenia
- Wyślij adres URL strony lub kod HTML w żądaniu, a nie oba.
- Każdy renderowanie jest ograniczone do 30 sekund. Strona, która trwa dłużej, zanim stanie się gotowa, kończy się niepowodzeniem z powodu błędu renderowania.
- Plik PDF może zawierać co najwyżej 100 stron i obraz o szerokości lub wysokości co najwyżej 4096 pikseli. Przechwytywanie pełnej strony wynosi najwyżej 20000 pikseli.
- Plik zadania jest przechowywany przez 24 godziny po pomyślnym zakończeniu zadania, a podpisany link pobierania w sekcji Pobieranie zadania renderowania działa przez 15 minut. Pobierz wynik zadania można wywołać ponownie w ciągu 24 godzin.
- Konto może uruchamiać dwa renderowanie jednocześnie. Żądanie wykraczające poza to zostało odrzucone ze stanem 429 i powinno zostać ponowione po krótkim oczekiwaniu; zadania oczekują w kolejce.
- Identyczne żądanie w ciągu 10 minut może zwrócić wcześniejsze renderowanie. Włącz opcję Pomiń pamięć podręczną, aby wymusić nowy.
- Nie można jeszcze przechwycić stron za logowaniem za pośrednictwem tego łącznika.
Często zadawane pytania
Czy coś jest dodawane do moich plików?
No. Pliki renderowane za pośrednictwem interfejsu API nie zawierają znaczka Ironfang ani znaku wodnego.
Gdzie mogę uzyskać pomoc?
Skontaktuj się z Ironfang pod adresem https://ironfang.com/contact lub hello@ironfang.com. Stan usługi to https://status.ironfang.com.
Instrukcje dotyczące wdrażania
Użyj interfejsu wiersza polecenia platformy Power Platform, aby wdrożyć ten łącznik jako łącznik niestandardowy:
pac connector create --api-definition-file apiDefinition.swagger.json --api-properties-file apiProperties.json --icon-file icon.png
Następnie utwórz połączenie z kluczem interfejsu API Ironfang.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Opis | Required |
|---|---|---|---|
| klucz interfejsu API | securestring | Klucz interfejsu API Ironfang, który zaczyna się od if_live_. | True |
Akcje
| Pobieranie wyniku zadania |
Zwraca plik utworzone zadanie zakończone pomyślnie. Wyniki są przechowywane przez 24 godziny po pomyślnym zakończeniu zadania. |
| Pobieranie zadania renderowania |
Zwraca zadanie renderowania ze stanem. Zadanie zakończone pomyślnie zawiera szczegóły jego wyniku, a zadanie zakończone niepowodzeniem powoduje błąd. |
| Przechwytywanie zrzutu ekranu |
Renderuje stronę internetową lub blok HTML w przeglądarce i zwraca obraz. Wyślij adres URL strony lub kod HTML, a nie oba. |
| Tworzenie pliku PDF |
Drukuje stronę internetową lub blok HTML do dokumentu PDF z co najwyżej 100 stron i zwraca plik. Wyślij adres URL strony lub kod HTML, a nie oba. |
| Uruchamianie zadania w formacie PDF |
Kolejkuje plik PDF jako trwałe zadanie i zwraca je jednocześnie. Sprawdź zadanie za pomocą polecenia Pobierz zadanie renderowania, a następnie użyj polecenia Pobierz wynik zadania. Gotowy plik jest przechowywany przez 24 godziny. |
| Uruchamianie zadania zrzutu ekranu |
Kolejkuje zrzut ekranu jako trwałe zadanie i zwraca je jednocześnie. Sprawdź zadanie za pomocą polecenia Pobierz zadanie renderowania, a następnie użyj polecenia Pobierz wynik zadania. Gotowy plik jest przechowywany przez 24 godziny. |
Pobieranie wyniku zadania
Zwraca plik utworzone zadanie zakończone pomyślnie. Wyniki są przechowywane przez 24 godziny po pomyślnym zakończeniu zadania.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zadania
|
id | True | string |
Identyfikator zadania renderowania, który został zwrócony po uruchomieniu. |
Zwraca
Plik, który został utworzony.
- Zawartość pliku
- binary
Pobieranie zadania renderowania
Zwraca zadanie renderowania ze stanem. Zadanie zakończone pomyślnie zawiera szczegóły jego wyniku, a zadanie zakończone niepowodzeniem powoduje błąd.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zadania
|
id | True | string |
Identyfikator zadania renderowania, który został zwrócony po uruchomieniu. |
Zwraca
- Body
- Job
Przechwytywanie zrzutu ekranu
Renderuje stronę internetową lub blok HTML w przeglądarce i zwraca obraz. Wyślij adres URL strony lub kod HTML, a nie oba.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL strony
|
url | string |
Adres strony do przechwycenia. Pozostaw wartość pustą podczas wysyłania kodu HTML. |
|
|
HTML
|
html | string |
Znaczniki HTML do renderowania. Pozostaw wartość pustą po wysłaniu adresu URL strony. |
|
|
Format obrazu
|
format | string |
Format pliku obrazu. PLIK PNG jest bezstratny, a WebP jest zwykle najmniejszym plikiem. |
|
|
Pełna strona
|
full_page | boolean |
Czy przechwytywać całą stronę przewijaną, a nie tylko widoczny obszar. |
|
|
Szerokość
|
width | integer |
Szerokość okna przeglądarki w pikselach do 4096. |
|
|
Wysokość
|
height | integer |
Wysokość okna przeglądarki w pikselach do 4096. Jest on ignorowany w przypadku przechwytywania pełnej strony. |
|
|
Urządzenie
|
device | string |
Przechwyć stronę w postaci telefonu lub tabletu z pasującym rozmiarem ekranu i agentem użytkownika. |
|
|
Tryb nocny
|
dark_mode | boolean |
Czy strona ma być renderowana z ciemnym schematem kolorów. |
|
|
Kontrola
|
quality | integer |
Jakość obrazu z zakresu od 1 do 100 dla plików JPEG i WebP. Jest ignorowany dla png. |
|
|
Selektor elementów
|
selector | string |
Selektor CSS jednego elementu do przechwycenia zamiast całego okna. |
|
|
Opóźnienie (milisekundy)
|
delay_ms | integer |
Czas oczekiwania po załadowaniu strony przed przechwyceniem do 10000 milisekund. |
|
|
Poczekaj, aż
|
wait_until | string |
Gdy strona będzie zliczana jako gotowa. Bezczynność sieci czeka na zatrzymanie ruchu sieciowego. |
|
|
Ukryj banery plików cookie
|
block_cookie_banners | boolean |
Czy ukryć typowe banery zgody na pliki cookie. Są ukryte, nigdy nie akceptowane. |
|
|
Blokuj reklamy
|
block_ads | boolean |
Czy blokować żądania znanych sieci reklamowych i śledzenia. |
|
|
Pomiń pamięć podręczną
|
no_cache | boolean |
Czy wymusić odświeżenie renderowania zamiast ponownie używać identycznego renderowania z ostatnich 10 minut. |
Zwraca
Zawartość pliku zrzutu ekranu.
- Zawartość obrazu
- binary
Tworzenie pliku PDF
Drukuje stronę internetową lub blok HTML do dokumentu PDF z co najwyżej 100 stron i zwraca plik. Wyślij adres URL strony lub kod HTML, a nie oba.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL strony
|
url | string |
Adres strony do wydrukowania. Pozostaw wartość pustą podczas wysyłania kodu HTML. |
|
|
HTML
|
html | string |
Znacznik HTML do wydrukowania. Pozostaw wartość pustą po wysłaniu adresu URL strony. |
|
|
Rozmiar papieru
|
paper_format | string |
Nazwany rozmiar papieru. Gdy jest ona pusta, jest używana litera. |
|
|
Krajobraz
|
landscape | boolean |
Czy drukować w orientacji poziomej. |
|
|
Drukuj tła
|
print_background | boolean |
Czy należy uwzględnić kolory tła i obrazy, ponieważ okno dialogowe drukowania przeglądarki może. |
|
|
Górny margines (cale)
|
top | float |
Górny margines w calach. |
|
|
Prawy margines (cale)
|
right | float |
Prawy margines w calach. |
|
|
Dolny margines (cale)
|
bottom | float |
Dolny margines w calach. |
|
|
Lewy margines (cale)
|
left | float |
Lewy margines w calach. |
|
|
Nagłówek HTML
|
header_html | string |
Szablon HTML wydrukowany w górnej części każdej strony. |
|
|
Stopka HTML
|
footer_html | string |
Szablon HTML wydrukowany w dolnej części każdej strony. |
|
|
Scale
|
scale | float |
Skala wydruku, w której 1 ma rzeczywisty rozmiar. |
|
|
Poczekaj, aż
|
wait_until | string |
Gdy strona będzie zliczana jako gotowa. Bezczynność sieci czeka na zatrzymanie ruchu sieciowego. |
|
|
Ukryj banery plików cookie
|
block_cookie_banners | boolean |
Czy ukryć typowe banery zgody na pliki cookie. Są ukryte, nigdy nie akceptowane. |
|
|
Blokuj reklamy
|
block_ads | boolean |
Czy blokować żądania znanych sieci reklamowych i śledzenia. |
Zwraca
Zawartość pliku PDF.
- Zawartość pliku PDF
- binary
Uruchamianie zadania w formacie PDF
Kolejkuje plik PDF jako trwałe zadanie i zwraca je jednocześnie. Sprawdź zadanie za pomocą polecenia Pobierz zadanie renderowania, a następnie użyj polecenia Pobierz wynik zadania. Gotowy plik jest przechowywany przez 24 godziny.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz idempotentności
|
Idempotency-Key | string |
Unikatowa wartość dla tego żądania, taka jak identyfikator przebiegu przepływu. Ponowne wysłanie tego samego klucza nigdy nie powoduje utworzenia drugiego renderowania. |
|
|
Adres URL strony
|
url | string |
Adres strony do wydrukowania. Pozostaw wartość pustą podczas wysyłania kodu HTML. |
|
|
HTML
|
html | string |
Znacznik HTML do wydrukowania. Pozostaw wartość pustą po wysłaniu adresu URL strony. |
|
|
Rozmiar papieru
|
paper_format | string |
Nazwany rozmiar papieru. Gdy jest ona pusta, jest używana litera. |
|
|
Krajobraz
|
landscape | boolean |
Czy drukować w orientacji poziomej. |
|
|
Drukuj tła
|
print_background | boolean |
Czy należy uwzględnić kolory tła i obrazy, ponieważ okno dialogowe drukowania przeglądarki może. |
|
|
Górny margines (cale)
|
top | float |
Górny margines w calach. |
|
|
Prawy margines (cale)
|
right | float |
Prawy margines w calach. |
|
|
Dolny margines (cale)
|
bottom | float |
Dolny margines w calach. |
|
|
Lewy margines (cale)
|
left | float |
Lewy margines w calach. |
|
|
Nagłówek HTML
|
header_html | string |
Szablon HTML wydrukowany w górnej części każdej strony. |
|
|
Stopka HTML
|
footer_html | string |
Szablon HTML wydrukowany w dolnej części każdej strony. |
|
|
Scale
|
scale | float |
Skala wydruku, w której 1 ma rzeczywisty rozmiar. |
|
|
Poczekaj, aż
|
wait_until | string |
Gdy strona będzie zliczana jako gotowa. Bezczynność sieci czeka na zatrzymanie ruchu sieciowego. |
|
|
Ukryj banery plików cookie
|
block_cookie_banners | boolean |
Czy ukryć typowe banery zgody na pliki cookie. Są ukryte, nigdy nie akceptowane. |
|
|
Blokuj reklamy
|
block_ads | boolean |
Czy blokować żądania znanych sieci reklamowych i śledzenia. |
|
|
Odwołanie
|
external_id | string |
Własne odwołanie do zadania, maksymalnie 120 znaków. |
Zwraca
- Body
- Job
Uruchamianie zadania zrzutu ekranu
Kolejkuje zrzut ekranu jako trwałe zadanie i zwraca je jednocześnie. Sprawdź zadanie za pomocą polecenia Pobierz zadanie renderowania, a następnie użyj polecenia Pobierz wynik zadania. Gotowy plik jest przechowywany przez 24 godziny.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz idempotentności
|
Idempotency-Key | string |
Unikatowa wartość dla tego żądania, taka jak identyfikator przebiegu przepływu. Ponowne wysłanie tego samego klucza nigdy nie powoduje utworzenia drugiego renderowania. |
|
|
Adres URL strony
|
url | string |
Adres strony do przechwycenia. Pozostaw wartość pustą podczas wysyłania kodu HTML. |
|
|
HTML
|
html | string |
Znaczniki HTML do renderowania. Pozostaw wartość pustą po wysłaniu adresu URL strony. |
|
|
Format obrazu
|
format | string |
Format pliku obrazu. PLIK PNG jest bezstratny, a WebP jest zwykle najmniejszym plikiem. |
|
|
Pełna strona
|
full_page | boolean |
Czy przechwytywać całą stronę przewijaną, a nie tylko widoczny obszar. |
|
|
Szerokość
|
width | integer |
Szerokość okna przeglądarki w pikselach do 4096. |
|
|
Wysokość
|
height | integer |
Wysokość okna przeglądarki w pikselach do 4096. Jest on ignorowany w przypadku przechwytywania pełnej strony. |
|
|
Urządzenie
|
device | string |
Przechwyć stronę w postaci telefonu lub tabletu z pasującym rozmiarem ekranu i agentem użytkownika. |
|
|
Tryb nocny
|
dark_mode | boolean |
Czy strona ma być renderowana z ciemnym schematem kolorów. |
|
|
Kontrola
|
quality | integer |
Jakość obrazu z zakresu od 1 do 100 dla plików JPEG i WebP. Jest ignorowany dla png. |
|
|
Selektor elementów
|
selector | string |
Selektor CSS jednego elementu do przechwycenia zamiast całego okna. |
|
|
Opóźnienie (milisekundy)
|
delay_ms | integer |
Czas oczekiwania po załadowaniu strony przed przechwyceniem do 10000 milisekund. |
|
|
Poczekaj, aż
|
wait_until | string |
Gdy strona będzie zliczana jako gotowa. Bezczynność sieci czeka na zatrzymanie ruchu sieciowego. |
|
|
Ukryj banery plików cookie
|
block_cookie_banners | boolean |
Czy ukryć typowe banery zgody na pliki cookie. Są ukryte, nigdy nie akceptowane. |
|
|
Blokuj reklamy
|
block_ads | boolean |
Czy blokować żądania znanych sieci reklamowych i śledzenia. |
|
|
Pomiń pamięć podręczną
|
no_cache | boolean |
Czy wymusić odświeżenie renderowania zamiast ponownie używać identycznego renderowania z ostatnich 10 minut. |
|
|
Odwołanie
|
external_id | string |
Własne odwołanie do zadania, maksymalnie 120 znaków. |
Zwraca
- Body
- Job
Definicje
Job
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator zadania
|
id | string |
Identyfikator zadania. |
|
Rodzaj
|
kind | string |
Rodzaj renderowania, taki jak zrzut ekranu lub plik PDF. |
|
Status
|
status | string |
Stan zadania. Zadanie jest zakończone po pomyślnym zakończeniu, niepomyślnie lub anulowaniu. |
|
Odwołanie
|
external_id | string |
Odwołanie podane podczas uruchamiania zadania. |
|
Attempts
|
attempts | integer |
Ile razy zadanie zostało uruchomione. |
|
Utworzono w
|
created_at | date-time |
Kiedy zadanie zostało zaakceptowane. |
|
Rozpoczęto w:
|
started_at | date-time |
Kiedy zadanie zostało ostatnio uruchomione. |
|
Ukończono o
|
completed_at | date-time |
Po zakończeniu zadania. |
|
Kod błędu
|
error.code | string |
Stabilny kod błędu. |
|
Komunikat o błędzie
|
error.message | string |
Czytelny opis błędu. |
|
Typ zawartości
|
result.content_type | string |
Typ nośnika pliku wyników. |
|
Rozmiar (bajty)
|
result.bytes | integer |
Rozmiar pliku wynikowego w bajtach. |
|
Hasz SHA256
|
result.sha256 | string |
Skrót SHA-256 pliku wyników. |
|
Available
|
result.available | boolean |
Czy plik wyników nadal można pobrać. |
|
Wynik wygaśnie o godzinie
|
result.expires_at | date-time |
Po usunięciu hostowanego pliku wyników. |
|
Link pobierania
|
result.url | string |
Podpisany link do pliku wyników, który nie wymaga klucza interfejsu API. |
|
Link pobierania wygasa o godzinie
|
result.url_expires_at | date-time |
Gdy podpisany link pobierania przestanie działać. |
binarny
Jest to podstawowy typ danych "binary".