Explore los conectores personalizados certificados
Para que un conector personalizado esté disponible como conector certificado para todos los usuarios en Logic Apps, Power Automate y Power Apps, debe enviarlo 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 cuando empieza a imaginar el aspecto de su conector. La creación de un conector que otros van a usar debe implicar cierta planificación.
El primer paso en el proceso de planificación es comprobar que el conector aún no exista. 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:
Identifique qué desencadenadores y acciones hay disponibles inicialmente. No necesita cubrir el 100 % de su API, pero el conjunto inicial de desencadenadores y acciones debería ser útil. Si limita demasiado el contenido de la versión inicial, los usuarios se sentirán frustrados por la falta de funcionalidad para escenarios comunes. Valore la posibilidad de escribir o bosquejar uno o más flujos de trabajo que se pueden crear en 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 para ofrecer un conector fácil de usar.
Considere el modo de gestionar la autenticación y la adaptación necesaria entre la forma de autenticar actual de su API y las capacidades compatibles de los conectores personalizados.
Piense en cómo obtendrán una clave las personas que usarán el conector, si la 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 los documentos Proceso de certificación de editor verificado o 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. Esta cuestión se analiza con 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é refinada 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. En este proceso, 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 para 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 inicia un proceso automatizado que lleva a cabo la validación inicial de su solicitud de extracción y se asegura de que tenga un acuerdo de contribución adecuado. Cuando se haya completado la validación automatizada, el sistema la asigna a Microsoft para su revisión inicial. Si los revisores encuentran problemas que deban corregirse, escriben comentarios en la solicitud de incorporación de cambios. Después, se espera que usted los resuelva y vuelva a enviarla. Cuando todo parezca aceptable, el revisor fusionará su solicitud de incorporación de cambios con el repositorio.
Envío de editor independiente
Si está publicando un conector de editor independiente, estos son los siguientes pasos:
Envíe los artefactos del conector a la solicitud de incorporación de cambios que creó al proponer el conector.
Complete la lista de comprobación en la plantilla de la solicitud de incorporación de cambios.
Elimine "Propuesta -" del título de la solicitud de incorporación de cambios.
Un ingeniero de certificación de Microsoft le responderá en un plazo de 1-2 semanas desde la solicitud inicial. Si la respuesta requiere una actualización del conector, deberá enviar una actualización de la solicitud de incorporación de cambios.
Envío de editor verificado
El siguiente paso es enviar su conector para la certificación en Microsoft Power Platform 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 los siguientes datos:
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. La plantilla está en el documento 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 para poder continuar con la certificación. 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, ya que Microsoft implementa de manera incremental en las regiones de todo el mundo. Recibirá notificaciones a medida que se implemente en 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 su personal de soporte técnico sepa cómo usar su conector con Power Apps o Power Automate para que puedan asistir a los usuarios que tengan problemas.