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
Email 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.

  1. Connectez-vous à l’adresse https://portal.ironfang.com, ou créez un compte gratuit là-bas.
  2. 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.
  3. Copiez la clé, qui commence par if_live_. Il est affiché une seule fois.
  4. 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 :

  1. 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.
  2. 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 :

  1. Commencez par un déclencheur de périodicité.
  2. 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.
  3. 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".