Documentación de Oracle Cloud Infrastructure

Envío de notificaciones de los equipos de Microsoft desde Autonomous Database

Describe cómo configurar Microsoft Teams para que pueda enviar mensajes, alertas o salidas de una consulta desde Autonomous Database a un canal de Microsoft Teams. También describe los procedimientos que se utilizan para enviar notificaciones de Microsoft Teams.

Tema principal: Envío de correo electrónico y notificaciones en Autonomous Database

Preparación para enviar notificaciones de Microsoft Teams desde Autonomous Database

Para empezar, configure un bot en la aplicación Microsoft Teams. A continuación, cree una credencial para utilizarla con los procedimientos DBMS_CLOUD_NOTIFICATION para enviar notificaciones de Microsoft Teams desde Autonomous Database.

Para configurar las notificaciones de Microsoft Teams:

  1. Cree su aplicación de Microsoft Teams y agregue un bot en ella. Consulte Portal de desarrolladores para equipos para obtener información sobre la configuración de una aplicación.
  2. En la sección Gestión de bots, asegúrese de que el bot tenga una clave secreta, un ámbito definido en Equipo y un permiso para enviar notificaciones.
  3. Publica la aplicación en tu organización para que esté disponible para las personas de tu organización.
  4. Después de que el administrador de TI apruebe la aplicación desde el centro de administración, instale la aplicación desde la sección Aplicaciones en Equipos.
  5. Solicite los permisos Files.ReadWrite.All y ChannelSettings.Read.All a la aplicación para Graph API desde el portal de Azure mediante las siguientes instrucciones:
    1. Conéctese al portal de Azure, vaya a Azure Active Directory mediante el panel izquierdo y seleccione la opción Aplicación.
    2. La página Aplicación muestra las aplicaciones de las que es propietario junto con los bots agregados a esas aplicaciones. Haga clic en el bot para ver sus detalles.
    3. Copie el ID de directorio/inquilino de la página de visión general del bot para su uso posterior.
    4. A continuación, vaya a Permisos de API en el panel izquierdo. En Permisos de API, haga clic en Agregar permiso, seleccione Gráfico de Microsoft y, a continuación, Permiso de aplicación.
    5. Busque los permisos Files.ReadWrite.All y ChannelSettings.Read.All y agréguelos.
  6. Haga que su administrador de TI apruebe los permisos solicitados anteriormente desde el portal de Azure siguiendo los pasos siguientes:
    1. Conéctese al portal de Azure, vaya a Azure Active Directory mediante el panel izquierdo y seleccione la opción Aplicación.
    2. Seleccione Todas las aplicaciones en la página Aplicación.
    3. Busque la aplicación/bot por su nombre, vaya a permisos de API y otorgue el consentimiento del administrador para los permisos solicitados: Files.ReadWrite.All y ChannelSettings.Read.All.

    Consejo:

    Una vez que la aplicación haya sido aprobada por el administrador de TI, puede proporcionar el ID del bot y la clave secreta a otros usuarios para instalar la aplicación en Teams de la organización.
  7. Después de que el administrador de TI apruebe la aplicación y se otorguen los permisos solicitados anteriormente, puede utilizar el ID de bot de la aplicación y la clave secreta para crear el objeto de credencial y generar un token de bot.
  8. Para enviar un resultado de consulta a un canal de Microsoft Teams, obtenga team id y tenant id.

    Consejo:

    El team id se encuentra en el enlace de equipo entre /team/ y /conversaciones. tenant id se encuentra después de "tenantId=" al final del enlace del equipo. Este vínculo se encuentra haciendo clic en los tres puntos situados junto al nombre del equipo y seleccionando Obtener vínculo al equipo.

    Por ejemplo:

    https://teams.microsoft.com/l/team/teamID/conversations?groupId=groupid%tenantId=tenantid

  9. Obtenga channelID.

    Consejo:

    channelID se encuentra en el enlace de canal entre /team/ y el nombre de canal. Para encontrar este enlace, haga clic en los tres puntos situados junto al nombre del canal y seleccione Obtener enlace al canal.

    Por ejemplo:

    https://teams.microsoft.com/l/channel/channelID/channel_name?groupId=groupid&tenantId=tenantid

  10. Cree un objeto de credencial para acceder a la aplicación Microsoft Teams desde Autonomous Database.

    Consejo:

    Si no puede utilizar el procedimiento CREATE_CREDENTIAL correctamente, consulte con el usuario ADMIN para otorgar acceso de ejecución en paquetes DBMS_CLOUD.

    El nombre de usuario de la credencial es bot_id y la contraseña es la clave del bot.

    Por ejemplo:

    
BEGIN     
    DBMS_CLOUD.CREATE_CREDENTIAL(credential_name => 'TEAMS_CRED',       
        username        => 'bot_id', 
        password        => 'bot_secret');
END;
/

    Consulte CREATE_CREDENTIAL Procedure para obtener más información.

Envío de mensajes a un canal de Microsoft Teams

Después de crear el objeto de credencial de Microsoft Teams, como se describe en Preparar para enviar notificaciones de Microsoft Teams desde Autonomous Database, puede utilizar el procedimiento DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE para enviar un mensaje a un canal de Microsoft Teams.

Ejemplo:

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
        provider        => 'msteams',
        credential_name => 'TEAMS_CRED',
        message         => 'text from new teams api',
        params          => json_object('channel' value 'channelID'));
END;
/

Utilice el parámetro params para especificar el canal.

Consulte SEND_MESSAGE Procedure para obtener más información.

Envío de resultados de consultas a un canal de Microsoft Teams

Después de crear el objeto de credencial de Microsoft Teams, como se describe en Preparar para enviar notificaciones de Microsoft Teams desde Autonomous Database, puede utilizar el procedimiento DBMS_CLOUD_NOTIFICATION.SEND_DATA para enviar la salida de una consulta a un canal de Microsoft Teams.

Ejemplo:

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_DATA(provider => 'msteams',
        credential_name => 'TEAMS_CRED',
        query           => 'SELECT tablespace_name FROM dba_tablespaces',
        params          => json_object('tenant'value '5b743bc******c0286',
                                       'team'value '0ae401*********5d2bd',
                                       'channel'value '19%3a94be023*****%40thread.tacv2',
                                       'title'value 'today',
                                       'type'value 'csv'));
END;
/

Utilice el parámetro params para especificar el inquilino, el equipo, el canal, el título y el tipo de dato en los valores string.

Nota

El tamaño máximo de archivo soportado al utilizar DBMS_CLOUD_NOTIFICATION.SEND_DATA para Microsoft Teams es de 4 MB.

Consulte SEND_DATA Procedure para obtener más información.