Usar um conector personalizado
Como importar o conector do PDF Blocks do GitHub como conector personalizado, para usar ações antes que elas cheguem ao conector publicado.
O conector PDF Blocks publicado no Power Automate é certificado pela Microsoft, então novas ações e novos parâmetros chegam a ele no ritmo de revisão da Microsoft, e não no nosso. Quando você precisa de um recurso que já está na definição do conector, mas ainda não foi liberado no conector publicado, como as ações de divisão e reordenação, a seleção de páginas ou as opções de criptografia, você mesmo pode instalar a definição mais recente como um conector personalizado, importando-a do GitHub.
A definição do conector é de código aberto e fica no repositório PowerPlatformConnectors da Microsoft. O Power Automate consegue construir um conector personalizado diretamente a partir dele, então você nunca copia arquivos à mão.
Um conector personalizado fica em um único ambiente do Power Platform e não é certificado. Ele funciona exatamente como o conector publicado, com as mesmas ações e a mesma chave de API, mas quem o mantém é você: importe de novo para pegar as atualizações seguintes. Quando o conector publicado alcançar essa definição, você pode devolver seus fluxos a ele.
Antes de começar
- Um plano pago do Power Automate (por usuário ou por fluxo), o mesmo requisito do conector publicado.
- Permissão para criar conectores personalizados no seu ambiente. Se você não vir Conectores personalizados (Custom connectors), fale com o administrador do Power Platform.
- Sua chave de API do PDF Blocks, pronta para quando você criar a conexão. Consulte Primeiros passos se não tiver uma.
Importar o conector
No Power Automate, expanda o menu da esquerda, escolha Mais (More) e abra Conectores personalizados. (Você também chega à mesma página pelo portal do criador do Power Apps, em Descobrir tudo → Conectores personalizados.)
Selecione + Novo conector personalizado (+ New custom connector) e escolha Importar do GitHub (Import from GitHub).
Na caixa de diálogo Importar do GitHub:
- Defina Tipo de Conector (Connector Type) como Certified: assim a leitura é feita na pasta de conectores certificados do repositório de código aberto, onde fica o PDF Blocks.
- Escolha uma Ramificação (Branch). Use a ramificação que traz a
atualização de que você precisa (por exemplo,
devpara a mais recente ou uma ramificação de versão para uma versão fixada). - Defina Conector (Connector) como PDF Blocks.
Selecione Continuar (Continue).
Use o link Click here to explore the open source repository da caixa de diálogo para percorrer a definição exata antes de importar.
O Power Automate carrega a definição do conector no editor. Você não precisa mudar nada: percorra as guias Geral (General), Segurança (Security) e Definição (Definition) para revisá-la, se quiser, e depois selecione Criar conector (Create connector) no canto superior direito. Dê a ele um nome reconhecível (por exemplo, PDF Blocks Next) para distingui-lo do conector publicado.
Na primeira vez que você adiciona a um fluxo uma ação do seu conector personalizado, o Power Automate pede os mesmos parâmetros de conexão do conector publicado: um Connection Name, sua API Key e um Server Hostname opcional. Consulte Primeiros passos para saber o que significa cada um.
Em um fluxo, adicione uma ação e procure o nome que você deu ao seu conector personalizado. As ações dele, incluindo as que ainda não estão no conector publicado, como Dividir um PDF por número de páginas e Reordenar as páginas de um PDF, aparecem ao lado de todas as outras, prontas para configurar.
Manter tudo atualizado
Um conector personalizado é um instantâneo da definição no momento da importação. Quando publicarmos mais atualizações, repita Importar do GitHub no mesmo conector (ou importe de novo e recrie o conector) para atualizá-lo. Como o conector personalizado e o conector publicado são independentes, você pode manter os dois instalados e migrar cada fluxo quando estiver pronto.