Compartir vía


Probar y distribuir un conector personalizado

Importante

Algunas o todas estas funciones están disponibles como parte de una versión preliminar. El contenido y la funcionalidad están sujetos a cambios.

Aprenda a probar y distribuir el conector de importación de datos personalizado en Microsoft Sustainability Manager.

Probar la interfaz de usuario del conector

Si sigue estos pasos podrá ver el aspecto de la interfaz de usuario de su conector.

  1. Exporte la solución Power Platform que creó anteriormente siguiendo los pasos de Exportar soluciones. Asegúrese de que el número de versión de la solución que exporta sea superior a la versión actual. Volverá a importar la solución después de agregar el archivo XML que creó anteriormente.

  2. Extraiga los archivos ZIP que exportó y cree una carpeta denominada Assets.

  3. Guarde el archivo msdyn_dataconnectors.xml (y el archivo msdyn_dataflowtemplates.xml para un conector de plantilla de Power Query) en la carpeta Assets.

    En el caso de un conector de Power Automate, la estructura de carpetas debería ser similar a la siguiente:

    Una captura de pantalla que muestra la carpeta y los archivos dentro del archivo ZIP para un conector de Power Automate.

    Para un conector de plantilla de Power Query, la estructura de carpetas debe ser similar a la siguiente:

    Captura de pantalla que muestra la carpeta y los archivos en el archivo ZIP de un conector de plantilla de Power Query.

  4. Seleccione todos los archivos y comprímalos en un archivo ZIP. Cuando abre su archivo ZIP recién creado, la estructura de carpetas de nivel superior debe tener estos elementos:

    • Carpeta de Activos
    • Archivo [Content-Types]
    • Archivo customizations.xml
    • Archivo solution.xml
    • Archivo ZIP de solución de plantillas (para conectores de plantillas de Power Query)
  5. Vuelva a importar el archivo ZIP en el mismo entorno de Power Platform desde el que lo exportó siguiendo los pasos de Importar soluciones.

  6. Una vez que la importación se completa correctamente, aparece un conector en ese entorno. En Sustainability Manager, en el área Datos de la navegación izquierda, seleccione Importaciones. Seleccione Nuevo y luego seleccione CONECTORES DE PROVEEDORES DE DATOS. El icono del conector se muestra en la página siguiente. Seleccione el icono del conector y, a continuación, Siguiente.

    Para un conector de Power Automate, aparece la interfaz de usuario del formulario de credenciales que ha diseñado. Puede asegurarse de que tiene el diseño deseado y depurar el formulario a través de esta página.

    Cuando se utiliza un conector de plantilla de Power Query, se presenta la experiencia de importación de la plantilla de Power Query.

    Si desea realizar algún cambio, siga los pasos para exportar la solución, actualice el archivo msdyn_dataconnectors.xml y luego vuelva a importarlo. Asegúrese de que la versión que está exportando sea superior a la versión actual.

  7. Puede completar el formulario con valores de ejemplo y guardarlo. Para comprobar cómo se almacenan estos valores, en Power Apps, seleccione Tables. Seleccione Todo y busque msdyn_providercredential. Se muestran los datos de la tabla. Si es la primera vez que crea la conexión, solo debe haber un registro de credenciales. Compruebe la columna Credencial para ver cómo se almacenan los valores que proporcionó en el formulario.

    Captura de pantalla que muestra la columna Credencial en la tabla msdyn_providercredential.

Prueba de manejo de errores

Para los conectores de Power Automate, maneje los errores en su flujo de conexión. Si, por algún motivo, se produce un error en cualquier paso del flujo, el estado de importación de datos permanece programado.

Para probar este evento, agregue sus acciones en el flujo en un bloque try/catch. En el bloque catch, genere error en la conexión y la actualización de la conexión.

Si se produce un error en la conexión, los usuarios pueden ponerse en contacto con usted mediante el vínculo de soporte técnico que incluyó en json para la interfaz de usuario del conector. Este JSON aparece en Paso 2: crear un registro de conector.

Para invalidar la conexión y el refresco de conexión, utilice la acción de Dataverse Actualizar una fila para los registros de Refresco de conexión y Conexión.

  • Para el registro Actualización de conexión, establezca el campo Actualizar estado como Con error:

    Captura de pantalla que muestra cómo configurar el campo Estado de actualización del registro Actualización de conexión como Con error en un flujo de Power Automate.

  • Para el registro Conexión, establezca el campo Estado como Error:

    Captura de pantalla que muestra cómo establecer el campo Estado del registro de conexión en Error en un flujo de Power Automate.

Para obtener más información, consulte Uso de un flujo para actualizar una fila.

Para obtener más información sobre el manejo de errores, consulte las mejores prácticas para el manejo de errores en flujos de Power Automate.

Probar el conector

Después de crear el conector, expórtelo como solución administrada siguiendo los pasos descritos en Exportación de soluciones.

Importe la solución exportada en otros entornos que tengan instalado Sustainability Manager. Pruebe la solución para asegurarse de que funciona según lo previsto.

Distribuye los conectores

Después de probar el conector, puede distribuir la solución de forma privada directamente a los usuarios, o bien puede distribuirla públicamente a través de Microsoft Marketplace. Para obtener más información sobre la distribución a través de Marketplace, consulte Publicación de la aplicación en Marketplace.