Microsoft OneDrive Parlé

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 8 minutes de lecture
  • Automatisez la gestion des fichiers et des dossiers et la collaboration dans Microsoft OneDrive. Ajoute des données Microsoft OneDrive dans votre instance ServiceNow.

    Demander des applications dans l'App Store

    Visitez le site Web ServiceNow Store pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Storenotes de publication relatives à l'historique des versions.

    Abonnement à Hub d'intégration

    Ce spoke requiert un abonnement au Centre d'intégration. Pour plus d'informations, consultez Calendriers juridiques - Vue d'ensemble du Centre d'intégration.

    Version de spoke

    Spoke Microsoft OneDrive La version2.3.2 est la dernière version.

    Dépendances des spokes

    Si vous rencontrez des difficultés pour installer l'application, assurez-vous que les modules d'extension dépendants suivants sont installés :

    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    Remarque :
    Certains de ces modules d'extension sont des fonctionnalités sous licence et nécessitent une licence appropriée s'ils sont utilisés en dehors de l'implémentation des spokes. Pour en savoir plus sur les licences, contactez votre chargé de clientèle.

    Versions prises en charge

    Version d’API v1.

    Flux de spokes

    Donne Spoke Microsoft OneDrive des échantillons de flux à l’état brouillon pour illustrer l’automatisation des tâches Microsoft OneDrive . Pour personnaliser un échantillon de flux, copiez-le dans un nouveau périmètre de l’application. Les échantillons de flux disponibles sont les suivants :

    Flux Description
    Renouveler les abonnements Renouvelle les abonnements expirés en mettant à jour la date d’expiration de l’abonnement.

    Flux secondaires du spoke

    Le Spoke Microsoft OneDrive fournit des exemples de flux secondaires à l’état de brouillon pour illustrer l’automatisation des tâches Microsoft OneDrive . Pour personnaliser un exemple de flux secondaire, copiez-le dans un nouveau périmètre de l’application. Exemples de flux secondaires disponibles :

    Flux secondaire Description
    Télécharger un nouveau fichier OneDrive vers ServiceNow Télécharge les nouveaux fichiers chargés dans une ressource vers un enregistrement ServiceNow
    S’abonner à un webhook Souscrit à une application d'écoute pour recevoir des notifications lorsque des données changent.
    Changements de synchronisation Effectue le suivi des changements apportés à un lecteur et à ses enfants au fil du temps.
    Obtenir la dernière URL du document Obtient le dernier chemin d’accès d’un fichier dans OneDrive à l’aide de l’ID système du document comme entrée. Pour utiliser ce flux secondaire, une connexion OneDrive et les informations d’identification correspondantes doivent être créées et un jeton d’autorisation OneDrive doit être disponible.
    Reconnecter un document à partir de Microsoft OneDrive Obtient la dernière URL Web et WebDAV d’un document à partir de Microsoft OneDrive à l’aide de l’ID système du document, de l’ID système des détails du fournisseur, du nom de la table cible, de l’ID système de la table cible et du nom du document. Pour utiliser ce flux secondaire, une connexion OneDrive et les informations d’identification correspondantes doivent être créées et un jeton d’autorisation OneDrive doit être disponible.

    Actions du spoke

    La Spoke Microsoft OneDrive fournit des actions pour automatiser les Microsoft OneDrive tâches lorsque des événements se produisent dans .ServiceNow Les actions disponibles sont les suivantes :

    Catégorie Action Description
    Gestion des lecteurs Rechercher des informations sur le lecteur Recherche les métadonnées d’un lecteur spécifique Microsoft OneDrive
    Gestion des dossiers Déplacer un élément de fichier ou de dossier Déplace un fichier ou un dossier vers Microsoft OneDrive l’emplacement cible.
    Créer un dossier Crée un dossier dans Microsoft OneDrive.
    Mettre à jour le nom du fichier ou du dossier Met à jour le nom d’un élément de fichier ou de dossier à partir d’un ID.
    Supprimer un élément de fichier ou de dossier Supprime un fichier ou un dossier de Microsoft OneDrive.
    Gestion des fichiers Enregistrer le fichier Enregistre un élément de lecteur et envoie une invitation de partage. Lorsque vous enregistrez un fichier, d’autres utilisateurs peuvent accéder au fichier enregistré.
    Extraire le fichier Extrait un élément de lecteur à partir de OneDrive. Lorsque vous retirez un élément de lecteur, les autres utilisateurs ne peuvent pas modifier le document. Les autres utilisateurs ne peuvent pas non plus voir les modifications que vous avez apportées au document tant que vous ne l’avez pas consigné.
    Copier le fichier OneDrive dans la pièce jointe Copie un fichier dans Microsoft OneDrive une pièce jointe d’un enregistrement dans un ServiceNow enregistrement.
    Copier la pièce jointe dans OneDrive Copie un enregistrement de pièce jointe dans ServiceNow vers Microsoft OneDrive
    Copier un élément de fichier ou de dossier Crée de façon asynchrone une copie d’un Microsoft OneDrive élément (y compris les enfants), sous un nouvel élément parent ou avec un nouveau nom.
    Rechercher des éléments Récupère une liste d’éléments de lecteur à partir d’un chemin d’accès ou la source et l’ID source d’un élément de lecteur.
    Rechercher des informations sur un élément de fichier ou de dossier par ID

    Obtient les informations de métadonnées d’un fichier à partir de l’ID de fichier ou de dossier dans Microsoft OneDrive.

    Rechercher des informations sur un élément de fichier ou de dossier par chemin Recherche les informations de métadonnées d’un fichier à partir de son chemin d’accès dans Microsoft OneDrive.
    Copier la pièce jointe dans OneDrive à l'aide du chemin d'accès Copie un enregistrement de pièce jointe dans ServiceNow sur OneDrive.
    Copier le fichier OneDrive vers la pièce jointe à l’aide du chemin d’accès du fichier Copie un fichier à l’aide de son chemin dans OneDrive vers une pièce jointe d’un enregistrement dans ServiceNow.
    Copier la version du fichier OneDrive vers la pièce jointe Copie un fichier OneDrive dans une pièce jointe d’enregistrement dans ServiceNow.
    Supprimer la version d'un fichier Supprime la version spécifiée d’un fichier de OneDrive.
    Rechercher toutes les versions d'un fichier Récupère toutes les versions d’un fichier dans OneDrive.
    Restaurer la version du fichier Restaure la version du fichier spécifiée et faites de cette version la plus récente.
    Charger et remplacer un fichier Charge la version mise à jour d’un fichier existant ou remplace le fichier existant par un nouveau fichier.
    Remarque :
    La taille maximale du fichier ne peut pas dépasser 4 Mo.
    Rechercher dans les documents Rechercher des fichiers ou des éléments de dossier Recherche les éléments de lecteur (fichiers ou dossiers) en fonction des attributs de métadonnées tels que le nom de l’élément.
    Partage de documents Ajouter un collaborateur Ajoute un collaborateur et ses autorisations à un fichier ou à un dossier. Vous pouvez identifier le collaborateur par son alias Azure AD ou un ID d’objet.
    Rechercher des collaborateurs Répertorie tous les détails du collaborateur associés à un fichier ou à un dossier dans Microsoft OneDrive.
    Retirer un collaborateur Supprime un collaborateur d’un fichier ou d’un dossier dans Microsoft OneDrive.
    Gestion des autorisations Ajouter une autorisation Envoie une invitation de partage pour un élément de lecteur. Une invitation de partage permet aux destinataires d’accéder à l’élément de lecteur et leur envoie éventuellement un e-mail contenant un lien de partage.
    Créer un lien de partage Crée un lien de partage qui vous permet de partager un élément de lecteur avec d’autres utilisateurs.
    Supprimer l'autorisation Supprime l’accès à un élément de lecteur.
    Rechercher des autorisations Récupère les autorisations de partage d’un élément de lecteur.
    Mettre à jour l'autorisation Met à jour la date d'expiration de l'abonnement.
    Gestion des Webhook S'abonner au webhook Crée un abonnement qui envoie des notifications lorsque des données changent.
    Se désabonner du webhook Supprime l’ID d’abonnement spécifié.
    Obtenir un synctoken pour l'abonnement Récupère le dernier jeton de synchronisation pour l’ID d’abonnement spécifié.
    Rechercher des abonnements Récupère la liste des abonnements actifs.
    Renouveler l'abonnement Met à jour la date d'expiration de l'abonnement.
    Changements de synchronisation Effectue le suivi des modifications apportées à un lecteur et à ses enfants au fil du temps.

    Module de spokes

    Des webhooks bidirectionnels peuvent être configurés pour recevoir des notifications sur les événements requis. La politique d’acheminement définit les conditions qui doivent être remplies pour notifier l’application ServiceNow. Ces conditions sont basées sur les événements de OneDrive pour lesquels vous souhaitez être informé. Lorsque les conditions sont remplies, une politique d’acheminement déclenche le flux secondaire associé, qui automatise à son tour les tâches OneDrive.

    Les webhooks bidirectionnels nécessitent une configuration distincte et peuvent être utilisés indépendamment sans utiliser les actions de spoke. Par défaut, l’application Webhooks OneDrive est disponible dans le spoke OneDrive et comporte les modules suivants :

    Module Description
    SyncToken OneDrive Vous permet d’afficher les SyncTokens de OneDrive.
    Registres Webhook OneDrive Vous permet de créer et d’afficher les webhooks OneDrive dans ServiceNow.
    Politique d'acheminement du Webhook OneDrive Vous permet de créer et d’afficher les politiques d’acheminement pour les webhooks OneDrive dans ServiceNow. Vous pouvez également personnaliser les conditions des politiques d’acheminement selon vos besoins.

    Exigences relatives au compte OneDrive Online

    Le Spoke Microsoft OneDrive nécessite une application personnalisée que vous créez dans Microsoft Azure.

    Exigences en matière d'alias de connexion et d'informations d'identification

    Hub d'intégration utilise des alias pour gérer les informations de connexion et d’informations d’identification, ainsi que les informations d’identification OAuth. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'environnements multiples. Si les informations de connexion ou d'identification changent, il n'est pas nécessaire de mettre à jour les actions qui utilisent la connexion.

    Locataire unique
    Le spoke OneDrive inclut l’enregistrement d’alias OneDrive pour autoriser des actions sur Microsoft OneDrive. Sélectionnez cet alias dans l’enregistrement du locataire pour autoriser les changements pour Microsoft OneDrive un locataire unique.

    Pour en savoir plus sur la configuration du spoke, consultez Configurer un Microsoft spoke OneDrive.

    Configuration requise pour le Serveur MID

    Ces actions utilisent des appels REST, qui peuvent s’exécuter sur une instance ou Serveur MID. Utilisez l’enregistrement de connexion associé à l’alias Microsoft OneDrive pour configurer l’emplacement d’exécution des actions ainsi que pour définir Serveur MID des attributs de sélection. Pour en savoir plus, consultez Serveur MID.