Ironfang Render (Pré-visualização)

O Ironfang Render transforma páginas web e HTML em capturas de ecrã e documentos PDF. Captura uma página em PNG, JPEG ou WebP, imprime um URL ou o teu próprio HTML para PDF, ou coloca uma tarefa de renderização e recolhe o ficheiro quando estiver pronto. Sem navegador para correr ou manter.

Este conector está disponível nos seguintes produtos e regiões:

Service Classe Regiões
Estúdio Copiloto Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões Azure Government
     - 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 (CCG)
     - 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 (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contact
Name Ironfang
URL https://ironfang.com/contact
Email hello@ironfang.com
Metadados do conector
Publisher Ironfang
Website https://ironfang.com/render
Política de privacidade https://ironfang.com/legal/privacy
Categories Conteúdos e Ficheiros; Produtividade

Ironfang Render

O Ironfang Render transforma páginas web e HTML em capturas de ecrã e documentos PDF. Com este conector, um fluxo pode capturar uma página como imagem, imprimir uma URL ou o seu próprio HTML para PDF, ou colocar um trabalho de renderização em fila e recolher o ficheiro quando estiver pronto, sem ter de correr um navegador.

Publisher: Ironfang

Prerequisites

Precisas de uma conta Ironfang e de uma chave API. As contas são gratuitas para criar em https://portal.ironfang.com, e cada conta inclui uma mensalidade gratuita de renderizações. O uso para além da autorização é faturado na sua conta Ironfang; as tarifas atuais estão em https://ironfang.com/pricing.

Operações suportadas

Capturar uma captura de tela

Renderiza uma página web ou um bloco de HTML e devolve a imagem como PNG, JPEG ou WebP. Escolha o tamanho da janela, capture toda a página deslizável ou um único elemento, emule um telemóvel ou tablet, use o esquema de cores escuras e oculte banners de cookies ou bloqueie anúncios.

Criar um PDF

Imprime uma página web ou um bloco de HTML num documento PDF com até 100 páginas e devolve o ficheiro. Escolha o tamanho do papel, orientação, margens, fundos e modelos de cabeçalho e rodapé.

Comece um trabalho de captura de ecrã

Coloca uma captura de ecrã como trabalho durável e devolve o ID imediatamente. Use-o quando um fluxo não deve esperar pela renderização, ou para manter o ficheiro disponível para passos posteriores.

Comece um emprego em PDF

Coloca um PDF em fila como um trabalho durável e devolve o seu ID imediatamente.

Arranja um trabalho de renderização

Devolve uma tarefa com o seu estado: em fila, em execução, bem-sucedido, falhado ou cancelado. Um trabalho bem-sucedido inclui o tamanho e tipo do seu ficheiro e um link de download assinado; um trabalho falhado inclui a razão.

Descarregar um resultado de emprego

Devolve o ficheiro como um trabalho bem-sucedido produzido.

Obtenção de credenciais

O conector autentica-se com uma chave API Ironfang.

  1. Inicia sessão em https://portal.ironfang.com, ou cria uma conta gratuita lá.
  2. Abre chaves API e cria uma chave. Uma chave apenas com o escopo render:render é suficiente para todas as ações neste conector.
  3. Copia a chave, que começa por if_live_. É mostrado uma vez.
  4. Quando criar uma ligação, cole a chave no campo da chave API.

Introdução

Para guardar um PDF do seu próprio HTML no SharePoint:

  1. Adicione a ação Criar um PDF e coloque o seu HTML no campo HTML. Define o tamanho do papel para a4.
  2. Adicionar a ação Criar ficheiro do SharePoint. Use um nome de ficheiro que termine em .pdf, e use a saída de conteúdo PDF de Criar um PDF como conteúdo do ficheiro.

Para captar uma página num cronograma:

  1. Comece com um gatilho de recorrência.
  2. Adiciona o Capture de uma captura de ecrã com a URL da página, e ativa a página completa se quiseres a página completa.
  3. Adicione a ação OneDrive Criar ficheiro com um nome de ficheiro a terminar em .png e a saída de conteúdo da imagem como conteúdo do ficheiro.

Para um lote longo, usa Iniciar um trabalho de captura de ecrã ou Iniciar um trabalho PDF, depois um ciclo Fazer até que execute um atraso de pelo menos 5 segundos e Obter um trabalho de renderização até o estado ser bem-sucedido, falhado ou cancelado, e terminar com Descarregar um resultado de trabalho.

A documentação completa da API encontra-se em https://ironfang.com/render/docs.

Problemas conhecidos e limitações

  • Envie uma URL de página ou HTML num pedido, não ambos.
  • Cada renderização está limitada a 30 segundos. Uma página que demora mais a ficar pronta falha com um erro de renderização.
  • Um PDF pode ter no máximo 100 páginas, e uma imagem no máximo 4096 píxeis de largura ou altura. Uma captura de página inteira tem no máximo 20.000 pixels de altura.
  • O ficheiro de um job é mantido durante 24 horas após o sucesso do job, e o link de download assinado em Get a render job funciona durante 15 minutos. Descarregar um resultado de trabalho pode ser chamado novamente dentro das 24 horas.
  • Uma conta pode executar dois renders ao mesmo tempo. Um pedido além disso é recusado com o estado 429 e deve ser retentado após uma curta espera; os trabalhos ficam na fila em vez disso.
  • Um pedido idêntico dentro de 10 minutos pode devolver a renderização anterior. Ativar Saltar a cache para forçar uma nova.
  • As páginas atrás de um login ainda não podem ser captadas através deste conector.

Perguntas Mais Frequentes

Alguma coisa é adicionada aos meus ficheiros?

No. Os ficheiros renderizados através da API não têm qualquer emblema Ironfang ou marca de água.

Onde posso obter ajuda?

Contacte a Ironfang em https://ironfang.com/contact ou hello@ironfang.com. O estado do serviço é em https://status.ironfang.com.

Instruções de implantação

Use a Power Platform CLI para implementar este conector como um conector personalizado:

pac connector create --api-definition-file apiDefinition.swagger.json --api-properties-file apiProperties.json --icon-file icon.png

Depois cria uma ligação com a tua chave API do Ironfang.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Name Tipo Description Required
chave de API securestring A tua chave API do Ironfang, que começa por if_live_. True

Ações

Arranja um trabalho de renderização

Devolve um trabalho de renderização com o seu estado. Uma tarefa bem-sucedida contém detalhes do seu resultado, e uma tarefa falhada carrega o erro.

Capturar uma captura de tela

Renderiza uma página web ou um bloco de HTML num navegador e devolve a imagem. Envie uma URL de página ou HTML, não ambos.

Comece um emprego em PDF

Coloca um PDF em fila como trabalho durável e devolve imediatamente. Verifica o trabalho com Obter um trabalho de renderização, depois usar Descarregar um resultado do trabalho. O ficheiro final é guardado durante 24 horas.

Comece um trabalho de captura de ecrã

Coloca uma captura de ecrã como trabalho durável e devolve imediatamente. Verifica o trabalho com Obter um trabalho de renderização, depois usar Descarregar um resultado do trabalho. O ficheiro final é guardado durante 24 horas.

Criar um PDF

Imprime uma página web ou um bloco de HTML num documento PDF com no máximo 100 páginas e devolve o ficheiro. Envie uma URL de página ou HTML, não ambos.

Descarregar um resultado de emprego

Devolve o ficheiro como um trabalho bem-sucedido produzido. Os resultados são mantidos durante 24 horas após o sucesso do trabalho.

Arranja um trabalho de renderização

Devolve um trabalho de renderização com o seu estado. Uma tarefa bem-sucedida contém detalhes do seu resultado, e uma tarefa falhada carrega o erro.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
ID do trabalho
id True string

O ID do trabalho de renderização, tal como devolvido quando foi iniciado.

Devoluções

Corpo
Job

Capturar uma captura de tela

Renderiza uma página web ou um bloco de HTML num navegador e devolve a imagem. Envie uma URL de página ou HTML, não ambos.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
URL da página
url string

O endereço da página a capturar. Deixe vazio quando enviar HTML.

HTML
html string

A marcação HTML para renderizar. Deixe vazio quando enviar uma URL de página.

Formato de imagem
format string

O formato do ficheiro de imagem. O PNG é sem perdas, e o WebP é geralmente o ficheiro mais pequeno.

Página inteira
full_page boolean

Se deve capturar toda a página deslocá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. É ignorado durante uma captura de página inteira.

Dispositivo
device string

Captura a página como um telemóvel ou tablet a mostraria, com um tamanho de ecrã e agente de utilizador correspondentes.

Modo escuro
dark_mode boolean

Se deve renderizar a página com o seu esquema de cores escuras.

Quality
quality integer

A qualidade de imagem de 1 a 100 para JPEG e WebP. É ignorado para PNG.

Seletor de elementos
selector string

O seletor CSS de um elemento para capturar em vez de toda a janela.

Atraso (milissegundos)
delay_ms integer

Quanto tempo esperar depois de a página carregar antes de capturar, até 10000 milissegundos.

Espera até
wait_until string

Quando a página conta como pronta. A rede inativa espera que o tráfego de rede pare.

Ocultar banners de cookies
block_cookie_banners boolean

Se deve esconder banners comuns de consentimento para cookies. Estão escondidos, nunca aceites.

Bloquear anúncios
block_ads boolean

Se deve bloquear pedidos para redes conhecidas de publicidade e rastreamento.

Ignorar a cache
no_cache boolean

Se devo forçar uma renderização nova em vez de reutilizar uma idêntica dos últimos 10 minutos.

Devoluções

O conteúdo do ficheiro de captura de ecrã.

Conteúdo da imagem
binary

Comece um emprego em PDF

Coloca um PDF em fila como trabalho durável e devolve imediatamente. Verifica o trabalho com Obter um trabalho de renderização, depois usar Descarregar um resultado do trabalho. O ficheiro final é guardado durante 24 horas.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Chave de idempotência
Idempotency-Key string

Um valor único para este pedido, como o ID de corrida do 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 imprimir. Deixe vazio quando enviar HTML.

HTML
html string

A marcação HTML para imprimir. Deixe vazio quando enviar uma URL de página.

Tamanho do papel
paper_format string

O tamanho de papel nomeado. Quando está vazio, usa-se Carta.

Paisagem
landscape boolean

Se deve imprimir em orientação horizontal.

Fundos impressos
print_background boolean

Se deve incluir cores de fundo e imagens, como pode acontecer numa caixa de diálogo de impressão do navegador.

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 no topo de cada página.

Rodapé HTML
footer_html string

O modelo HTML impresso no final de cada página.

Scale
scale float

A escala de impressão, onde 1 é o tamanho real.

Espera até
wait_until string

Quando a página conta como pronta. A rede inativa espera que o tráfego de rede pare.

Ocultar banners de cookies
block_cookie_banners boolean

Se deve esconder banners comuns de consentimento para cookies. Estão escondidos, nunca aceites.

Bloquear anúncios
block_ads boolean

Se deve bloquear pedidos para redes conhecidas de publicidade e rastreamento.

A sua referência
external_id string

A tua própria referência para o trabalho, até 120 caracteres.

Devoluções

Corpo
Job

Comece um trabalho de captura de ecrã

Coloca uma captura de ecrã como trabalho durável e devolve imediatamente. Verifica o trabalho com Obter um trabalho de renderização, depois usar Descarregar um resultado do trabalho. O ficheiro final é guardado durante 24 horas.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Chave de idempotência
Idempotency-Key string

Um valor único para este pedido, como o ID de corrida do 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 capturar. Deixe vazio quando enviar HTML.

HTML
html string

A marcação HTML para renderizar. Deixe vazio quando enviar uma URL de página.

Formato de imagem
format string

O formato do ficheiro de imagem. O PNG é sem perdas, e o WebP é geralmente o ficheiro mais pequeno.

Página inteira
full_page boolean

Se deve capturar toda a página deslocá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. É ignorado durante uma captura de página inteira.

Dispositivo
device string

Captura a página como um telemóvel ou tablet a mostraria, com um tamanho de ecrã e agente de utilizador correspondentes.

Modo escuro
dark_mode boolean

Se deve renderizar a página com o seu esquema de cores escuras.

Quality
quality integer

A qualidade de imagem de 1 a 100 para JPEG e WebP. É ignorado para PNG.

Seletor de elementos
selector string

O seletor CSS de um elemento para capturar em vez de toda a janela.

Atraso (milissegundos)
delay_ms integer

Quanto tempo esperar depois de a página carregar antes de capturar, até 10000 milissegundos.

Espera até
wait_until string

Quando a página conta como pronta. A rede inativa espera que o tráfego de rede pare.

Ocultar banners de cookies
block_cookie_banners boolean

Se deve esconder banners comuns de consentimento para cookies. Estão escondidos, nunca aceites.

Bloquear anúncios
block_ads boolean

Se deve bloquear pedidos para redes conhecidas de publicidade e rastreamento.

Ignorar a cache
no_cache boolean

Se devo forçar uma renderização nova em vez de reutilizar uma idêntica dos últimos 10 minutos.

A sua referência
external_id string

A tua própria referência para o trabalho, até 120 caracteres.

Devoluções

Corpo
Job

Criar um PDF

Imprime uma página web ou um bloco de HTML num documento PDF com no máximo 100 páginas e devolve o ficheiro. Envie uma URL de página ou HTML, não ambos.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
URL da página
url string

O endereço da página a imprimir. Deixe vazio quando enviar HTML.

HTML
html string

A marcação HTML para imprimir. Deixe vazio quando enviar uma URL de página.

Tamanho do papel
paper_format string

O tamanho de papel nomeado. Quando está vazio, usa-se Carta.

Paisagem
landscape boolean

Se deve imprimir em orientação horizontal.

Fundos impressos
print_background boolean

Se deve incluir cores de fundo e imagens, como pode acontecer numa caixa de diálogo de impressão do navegador.

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 no topo de cada página.

Rodapé HTML
footer_html string

O modelo HTML impresso no final de cada página.

Scale
scale float

A escala de impressão, onde 1 é o tamanho real.

Espera até
wait_until string

Quando a página conta como pronta. A rede inativa espera que o tráfego de rede pare.

Ocultar banners de cookies
block_cookie_banners boolean

Se deve esconder banners comuns de consentimento para cookies. Estão escondidos, nunca aceites.

Bloquear anúncios
block_ads boolean

Se deve bloquear pedidos para redes conhecidas de publicidade e rastreamento.

Devoluções

O conteúdo do ficheiro PDF.

Conteúdo em PDF
binary

Descarregar um resultado de emprego

Devolve o ficheiro como um trabalho bem-sucedido produzido. Os resultados são mantidos durante 24 horas após o sucesso do trabalho.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
ID do trabalho
id True string

O ID do trabalho de renderização, tal como devolvido quando foi iniciado.

Devoluções

O ficheiro que o trabalho produziu.

Conteúdo do ficheiro
binary

Definições

Job

Nome Caminho Tipo Descrição
ID do trabalho
id string

A ID do trabalho.

Variante
kind string

O tipo de render, como uma captura de ecrã ou pdf.

Status
status string

O status do trabalho. Um trabalho termina quando é sucedido, falhado ou cancelado.

A sua referência
external_id string

A referência dada quando o trabalho começou.

Attempts
attempts integer

Quantas vezes o trabalho já foi feito.

Criado(a) a
created_at date-time

Quando o trabalho foi aceite.

Começou em
started_at date-time

Quando o trabalho começou a funcionar 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 do conteúdo
result.content_type string

O tipo de media do ficheiro de resultados.

Tamanho (bytes)
result.bytes integer

O tamanho do ficheiro de resultado em bytes.

Hash SHA256
result.sha256 string

O hash SHA-256 do ficheiro de resultados.

Available
result.available boolean

Se o ficheiro do resultado ainda pode ser descarregado.

O resultado expira em
result.expires_at date-time

Quando o ficheiro de resultado alojado é eliminado.

Link para download
result.url string

Um link assinado para o ficheiro de resultados que não precisa de chave API.

O link de download expira em
result.url_expires_at date-time

Quando o link de download assinado deixa de funcionar.

binário

Este é o tipo de dados básico 'binário'.