Processo de certificação de editor independente
Esse processo é para editores independentes. Se você possui o serviço subjacente ao seu conector, vá para Processo de certificação de editor verificado.
Observação
Este artigo apresenta informações para certificação dos conectores de editor independente em Aplicativos Lógicos do Azure, no Power Automate e no Power Apps. Antes de seguir as etapas neste artigo, leia Obter seu conector certificado.
Depois que você tiver identificado um conector personalizado para compilação no programa Editor Independente, siga as etapas em Preparar e enviar o conector para certificação. Esse processo o prepara para certificação e gera os arquivos de conector a serem enviados para a Microsoft. O processo de envio é feito por meio do Repositório GitHub para conectores de editores independentes.
Leia o manifesto
O Grupo de Conectores de Editor Independente possibilita que qualquer pessoa publique um conector na lista oficial de conectores da Microsoft. Esse grupo pede que os participantes estejam cientes do e concordem com o conteúdo do manifesto.
Se pretender contribuir com ou fazer parte dessa iniciativa, você deverá ler e compreender este documento.
Preparar e enviar seu conector para certificação da Microsoft
O processo de certificação do seu conector como um editor independente é fácil. Antes de enviá-lo no Repositório GitHub, certifique-se de seguir as etapas nesta seção.
Quando você envia o conector de editor independente, o nome aparece em destaque em nosso produto como o editor oficial, e um ícone genérico é aplicado ao conector.
Antes de começar a compilar um conector, compartilhe a proposta de conector com a Microsoft: verifique se o conector ainda não foi compilado. Para verificar, procure o conector na documentação do Power Platform e nas pull requests do repositório do GitHub. A tabela a seguir dá opções para aquilo que você pode fazer com o conector com base no status.
Se o conector proposto Opção Já existe na Power Platform. Você não pode criar o conector. Já existente como um conector de editor independente Você pode adicionar mais funcionalidade ao conector Atualmente é uma solicitação pull e uma proposta. Você pode entrar em contato com o editor independente para colaborar com ele no conector. É uma solicitação pull e não uma proposta. Aguarde até que o conector seja certificado e implantado. Em seguida, adicione uma atualização a esse conector. Depois que você tiver verificado se o conector não está na plataforma, compartilhe a proposta de conector no repositório do GitHub: isso evita a duplicação de iniciativas com os colegas que possam ter a mesma ideia para um novo conector. Também pode criar uma oportunidade para você encontrar outras pessoas para colaborar enquanto cria seu conector.
Para compartilhar sua proposta, envie uma solicitação pull no repositório GitHub com os seguintes critérios:
Dê um título à solicitação pull "Proposta - <Connector Name> (Editor Independente)". Por exemplo,
Proposal - HubSpotCRM (Independent Publisher)
.Confirme um arquivo intro.md com o máximo de detalhes que puder dar. Se você tiver abertura para encontrar um colaborador, inclua o email de contato.
Observação
Use a mesma pull request quando tudo estiver pronto para enviar todos os arquivos para certificação na etapa 10.
Compile o conector e/ou plug-in:
- Para aprender a compilar um conector, vá até Criar um conector personalizado do zero.
Crie um título para o conector que atenda aos requisitos da Microsoft: para obter instruções e exemplos, vá até Dar um título ao conector.
Escreva uma descrição para o conector: para obter instruções, vá até Escrever uma descrição para o conector.
Definir resumos e descrições: para obter instruções, vá até Definir resumos e descrições de operação e parâmetro.
Definir respostas de operação exatas: para obter instruções, vá até Definir respostas de operação exatas.
Adicionar metadados que descrevam o conector e/ou plug-in e o serviço final: para obter instruções, vá até Adicionar metadados.
Preparar os artefatos de conector: para obter instruções, vá até Preparar o conector e/ou artefatos.
Envie seu conector para implantação:
Faça o seguinte:
- Envie os artefatos de conector para a pull request criada na etapa 2.
- Preencher a lista de verificação no modelo de solicitação de pull.
- Remover "Proposta -" do título da pull request.
Um engenheiro de certificação da Microsoft dará um feedback dentro de uma a duas semanas depois da solicitação inicial. Se os comentários exigirem uma atualização do conector, você precisará enviar uma atualização para a solicitação de pull. Reserve um tempo extra de uma a duas semanas para isso. Se você precisar solucionar erros de swagger, vá para Corrigir erros do Validador Swagger.
Você mantém propriedade do conector e pode aceitar ou rejeitar eventuais alterações feitas no conector.
A Microsoft aprova e mescla a pull request.
O conector é enviado para certificação: durante a certificação, aguarde contato da Microsoft dentro de 1 a 2 semanas.
Aguardar implantação: depois que o conector for validado e preparado para a implantação de produção, vamos implantá-lo em todas as regiões de produção.
Importante
Em média, leva 15 dias úteis para implantar o conector. É obrigatório independentemente do tamanho ou complexidade do seu conector, seja ele novo ou uma atualização. Para proteger a integridade, o conector permanece sujeito às mesmas tarefas de validação para testar a funcionalidade e o conteúdo seguidos em cada implantação.
Agendas de implantação: nossas agendas de implantação de conector para produção começam nas manhãs de sexta-feira, PST/PDT. Notifique seu contato da Microsoft quando estiver pronto para a implantação de produção com pelo menos 24 horas de antecedência para incluirmos seu conector na próxima implantação agendada.
Implantação de região: notificamos você por email com os nomes das regiões nas quais o conector será implantado, pois a implantação nas regiões é feita em etapas. Se houver um atraso ou congelamento da implantação, você receberá a notificação por email. Para saber mais, vá até Implantação da região.
Quando o conector estiver concluindo a certificação, entraremos em contato com você sobre uma oportunidade de marketing do conector no blog do Power Automate.
Atualizar o conector a qualquer hora: assim que a certificação terminar e o conector for publicado, você poderá adicionar novas operações e funcionalidades ao conector no repositório do GitHub a qualquer momento. Recertificamos o conector conforme necessário.
Práticas recomendadas para envio
Você só pode enviar um conector por pull request. Isso garante que nosso processo de validação seja executado sem problemas.
A pull request do conector deve seguir o padrão
Connector Name (Independent Publisher)
.Adicione um email à seção de email de suporte. No caso de precisarmos entrar em contato com você.
Certifique-se de preencher o parâmetro da política de privacidade com a política de privacidade do serviço final.
Certifique-se de que suas descrições de operação sejam detalhadas. Isso garante que o usuário possa entender sua operação.
Se seu conector usa OAuth, certifique-se de fornecer etapas detalhadas sobre como criar um aplicativo em seu readme.md. Deixar de fazer isso resulta em atrasos na certificação. Para obter um exemplo de documentação a ser incluída, vá para o exemplo de Readme.md.
Não se esqueça de incluir esquemas de resposta nas ações, a menos que o esquema de resposta seja dinâmico. Isso garante que o conector tenha mais uso.
Revise a Lista de verificação antes de enviar.
Garantias da Microsoft
A Microsoft se compromete a atender às seguintes garantias:
Se houver uma atualização no conector, vamos executar a ferramenta de alteração interruptiva e todas as outras ferramentas de validação novamente.
Se não houver atualização em um conector, garantimos que ele funciona, a menos que haja uma alteração ou atualização da API ou um problema de plataforma.
A Microsoft investiga problemas de plataforma e segurança à medida que eles surgem e descontinua conectores de editor independente com falhas.
Você sabia que pode estender o conector como plug-ins?
Os conectores do Power Platform podem ser estendidos como plug-ins no Microsoft Copilot Studio e ser publicados para os locatários. Para saber mais sobre como estender os conectores como plug-ins, vá até Criar plug-ins de IA do Microsoft Copilot. Em breve, vamos estender o suporte para editores independentes certificarem e publicarem os plug-ins no Copilot para M365.