Introducción
Puede crear un conector personalizado de código abierto y certificarlo de modo que esté 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.
Repositorio de GitHub de Microsoft Power Platform
El repositorio de GitHub de Microsoft Power Platform tiene varios tipos de conectores, y se pueden dividir en dos grupos: personalizados y certificados.
Los conectores personalizados son conectores que cualquier usuario puede importar desde el repositorio de GitHub a un entorno; después, pueden usar el conector o hacer contribuciones en él para que usted valore si desea adoptarlas. Cuando crea un conector personalizado, solo está disponible para usted y los usuarios con los que comparte explícitamente el conector. El hecho de agregar un conector personalizado al repositorio de GitHub de Microsoft Power Platform facilita que otros lo importen a su entorno.
Cuándo certificar un conector personalizado
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 certificarlo previamente.
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.
Microsoft revisa los conectores certificados para garantizar que cumplan con los criterios de certificación antes de su publicación. Hay dos tipos de editores de conectores.
Editores verificados: un requisito clave con los editores verificados 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 usuarios de la comunidad participen en el ecosistema de conectores de Microsoft 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. Luego, debe comprobar 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 para mostrar 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 aceptar un Acuerdo de licencia de colaborador (CLA). Este acuerdo declara que usted tiene derecho a otorgar, y de hecho otorga, los derechos para utilizar su contribución. Para obtener más información, consulte el Acuerdo de licencia de colaborador.
El repositorio de GitHub tiene tres carpetas principales con los siguientes conectores:
custom-connectors
independent-publisher-connectors
certified-connectors
La carpeta custom-connectors contiene ejemplos de conectores completamente funcionales que puede implementar en Microsoft Power Platform para extensión y uso. Estos ejemplos no son conectores certificados, pero los crea y mantiene la comunidad de código abierto para ofrecer escenarios útiles o ejemplos de conceptos de conector. Los conectores no se implementan en Power Apps, Power Automate o Logic Apps de forma predeterminada, lo que los diferencia de las otras dos carpetas.
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 Microsoft 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 comunidad de conectores de editores independientes, que incluye a los editores independientes y a los coordinadores de proyectos, administra esta carpeta. El equipo de certificación de conectores de Microsoft hace el mantenimiento de la rama master y se asegura de que la versión del conector sea idéntica a la que se implementa en Microsoft 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, sin modificaciones, 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, puede empezar 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 creada una bifurcación, puede 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.
CLI de conectores de Microsoft Power Platform
Para trabajar con sus activos de conector, descargue la CLI de conectores de Microsoft Power Platform siguiendo las instrucciones de instalación de la CLI de conectores de Microsoft Power Platform.
Nota
paconn es otro nombre de la CLI de conectores de Microsoft Power Platform.
Inicie sesión con la CLI de conectores de Microsoft Power Platform
Para poder descargar archivos de conector, es necesario haber iniciado sesión en la Microsoft Power Platform CLI de conectores. Inicie sesión ejecutando el comando siguiente:
paconn login
Este comando le pide que inicie sesión utilizando el proceso de inicio de sesión con código de dispositivo. Siga las indicaciones para el inicio de sesión.
Descarga con la CLI de conectores de Microsoft Power Platform
A fin de preparar los archivos necesarios para crear un conector de código abierto, use el comando de paconn download desde la CLI de conectores de Microsoft Power Platform.
Descargue los archivos del conector personalizado ejecutando el siguiente comando:
paconn download
Cuando ejecuta este comando, comienza un inicio de sesión de dispositivo con el que paconn accede 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, entre otras cosas, 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: pequeño icono que representa el servicio en el diseñador cuando se utiliza el conector.
settings.json: se usa este archivo en lugar de proporcionar parámetros a
paconn.
Si hace que su conector personalizado sea de código abierto y luego lo certifica, ayudará a 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 deben aplicar las actualizaciones a su propia copia. El resto de este módulo explica cómo certificar su conector personalizado y cómo administrar su ciclo de vida a medida que lo desarrolla.