Certificar un conector personalizado
Para hacer que un conector personalizado esté disponible para todos los usuarios en Logic Apps, Power Automate y Power Apps como conector certificado, envíe su conector a Microsoft para su certificación. Microsoft revisará el conector y lo aprobará para su publicación si cumple los criterios de certificación. Una vez publicado el conector, se unirá a la lista completa de conectores disponibles públicamente.
Esta unidad examina cada paso, incluidos algunos pasos de alto nivel, en el proceso de certificación. Estos mismos pasos se aplican también a actualizaciones posteriores, pero dependiendo del alcance de la actualización, pueden ser considerablemente más rápidos.
Planificación
La planificación es el primer paso en el proceso de certificación a medida que comienza a imaginar cómo se verá su conector. La creación de un conector que otros usarán debería implicar cierta planificación.
El primer paso consiste en comprobar que no haya ya un conector; si ya hay un conector, valore la posibilidad de contribuir al conector existente con los cambios propuestos, ya que Microsoft no certificará varios conectores para la misma API.
Algunos factores clave de la planificación que debe considerar son los siguientes:
Identificar qué desencadenadores y acciones estarán disponibles inicialmente. No necesita cubrir el 100 % de su API, pero el conjunto inicial de desencadenadores y acciones debería ser un conjunto útil. Si limita demasiado lo que tiene en su versión inicial, los usuarios se sentirán frustrados por la falta de funcionalidad para escenarios comunes. Considere escribir o bosquejar uno o más flujos de trabajo que se pueden crear en Microsoft Power Automate utilizando su conector. Este enfoque puede ayudarle a decidir qué API incluir en el conector.
Evalúe qué cambios podrían ser necesarios en la API para admitir desencadenadores o mejorar la capacidad de ofrecer un conector fácil de usar.
Considere cómo se gestionará la autenticación y la adaptación necesaria entre cómo se autentica actualmente su API y las capacidades admitidas de los conectores personalizados.
Considere cómo los usuarios que quieran usar el conector obtendrán una clave, si su API usa claves de API.
Revise las plantillas de directivas de conectores para determinar si la implementación de plantillas ayudaría a la usabilidad de su conector.
Revise las extensiones de OpenAPI compatibles para determinar su aplicabilidad. Por ejemplo, la prueba de conexión se implementa comúnmente mediante conectores certificados. Además, el uso de extensiones de valores dinámicos puede resultar útil si tiene parámetros con listas de valores para elegir.
Para la certificación de un nuevo conector, no tiene que esperar hasta que termine de desarrollar el conector para registrarse para la certificación. Para obtener más información, consulte el Proceso de certificación de editor verificado o el Proceso de certificación de editores independientes. Un representante de Microsoft se pondrá en contacto con usted; le ayudará a comprender mejor su conector personalizado, le explicará su progreso de desarrollo y le guiará en el proceso de certificación.
Para las actualizaciones de un conector certificado, la parte más importante de la planificación es no interrumpir a los usuarios existentes. Este tema se analizará en más detalle en una unidad posterior.
Desarrollo
El enfoque principal en el paso de desarrollo es preparar su API y la definición de su conector personalizado para su envío. Antes de continuar con el siguiente paso, debe asegurarse de que la definición de su conector personalizado esté limpia y tenga todos los nombres adecuados que desea publicar.
Crear código abierto
En la unidad de introducción se incluyó una descripción general sobre cómo crear un conector de código abierto. Colocará el conector certificado de editor verificado en la carpeta certified-connectors y los conectores de editor independiente en la carpeta independent-publisher-connectors. Antes de enviar una solicitud de incorporación de cambios, asegúrese de realizar las siguientes tareas:
Edite sus archivos de conector para agregar los metadatos específicos necesarios. Los archivos del conector deben contener metadatos específicos que describan el conector y su servicio final.
Ejecute el comando paconn validate en el conector descargado y luego resuelva los errores.
Para ejecutar la validación, use el siguiente comando:
paconn validate --api-def [Location of apiDefinition.swagger.json]
Una vez que haya superado la validación, puede enviar su solicitud de extracción a la rama dev del repositorio de GitHub. Esta acción iniciará un proceso automatizado que llevará a cabo la validación inicial de su solicitud de extracción y se asegurará de que tenga un acuerdo de contribución adecuado. Cuando se haya completado la validación automatizada, se asignará a Microsoft para su revisión inicial. Si los revisores encuentran problemas que deben corregirse, escribirán comentarios en la solicitud de incorporación de cambios; se espera que usted los resuelva y vuelva a enviarla. Cuando todo parezca aceptable, su solicitud de incorporación de cambios se fusionará con el repositorio.
Envío de editor independiente
Si está publicando un conector de editor independiente, el próximo paso es enviar los artefactos del conector a la solicitud de incorporación de cambios que ha creado al proponer el conector; complete la lista de verificación en la plantilla de la solicitud de incorporación de cambios y elimine "Propuesta -" del título de esta. Un ingeniero de certificación de Microsoft le proporcionará algunos comentarios en un plazo de 1-2 semanas desde la solicitud inicial. Si los comentarios requieren una actualización del conector, deberá enviar una actualización de la solicitud de incorporación de cambios. Una vez que
Envío de editor verificado
El siguiente paso es enviar su conector para la certificación en ISV Studio después de que su contacto de Microsoft le haya pedido que lo haga. ISV Studio es un portal para administrar el resto del proceso de certificación y le indicará el estado de su conector una vez que se haya implementado.
Como parte del proceso de envío a ISV Studio para la certificación, debe estar preparado para proporcionar:
Información de prueba del conector, por ejemplo, una clave de API, otros detalles de autenticación o cualquier detalle que ayude a un evaluador a usar el conector.
Un archivo
Intro.mdque contenga información para incluir en la documentación pública del conector. Puede encontrar una plantilla en Envío a ISV Studio.
A medida que avanza la certificación, recibirá actualizaciones en el portal y recibirá un correo electrónico del contacto principal. Si se detectan problemas, se espera que los resuelva antes de que la certificación continúe. Una vez que el conector haya pasado la certificación, se programará su implementación en la región "Versión preliminar" para su prueba.
Pruebas
Como parte del proceso de certificación, su conector se implementa en la región "Versión preliminar" para realizar pruebas. Ahora tiene la oportunidad de asegurarse de que el conector implementado funcione correctamente antes de implementarlo en todas las regiones del mundo. Asegúrese de probar todas las funciones de su conector en Power Apps, Power Automate y Logic Apps.
Para obtener más información, consulte Instrucciones para probar un conector en certificación.
Implementación
Una vez completada la prueba, su conector se implementará en todas las regiones públicas. Se espera que este proceso tarde entre siete y diez días hábiles, porque Microsoft implementa de manera incremental en las regiones de todo el mundo. Recibirá notificaciones a medida que se implemente cada región.
Soporte técnico
Ahora que su conector se ha lanzado públicamente, puede supervisar el rendimiento de conectores de editor verificado desde ISV Studio. Asegúrese de que el personal de soporte técnico sepa cómo se puede usar su conector con Power Apps o Power Automate para que puedan ayudar a los usuarios que tengan problemas.