SharePoint

Le connecteur SharePoint vous permet de gérer des fichiers, des dossiers et des pièces jointes dans SharePoint.

Versions compatibles

Ce connecteur est compatible avec Windows SharePoint Services 3.0, Microsoft Office SharePoint Server 2007 et versions ultérieures, et SharePoint Online.

Avant de commencer

Dans votre projet Google Cloud, effectuez les tâches suivantes :

  • Assurez-vous que la connectivité réseau est configurée. Pour en savoir plus, consultez Connectivité réseau.
  • Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
  • Attribuez les rôles IAM roles/secretmanager.viewer et roles/secretmanager.secretAccessor au compte de service que vous souhaitez utiliser pour le connecteur :
  • Activez secretmanager.googleapis.com (API Secret Manager) et connectors.googleapis.com (API Connectors). Pour en savoir plus, consultez Activer des services.

Créer une connexion SharePoint

Une connexion est propre à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit :

  1. Dans la console Cloud, accédez à la page Connecteurs d'intégration > Connexions, puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connexions"

  2. Cliquez sur + Créer pour ouvrir la page Créer une connexion.
  3. Dans la section Emplacement, sélectionnez un emplacement dans la liste Région, puis cliquez sur Suivant.

    Pour obtenir la liste de toutes les régions disponibles, consultez Emplacements.

  4. Dans la section Détails de connexion, procédez comme suit :
    1. Sélectionnez SharePoint dans la liste des connecteurs.
    2. Sélectionnez une version de connecteur dans la liste Version du connecteur.
    3. Dans le champ Nom de connexion, saisissez un nom pour l'instance de connexion. Le nom de la connexion peut contenir des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre et se terminer par une lettre ou un chiffre. Il ne doit pas dépasser 49 caractères.
    4. (Facultatif) Saisissez une description de l'instance de connexion.
    5. (Facultatif) Activez Cloud Logging, puis sélectionnez un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur Error.
    6. Dans le champ Compte de service, sélectionnez un compte disposant des rôles requis.
    7. (Facultatif) Configurez les paramètres des nœuds de connexion :

      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour améliorer la disponibilité) et le nombre maximal de nœuds sur 50.

    8. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
    9. Cliquez sur Suivant.
  5. Dans la section Destinations, saisissez les informations concernant l'hôte distant (système backend) auquel vous souhaitez vous connecter, puis cliquez sur Suivant.

    6. Dans le champ Type de destination, sélectionnez un type de destination. Par exemple, l'adresse de l'hôte est https://<SITE_NAME>.sharepoint.com.

    • Pour spécifier le nom d'hôte ou l'adresse IP de la destination, sélectionnez Adresse de l'hôte, puis saisissez l'adresse dans le champ Hôte 1.
    • Pour établir une connexion privée, sélectionnez Rattachement de point de terminaison, puis choisissez le rattachement requis dans la liste Rattachement de point de terminaison.

    Si vous souhaitez établir une connexion publique à vos systèmes backend avec une sécurité supplémentaire, vous pouvez envisager de configurer des adresses IP sortantes statiques pour vos connexions, puis de configurer vos règles de pare-feu pour ajouter à la liste d'autorisation uniquement les adresses IP statiques spécifiques.

    Pour saisir d'autres destinations, cliquez sur + Ajouter une destination.
  6. Dans la section Authentification, saisissez les informations d'authentification.
    1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

      Les types d'authentification suivants sont compatibles avec la connexion SharePoint :

      • Identifiants Windows. Sélectionnez cette option si vous utilisez l'édition On-Premises de SharePoint.
      • Azure AD. Sélectionnez cette option si vous utilisez l'édition Online de SharePoint.
      • Identifiants client OAuth 2.0 avec un jeton de support JWT. Sélectionnez cette option si vous utilisez des identifiants client OAuth 2.0 avec un jeton de support JWT pour l'authentification.
      • Identifiants client OAuth 2.0 avec code secret du client. Sélectionnez cette option si vous utilisez des identifiants client OAuth 2.0 avec un code secret de client pour l'authentification.

      2. Pour savoir comment configurer ces types d'authentification, consultez Configurer l'authentification.

    2. Cliquez sur Suivant.
  7. Dans la section Vérifier, examinez vos informations de connexion et d'authentification.
  8. Cliquez sur Créer.

Configurer l'authentification

Le connecteur SharePoint est compatible avec les types d'authentification suivants :

Type d'authentification par identifiants Windows

Pour activer le type d'authentification par identifiants Windows, procédez comme suit :

  1. Configurez PSC et créez un rattachement de point de terminaison.
  2. Spécifiez les identifiants dans Google Cloud.

Configurer PSC et créer un rattachement de point de terminaison

  1. Créez un groupe d'instances avec l'adresse IP où SharePoint est hébergé.
  2. Créez un équilibreur de charge réseau passthrough interne et utilisez le groupe d'instances que vous avez créé comme backend. L'accès mondial doit être activé pour l'équilibreur de charge interne TCP.
  3. Publiez l'équilibreur de charge dans Private Service Connect. Un rattachement de service est généré une fois l'équilibreur de charge publié.
  4. Publiez le service et spécifiez l'équilibreur de charge que vous avez créé.
  5. Utilisez le rattachement de service pour créer un rattachement de point de terminaison.
  6. Après avoir créé le rattachement de point de terminaison, créez une connexion SharePoint avec l'adresse IP du rattachement de point de terminaison.

    7. Pour en savoir plus sur la création d'un rattachement de point de terminaison, consultez Créer un rattachement de point de terminaison.

Spécifier les informations d'identification Windows dans Google Cloud

Lorsque vous créez la connexion dans Integration Connectors, vous devez spécifier les informations indiquées ci-dessous.

Dans la section Authentification, sélectionnez Identifiants Windows comme type d'authentification, puis saisissez les informations suivantes :

  • Nom d'utilisateur : saisissez le nom d'utilisateur.
  • Mot de passe : sélectionnez le mot de passe.
  • Version du secret : saisissez la version du secret.

Type de connexion avec des identifiants Windows

Le tableau suivant présente des exemples de valeurs de configuration pour le type de connexion avec des identifiants Windows.

Nom du champ Détails
Région us-central1
Connecteur SharePoint
Version du connecteur 1
Nom de connexion sharepoint-staging-psc
Compte de service NOM_COMPTE_SERVICE@ID_PROJET.iam.gserviceaccount.com
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Type de destination Adresse de l'hôte
hôte 1 http://192.0.2.0
port 1 24
Authentification Identifiants Windows
Nom d'utilisateur USER_NAME
Mot de passe MOT DE PASSE
Version du secret 1

Type d'authentification par Azure AD

Pour activer le type d'authentification par Azure AD, procédez comme suit :

  1. Enregistrez votre application et obtenez l'OAuthClientId ainsi que l'OAuthClientSecret.
  2. Spécifiez les identifiants dans Google Cloud.
  3. Autorisez la connexion dans Google Cloud.
  4. Ajoutez l'URL de redirection à votre application.

Enregistrer votre application et obtenir l'OAuthClientId ainsi que l'OAuthClientSecret

Pour enregistrer votre application et obtenir l'OAuthClientId ainsi que l'OAuthClientSecret, procédez comme suit :

  1. Connectez-vous au portail Azure.
  2. Dans Services Azure, sélectionnez Enregistrements d'applications, puis Nouvel enregistrement.
  3. Saisissez un nom d'application, puis sélectionnez Any Microsoft Entra ID tenant - Multitenant (N'importe quel locataire Microsoft Entra ID - Mutualisé).
  4. Cliquez sur S'inscrire.
  5. Après avoir créé l'application, accédez à la page Certificates & secrets (Certificats et secrets).
  6. Créez un code secret du client pour l'application, puis enregistrez-code secret du client.
  7. Accédez à la page Autorisations de l'API.
  8. Cliquez sur Ajouter une autorisation.
  9. Dans la boîte de dialogue Demander des autorisations d'API, sélectionnez l'API, le type et les autorisations du tableau suivant pour effectuer des opérations dans l'application.

    10. Pour que la connexion soit active, vous devez accorder l'autorisation Sites.Read.All pour l'API Microsoft Graph.

    API Nom des autorisations Type
    Microsoft Graph ConsentRequest.Read.All Application/ Delegated
    Microsoft Graph ConsentRequest.ReadWrite.All Application/ Delegated
    Microsoft Graph DelegatedAdminRelationship.Read.All Application/ Delegated
    Microsoft Graph DelegatedAdminRelationship.ReadWrite.All Application/ Delegated
    Microsoft Graph DelegatedPermissionGrant.Read.All Application/ Delegated
    Microsoft Graph DelegatedPermissionGrant.ReadWrite.All Application/ Delegated
    Microsoft Graph Files.Read.All Application/ Delegated
    Microsoft Graph Files.ReadWrite.All Application/ Delegated
    Microsoft Graph Sites.FullControl.All Application/ Delegated
    Microsoft Graph Sites.Manage.All Application/ Delegated
    Microsoft Graph Sites.Read.All Application/ Delegated
    Microsoft Graph Sites.ReadWrite.All Application/ Delegated
    Microsoft Graph Sites.Selected Application/ Delegated
    Microsoft Graph TermStore.Read.All Application/ Delegated
    Microsoft Graph TermStore.ReadWrite.All Application/ Delegated
    Microsoft Graph User.Export.All Application/ Delegated
    Microsoft Graph User.Read Delegated
    Microsoft Graph User.Read.All Application/ Delegated
    Microsoft Graph User.ReadWrite.All Application/ Delegated
    SharePoint EnterpriseResource.Read Delegated
    SharePoint EnterpriseResource.Write Delegated
    SharePoint Project.Read Delegated
    SharePoint Project.Write Delegated
    SharePoint ProjectWebApp.FullControl Delegated
    SharePoint ProjectWebAppReporting.Read Delegated
    SharePoint TaskStatus.Submit Delegated
  10. Enregistrez les modifications.
  11. Si vous avez choisi d'utiliser des autorisations qui nécessitent le consentement de l'administrateur, vous pouvez les accorder à partir du locataire actuel sur la page API Permissions (Autorisations d'API).
  12. Pour ajouter le niveau d'accès, accédez à la section Expose an API (Exposer une API), ajoutez les niveaux d'accès AllSites.Manage, Sites.FullControl.All et sélectionnez "Admins and users" (Administrateurs et utilisateurs) pour indiquer qui peut les contrôler.
  13. Cliquez sur Enregistrer.

Spécifiez les identifiants dans Google Cloud.

Lorsque vous créez la connexion dans Integration Connectors, vous devez spécifier les informations indiquées ci-dessous.

Dans la section Authentification, sélectionnez AzureAD comme type d'authentification, puis saisissez les informations suivantes :

  • ID client : saisissez l'ID client utilisé pour demander des jetons d'accès.
  • Niveaux d'accès : saisissez une liste de niveaux d'accès souhaités, séparés par une virgule. Par exemple : Sites.FullControl.All.
  • Code secret du client : saisissez le code secret contenant le code secret du client pour l'application connectée que vous avez créée.
  • Version du secret : version du secret sélectionné ci-dessus.
  • URL d'autorisation : URL d'autorisation que vous générez lorsque vous créez un client OAuth. Saisissez l'URL au format suivant : https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent. Par exemple : https://login.microsoftonline.com/9byyyyyyyyy8112/oauth2/v2.0/authorize?prompt=consent.

Autorisez la connexion dans Google Cloud.

  1. Sur la page Connexions, recherchez la connexion que vous venez de créer.

    L'état du nouveau connecteur sera Autorisation requise.

  2. Cliquez sur Autorisation requise.

    Le volet Modifier l'autorisation s'affiche.

  3. Copiez la valeur de l'URI de redirection dans votre application externe. Pour en savoir plus, consultez Ajouter l'URL de redirection à votre application.
  4. Vérifiez les détails de l'autorisation.
  5. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Ajouter l'URL de redirection à votre application

  1. Sur le portail Azure, cliquez sur Azure services > App registrations (Services Azure > Enregistrements d'applications).
  2. Cliquez sur le nom de votre application.
  3. Cliquez sur "Add Redirect URI" (Ajouter un URI de redirection).
  4. Cliquez sur Add a platform (Ajouter une plate-forme).
  5. Dans la boîte de dialogue Web, collez l'URI de redirection que vous avez copié lorsque vous avez autorisé la connexion dans Google Cloud.

Type de connexion Azure AD

Le tableau suivant présente des exemples de valeurs de configuration pour le type de connexion avec Azure AD :

Nom du champ Détails
Région us-central1
Connecteur SharePoint
Version du connecteur 1
Nom de connexion sharepoint-google-cloud-con
Compte de service NOM_COMPTE_SERVICE@ID_PROJET.iam.gserviceaccount.com
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Type de destination Adresse de l'hôte
hôte 1 http://z8**.sharepoint.com
Authentification AzureAD
ID client ID_CLIENT
Niveaux d'accès Sites.FullControl.All
Code secret du client SECRET_CLIENT
Version du secret 1
URL d'autorisation https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

Type d'authentification par identifiants client OAuth 2.0 avec un jeton de support JWT

Pour activer le type d'authentification par identifiants client OAuth 2.0 avec un jeton de support JWT, procédez comme suit :

  1. Créez un certificat.
  2. Importez le certificat sur le portail Azure.
  3. Obtenez une clé privée.
  4. Terminez la configuration.
  5. Spécifiez les identifiants OAuth 2.0 avec un jeton de support JWT dans Google Cloud.

Créer un certificat

  1. Créez un dossier vide sur votre ordinateur.
  2. Créez un fichier texte dans le dossier.
  3. Copiez le script PowerShell figurant sur la page Accorder l'accès uniquement via application Azure AD et collez-le dans le fichier texte.
  4. Remplacez le nom du fichier texte par Create-SelfSignedCertificate.ps1.
  5. Exécutez Windows PowerShell dans le dossier.
  6. Accédez au répertoire contenant le fichier texte.
  7. Copiez la commande suivante : .\Create-SelfSignedCertificate.ps1 -CommonName "CERTIFICATE_NAME" -StartDate 2022-09-25 -EndDate 2023-10-25

    Saisissez un nom unique pour NOM_CERTIFICAT. Remplacez la StartDate par la date actuelle et l'EndDate par la date de votre choix.

  8. Collez la commande copiée avec vos modifications dans Windows PowerShell, puis appuyez sur Entrée.

    Windows PowerShell vous demande de saisir le mot de passe pour protéger la clé privée. Veillez à enregistrer le mot de passe pour les prochaines fois.

    Windows PowerShell crée deux fichiers : MyCertificate.pfx et MyCertificate.cer.

Importer le certificat sur le portail Azure

  1. Connectez-vous au portail Azure et enregistrez une application en spécifiant les informations suivantes :
    • Name (Nom) : saisissez le nom de l'application.
    • Supported account types (Types de comptes pris en charge) : sélectionnez Accounts in this organizational directory only (Account name only - Single tenant) [(Comptes dans cet annuaire organisationnel uniquement (Nom de compte uniquement - Locataire unique)].
  2. Accédez à API Permissions > Add permission > Request API permissions > SharePoint (Autorisations d'API > Ajouter une autorisation > Demander des autorisations d'API > SharePoint).
  3. Sélectionnez Application permissions (Autorisations de l'application), puis ajoutez les autorisations requises.
  4. Sélectionnez Grant admin consent (Accorder le consentement administrateur), puis Yes (Oui).
  5. Après avoir créé l'application, accédez à la section Certificates & Secrets (Certificats et secrets).
  6. Sélectionnez Upload Certificate (Importer un certificat), puis importez votre certificat CER depuis votre ordinateur. Une fois l'importation terminée, sélectionnez Add (Ajouter).

    N'ajoutez pas de codes secrets de client dans l'application, car cela interfère avec le flux d'authentification basée sur les certificats.

  7. Accédez au fichier manifeste, recherchez "KeyCredentials", puis copiez le customKeyIdentifier en tant qu'empreinte. Vous l'utiliserez plus tard. Vous avez maintenant enregistré l'application et associé le certificat.

Obtenir une clé privée

Vous pouvez obtenir une clé privée en convertissant le fichier PFX en fichier PEM à l'aide d'OpenSSL.

  1. À partir de l'invite de commande, accédez au dossier contenant votre fichier PFX et exécutez la commande suivante : openssl pkcs12 -in MyCertificate.pfx -out MyCertificate.pem -nodes.
  2. Saisissez le mot de passe PFX que vous avez utilisé lors du processus de création du certificat.
  3. Ouvrez le fichier PEM dans un éditeur de texte et copiez l'intégralité du texte, qui correspond à votre clé privée.

Terminer la configuration

  1. Copiez l'ID client et l'ID de locataire de l'application que vous venez d'enregistrer sur le portail Azure.
  2. Connectez-vous à l'aide de l'authentification par compte de service principal de liste SharePoint avec les identifiants suivants :
    • ID client
    • ID du locataire
    • Clé privée
    • Empreinte (mot de passe de la clé privée)

Spécifiez les identifiants OAuth 2.0 avec un jeton de support JWT dans Google Cloud.

Lorsque vous créez la connexion dans Integration Connectors, vous devez spécifier les informations indiquées ci-dessous.

Dans la section Authentification, sélectionnez Identifiants client OAuth 2.0 avec un jeton de support JWT comme type d'authentification, puis saisissez les informations suivantes :

  • Dans le champ ID client, saisissez l'ID client utilisé pour demander des jetons d'accès. Il s'agit de la clé client générée lorsque vous avez enregistré l'application sur le portail Azure.
  • Dans le champ Clé privée, sélectionnez le secret Secret Manager contenant le contenu du fichier de clé privée au format PEM. La clé privée doit correspondre à la clé publique/au certificat fournis au connecteur.
  • Dans le champ Version du secret, sélectionnez la version du secret sélectionné ci-dessus.
  • Dans le champ Mot de passe de la clé privée, sélectionnez le secret Secret Manager contenant le mot de passe (paraphrase) du fichier de clé privée. Utilisez le même mot de passe que celui que vous avez défini pour protéger la clé privée lorsque vous avez créé le certificat.
  • Dans le champ Version du secret, sélectionnez la version du secret sélectionné ci-dessus.
  • Dans le champ Locataire Azure, saisissez le locataire Microsoft Online utilisé pour accéder aux données.

Type de connexion à l'aide d'un certificat avec un jeton de support JWT

Le tableau suivant présente des exemples de valeurs de configuration pour le type de connexion à l'aide d'un certificat OAuth 2.0 avec un jeton de support JWT.

Nom du champ Détails
Région europe-west1
Connecteur SharePoint
Version du connecteur 1
Nom de la connexion sharepoint-jwt-certificate
Compte de service NOM_COMPTE_SERVICE@ID_PROJET.iam.gserviceaccount.com
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Type de destination Adresse de l'hôte
hôte 1 http://z8**.sharepoint.com
port 1 ****
Authentification Identifiants client OAuth 2.0 avec un jeton de support JWT
ID client OAuth ID_CLIENT
Clé privée CLÉ
Version du secret 1
Mot de passe de la clé privée MOT DE PASSE
Version du secret 1
Locataire Azure AZURE_TENANT_ID

Type de connexion avec un code secret de client OAuth 2.0

Pour activer le type de connexion avec un code secret de client OAuth 2.0, procédez comme suit :

  1. Enregistrez le module complémentaire.
  2. Accordez des autorisations au module complémentaire.
  3. Spécifiez les identifiants client OAuth 2.0 dans Google Cloud.
  4. Accordez une nouvelle autorisation pour le code d'autorisation.

Enregistrer le module complémentaire

  1. Accédez à la page Register Add-In (Enregistrer un module complémentaire) à l'aide de l'URL suivante : https://<SITE_NAME>.SharePoint.com/_layouts/15/appregnew.aspx.
  2. Dans la section Informations sur l'application, générez l'ID client et le code secret du client.
  3. Spécifiez les valeurs pour le titre, le domaine de l'application et l'URI de redirection.
  4. Cliquez sur Create (Créer). Le module complémentaire est enregistré et l'application SharePoint affiche les informations créées.

Accorder des autorisations au module complémentaire

  1. Accédez au site SharePoint à l'aide de l'URL suivante : https://<SITE_NAME>-admin.sharepoint.com/_layouts/15/appinv.aspx. Vous êtes redirigé vers la page Grant Permission (Accorder l'autorisation).
  2. Dans le champ ID de l'application, saisissez l'ID client que vous avez généré précédemment, puis cliquez sur Rechercher. Les valeurs du titre, du domaine de l'application et de l'URL de redirection sont renseignées.
  3. Saisissez la demande d'autorisation suivante au format XML : 
          <AppPermissionRequests AllowAppOnlyPolicy="true">
      <AppPermissionRequest Scope="http://sharepoint.com/content/tenant" Right="FullControl"/>
      </AppPermissionRequests>
  4. Cliquez sur Créer. L'application Sharepoint affiche une boîte de dialogue de recueil du consentement.
  5. Cliquez sur Approuver.

Spécifiez les identifiants client OAuth 2.0 dans Google Cloud.

Lorsque vous créez la connexion dans Integration Connectors, vous devez spécifier les informations suivantes :

Dans la section Authentification, sélectionnez Identifiants client OAuth 2.0 avec code secret du client comme type d'authentification, puis saisissez les informations suivantes :

  • Dans le champ ID client, saisissez l'ID client fourni par le connecteur pour l'application que vous avez créée.
  • Dans le champ Code secret du client, sélectionnez le secret Secret Manager contenant le code secret du client pour l'application connectée que vous avez créée.
  • Dans le champ Version du secret, sélectionnez la version du code secret du client.

Accordez une nouvelle autorisation pour le code d'autorisation.

Si vous utilisez le type d'authentification Authorization code et que vous avez modifié la configuration de votre application SharePoint, vous devez autoriser à nouveau votre connexion SharePoint. Pour autoriser à nouveau une connexion, procédez comme suit :

  1. Sur la page Connexions, cliquez sur la connexion requise.

    La page de détails de la connexion s'ouvre.

  2. Cliquez sur Modifier pour modifier les détails de la connexion.
  3. Dans la section Authentification, vérifiez les détails du code d'autorisation OAuth 2.0.

    Apportez des modifications, si besoin.

  4. Cliquez sur Enregistrer. La page de détails de la connexion s'affiche.
  5. Dans la section Authentification, cliquez sur Modifier l'autorisation. Le volet Autoriser s'affiche.
  6. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Type de connexion avec des identifiants client

Le tableau suivant présente des exemples de valeurs de configuration pour le type de connexion avec des identifiants client OAuth 2.0.

Nom du champ Détails
Région europe-west1
Connecteur SharePoint
Version du connecteur 1
Nom de la connexion sharepoint-client-credentials
Compte de service NOM_COMPTE_SERVICE@ID_PROJET.iam.gserviceaccount.com
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Type de destination Adresse de l'hôte
hôte 1 http://z8**.sharepoint.com
port 1 ****
Authentification Identifiants client OAuth 2.0 avec code secret de client
ID client ID_CLIENT
Code secret du client SECRET_CLIENT
Version du secret 1

Utiliser la connexion SharePoint dans une intégration

Une fois la connexion créée, elle devient disponible dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration au moyen de la tâche "Connecteurs".

Actions

Dans cette section, vous trouverez une liste non exhaustive des actions prises en charge par le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action DeleteAttachment

Cette action supprime une pièce jointe.

Paramètres d'entrée de l'action DeleteAttachment

Nom du paramètre Type de données Obligatoire Description
ListTitle STRING Oui Titre de l'élément de liste.
ItemId Chaîne Oui ID de l'élément de liste.
FileName Chaîne Oui Nom du fichier à supprimer de la bibliothèque de documents.

Action CheckInDocument

Cette action permet d'archiver un document.

Paramètres d'entrée de l'action CheckInDocument

Nom du paramètre Type de données Obligatoire Description
RelativeURL STRING Oui URL relative du dossier.
DocumentName STRING Oui Nom du fichier à archiver.
Comment STRING Non Message d'archivage facultatif.

Action CheckOutDocument

Cette action permet d'extraire un fichier.

Paramètres d'entrée de l'action CheckOutDocument

Nom du paramètre Type de données Obligatoire Description
RelativeURL STRING Oui URL relative du dossier.
DocumentName STRING Oui Nom du fichier à extraire.

Action DiscardCheckOutDocument

Cette action permet d'annuler l'extraction d'un fichier.

Paramètres d'entrée de l'action DiscardCheckOutDocument

Nom du paramètre Type de données Obligatoire Description
RelativeURL STRING Oui URL relative du dossier.
DocumentName STRING Oui Nom du fichier dont l'extraction doit être annulée.

Action CopyDocument

Cette action permet de copier un fichier d'un emplacement vers un autre.

Paramètres d'entrée de l'action CopyDocument

Nom du paramètre Type de données Obligatoire Description
SourceFileRelativeUrl STRING Oui URL relative du fichier source.
DestFileRelativeUrl STRING Oui URL relative du fichier de destination.

Action UploadDocument

Cette action permet d'importer un fichier.

Paramètres d'entrée de l'action UploadDocument

Nom du paramètre Type de données Obligatoire Description
FileName Chaîne Oui Nom du fichier à importer.
RelativeUrl STRING Oui URL relative du dossier.
Content Chaîne Non Contenu à importer en tant que fichier.
ContentBytes Chaîne Non Contenu de type octets (chaîne Base64) à importer en tant que fichier. À utiliser pour importer des données binaires.
HasBytes Booléen Non Indique si le contenu à importer est binaire. La valeur par défaut est false.

Action DownloadDocument

Cette action permet de télécharger un fichier.

Paramètres d'entrée de l'action DownloadDocument

Nom du paramètre Type de données Obligatoire Description
RemoteFile Chaîne Oui URL complète du fichier à télécharger.
Library STRING Oui Nom de la bibliothèque sur le serveur SharePoint.
HasBytes Booléen Non Indique si le contenu doit être téléchargé sous forme d'octets. La valeur par défaut est false.

Action MoveAttachmentOrDocument

Cette action permet de déplacer un fichier d'un dossier à un autre.

Paramètres d'entrée de l'action MoveAttachmentOrDocument

Nom du paramètre Type de données Obligatoire Description
SourceFileURL STRING Oui URL du fichier source à déplacer.
DestinationFolderURL STRING Oui URL du dossier de destination.

Action CreateFolder

Cette action permet de créer un dossier.

Paramètres d'entrée de l'action CreateFolder

Nom du paramètre Type de données Obligatoire Description
RelativeURL STRING Oui URL relative du dossier.
FolderName STRING Oui Nom du dossier à créer.

Action AddAttachments

Cette action permet d'ajouter une pièce jointe.

Paramètres d'entrée de l'action AddAttachments

Nom du paramètre Type de données Obligatoire Description
ListTitle STRING Oui Nom de la liste de pièces jointes.
FileName Chaîne Oui Nom du fichier en pièce jointe.
ItemId Chaîne Oui ID de la pièce jointe à ajouter.
Content Chaîne Oui Contenu de la pièce jointe.
ContentBytes Chaîne Non Contenu de type octets (chaîne Base64) à importer en tant que pièce jointe. À utiliser pour importer des données binaires.
HasBytes Booléen Non Indique si le contenu à importer est binaire. La valeur par défaut est false.

Action DownloadAttachments

Cette action permet de télécharger des pièces jointes.

Paramètres d'entrée de l'action DownloadAttachments

Nom du paramètre Type de données Obligatoire Description
RemoteFile Chaîne Oui URL relative du fichier.
HasBytes Booléen Non Indique si le contenu à télécharger est binaire. La valeur par défaut est false.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : Supprimer une pièce jointe

Cet exemple supprime le fichier spécifié.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DeleteAttachment, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"ListTitle": "My lists",
"ItemId": "1",
"FileName": "sitepages.txt"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DeleteAttachment aura une valeur semblable à la suivante :

    [{
"Status": "Success"
}]

Exemple : Archiver un document

Cet exemple archive un document.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CheckInDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.txt",
"Comment": "Comment test"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CheckInDocument aura une valeur semblable à la suivante :

    [{
"Status": "Success"
}]

Exemple : Extraire un fichier

Cet exemple extrait un fichier.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CheckOutDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.txt"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CheckOutDocument aura une valeur semblable à la suivante :

    [{
"Status": "Success"
}]

Exemple : Annuler une extraction

Cet exemple annule l'extraction d'un fichier.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DiscardCheckOutDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.docx"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DiscardCheckOutDocument aura une valeur semblable à la suivante :

    [{
"Status": "Success"
}]

Exemple : Copier un fichier

Cet exemple copie un fichier d'un emplacement vers un autre.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CopyDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"SourceFileRelativeUrl": "/Shared Documents/Document.docx",
"DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CopyDocument aura une valeur semblable à la suivante :

    [{
"Status": "Success"
}]

Exemple : Importer un fichier texte

Cet exemple importe un fichier texte à l'emplacement spécifié.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UploadDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"FileName": "test.txt",
"RelativeUrl": "/Shared Documents/TestFolder",
"Content": "abcd"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UploadDocument aura une valeur semblable à la suivante :

    [{
"Status": "Success"
}]

Exemple : Importer un fichier binaire

Cet exemple importe un fichier binaire à l'emplacement spécifié. Lorsque vous importez un fichier binaire, spécifiez le contenu à importer sous la forme d'une chaîne encodée en Base64.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UploadDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"FileName": "test.txt",
"RelativeUrl": "/Shared Documents/TestFolder",
"ContentBytes": "SGVsbG8gd29ybGQK",
"HasBytes": "true"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UploadDocument aura une valeur semblable à la suivante :

    [{
"Status": "Success"
}]

Exemple : Télécharger un fichier

Cet exemple télécharge un fichier.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"RemoteFile": "/TestFolder/test.txt",
"Library": "Shared Documents"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadDocument aura une valeur semblable à la suivante :

    [{
"Success": "True",
"Content": "Test File",
}]

Exemple : Télécharger un fichier binaire

Cet exemple télécharge un fichier binaire.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"RemoteFile": "/TestFolder/test1.png",
"Library": "Shared Documents"
"HasBytes": "true"  
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadDocument aura une valeur semblable à la suivante :

    [{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

Exemple : Télécharger un fichier à partir d'un site spécifique

Cet exemple télécharge un fichier à partir d'un site spécifique.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
  "RemoteFile": "	http://z8**.sharepoint.com/sites/SharepointGCS/Docs/SharpointGCS.docx",
  "Library": "Docs",
  "HasBytes": true
}
    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadDocument aura une valeur semblable à la suivante :

    [
  {
    "Success": "True",
    "ContentBytes": "UEsDBAoAAAAAAAAAIQD/////TwEAAE8BAAAQAAAAW3RyYXNoXS8wMDAwLmRhdP////nFmjQeC1QbGmk9o7n0xjiLgudAMOrYQBpOZdZp5/OrWkWbudVPccasL5uVSKun3URrHAxow7iMUm2WSi7nlGy2Mr+sjJxQSrYFcFtDQyo/QSutWhbNcAODEWh14mklzxCS9C5CW3Fmwme/gMKGjGoXlSVyvtDoB+u0A6XtA8bkWTnPNHSvxcepoAKIdsR96imCvxe4MxOWqHWnQkLDyjNMOMrrQeMDF7nOMCCvPlVn5Vd6KlDYnHlW1zLOcQf6WmKl2xN4Z8WBXZfkrJZqPv6yNdWyp8ADRmgTdRSqDkPpQqzvqWj3qpdiRZqSwyBRtfr2kHBumkTNjSi6drBMFMxZEgrktw6ZxuEXcx3v16cXd6k5JVO3kOXMg/HFnH"
  }
]

    Pour télécharger un fichier à partir d'un site spécifique, vous devez fournir l'adresse complète du fichier distant.

Exemple : Déplacer une pièce jointe

Cet exemple déplace une pièce jointe d'un emplacement à un autre.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action MoveAttachmentOrDocument, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"SourceFileURL": "/Shared Documents/test.txt",
"DestinationFolderURL": "/Shared Documents/TestFolder"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche MoveAttachmentOrDocument aura une valeur semblable à la suivante :

    [{
"Result": "Success"
}]

Exemple : Créer un dossier

Cet exemple crée un dossier à l'emplacement spécifié.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CreateFolder, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"RelativeURL": "/Shared Documents/TestFolder",
"FolderName": "TestFolder123"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreateFolder aura une valeur semblable à la suivante :

    [{
"Id": "110842b7-2393-4f11-9391-3d75214e9fb8",
"Status": "Success"
}]

Exemple : Ajouter une pièce jointe

Cet exemple ajoute une pièce jointe à la liste spécifiée.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddAttachments, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"ListTitle": "My Lists",
"FileName": "TestAttachment2",
"Content": "abcd text",
"ItemId": "1"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche AddAttachments aura une valeur semblable à la suivante :

    [{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment2",
"Status": "Success"
}]

Exemple : Ajouter une pièce jointe binaire

Cet exemple ajoute une pièce jointe binaire à la liste spécifiée.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddAttachments, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"ListTitle": "My Lists",
"FileName": "TestAttachment3",
"ContentBytes": "VGVzdCBGaWxl",
"HasBytes": "true",  
"ItemId": "1"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche AddAttachments aura une valeur semblable à la suivante :

    [{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment3",
"Status": "Success"
}]

Exemple : Télécharger une pièce jointe

Cet exemple télécharge une pièce jointe.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadAttachments, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"RemoteFile": "/Shared Documents/Document.txt"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadAttachments aura une valeur semblable à la suivante :

    [{
"Success": "True",
"Content": "Test File",
}]

Exemple : Télécharger une pièce jointe binaire

Cet exemple télécharge une pièce jointe binaire.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadAttachments, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"RemoteFile": "/Shared Documents/Document.docx",
"HasBytes": "true"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadAttachments aura une valeur semblable à la suivante :

    [{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister tous les fichiers

Cet exemple liste tous les fichiers de l'entité Files.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Files dans la liste Entity.
  3. Sélectionnez l'opération List, puis cliquez sur OK.
  4. (Facultatif) Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez filtrer votre ensemble de résultats en spécifiant une clause de filtre. Vous pouvez également spécifier plusieurs conditions de filtre à l'aide des opérateurs logiques.

Exemple : Récupérer une liste

Cet exemple récupère une liste ayant l'ID spécifié à partir de l'entité My Lists.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez My Lists dans la liste Entity.
  3. Sélectionnez l'opération Get, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez 3 dans le champ Valeur par défaut.

    Ici, 3 est une valeur de clé primaire dans l'entité My Lists.

Exemple : Créer un enregistrement

Cet exemple crée un enregistrement dans l'entité My Lists.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez My Lists dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    {
"AuthorId": 11.0, 
"BaseName": "3_",
"Attachments": false,
"Title": "Created List New"
}

    Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    [{
"ID": 3.0
}]

Exemple : Supprimer un enregistrement

Cet exemple supprime l'enregistrement ayant l'ID spécifié dans l'entité My Lists.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez My Lists dans la liste Entity.
  3. Sélectionnez l'opération Delete, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez 2 dans le champ Valeur par défaut.
  • Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Apigee Integration, consultez Tâche "Connecteurs".
  • Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Application Integration, consultez Tâche "Connecteurs".

Demander de l'aide à la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étapes suivantes