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 Integration Connectors > 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 la 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. Le connecteur SharePoint existe en deux versions : V1 et V2.
   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.

   Remarque : Vous ne pouvez personnaliser les valeurs des nœuds de connexion que si vous avez opté pour le paiement à l'usage.
   8. (Facultatif) Dans la section Paramètres avancés, cochez la case Utiliser un proxy pour configurer un serveur proxy pour la connexion et configurez les valeurs suivantes :
   • Schéma d'authentification du proxy : sélectionnez le type d'authentification pour l'authentification auprès du serveur proxy. Les types d'authentification suivants sont compatibles :
     • De base : authentification HTTP de base.
     • Digest : authentification HTTP Digest.
   • Utilisateur du proxy : nom d'utilisateur permettant de s'authentifier auprès du serveur proxy.
   • Mot de passe du proxy : secret Secret Manager du mot de passe de l'utilisateur.
   • Type SSL du proxy : type SSL à utiliser pour se connecter au serveur proxy. Les types d'authentification suivants sont compatibles :
     • Auto : paramètre par défaut. Dans le cas d'une URL HTTPS, l'option "Tunnel" est utilisée. Dans le cas d'une URL HTTP, l'option "Jamais" est utilisée.
     • Toujours : le protocole SSL est toujours activé pour la connexion.
     • Jamais : le protocole SSL n'est pas activé pour la connexion.
     • Tunnel : la connexion s'effectue avec un proxy de tunnelisation. Le serveur proxy ouvre une connexion à l'hôte distant et le trafic transite par le proxy.
   • Dans la section Serveur proxy, saisissez les détails du serveur proxy.
     1. Cliquez sur + Ajouter une destination.
     2. Sélectionnez un type de destination.
        • Adresse de l'hôte : spécifiez le nom d'hôte ou l'adresse IP de la destination.

          Si vous souhaitez établir une connexion privée à votre système backend, procédez comme suit :

          • Créez un rattachement de service PSC.
          • Créez un rattachement de point de terminaison, puis saisissez les détails du rattachement de point de terminaison dans le champ Adresse de l'hôte.
   9. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
   10. 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.

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.
  Remarque : Pour savoir comment créer un rattachement de point de terminaison, consultez Rattachement de service PSC et Rattachement de point de terminaison. Une fois le rattachement de point de terminaison créé, il apparaît 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.

   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.

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 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.

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

API	Nom de l'autorisation	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?prompt=consent

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 App information (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 des 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.

Remarque : Les résultats de toutes les actions seront disponibles sous forme de réponse JSON dans le paramètre de réponse connectorOutputPayload de la tâche Connectors une fois l'intégration exécutée.

Version 1

Actions prises en charge dans la version 1

AddAttachments, CheckInDocument, CheckOutDocument, CopyDocument, CreateFolder, DeleteAttachment, DiscardCheckOutDocument, DownloadAttachments, DownloadDocument, MoveAttachmentOrDocument et UploadDocument.

Version 2

Actions prises en charge dans la version 2

AddAttachments, AddLists, CheckInDocument, CheckInFile, CheckPermission, CheckOutDocument, CopyDocument, CreateFolder, DeleteAttachment, DeleteDocument, DeleteLists, DiscardCheckOutDocument, DownloadAttachments, DownloadDocument, MoveAttachmentOrDocument et UploadDocument.

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	Identifiant de l'élément de liste.
FileName	Chaîne	Oui	Nom du fichier à supprimer de la bibliothèque de documents.

Pour obtenir un exemple de configuration de l'action DeleteAttachment, consultez Exemples.

Action AddLists

Cette action ajoute une liste à la bibliothèque de documents.

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

Nom du paramètre	Type de données	Obligatoire	Description
Modèle	Chaîne	Non	Nom du modèle utilisé.
Description	Chaîne	Non	Description de la liste.
Nom	Chaîne	Non	Nom de la liste à ajouter à la bibliothèque de documents.

Pour obtenir un exemple de configuration de l'action AddLists, consultez Exemples.

Action DeleteDocument

Cette action supprime le document de la bibliothèque.

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

Nom du paramètre	Type de données	Obligatoire	Description
Bibliothèque	STRING	Oui	Nom de la bibliothèque de documents dans laquelle le fichier est stocké.
Chemin d'accès	STRING	Oui	Chemin relatif du document.

Pour obtenir un exemple de configuration de l'action DeleteDocument, consultez Exemples.

Action CheckPermission

Cette action vérifie les autorisations d'un utilisateur ou d'un groupe sur une liste ou un élément de liste.

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

Nom du paramètre	Type de données	Obligatoire	Description
ListName	Chaîne	Non	Titre de la liste.
Compte principal	Chaîne	Non	Nom de connexion de l'utilisateur
ItemId	Chaîne	Non	Identifiant de l'élément de liste.

Pour obtenir un exemple de configuration de l'action CheckPermission, consultez Exemples.

Action DeleteLists

Cette action supprime une liste dans la bibliothèque de documents.

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

Nom du paramètre	Type de données	Obligatoire	Description
Name	Chaîne	Non	Nom de la liste à supprimer dans la bibliothèque de documents.

Pour obtenir un exemple de configuration de l'action DeleteLists, consultez Exemples.

Action CheckInFile

Cette action archive le fichier ou le document.

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

Nom du paramètre	Type de données	Obligatoire	Description
RelativeURL	STRING	Oui	URL relative du dossier.
DocumentName	STRING	Oui	Nom du fichier.
Commentaire	Chaîne	Oui	Commentaire pour l'enregistrement.

Pour obtenir un exemple de configuration de l'action CheckInFile, consultez Exemples.

Action CheckOutDocument

Cette action extrait le fichier ou le document.

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.

Pour obtenir un exemple de configuration de l'action CheckOutDocument, consultez Exemples.

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.
Commentaire	STRING	Non	Commentaire pour l'enregistrement.

Pour obtenir un exemple de configuration de l'action CheckInDocument, consultez Exemples.

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.

Pour obtenir un exemple de configuration de l'action DiscardCheckOutDocument, consultez Exemples.

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.

Pour obtenir un exemple de configuration de l'action CopyDocument, consultez Exemples.

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.
Contenu	Chaîne	Non	Contenu à importer en tant que fichier.
ContentBytes	Chaîne	Non	Contenu du fichier encodé en base64. À utiliser pour importer des données binaires.
HasBytes	Booléen	Non	Ce paramètre indique si le contenu à importer est binaire. La valeur par défaut est false.

Pour obtenir un exemple de configuration de l'action UploadDocument, consultez Exemples.

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 du document. Il peut s'agir d'une URL complète ou relative.
Bibliothèque	STRING	Oui	Nom de la bibliothèque.
HasBytes	Booléen	Non	Ce paramètre indique si le contenu doit être téléchargé sous forme d'octets. La valeur par défaut est false.

Pour obtenir un exemple de configuration de l'action DownloadDocument, consultez Exemples.

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.

Pour obtenir un exemple de configuration de l'action MoveAttachmentOrDocument, consultez Exemples.

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.

Pour obtenir un exemple de configuration de l'action CreateFolder, consultez Exemples.

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.
Contenu	Chaîne	Oui	Contenu de la pièce jointe.
ContentBytes	Chaîne	Non	Contenu du fichier encodé en base64. À utiliser pour importer des données binaires.
HasBytes	Booléen	Non	Ce paramètre indique si le contenu à importer est binaire. La valeur par défaut est false.

Pour obtenir un exemple de configuration de l'action AddAttachments, consultez Exemples.

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 du fichier.
HasBytes	Booléen	Non	Ce paramètre indique si le contenu à télécharger est binaire. La valeur par défaut est false.

Pour obtenir un exemple de configuration de l'action DownloadAttachments, consultez Exemples.

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"
   }

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 fichier

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CheckInFile, 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",
     "Comment": "Comment test with more than 1 word"
   }
   

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

[{
"Status": "Success"
}]

Exemple : Ajouter une liste à une bibliothèque

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action AddLists, 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 :

   {
     "Template": "DocumentLibrary",
     "Description": "testdata_from_gcpcloud",
     "Name": "TestList1757601118898"
   }
   

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

[{
"Status": "Success"
}]

Exemple : Supprimer un document

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action DeleteDocument, 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 :

   {
     "Library": "Shared Documents",
     "Path": "/Shared Documents/TestFolder/Document.docx"
   }
   

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

[{
"Status": "Success"
}]

Exemple : Vérifier les autorisations sur une liste

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CheckPermission, 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 :

   {
     "ListName": "TestList",
     "ItemId": "1",
     "Principal": "ACLSITE1 Owners"
   }
   

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

[{
"Status": "Success"
}]

Exemple : Supprimer une liste

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action DeleteLists, 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 :

   {
     "Name": "TestList1757601118898"
   }
   

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

[{
"Status": "Success"
}]

Exemple : Archiver 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"
   }

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

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"
   }

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"
   }

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 vers un autre emplacement

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"
   }

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 à un 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"
   }

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 à un 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",
   "ContentBytes": "SGVsbG8gd29ybGQK",
   "HasBytes": "true"
   }

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

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"
   }

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

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"  
   }

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",
}]

Remarque : Le contenu téléchargé est une chaîne encodée en Base64.

Exemple : Télécharger 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
   }
   

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 vers un autre emplacement

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"
   }

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 à un emplacement spécifique

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"
   }

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 à une liste

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"
   }

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 à une liste

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"
   }

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

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"
   }

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

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"
   }

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",
}]

Remarque : Le contenu téléchargé est une chaîne encodée en Base64.

Exemples d'opérations d'entité

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

Version 1

Entités acceptées dans la version 1

Fichiers et Mes listes.

Version 2

Entités compatibles avec la version 2

Fichiers, ListItem, MyLists, RoleAssignments, SharingLinks, SitePages, Subsites et Users.

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 : Lister tous les liens de partage de fichiers

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Sharing Links dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Lister tous les liens de partage de dossiers

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Sharing Links dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Lister toutes les pages du site

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez SitePages dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Lister tous les sous-sites

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Subsites dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Lister toutes mes listes

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 List, puis cliquez sur OK.

Exemple : Lister tous les utilisateurs

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Users dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Lister tous les éléments

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez ListItem dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Lister toutes les attributions de rôle

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez RoleAssignments dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Obtenir un lien de partage pour un fichier

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Sharing Links dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Définissez entityId sur "Sharing Links" (Liens de partage). Pour définir l'entityId, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 1.0 dans le champ Valeur d'entrée et choisissez entityId comme variable locale.

Exemple : Obtenir les détails d'un fichier

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 Get, puis cliquez sur OK.
4. Définissez entityId sur "Files" (Fichiers). Pour définir l'entityId, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez ZETdEU1T_UOBEzbgDmsvcubxvUaXbcJNrrNPM4LqoklbdDZx3Eo0SIWPCsc_L6yI dans le champ Valeur d'entrée et choisissez entityId comme variable locale.

Exemple : Obtenir un lien de partage pour un dossier

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Sharing Links dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Définissez entityId sur "Sharing Links" (Liens de partage). Pour définir l'entityId, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 3.0 dans le champ Valeur d'entrée et choisissez entityId comme variable locale.

Exemple : Récupérer une liste

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 une liste

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 une liste

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.

Remarque  : Si votre entité possède une clé primaire composite, vous pouvez spécifier une clause de filtre.

• 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".

Limites

Voici les limites du connecteur SharePoint :

• L'opération de mise à jour des entités SitePages et Events ne fonctionne pas.
• L'opération de liste pour les entités AllFiles, AllPages, AllEvents, AllLists et Sites ne fonctionne pas.

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

• Découvrez comment suspendre et reprendre une connexion.
• Découvrez comment surveiller l'utilisation des connecteurs.
• Découvrez comment afficher les journaux des connecteurs.