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 |
| 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.
- Inicia sessão em https://portal.ironfang.com, ou cria uma conta gratuita lá.
- Abre chaves API e cria uma chave. Uma chave apenas com o escopo render:render é suficiente para todas as ações neste conector.
- Copia a chave, que começa por if_live_. É mostrado uma vez.
- 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:
- Adicione a ação Criar um PDF e coloque o seu HTML no campo HTML. Define o tamanho do papel para a4.
- 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:
- Comece com um gatilho de recorrência.
- 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.
- 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'.