Introducción
Puede crear un conector personalizado de código abierto y certificarlo de modo que esté fácilmente disponible para todos los usuarios. Al ser de código abierto, se asegura de que su conector se publique en el Repositorio de GitHub de Microsoft Power Platform. Desde el repositorio, cualquier usuario puede importar la definición de su conector personalizado a un entorno y luego usarlo o hacer contribuciones a su conector para que considere adoptarlo. Cuando crea un conector personalizado, solo está disponible para usted y los usuarios con los que comparte explícitamente el conector. Para que un conector esté visible en la lista de conectores oficiales para cualquier usuario de Microsoft Power Automate, Microsoft Power Apps o Microsoft Azure Logic Apps, debe estar certificado.
Cuándo certificar un conector personalizado
Existen muchas razones para certificar su conector personalizado, pero la facilidad de uso, la visibilidad y la expansión del alcance de su API son algunas de las principales. Certifique su conector personalizado si proporciona acceso a una API que es útil para un público amplio y no está enfocada solo a usuarios internos. No es necesario que hospede el servicio subyacente de la API con tecnologías de Microsoft. De hecho, los conectores son beneficiosos para integrar soluciones de Microsoft Power Platform con soluciones que no son de Microsoft. Puede certificar conectores para API gratuitas o de pago.
Los conectores certificados se revisan para garantizar que cumplan con los criterios de certificación antes de la publicación. Hay dos tipos de editores de conectores verificados e independientes.
Editores verificados: un requisito clave es que usted debe poseer el servicio subyacente, o bien, presentar derechos explícitos para usar la API y, a continuación, proporcionar un escenario de usuario que se adapte bien a los productos.
Editores independientes: no son propietarios del servicio subyacente que hay tras su conector. Por ejemplo, un usuario de una API que no esté afiliado a la empresa puede enviar un conector a la API para la certificación. Este tipo permite que los miembros de la comunidad participen en el ecosistema de conectores de Power Platform.
La certificación inicial y las actualizaciones del conector son gratuitas. La siguiente unidad explicará con más detalle el proceso de certificación.
Cuándo crear un conector personalizado de código abierto
Cualquier conector personalizado que cree es candidato para convertirse en código abierto si determina que otros podrían beneficiarse de su uso. Cuando certifica un conector, el primer paso que debe dar es hacer que la definición sea de código abierto. Primero, compruebe si existe una definición de conector personalizado en el repositorio para la API que está creando. Si encuentra una definición, le recomendamos que contribuya con sus cambios para mejorarla enviando una solicitud de extracción en lugar de intentar crear un conector duplicado.
A continuación se presentan algunos ejemplos de cuándo es más o menos óptimo crear un conector personalizado de código abierto.
| Candidato óptimo para código abierto | Candidato menos óptimo para código abierto |
|---|---|
| Conector para una API que está disponible públicamente para que cualquiera la use | Conector para una API privada que solo está disponible dentro de la red de una empresa |
La mayoría de las contribuciones requieren que acepte un contrato de licencia de colaborador (CLA) en el que declare que tiene el derecho pertinente y lo concede para usar su contribución. Para obtener más información, consulte el Acuerdo de licencia de colaborador.
El repositorio de GitHub tiene tres carpetas principales que contienen los conectores: custom-connectors, independent-publisher-connectors y certified-connectors.
La carpeta custom-connectors contiene ejemplos de conectores completamente funcionales que se pueden implementar en Microsoft Power Platform para extensión y uso. Es posible que estos ejemplos no sean conectores certificados, pero los crea y mantiene la comunidad de código abierto para ofrecer escenarios útiles o ejemplos de conceptos de conector.
La carpeta independent-publisher-connectors contiene conectores enviados por editores que no poseen el servicio subyacente tras el conector. Estos conectores se implementan y están disponibles en Power Platform como conectores Premium. En esta carpeta, cualquiera puede enviar un nuevo conector, agregar funciones a los conectores y resolver problemas relacionados con estos. La carpeta está administrada por la comunidad de conectores de editores independientes, que incluye a los editores independientes y a los coordinadores de proyectos. El equipo de certificación de conectores de Microsoft hace el mantenimiento de la rama maestra y se asegura de que la versión del conector sea idéntica a la que se implementa en Power Platform. Los encargados del mantenimiento del conector y el equipo de certificación de conectores de Microsoft mantienen la rama dev para permitir el desarrollo comunitario del conector antes de la certificación y la implementación de una versión.
La carpeta certified-connectors contiene conectores certificados que ya están implementados y disponibles para su uso, listos para usar, dentro de Microsoft Power Platform. Un requisito del programa de certificación de conectores de Microsoft es que los nuevos conectores certificados deben ser de código abierto para las contribuciones de la comunidad. El equipo de certificación de conectores de Microsoft administra la carpeta certified-connectors para asegurarse de que, dentro de la rama master, la versión del conector sea idéntica a la que se implementa en Microsoft Power Platform. El propietario del conector y el equipo de certificación de conectores de Microsoft mantienen la rama dev para permitir el desarrollo comunitario del conector antes de la certificación y la implementación de una versión.
Para contribuir al repositorio de GitHub, comenzará tomando su propia copia (o creando una bifurcación) del repositorio. Los pasos se explican en la documentación Crear una bifurcación. Una vez que haya creado una bifurcación, estará listo para preparar su conector para la contribución mediante una solicitud de incorporación de cambios. Puede descargar los activos de su conector utilizando la CLI de conectores de Microsoft Power Platform.
Descarga con la CLI de conectores de Microsoft Power Platform
Para preparar los archivos necesarios para crear un conector de código abierto, use el comando de descarga paconn de la CLI de conectores de Microsoft Power Platform.
Descargue los archivos del conector personalizado ejecutando el siguiente comando:
paconn download
Cuando ejecute este comando, pasará por un registro de dispositivo para permitir que paconn acceda al entorno de Microsoft Power Platform en su nombre. Una vez que se haya autenticado, paconn le proporcionará una lista de entornos para seleccionar, seguida de una lista de conectores para seleccionar.
Si conoce el id. de su entorno y el id. del conector, puede utilizar la siguiente sintaxis de línea de comandos para evitar que se le solicite:
paconn download -e [Microsoft Power Platform Environment GUID] -c [Connector ID]
La descarga incluye cuatro archivos:
apiDefintion.swagger.json: definición de OpenAPI para el conector, que incluye, por ejemplo, todos los desencadenadores y acciones.
apiProperties.json: define plantillas de directivas y otras propiedades de conector extendidas que no forman parte de las especificaciones de OpenAPI.
icon.png: un pequeño icono que se utiliza para representar el servicio en el diseñador cuando se utiliza el conector.
settings.json: se usa en lugar de proporcionar parámetros a paconn.
Si hace que su conector personalizado sea de código abierto y luego lo certifica, dará más visibilidad a su API. Al contribuir con la definición del conector en el repositorio de código abierto, su conector personalizado estará disponible para que otros lo utilicen. Cuando alguien usa un conector certificado, está usando una definición que se actualiza automáticamente cuando publica actualizaciones. Al utilizar la definición de conector de código abierto, los usuarios deberán aplicar actualizaciones a su propia copia. En el resto de este módulo, se examinará cómo certificar su conector personalizado y cómo administrar su ciclo de vida a medida que lo desarrolla.