Envoi de notifications Microsoft Teams à partir d'une base de données Autonomous AI sur une infrastructure Exadata dédiée

Vous pouvez configurer Microsoft Teams pour envoyer des messages, des alertes ou la sortie d'une requête d'une base de données Autonomous AI sur une infrastructure Exadata dédiée à un canal Microsoft Teams à l'aide du package DBMS_CLOUD_NOTIFICATION.

Préparation à l'envoi de notifications Microsoft Teams à partir d'une base de données Autonomous AI

Commencez par configurer un bot dans votre application Microsoft Teams. Créez ensuite des informations d'identification à utiliser avec les procédures DBMS_CLOUD_NOTIFICATION pour envoyer des notifications Microsoft Teams à partir de la base de données Autonomous AI.

Pour configurer les notifications Microsoft Teams :

  1. Créez votre application Microsoft Teams et ajoutez-y un bot. Pour plus d'informations sur la configuration d'une application, reportez-vous à Portail développeur pour les équipes.

  2. Dans la section Gestion des robots, assurez-vous que le bot dispose d'une clé secrète, d'une portée définie sur Equipe et d'un droit d'accès permettant d'envoyer des notifications.

  3. Publiez l'application dans votre organisation pour la mettre à la disposition des personnes de votre organisation.

  4. Une fois que votre administrateur informatique a approuvé l'application à partir du centre d'administration, installez-la à partir de la section Applications dans Teams.

  5. Demandez les droits d'accès Files.ReadWrite.All et ChannelSettings.Read.All à l'application pour l'API Graph à partir du portail Azure en suivant les instructions suivantes :

    1. Connectez-vous à votre portail Azure, accédez à Azure Active Directory à l'aide du panneau de gauche et sélectionnez l'option Application.

    2. La page Application affiche les applications que vous possédez avec les bots ajoutés à ces applications. Cliquez sur le bot pour afficher ses détails.

    3. Copiez l'ID de répertoire/locataire à partir de la page de présentation du bot pour une utilisation ultérieure.

    4. Ensuite, accédez à Droits d'accès API dans le panneau de gauche. Sous Droits d'accès à l'API, cliquez sur Ajouter un droit d'accès, sélectionnez Microsoft graph, puis Autorisation à l'application.

    5. Recherchez les droits d'accès Files.ReadWrite.All et ChannelSettings.Read.All et ajoutez-les.

  6. Demandez à votre administrateur informatique d'approuver les autorisations demandées ci-dessus à partir du portail Azure en suivant les étapes ci-dessous :

    1. Connectez-vous à votre portail Azure, accédez à Azure Active Directory à l'aide du panneau de gauche et sélectionnez l'option Application.

    2. Sélectionnez Toutes les applications sur la page Application.

    3. Recherchez l'application/bot par son nom, accédez à Droits d'accès à l'API et accordez le consentement ADMIN pour les droits d'accès demandés : Files.ReadWrite.All et ChannelSettings.Read.All.

    A savoir : Une fois l'application approuvée par l'administrateur informatique, vous pouvez fournir l'ID de bot et la clé secrète aux autres utilisateurs pour installer l'application dans Teams dans l'organisation.

  7. Une fois l'application approuvée par l'administrateur informatique et les droits d'accès demandés ci-dessus accordés, vous pouvez utiliser l'ID de bot de l'application et la clé secrète utilisée pour créer l'objet d'informations d'identification et générer un jeton de bot.

  8. Pour envoyer un résultat de requête à un canal Microsoft Teams, obtenez team id et tenant id.

    Conseil : le fichier team id se trouve dans le lien d'équipe entre /team/ et /conversations. L'élément tenant id se trouve après "tenantId=" à la fin du lien d'équipe. Pour accéder à ce lien, cliquez sur les trois points en regard du nom de l'équipe et sélectionnez Obtenir le lien vers l'équipe.

    Exemple :

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

  9. Obtenez le fichier channelID.

    A savoir : channelID se trouve dans la liaison de canal entre /team/ et le nom du canal. Pour accéder à ce lien, cliquez sur les trois points en regard du nom du canal et sélectionnez Obtenir le lien vers le canal.

    Exemple :

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

  10. Sur Exadata Cloud@Customer, configurez les paramètres de proxy HTTP dans votre environnement pour permettre à la base de données d'accéder à Microsoft Teams. Pour plus d'informations sur la configuration des paramètres de proxy HTTP lors de la création d'une infrastructure Exadata Cloud@Customer, reportez-vous à Utilisation de la console pour provisionner Exadata Database Service on Cloud@Customer.

    Remarque : la configuration réseau, y compris le proxy HTTP, peut uniquement être modifiée tant que l'infrastructure Exadata n'a pas l'état Activation requise. Une fois qu'il est activé, vous ne pouvez pas modifier ces paramètres.

    Afin de configurer un proxy HTTP pour une infrastructure Exadata déjà provisionnée, soumettez une demande de service dans My Oracle Support. Pour plus d'informations, reportez-vous à Création d'une demande d'assistance dans My Oracle Support.

  11. Créez un objet d'informations d'identification pour accéder à l'application Microsoft Teams à partir de la base de données Autonomous AI.

    A savoir : Si vous ne pouvez pas utiliser la procédure CREATE_CREDENTIAL avec succès, consultez l'utilisateur ADMIN pour accorder l'accès d'exécution sur les packages DBMS_CLOUD.

    Le nom utilisateur des informations d'identification est bot_id et le mot de passe est la clé de bot.

    Exemple :

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

    Pour plus d'informations, reportez-vous à Procédure CREATE_CREDENTIAL.

Envoyer des messages à un canal Microsoft Teams

Après avoir créé l'objet d'informations d'identification Microsoft Teams comme décrit dans Préparer l'envoi de notifications Microsoft Teams à partir d'Autonomous AI Database, vous pouvez utiliser la procédure DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE pour envoyer un message à un canal Microsoft Teams.

Exemple :

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;
/

Utilisez le paramètre params pour indiquer le canal.

canal : indique l'ID de canal obtenu à l'étape 10 dans Préparation à l'envoi de notifications Microsoft Teams à partir d'une base de données Autonomous AI.

Pour plus d'informations, reportez-vous à Procédure SEND_MESSAGE.

Envoyer les résultats de la requête à un canal Microsoft Teams

Après avoir créé l'objet d'informations d'identification Microsoft Teams comme décrit dans Préparer l'envoi de notifications Microsoft Teams à partir de la base de données Autonomous AI, vous pouvez utiliser la procédure DBMS_CLOUD_NOTIFICATION.SEND_DATA pour envoyer la sortie d'une requête à un canal Microsoft Teams.

Exemple :

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;
/

Utilisez le paramètre params pour indiquer le locataire, l'équipe, le canal, le titre et le type de données dans les valeurs string.

Remarque : la taille de fichier maximale prise en charge lors de l'utilisation de DBMS_CLOUD_NOTIFICATION.SEND_DATA pour Microsoft Teams est de 4 Mo.

Rubriques connexes