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

  1. https://portal.ironfang.comEntre ou crie uma conta gratuita lá.
  2. 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.
  3. Copie a chave, que começa com if_live_. É mostrado uma vez.
  4. 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:

  1. Adicione a ação Criar um PDF e coloque seu HTML no campo HTML. Defina o tamanho do papel como a4.
  2. 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:

  1. Comece com um gatilho de recorrência.
  2. Adicione Capturar uma captura de tela com a URL da página e ative a página inteira se desejar a página inteira.
  3. 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'.