Rendu Ironfang (préversion)
Ironfang Render transforme les pages web et HTML en captures d’écran et documents PDF. Capturez une page sous la forme PNG, JPEG ou WebP, imprimez une URL ou votre propre code HTML au format PDF, ou mettez en file d’attente un travail de rendu et collectez le fichier lorsqu’il est prêt. Aucun navigateur à exécuter ou à gérer.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Ironfang |
| URL | https://ironfang.com/contact |
| hello@ironfang.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Ironfang |
| Website | https://ironfang.com/render |
| Politique de confidentialité | https://ironfang.com/legal/privacy |
| Categories | Contenu et fichiers ; Productivité |
Rendu ironfang
Ironfang Render transforme les pages web et HTML en captures d’écran et documents PDF. Avec ce connecteur, un flux peut capturer une page en tant qu’image, imprimer une URL ou son propre code HTML au format PDF, ou mettre en file d’attente un travail de rendu et collecter le fichier lorsqu’il est prêt, sans exécuter de navigateur.
Publisher : Ironfang
Prerequisites
Vous avez besoin d’un compte Ironfang et d’une clé API. Les comptes sont gratuits à créer à l’adresse https://portal.ironfang.com, et chaque compte inclut une allocation gratuite mensuelle de rendu. L’utilisation au-delà de l’allocation est facturée à votre compte Ironfang ; les taux actuels sont à https://ironfang.com/pricing.
Opérations prises en charge
Capture d’écran
Affiche une page web ou un bloc de CODE HTML et retourne l’image en tant que PNG, JPEG ou WebP. Choisissez la taille de la fenêtre, capturez l’ensemble de la page défilante ou d’un seul élément, émulez un téléphone ou une tablette, utilisez le jeu de couleurs foncées et masquez les bannières de cookie ou les publicités de bloc.
Créer un PDF
Imprime une page web ou un bloc de CODE HTML dans un document PDF d’un maximum de 100 pages et retourne le fichier. Choisissez le format de papier, l’orientation, les marges, les arrière-plans et les modèles d’en-tête et de pied de page.
Démarrer un travail de capture d’écran
Met en file d’attente une capture d’écran en tant que travail durable et retourne son ID à la fois. Utilisez-le lorsqu’un flux ne doit pas attendre le rendu ou conserver le fichier disponible pour les étapes ultérieures.
Démarrer un travail PDF
Met en file d’attente un fichier PDF en tant que travail durable et retourne son ID en même temps.
Obtenir un travail de rendu
Retourne un travail avec son état : mis en file d’attente, en cours d’exécution, réussi, échoué ou annulé. Un travail réussi inclut la taille et le type de son fichier et un lien de téléchargement signé ; un travail ayant échoué inclut la raison.
Télécharger un résultat de travail
Retourne le fichier généré par un travail réussi.
Obtention des informations d’identification
Le connecteur s’authentifie avec une clé API Ironfang.
- Connectez-vous à l’adresse https://portal.ironfang.com, ou créez un compte gratuit là-bas.
- Ouvrez les clés API et créez une clé. Une clé avec uniquement l’étendue render :render est suffisante pour chaque action de ce connecteur.
- Copiez la clé, qui commence par if_live_. Il est affiché une seule fois.
- Lorsque vous créez une connexion, collez la clé dans le champ clé API.
Getting Started
Pour enregistrer un fichier PDF de votre propre code HTML dans SharePoint :
- Ajoutez l’action Créer un fichier PDF et placez votre code HTML dans le champ HTML. Définissez la taille du papier sur a4.
- Ajoutez l’action SharePoint Créer un fichier. Utilisez un nom de fichier se terminant par .pdfet utilisez la sortie de contenu PDF de Créer un fichier PDF comme contenu de fichier.
Pour capturer une page selon une planification :
- Commencez par un déclencheur de périodicité.
- Ajoutez capturez une capture d’écran avec l’URL de la page, puis activez la page complète si vous souhaitez que la page entière soit entière.
- Ajoutez le OneDrive Créer une action de fichier avec un nom de fichier se terminant par .png et la sortie du contenu de l’image en tant que contenu du fichier.
Pour un lot long, utilisez Démarrer un travail de capture d’écran ou Démarrer un travail PDF, puis une boucle Do jusqu’à ce qu’une boucle exécute un délai d’au moins 5 secondes et obtenez un travail de rendu jusqu’à ce que l’état soit réussi, échoué ou annulé, puis terminez par télécharger un résultat de travail.
La documentation complète de l’API est à l’adresse https://ironfang.com/render/docs.
Problèmes connus et limitations
- Envoyez une URL de page ou du code HTML dans une requête, et non les deux.
- Chaque rendu est limité à 30 secondes. Une page qui prend plus de temps pour devenir prête échoue avec une erreur de rendu.
- Un fichier PDF peut comporter au maximum 100 pages et une image de plus de 4 096 pixels de largeur ou de hauteur. Une capture de page complète est d’une hauteur de 2 0000 pixels.
- Le fichier d’un travail est conservé pendant 24 heures après la réussite du travail, et le lien de téléchargement signé dans Obtenir un travail de rendu fonctionne pendant 15 minutes. Le téléchargement d’un résultat de travail peut être appelé à nouveau dans les 24 heures.
- Un compte peut exécuter deux rendus à la fois. Une demande au-delà de ce qui est refusée avec l’état 429 et doit être retentée après une courte attente ; les travaux attendent dans la file d’attente à la place.
- Une requête identique dans les 10 minutes peut retourner le rendu précédent. Activez Skip the cache to force a new one.
- Les pages derrière une connexion ne peuvent pas encore être capturées via ce connecteur.
Questions fréquentes
Est-ce que quelque chose est ajouté à mes fichiers ?
Non. Les fichiers rendus par le biais de l’API ne comportent aucun badge Ironfang ni filigrane.
Où puis-je obtenir de l’aide ?
Contactez Ironfang à https://ironfang.com/contact ou hello@ironfang.com. L’état du service est à https://status.ironfang.com.
Instructions de déploiement
Utilisez l’interface CLI Power Platform pour déployer ce connecteur en tant que connecteur personnalisé :
pac connector create --api-definition-file apiDefinition.swagger.json --api-properties-file apiProperties.json --icon-file icon.png
Créez ensuite une connexion avec votre clé API Ironfang.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.
| Name | Type | Description | Required |
|---|---|---|---|
| Clé API | Securestring | Votre clé API Ironfang, qui commence par if_live_. | True |
Actions
| Capture d’écran |
Affiche une page web ou un bloc de code HTML dans un navigateur et retourne l’image. Envoyez une URL de page ou du code HTML, et non les deux. |
| Créer un PDF |
Imprime une page web ou un bloc de CODE HTML dans un document PDF d’au plus 100 pages et retourne le fichier. Envoyez une URL de page ou du code HTML, et non les deux. |
| Démarrer un travail de capture d’écran |
Met en file d’attente une capture d’écran en tant que travail durable et retourne à la fois. Vérifiez le travail avec Obtenir un travail de rendu, puis utilisez Télécharger un résultat de travail. Le fichier terminé est conservé pendant 24 heures. |
| Démarrer un travail PDF |
Met en file d’attente un fichier PDF en tant que travail durable et retourne à la fois. Vérifiez le travail avec Obtenir un travail de rendu, puis utilisez Télécharger un résultat de travail. Le fichier terminé est conservé pendant 24 heures. |
| Obtenir un travail de rendu |
Retourne un travail de rendu avec son état. Un travail réussi contient les détails de son résultat, et un travail ayant échoué porte l’erreur. |
| Télécharger un résultat de travail |
Retourne le fichier généré par un travail réussi. Les résultats sont conservés pendant 24 heures après la réussite du travail. |
Capture d’écran
Affiche une page web ou un bloc de code HTML dans un navigateur et retourne l’image. Envoyez une URL de page ou du code HTML, et non les deux.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URL de la page
|
url | string |
Adresse de la page à capturer. Laissez vide lorsque vous envoyez du code HTML. |
|
|
HTML
|
html | string |
Balisage HTML à afficher. Laissez vide lorsque vous envoyez une URL de page. |
|
|
Format d’image
|
format | string |
Format du fichier image. PNG est sans perte et WebP est généralement le plus petit fichier. |
|
|
Page complète
|
full_page | boolean |
Indique s’il faut capturer l’intégralité de la page défilante au lieu de la zone visible uniquement. |
|
|
Largeur
|
width | integer |
Largeur de la fenêtre du navigateur en pixels, jusqu’à 4096. |
|
|
Hauteur
|
height | integer |
Hauteur de la fenêtre du navigateur en pixels, jusqu’à 4096. Elle est ignorée pour une capture de page complète. |
|
|
Appareil
|
device | string |
Capturez la page sous la forme d’un téléphone ou d’une tablette, avec une taille d’écran et un agent utilisateur correspondants. |
|
|
Mode sombre
|
dark_mode | boolean |
Indique s’il faut restituer la page avec son jeu de couleurs foncées. |
|
|
Qualité
|
quality | integer |
Qualité de l’image comprise entre 1 et 100 pour JPEG et WebP. Il est ignoré pour PNG. |
|
|
Sélecteur d’élément
|
selector | string |
Sélecteur CSS d’un élément à capturer au lieu de la fenêtre entière. |
|
|
Délai (millisecondes)
|
delay_ms | integer |
Durée d’attente après le chargement de la page avant la capture, jusqu’à 1 0000 millisecondes. |
|
|
Patientez jusqu’à ce que
|
wait_until | string |
Lorsque la page compte comme prête. L’inactivité du réseau attend que le trafic réseau s’arrête. |
|
|
Masquer les bannières de cookie
|
block_cookie_banners | boolean |
Indique s’il faut masquer les bannières de consentement de cookie courantes. Ils sont cachés, jamais acceptés. |
|
|
Bloquer les publicités
|
block_ads | boolean |
Indique s’il faut bloquer les demandes adressées aux réseaux de publicité et de suivi connus. |
|
|
Ignorer le cache
|
no_cache | boolean |
Indique s’il faut forcer un nouveau rendu au lieu de réutiliser un rendu identique des 10 dernières minutes. |
Retours
Contenu du fichier de capture d’écran.
- Contenu du fichier image
- binary
Créer un PDF
Imprime une page web ou un bloc de CODE HTML dans un document PDF d’au plus 100 pages et retourne le fichier. Envoyez une URL de page ou du code HTML, et non les deux.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URL de la page
|
url | string |
Adresse de la page à imprimer. Laissez vide lorsque vous envoyez du code HTML. |
|
|
HTML
|
html | string |
Balisage HTML à imprimer. Laissez vide lorsque vous envoyez une URL de page. |
|
|
Taille du papier
|
paper_format | string |
Format de papier nommé. Lorsqu’elle est vide, la lettre est utilisée. |
|
|
Paysage
|
landscape | boolean |
Indique s’il faut imprimer en orientation paysage. |
|
|
Imprimer des arrière-plans
|
print_background | boolean |
Indique s’il faut inclure des couleurs et des images d’arrière-plan, car une boîte de dialogue d’impression du navigateur peut. |
|
|
Marge supérieure (pouces)
|
top | float |
Marge supérieure en pouces. |
|
|
Marge droite (pouces)
|
right | float |
Marge droite en pouces. |
|
|
Marge inférieure (pouces)
|
bottom | float |
Marge inférieure en pouces. |
|
|
Marge gauche (pouces)
|
left | float |
Marge gauche en pouces. |
|
|
Html d’en-tête
|
header_html | string |
Modèle HTML imprimé en haut de chaque page. |
|
|
Code HTML du pied de page
|
footer_html | string |
Modèle HTML imprimé en bas de chaque page. |
|
|
Scale
|
scale | float |
Échelle d’impression, où 1 est une taille réelle. |
|
|
Patientez jusqu’à ce que
|
wait_until | string |
Lorsque la page compte comme prête. L’inactivité du réseau attend que le trafic réseau s’arrête. |
|
|
Masquer les bannières de cookie
|
block_cookie_banners | boolean |
Indique s’il faut masquer les bannières de consentement de cookie courantes. Ils sont cachés, jamais acceptés. |
|
|
Bloquer les publicités
|
block_ads | boolean |
Indique s’il faut bloquer les demandes adressées aux réseaux de publicité et de suivi connus. |
Retours
Contenu du fichier PDF.
- Contenu PDF
- binary
Démarrer un travail de capture d’écran
Met en file d’attente une capture d’écran en tant que travail durable et retourne à la fois. Vérifiez le travail avec Obtenir un travail de rendu, puis utilisez Télécharger un résultat de travail. Le fichier terminé est conservé pendant 24 heures.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Clé d’Idempotency
|
Idempotency-Key | string |
Valeur unique pour cette requête, telle que l’ID d’exécution du flux. L’envoi de la même clé ne crée plus jamais de deuxième rendu. |
|
|
URL de la page
|
url | string |
Adresse de la page à capturer. Laissez vide lorsque vous envoyez du code HTML. |
|
|
HTML
|
html | string |
Balisage HTML à afficher. Laissez vide lorsque vous envoyez une URL de page. |
|
|
Format d’image
|
format | string |
Format du fichier image. PNG est sans perte et WebP est généralement le plus petit fichier. |
|
|
Page complète
|
full_page | boolean |
Indique s’il faut capturer l’intégralité de la page défilante au lieu de la zone visible uniquement. |
|
|
Largeur
|
width | integer |
Largeur de la fenêtre du navigateur en pixels, jusqu’à 4096. |
|
|
Hauteur
|
height | integer |
Hauteur de la fenêtre du navigateur en pixels, jusqu’à 4096. Elle est ignorée pour une capture de page complète. |
|
|
Appareil
|
device | string |
Capturez la page sous la forme d’un téléphone ou d’une tablette, avec une taille d’écran et un agent utilisateur correspondants. |
|
|
Mode sombre
|
dark_mode | boolean |
Indique s’il faut restituer la page avec son jeu de couleurs foncées. |
|
|
Qualité
|
quality | integer |
Qualité de l’image comprise entre 1 et 100 pour JPEG et WebP. Il est ignoré pour PNG. |
|
|
Sélecteur d’élément
|
selector | string |
Sélecteur CSS d’un élément à capturer au lieu de la fenêtre entière. |
|
|
Délai (millisecondes)
|
delay_ms | integer |
Durée d’attente après le chargement de la page avant la capture, jusqu’à 1 0000 millisecondes. |
|
|
Patientez jusqu’à ce que
|
wait_until | string |
Lorsque la page compte comme prête. L’inactivité du réseau attend que le trafic réseau s’arrête. |
|
|
Masquer les bannières de cookie
|
block_cookie_banners | boolean |
Indique s’il faut masquer les bannières de consentement de cookie courantes. Ils sont cachés, jamais acceptés. |
|
|
Bloquer les publicités
|
block_ads | boolean |
Indique s’il faut bloquer les demandes adressées aux réseaux de publicité et de suivi connus. |
|
|
Ignorer le cache
|
no_cache | boolean |
Indique s’il faut forcer un nouveau rendu au lieu de réutiliser un rendu identique des 10 dernières minutes. |
|
|
Votre référence
|
external_id | string |
Votre propre référence pour le travail, jusqu’à 120 caractères. |
Retours
- Body
- Job
Démarrer un travail PDF
Met en file d’attente un fichier PDF en tant que travail durable et retourne à la fois. Vérifiez le travail avec Obtenir un travail de rendu, puis utilisez Télécharger un résultat de travail. Le fichier terminé est conservé pendant 24 heures.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Clé d’Idempotency
|
Idempotency-Key | string |
Valeur unique pour cette requête, telle que l’ID d’exécution du flux. L’envoi de la même clé ne crée plus jamais de deuxième rendu. |
|
|
URL de la page
|
url | string |
Adresse de la page à imprimer. Laissez vide lorsque vous envoyez du code HTML. |
|
|
HTML
|
html | string |
Balisage HTML à imprimer. Laissez vide lorsque vous envoyez une URL de page. |
|
|
Taille du papier
|
paper_format | string |
Format de papier nommé. Lorsqu’elle est vide, la lettre est utilisée. |
|
|
Paysage
|
landscape | boolean |
Indique s’il faut imprimer en orientation paysage. |
|
|
Imprimer des arrière-plans
|
print_background | boolean |
Indique s’il faut inclure des couleurs et des images d’arrière-plan, car une boîte de dialogue d’impression du navigateur peut. |
|
|
Marge supérieure (pouces)
|
top | float |
Marge supérieure en pouces. |
|
|
Marge droite (pouces)
|
right | float |
Marge droite en pouces. |
|
|
Marge inférieure (pouces)
|
bottom | float |
Marge inférieure en pouces. |
|
|
Marge gauche (pouces)
|
left | float |
Marge gauche en pouces. |
|
|
Html d’en-tête
|
header_html | string |
Modèle HTML imprimé en haut de chaque page. |
|
|
Code HTML du pied de page
|
footer_html | string |
Modèle HTML imprimé en bas de chaque page. |
|
|
Scale
|
scale | float |
Échelle d’impression, où 1 est une taille réelle. |
|
|
Patientez jusqu’à ce que
|
wait_until | string |
Lorsque la page compte comme prête. L’inactivité du réseau attend que le trafic réseau s’arrête. |
|
|
Masquer les bannières de cookie
|
block_cookie_banners | boolean |
Indique s’il faut masquer les bannières de consentement de cookie courantes. Ils sont cachés, jamais acceptés. |
|
|
Bloquer les publicités
|
block_ads | boolean |
Indique s’il faut bloquer les demandes adressées aux réseaux de publicité et de suivi connus. |
|
|
Votre référence
|
external_id | string |
Votre propre référence pour le travail, jusqu’à 120 caractères. |
Retours
- Body
- Job
Obtenir un travail de rendu
Retourne un travail de rendu avec son état. Un travail réussi contient les détails de son résultat, et un travail ayant échoué porte l’erreur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de travail
|
id | True | string |
ID du travail de rendu, tel qu’il a été retourné lors du démarrage. |
Retours
- Body
- Job
Télécharger un résultat de travail
Retourne le fichier généré par un travail réussi. Les résultats sont conservés pendant 24 heures après la réussite du travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de travail
|
id | True | string |
ID du travail de rendu, tel qu’il a été retourné lors du démarrage. |
Retours
Fichier généré par le travail.
- Contenu du fichier
- binary
Définitions
Job
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de travail
|
id | string |
ID du travail. |
|
Type
|
kind | string |
Type de rendu, tel que capture d’écran ou pdf. |
|
Status
|
status | string |
État du travail. Un travail est terminé lorsqu’il a réussi, échoué ou annulé. |
|
Votre référence
|
external_id | string |
Référence donnée lors du démarrage du travail. |
|
Tentatives
|
attempts | integer |
Combien de fois le travail a été exécuté. |
|
Créé à
|
created_at | date-time |
Quand le travail a été accepté. |
|
Démarré à l’adresse
|
started_at | date-time |
Lorsque le travail a commencé à s’exécuter pour la dernière fois. |
|
Terminé à
|
completed_at | date-time |
Une fois le travail terminé. |
|
Code d’erreur
|
error.code | string |
Code stable pour l’échec. |
|
Message d’erreur
|
error.message | string |
Description lisible de l’échec. |
|
Type de contenu
|
result.content_type | string |
Type de média du fichier de résultats. |
|
Taille (octets)
|
result.bytes | integer |
Taille du fichier de résultats en octets. |
|
Hachage SHA-256
|
result.sha256 | string |
Hachage SHA-256 du fichier de résultats. |
|
Available
|
result.available | boolean |
Indique si le fichier de résultats peut toujours être téléchargé. |
|
Le résultat expire à
|
result.expires_at | date-time |
Lorsque le fichier de résultats hébergé est supprimé. |
|
Lien de téléchargement
|
result.url | string |
Lien signé vers le fichier de résultats qui n’a besoin d’aucune clé API. |
|
Le lien de téléchargement expire à l’adresse
|
result.url_expires_at | date-time |
Lorsque le lien de téléchargement signé cesse de fonctionner. |
binary
Il s’agit du type de données de base "binaire".