Processo de certificação de editores independentes
Este processo destina-se a editores independentes. Se for o proprietário do serviço subjacente ao conector, aceda ao Processo de certificação de editores verificados.
Nota
Este artigo fornece informações para a certificação de conectores editores independentes no Azure Logic Apps, Power Automate e Power Apps. Antes de seguir os passos deste artigo, leia Certificar o seu conector.
Depois de identificar um conector personalizado para o programa de Editor Independente, siga os passos em Preparar e submeter o seu conector para certificação. Este processo prepara-o para certificação e gera os ficheiros de conector a submeter à Microsoft. O processo de submissão é feito através do Repositório do GitHub para conectores de editores independentes.
Ler o manifesto
O Grupo de Conectores de Editores Independentes permite que qualquer pessoa publique um conector na lista oficial de conectores da Microsoft. Este grupo solicita que os participantes estejam cientes e concordem com o conteúdo do seu manifesto.
Se planeia contribuir ou fazer parte deste esforço, deve ler e compreender este documento.
Preparar e enviar o seu conector para certificação
O processo de certificação do seu conector como editor independente é fácil. Antes de o submeter no Repositório do GitHub, certifique-se de que realiza os passos desta secção.
Quando submete o seu conector de editor independente, o seu nome é incluído no nosso produto como o editor oficial e um ícone genérico é aplicado ao seu conector.
Antes de começar a criar um conector, partilhe a proposta de conector com a Microsoft: verifique que o conector não foi já criado. Para verificar, pesquise pelo conector na documentação do Power Platform e em pedidos Pull do repositório GitHub. A tabela seguinte dá-lhe opções para o que pode fazer com o conector com base no respetivo estado.
Se o seu conector proposto Opção Já existe no Power Platform. Não pode criar o conector. Já existe como um conector de editor independente Pode adicionar mais funcionalidade ao conector Atualmente, é um pedido de solicitação e uma proposta. Pode contactar o editor independente para colaborar com ele no conector. É um pedido de solicitação e não é uma proposta. Aguarde até que o conector seja certificado e implementado. Em seguida, adicione uma atualização a esse conector. Depois de ter verificado se o conector não está na plataforma, partilhe a sua proposta de conector no repositório do GitHub: isto evita a duplicação de esforços com os seus colegas que possam ter a mesma ideia para um novo conector. Também poderá criar uma oportunidade para encontrar outras pessoas com quem colaborar à medida que cria o conector.
Para partilhar a sua proposta, submeta um pedido de solicitação no repositório GitHub com os seguintes critérios:
Título do pedido de solicitação "Proposta – <Connector Name> (Editor Independente)". Por exemplo,
Proposal - HubSpotCRM (Independent Publisher).Consolide um ficheiro intro.md com o máximo de detalhes que puder fornecer. Se quiser a encontrar um colaborador, inclua o seu e-mail de contacto.
Nota
Use o mesmo pedido de solicitação quando estiver pronto para submeter todos os ficheiros para certificação no passo 10.
Criar o conector e/ou o plug-in:
- Para saber como criar um conector, aceda a Criar um conector personalizado de raiz.
Criar um título para o seu conector que cumpra os requisitos da Microsoft: para obter instruções e exemplos, aceda a Dar um título aoseu conector.
Escrever uma descrição para o conector: para obter instruções, aceda a Escrever uma descrição para o conector.
Definir resumos e descrições: para obter instruções, aceda a Definir resumos e descrições de operação e de parâmetros.
Definir respostas de operação exatas: para obter instruções, aceda a Definir respostas de operação exatas.
Adicionar metadados que descrevam o conector e/ou plug-in e o respetivo serviço final: para obter instruções, aceda a Adicionar metadados.
Preparar os artefactos do conector: para obter instruções, aceda a Preparar o conector e/ou artefactos.
Submeter o seu conector para implementação:
Efectue o seguinte procedimento:
- Submeta os artefactos de conector ao pedido pull que criou no Passo 2.
- Preencha a lista de verificação no modelo do pedido pull.
- Remova "Proposta -" do título do pedido pull.
Um engenheiro de certificação da Microsoft fornece comentários dentro de uma a duas semanas úteis após o seu pedido inicial. Se o comentário necessitar de uma atualização para o conector, tem de submeter uma atualização ao pedido pull. Permita uma a duas semanas adicionais para isto. Se precisar de resolver erros de swagger, vá para Corrigir erros do Validador do Swagger.
Mantém a propriedade do seu conector e pode aceitar ou rejeitar quaisquer alterações feitas ao mesmo.
A Microsoft aprova e une o pedido pull.
Os seus conectores são submetidos para certificação: durante a certificação, espere ser contactado pela Microsoft dentro de 1-2 semanas.
Esperar pela implementação: depois de o seu conector ser validado e preparado para implementação de produção, vamos implementá-lo em todas as regiões de produção.
Importante
Em média, são necessários 15 dias úteis para implementar o conector. Isto é necessário independentemente do tamanho ou complexidade do seu conector, seja novo ou uma atualização. Para proteger a integridade, o conector é submetido às mesmas tarefas de validação para testar a funcionalidade e o conteúdo que são seguidas em todas as implementações.
Agendas de implementação: as nossas agendas de implementação de conector para produção começam sexta-feira de manhã, PST/PDT. Notifique o seu contacto da Microsoft quando estiver pronto para a implementação da produção com, pelo menos, 24 horas de antecedência para que inclua o seu conector na próxima implementação agendada.
Implementação da região: vamos notificá-lo por e-mail com os nomes das regiões para onde o conector será implementado, uma vez que a implementação para as regiões é feita em passos. Se houver um atraso ou congelamento da implementação, será notificado por e-mail. Para saber mais, aceda a Implementação da região.
Como os seus conectores estão a terminar a certificação, vamos envolvê-lo sobre uma oportunidade de marketing para o conector no blogue do Power Automate.
Atualizar o seu conector a qualquer altura: uma vez terminada a certificação e o seu conector ser publicado, pode adicionar novas operações e funcionalidades ao seu conector no repositório do GitHub em qualquer altura. Voltaremos a certificar o seu conector, conforme necessário.
Melhores práticas de submissão
Só pode submeter um conector por pedido Pull. Isto garante que o nosso processo de validação decorre sem problemas.
O pedido pull para o seu conector deve seguir o padrão
Connector Name (Independent Publisher).Adicione um e-mail à secção de e-mail de suporte. Isto é para o caso de precisarmos de o contactar.
Certifique-se de que preenche o parâmetro da política de privacidade com a política de privacidade para o serviço final.
Certifique-se de que as suas descrições da operação são detalhadas. Isto garante que o utilizador pode compreender a sua operação.
Se o seu conector utilizar OAuth, certifique-se de que fornece passos detalhados sobre como criar uma aplicação no seu leia-me.md. Se não o fizer, resulta em atrasos na certificação. Para um exemplo de documentação a incluir, vá ao exemplo de Leia-me.md.
Certifique-se de que adiciona esquemas de resposta às suas ações, a menos que o esquema de resposta seja dinâmico. Isto garante que o seu conector obtém mais utilização.
Reveja a Lista de verificação antes de submeter.
Garantias da Microsoft
A Microsoft compromete-se em satisfazer as seguintes garantias:
Se houver uma atualização do conector, passaremos novamente a ferramenta de alteração interruptiva e todas as outras ferramentas de validação.
Se não houver atualização a um conector, garantimos que funciona, a menos que haja uma alteração ou atualização da API, ou um problema na plataforma.
A Microsoft investiga os problemas de plataforma e segurança à medida que surgem e irá preterir os conectores independentes de editores quebrados.
Sabia que pode expandir o seu conector como plug-ins?
Os seus conectores do Power Platform podem ser expandidos como plug-ins no Microsoft Copilot Studio e podem ser publicados para os seus inquilinos. Para saber mais sobre como expandir os seus conectores como Plug-ins, aceda a Criar plug-ins de IA para Microsoft Copilot. Em breve, estenderemos o suporte para Editores Independentes certificarem e publicarem os Plug-ins no Copilot para M365.