Renderização do Ironfang (versão prévia)
O Ironfang Render transforma páginas da Web e HTML em capturas de tela e documentos PDF. Capture uma página como PNG, JPEG ou WebP, imprima uma URL ou seu próprio HTML em PDF ou enfileira um trabalho de renderização e colete o arquivo quando ele estiver pronto. Nenhum navegador a ser executado ou mantido.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Name | Ironfang |
| URL | https://ironfang.com/contact |
| hello@ironfang.com |
| Metadados do conector | |
|---|---|
| Publicador | Ironfang |
| Website | https://ironfang.com/render |
| Política de privacidade | https://ironfang.com/legal/privacy |
| Categories | Conteúdo e arquivos; Produtividade |
Renderização do Ironfang
O Ironfang Render transforma páginas da Web e HTML em capturas de tela e documentos PDF. Com esse conector, um fluxo pode capturar uma página como uma imagem, imprimir uma URL ou seu próprio HTML em PDF ou enfileirar um trabalho de renderização e coletar o arquivo quando ele estiver pronto, sem executar um navegador.
Publisher: Ironfang
Prerequisites
Você precisa de uma conta ironfang e uma chave de API. As contas são gratuitas para criar https://portal.ironfang.come cada conta inclui um subsídio gratuito mensal de renderizações. O uso além do subsídio é cobrado para sua conta do Ironfang; as taxas atuais estão em https://ironfang.com/pricing.
Operações com suporte
Capturar uma captura de tela
Renderiza uma página da Web ou um bloco de HTML e retorna a imagem como PNG, JPEG ou WebP. Escolha o tamanho da janela, capture toda a página rolável ou um único elemento, emule um telefone ou tablet, use o esquema de cores escuras e oculte faixas de cookie ou bloqueie anúncios.
Criar um PDF
Imprime uma página da Web ou um bloco de HTML em um documento PDF de até 100 páginas e retorna o arquivo. Escolha o tamanho do papel, a orientação, as margens, os planos de fundo e os modelos de cabeçalho e rodapé.
Iniciar um trabalho de captura de tela
Enfileira uma captura de tela como um trabalho durável e retorna sua ID de uma só vez. Use-o quando um fluxo não deve aguardar a renderização ou manter o arquivo disponível para etapas posteriores.
Iniciar um trabalho em PDF
Enfileira um PDF como um trabalho durável e retorna sua ID de uma vez.
Obter um trabalho de renderização
Retorna um trabalho com seu status: enfileirado, em execução, bem-sucedido, com falha ou cancelado. Um trabalho bem-sucedido inclui o tamanho e o tipo de seu arquivo e um link de download assinado; um trabalho com falha inclui o motivo.
Baixar um resultado de trabalho
Retorna ao arquivo um trabalho bem-sucedido produzido.
Obtendo credenciais
O conector é autenticado com uma chave de API Do Ironfang.
- https://portal.ironfang.comEntre ou crie uma conta gratuita lá.
- Abra as chaves de API e crie uma chave. Uma chave com apenas o escopo render:renderização é suficiente para cada ação neste conector.
- Copie a chave, que começa com if_live_. É mostrado uma vez.
- Ao criar uma conexão, cole a chave no campo de chave de API.
Introdução
Para salvar um PDF de seu próprio HTML para SharePoint:
- Adicione a ação Criar um PDF e coloque seu HTML no campo HTML. Defina o tamanho do papel como a4.
- Adicione a ação SharePoint Criar arquivo. Use um nome de arquivo que termina em .pdfe use a saída de conteúdo EM PDF de Criar um PDF como o conteúdo do arquivo.
Para capturar uma página em um agendamento:
- Comece com um gatilho de recorrência.
- Adicione Capturar uma captura de tela com a URL da página e ative a página inteira se desejar a página inteira.
- Adicione a ação OneDrive Criar arquivo com um nome de arquivo que termina em .png e a saída do conteúdo da imagem como o conteúdo do arquivo.
Para um lote longo, use Iniciar um trabalho de captura de tela ou iniciar um trabalho em PDF, em seguida, um loop Do until que executa um atraso de pelo menos 5 segundos e Obter um trabalho de renderização até que o status seja bem-sucedido, com falha ou cancelado e concluir com Baixar um resultado de trabalho.
A documentação completa da API está em https://ironfang.com/render/docs.
Problemas e limitações conhecidos
- Envie uma URL de página ou HTML em uma solicitação, não em ambos.
- Cada renderização é limitada a 30 segundos. Uma página que leva mais tempo para ficar pronta falha com um erro de renderização.
- Um PDF pode ter no máximo 100 páginas e uma imagem com no máximo 4.096 pixels de largura ou altura. Uma captura de página inteira tem no máximo 2.000 pixels de altura.
- O arquivo de um trabalho é mantido por 24 horas após o sucesso do trabalho e o link de download assinado em Obter um trabalho de renderização funciona por 15 minutos. Baixar um resultado de trabalho pode ser chamado novamente dentro de 24 horas.
- Uma conta pode executar duas renderizações por vez. Uma solicitação além disso é recusada com o status 429 e deve ser repetida após uma breve espera; em vez disso, os trabalhos esperam na fila.
- Uma solicitação idêntica dentro de 10 minutos pode retornar a renderização anterior. Ative Ignorar o cache para forçar um novo.
- As páginas por trás de uma entrada ainda não podem ser capturadas por meio desse conector.
Perguntas frequentes
Alguma coisa foi adicionada aos meus arquivos?
No. Os arquivos renderizados por meio da API não carregam nenhum selo ironfang ou marca d'água.
Onde posso obter ajuda?
Entre em contato com Ironfang em https://ironfang.com/contact ou hello@ironfang.com. O status do serviço está em https://status.ironfang.com.
Instruções de implantação
Use a CLI do Power Platform para implantar esse conector como um conector personalizado:
pac connector create --api-definition-file apiDefinition.swagger.json --api-properties-file apiProperties.json --icon-file icon.png
Em seguida, crie uma conexão com sua chave de API do Ironfang.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Name | Tipo | Descrição | Required |
|---|---|---|---|
| chave de API | secureString | Sua chave de API do Ironfang, que começa com if_live_. | True |
Ações
| Baixar um resultado de trabalho |
Retorna ao arquivo um trabalho bem-sucedido produzido. Os resultados são mantidos por 24 horas após o sucesso do trabalho. |
| Capturar uma captura de tela |
Renderiza uma página da Web ou um bloco de HTML em um navegador e retorna a imagem. Enviar uma URL ou HTML de página, não ambos. |
| Criar um PDF |
Imprime uma página da Web ou um bloco de HTML em um documento PDF de no máximo 100 páginas e retorna o arquivo. Enviar uma URL ou HTML de página, não ambos. |
| Iniciar um trabalho de captura de tela |
Enfileira uma captura de tela como um trabalho durável e retorna ao mesmo tempo. Verifique o trabalho com Obter um trabalho de renderização e, em seguida, use Baixar um resultado do trabalho. O arquivo concluído é mantido por 24 horas. |
| Iniciar um trabalho em PDF |
Enfileira um PDF como um trabalho durável e retorna ao mesmo tempo. Verifique o trabalho com Obter um trabalho de renderização e, em seguida, use Baixar um resultado do trabalho. O arquivo concluído é mantido por 24 horas. |
| Obter um trabalho de renderização |
Retorna um trabalho de renderização com seu status. Um trabalho bem-sucedido traz detalhes de seu resultado e um trabalho com falha carrega o erro. |
Baixar um resultado de trabalho
Retorna ao arquivo um trabalho bem-sucedido produzido. Os resultados são mantidos por 24 horas após o sucesso do trabalho.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do trabalho
|
id | True | string |
A ID do trabalho de renderização, conforme retornado quando ele foi iniciado. |
Retornos
O arquivo que o trabalho produziu.
- Conteúdo do arquivo
- binary
Capturar uma captura de tela
Renderiza uma página da Web ou um bloco de HTML em um navegador e retorna a imagem. Enviar uma URL ou HTML de página, não ambos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL da página
|
url | string |
O endereço da página a ser capturada. Deixe vazio quando você enviar HTML. |
|
|
HTML
|
html | string |
A marcação HTML a ser renderizada. Deixe vazio quando você enviar uma URL de página. |
|
|
Formato de imagem
|
format | string |
O formato do arquivo de imagem. O PNG não tem perda e o WebP geralmente é o menor arquivo. |
|
|
Página inteira
|
full_page | boolean |
Se deseja capturar toda a página rolável em vez de apenas a área visível. |
|
|
Largura
|
width | integer |
A largura da janela do navegador em pixels, até 4096. |
|
|
Altura
|
height | integer |
A altura da janela do navegador em pixels, até 4096. Ele é ignorado para uma captura de página inteira. |
|
|
Dispositivo
|
device | string |
Capturar a página como um telefone ou tablet a mostraria, com um tamanho de tela correspondente e um agente de usuário. |
|
|
Modo escuro
|
dark_mode | boolean |
Se a página deve ser renderizada com seu esquema de cores escuras. |
|
|
Quality
|
quality | integer |
A qualidade da imagem de 1 a 100 para JPEG e WebP. Ele é ignorado para PNG. |
|
|
Seletor de elemento
|
selector | string |
O seletor CSS de um elemento a ser capturado em vez de toda a janela. |
|
|
Atraso (milissegundos)
|
delay_ms | integer |
Quanto tempo aguardar após o carregamento da página antes da captura, até 10.000 milissegundos. |
|
|
Aguarde até
|
wait_until | string |
Quando a página conta como pronta. A rede ociosa aguarda o tráfego de rede parar. |
|
|
Ocultar faixas de cookie
|
block_cookie_banners | boolean |
Se deseja ocultar faixas comuns de consentimento de cookie. Eles estão ocultos, nunca aceitos. |
|
|
Bloquear anúncios
|
block_ads | boolean |
Se deseja bloquear solicitações para redes de publicidade e acompanhamento conhecidas. |
|
|
Ignorar o cache
|
no_cache | boolean |
Se deve forçar uma nova renderização em vez de reutilizar uma idêntica dos últimos 10 minutos. |
Retornos
O conteúdo do arquivo de captura de tela.
- Conteúdo da imagem
- binary
Criar um PDF
Imprime uma página da Web ou um bloco de HTML em um documento PDF de no máximo 100 páginas e retorna o arquivo. Enviar uma URL ou HTML de página, não ambos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL da página
|
url | string |
O endereço da página a ser impressa. Deixe vazio quando você enviar HTML. |
|
|
HTML
|
html | string |
A marcação HTML a ser impressa. Deixe vazio quando você enviar uma URL de página. |
|
|
Tamanho do papel
|
paper_format | string |
O tamanho do papel nomeado. Quando estiver vazio, a letra será usada. |
|
|
Paisagem
|
landscape | boolean |
Se deseja imprimir na orientação paisagem. |
|
|
Imprimir planos de fundo
|
print_background | boolean |
Se deve incluir cores e imagens de plano de fundo, como uma caixa de diálogo de impressão do navegador pode. |
|
|
Margem superior (polegadas)
|
top | float |
A margem superior em polegadas. |
|
|
Margem direita (polegadas)
|
right | float |
A margem direita em polegadas. |
|
|
Margem inferior (polegadas)
|
bottom | float |
A margem inferior em polegadas. |
|
|
Margem esquerda (polegadas)
|
left | float |
A margem esquerda em polegadas. |
|
|
HTML do cabeçalho
|
header_html | string |
O modelo HTML impresso na parte superior de cada página. |
|
|
HTML do rodapé
|
footer_html | string |
O modelo HTML impresso na parte inferior de cada página. |
|
|
Escala
|
scale | float |
A escala de impressão, em que 1 é o tamanho real. |
|
|
Aguarde até
|
wait_until | string |
Quando a página conta como pronta. A rede ociosa aguarda o tráfego de rede parar. |
|
|
Ocultar faixas de cookie
|
block_cookie_banners | boolean |
Se deseja ocultar faixas comuns de consentimento de cookie. Eles estão ocultos, nunca aceitos. |
|
|
Bloquear anúncios
|
block_ads | boolean |
Se deseja bloquear solicitações para redes de publicidade e acompanhamento conhecidas. |
Retornos
O conteúdo do arquivo PDF.
- Conteúdo em PDF
- binary
Iniciar um trabalho de captura de tela
Enfileira uma captura de tela como um trabalho durável e retorna ao mesmo tempo. Verifique o trabalho com Obter um trabalho de renderização e, em seguida, use Baixar um resultado do trabalho. O arquivo concluído é mantido por 24 horas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de Idempotency
|
Idempotency-Key | string |
Um valor exclusivo para essa solicitação, como a ID de execução de fluxo. Enviar a mesma chave novamente nunca cria uma segunda renderização. |
|
|
URL da página
|
url | string |
O endereço da página a ser capturada. Deixe vazio quando você enviar HTML. |
|
|
HTML
|
html | string |
A marcação HTML a ser renderizada. Deixe vazio quando você enviar uma URL de página. |
|
|
Formato de imagem
|
format | string |
O formato do arquivo de imagem. O PNG não tem perda e o WebP geralmente é o menor arquivo. |
|
|
Página inteira
|
full_page | boolean |
Se deseja capturar toda a página rolável em vez de apenas a área visível. |
|
|
Largura
|
width | integer |
A largura da janela do navegador em pixels, até 4096. |
|
|
Altura
|
height | integer |
A altura da janela do navegador em pixels, até 4096. Ele é ignorado para uma captura de página inteira. |
|
|
Dispositivo
|
device | string |
Capturar a página como um telefone ou tablet a mostraria, com um tamanho de tela correspondente e um agente de usuário. |
|
|
Modo escuro
|
dark_mode | boolean |
Se a página deve ser renderizada com seu esquema de cores escuras. |
|
|
Quality
|
quality | integer |
A qualidade da imagem de 1 a 100 para JPEG e WebP. Ele é ignorado para PNG. |
|
|
Seletor de elemento
|
selector | string |
O seletor CSS de um elemento a ser capturado em vez de toda a janela. |
|
|
Atraso (milissegundos)
|
delay_ms | integer |
Quanto tempo aguardar após o carregamento da página antes da captura, até 10.000 milissegundos. |
|
|
Aguarde até
|
wait_until | string |
Quando a página conta como pronta. A rede ociosa aguarda o tráfego de rede parar. |
|
|
Ocultar faixas de cookie
|
block_cookie_banners | boolean |
Se deseja ocultar faixas comuns de consentimento de cookie. Eles estão ocultos, nunca aceitos. |
|
|
Bloquear anúncios
|
block_ads | boolean |
Se deseja bloquear solicitações para redes de publicidade e acompanhamento conhecidas. |
|
|
Ignorar o cache
|
no_cache | boolean |
Se deve forçar uma nova renderização em vez de reutilizar uma idêntica dos últimos 10 minutos. |
|
|
Sua referência
|
external_id | string |
Sua própria referência para o trabalho, até 120 caracteres. |
Retornos
- Corpo
- Job
Iniciar um trabalho em PDF
Enfileira um PDF como um trabalho durável e retorna ao mesmo tempo. Verifique o trabalho com Obter um trabalho de renderização e, em seguida, use Baixar um resultado do trabalho. O arquivo concluído é mantido por 24 horas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de Idempotency
|
Idempotency-Key | string |
Um valor exclusivo para essa solicitação, como a ID de execução de fluxo. Enviar a mesma chave novamente nunca cria uma segunda renderização. |
|
|
URL da página
|
url | string |
O endereço da página a ser impressa. Deixe vazio quando você enviar HTML. |
|
|
HTML
|
html | string |
A marcação HTML a ser impressa. Deixe vazio quando você enviar uma URL de página. |
|
|
Tamanho do papel
|
paper_format | string |
O tamanho do papel nomeado. Quando estiver vazio, a letra será usada. |
|
|
Paisagem
|
landscape | boolean |
Se deseja imprimir na orientação paisagem. |
|
|
Imprimir planos de fundo
|
print_background | boolean |
Se deve incluir cores e imagens de plano de fundo, como uma caixa de diálogo de impressão do navegador pode. |
|
|
Margem superior (polegadas)
|
top | float |
A margem superior em polegadas. |
|
|
Margem direita (polegadas)
|
right | float |
A margem direita em polegadas. |
|
|
Margem inferior (polegadas)
|
bottom | float |
A margem inferior em polegadas. |
|
|
Margem esquerda (polegadas)
|
left | float |
A margem esquerda em polegadas. |
|
|
HTML do cabeçalho
|
header_html | string |
O modelo HTML impresso na parte superior de cada página. |
|
|
HTML do rodapé
|
footer_html | string |
O modelo HTML impresso na parte inferior de cada página. |
|
|
Escala
|
scale | float |
A escala de impressão, em que 1 é o tamanho real. |
|
|
Aguarde até
|
wait_until | string |
Quando a página conta como pronta. A rede ociosa aguarda o tráfego de rede parar. |
|
|
Ocultar faixas de cookie
|
block_cookie_banners | boolean |
Se deseja ocultar faixas comuns de consentimento de cookie. Eles estão ocultos, nunca aceitos. |
|
|
Bloquear anúncios
|
block_ads | boolean |
Se deseja bloquear solicitações para redes de publicidade e acompanhamento conhecidas. |
|
|
Sua referência
|
external_id | string |
Sua própria referência para o trabalho, até 120 caracteres. |
Retornos
- Corpo
- Job
Obter um trabalho de renderização
Retorna um trabalho de renderização com seu status. Um trabalho bem-sucedido traz detalhes de seu resultado e um trabalho com falha carrega o erro.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do trabalho
|
id | True | string |
A ID do trabalho de renderização, conforme retornado quando ele foi iniciado. |
Retornos
- Corpo
- Job
Definições
Job
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do trabalho
|
id | string |
A ID do trabalho. |
|
Variante
|
kind | string |
O tipo de renderização, como captura de tela ou pdf. |
|
Status
|
status | string |
O status do trabalho. Um trabalho é concluído quando é bem-sucedido, com falha ou cancelado. |
|
Sua referência
|
external_id | string |
A referência fornecida quando o trabalho foi iniciado. |
|
Tentativas
|
attempts | integer |
Quantas vezes o trabalho foi executado. |
|
Criado em
|
created_at | date-time |
Quando o trabalho foi aceito. |
|
Iniciado em
|
started_at | date-time |
Quando o trabalho começou a ser executado pela última vez. |
|
Concluído em
|
completed_at | date-time |
Quando o trabalho terminou. |
|
Código de erro
|
error.code | string |
Um código estável para a falha. |
|
Mensagem de erro
|
error.message | string |
Uma descrição legível da falha. |
|
Tipo de conteúdo
|
result.content_type | string |
O tipo de mídia do arquivo de resultado. |
|
Tamanho (bytes)
|
result.bytes | integer |
O tamanho do arquivo de resultado em bytes. |
|
Hash de SHA256
|
result.sha256 | string |
O hash SHA-256 do arquivo de resultado. |
|
Available
|
result.available | boolean |
Se o arquivo de resultado ainda pode ser baixado. |
|
O resultado expira em
|
result.expires_at | date-time |
Quando o arquivo de resultado hospedado é excluído. |
|
Baixar link
|
result.url | string |
Um link assinado para o arquivo de resultado que não precisa de nenhuma chave de API. |
|
O link de download expira em
|
result.url_expires_at | date-time |
Quando o link de download assinado parar de funcionar. |
binário
Esse é o tipo de dados básico 'binary'.