Certificação Power Query Conector do Power Query

Observação

Este artigo descreve os requisitos e o processo para enviar um conector Power Query personalizado para certificação. Leia o artigo inteiro com atenção antes de iniciar o processo de certificação.

Introdução

A certificação de Power Query conector personalizado torna o conector disponível publicamente, de forma aberta, dentro Power BI Desktop. A certificação é governada pelo Programa de Certificação do Conector da Microsoft, em que a Microsoft trabalha com desenvolvedores parceiros para estender os recursos de conectividade de dados Power BI.

Os conectores certificados são:

  • Mantido pelo desenvolvedor parceiro

  • Com suporte do desenvolvedor parceiro

  • Certificado pela Microsoft

  • Distribuído pela Microsoft

Trabalhamos com parceiros para tentar garantir que eles tenham suporte na manutenção, mas os problemas do cliente com o conector em si serão direcionados para o desenvolvedor parceiro.

Os conectores certificados são empacotados de Power BI Desktop. Os conectores personalizados precisam ser carregados Power BI Desktop, conforme descrito em Carregando sua extensão no Power BI Desktop. Ambos podem ser atualizados por meio Power BI Desktop serviço Power BI usando um gateway de dados local implementando um TestConnection.

Conectores certificados com uma implementação também são compatíveis com a atualização de ponta a ponta por meio da nuvem (serviço Power BI) sem a necessidade de um TestConnection gateway de dados local. O Power BI de serviço hospeda essencialmente um "gateway de nuvem" que é executado de forma semelhante ao gateway local. Após a certificação, implantaremos seu conector nesse ambiente para que ele seja disponibilizado para todos os Power BI clientes. Há requisitos adicionais para conectores que precisam usar componentes adicionais, como um driver baseado em ODBC. Entre em contato com seu contato da Microsoft se o conector exigir o uso de componentes adicionais.

Segurança e assinatura do conector personalizado

Como M é uma linguagem versátil que, como visto em Manipulando a Autenticação ,tem a capacidade de interagir com as credenciais armazenadas, precisamos dar aos usuários uma maneira de permitir apenas que conectores confiáveis executem.

Da perspectiva de um desenvolvedor, os desenvolvedores precisam assinar o conector personalizado por conta própria e fornecer aos usuários as informações (impressão digital) para carregá-los com segurança.

Da perspectiva de um usuário, os usuários precisam usar a impressão digital do desenvolvedor para confiar com segurança e carregar o conector personalizado para uso. Como alternativa, os usuários podem optar por reduzir suas configurações de segurança para permitir o carregamento de código não certificado pela Microsoft ou por outro desenvolvedor, mas isso não é recomendado.

Visão geral da certificação

Pré-requisitos

Para garantir a melhor experiência para nossos clientes, só consideramos conectores que atendem a um conjunto de pré-requisitos para certificação:

  • O conector deve ser para um produto público.

  • O desenvolvedor deve fornecer uma estimativa de uso. Sugerimos que os desenvolvedores de conectores para produtos muito simples usem nossos recursos de autoatendínio do conector para forcê-los diretamente ao cliente.

  • O conector já deve estar disponível para os clientes diretamente para atender a uma necessidade do usuário ou um cenário de negócios.

  • O conector deve estar funcionando com êxito em um nível de uso previsto pelos clientes.

  • Deve haver um thread no fórum Power BI Ideias orientado pelos clientes para indicar a demanda para disponibilizar o conector publicamente no Power BI Desktop.

Esses pré-requisitos existem para garantir que os conectores que passam pela certificação tenham necessidades significativas de clientes e negócios para serem usados e com suporte após a certificação.

Processo e linhas do tempo

Os conectores certificados são liberados com versões Power BI Desktop versões mensais, portanto, os prazos para cada versão funcionam de volta de cada Power BI Desktop de lançamento. A duração esperada do processo de certificação do registro até a versão varia dependendo da qualidade e da complexidade do envio do conector e é descrita nas seguintes etapas:

  • Registro: notificação de intenção para certificar seu conector personalizado. Isso deve ocorrer até o dia 15 do mês, dois meses antes da versão de Power BI desktop direcionada.

    • Por exemplo, para a versão de Power BI Desktop de abril, o prazo será 15 de fevereiro.
  • Envio: envio de arquivos do conector para análise da Microsoft. Isso deve ocorrer até o dia 1º do mês antes da versão de Power BI desktop direcionada.

    • Por exemplo, para a versão de Power BI Desktop de abril, o prazo será 1º de março.
  • Análise técnica: finalização dos arquivos do conector, passando a revisão e a certificação da Microsoft. Isso deve ocorrer até o dia 15 do mês antes da versão de Power BI Desktop direcionada.

    • Por exemplo, para a versão de Power BI Desktop de abril, o prazo será 15 de março.

Devido à complexidade das revisões técnicas e possíveis atrasos, problemas de rearquitetura e teste, é altamente recomendável enviar o início com um longo prazo de entrega para a versão inicial e a certificação. Se você acha que seu conector é importante fornecer a alguns clientes com sobrecarga mínima, recomendamos a autoatendação e o fornecimento dessa maneira.

Requisitos de certificação

Temos um determinado conjunto de requisitos para certificação. Reconhecemos que nem todos os desenvolvedores podem atender a esses requisitos e esperamos introduzir um conjunto de recursos que lidará com as necessidades do desenvolvedor em ordem curta.

Arquivos de envio (Artifacts)

Verifique se os arquivos do conector que você envia incluem todos os seguintes:

  • Arquivo connector (.mez)

    • O arquivo .mez deve seguir os padrões de estilo e ser nomeado de forma semelhante ao nome do produto ou serviço. Ele não deve incluir palavras como "Power BI", "Connector" ou "API".
    • Nome do arquivo .mez: ProductName.mez
  • Power BI Desktop arquivo (.pbix) para teste

    • Exigimos um exemplo Power BI relatório (.pbix) para testar seu conector.
    • O relatório deve incluir pelo menos uma consulta para testar cada item na tabela de navegação.
    • Se não houver nenhum esquema definido (por exemplo, bancos de dados), o relatório precisará incluir uma consulta para cada "tipo" de tabela que o conector possa manipular.
  • Testar conta para sua fonte de dados

    • Vamos usar a conta de teste para testar e solucionar problemas do conector.
    • Forneça uma conta de teste persistente para que possamos usar a mesma conta para certificar atualizações futuras.
  • Instruções de teste

    • Forneça qualquer documentação sobre como usar o conector e testar sua funcionalidade.
  • Links para dependências externas (por exemplo, drivers ODBC)

Recursos e estilo

O conector deve seguir um conjunto de regras de estilo e recurso para atender a um padrão de usabilidade consistente com outros conectores certificados.

  • O conector DEVE:

  • O FunctionName deve fazer sentido para o domínio (por exemplo, "Conteúdo", "Tabelas", "Documento", "Bancos de Dados" e assim por diante).

  • O conector DEVE:

    • Ter ícones.
    • Forneça uma tabela de navegação.
    • Coloque cadeias de caracteres em um resources.resx arquivo. As URLs e os valores devem ser codificados no código do conector e não devem ser colocados no resources.resx arquivo.

Segurança

Há considerações de segurança específicas que seu conector deve tratar.

  • Se Extension.CurrentCredentials() for usado:

    • O uso é necessário? Se sim, para onde as credenciais são enviadas?
    • As solicitações são garantidas por meio de HTTPS?
    • Se as credenciais são enviadas usando Web.Contents() via GET:
      • Ele pode ser transformado em um POST?
      • Se GET for necessário, o conector DEVERÁ usar o registro no CredentialQueryString registro de opções para passar credenciais Web.Contents() confidenciais.
  • Se as funções Diagnostics.* são usadas:

    • Validar o que está sendo rastreado; os dados não devem conter PII ou grandes quantidades de dados desnecessários.
    • Se você implementou um rastreamento significativo no desenvolvimento, deverá implementar uma variável ou sinalizador de recurso que determina se o rastreamento deve estar em. Isso deve ser desligado antes do envio para certificação.
  • Se Expression.Evaluate() for usado:

    • Validar a origem da expressão e o que ela é (ou seja, pode construir chamadas dinamicamente para Extension.CurrentCredentials() e assim por diante).
    • O Expression não deve ser fornecido pelo usuário nem receber entrada do usuário.
    • O Expression não deve ser dinâmico (ou seja, recuperado de uma chamada da Web).

Registrando para certificação

Se você estiver interessado em obter a certificação de seu conector personalizado, verifique se o seu cenário e o conector atendem aos pré-requisitos e requisitos descritos neste artigo. A falha em fazer isso causará atrasos na certificação, pois nossa equipe exigirá que você corrija quaisquer problemas ou inconsistências antes de prosseguir com a certificação.

Para começar, conclua nosso formulário de registroe um contato da Microsoft irá entrar no início do processo.

Depois de desenvolver um conector para uma fonte de dados, considere ajudar os clientes a entrarem em funcionamento rapidamente criando um aplicativo de modelo. Um aplicativo de modelo fornece aos clientes um relatório predefinido conectado aos dados que eles podem usar de forma integrada ou personalizá-los conforme necessário.

Observação

Os aplicativos de modelo não oferecem suporte a conectores que exigem um gateway.