Documentación de Oracle Cloud Infrastructure

Envío de notificaciones de Microsoft Teams desde Autonomous Database

Describe cómo configurar Microsoft Teams para que pueda enviar mensajes, alertas o salida de una consulta desde Autonomous Database a un canal de Microsoft Teams. También se describen 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 de 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 notificaciones de Microsoft Teams:

  1. Cree la aplicación de Microsoft Teams y agregue un bot. 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. Publique la aplicación en su organización para que esté disponible para las personas de su organización.
  4. Una vez que el administrador de TI apruebe la aplicación desde el centro de administración, instálela desde la sección Aplicaciones de Teams.
  5. Solicite los permisos Files.ReadWrite.All y ChannelSettings.Read.All a la aplicación para Graph API desde Azure Portal mediante las siguientes instrucciones:
    1. Conéctese a Azure Portal, vaya a Azure Active Directory mediante el panel de la izquierda y seleccione la opción Aplicación.
    2. La página Aplicación muestra las aplicaciones que posee junto con los bots agregados a esas aplicaciones. Haga clic en el bot para ver los detalles.
    3. Copie el id de directorio/inquilino en 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 siguientes pasos:
    1. Conéctese a Azure Portal, vaya a Azure Active Directory mediante el panel de la izquierda 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 de ADMIN para los permisos solicitados: Files.ReadWrite.All y ChannelSettings.Read.All.

    Consejo:

    Una vez que el administrador de TI apruebe la aplicación, puede proporcionar el ID de bot y la clave secreta a otros usuarios para instalar la aplicación en Teams en la organización.
  7. Una vez que el administrador de TI aprueba la aplicación y se otorgan los permisos solicitados anteriores, puede utilizar el ID de bot de la aplicación y utilizar 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:

    team id se encuentra en el enlace de equipo entre /equipo/ y /conversaciones. tenant id se encuentra después de "tenantId=" al final del enlace de equipo. Este enlace se encuentra haciendo clic en los tres puntos situados junto al nombre del equipo y seleccionando Obtener enlace 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. Este enlace se encuentra haciendo clic en los tres puntos situados junto al nombre del canal y seleccionando 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 de Microsoft Teams desde Autonomous Database.

    Consejo:

    Si no puede utilizar correctamente el procedimiento CREATE_CREDENTIAL, consulte al usuario ADMIN para otorgar acceso de ejecución en los 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 Procedimiento CREATE_CREDENTIAL para obtener más información.

Enviar mensajes a un canal de Microsoft Teams

Después de crear el objeto de credencial de Microsoft Teams como se describe en Preparación 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.

Por 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 el procedimiento SEND_MESSAGE para obtener más información.

Enviar resultados de consulta a un canal de Microsoft Teams

Después de crear el objeto de credencial de Microsoft Teams como se describe en Preparación 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.

Por 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 el procedimiento SEND_DATA para obtener más información.