SharePoint

Il connettore SharePoint fornisce l'accesso SQL ai servizi e ai server SharePoint.

Versioni supportate

Questo connettore supporta Windows SharePoint Services 3.0, Microsoft Office SharePoint Server 2007 e versioni successive e SharePoint Online.

Prima di iniziare

Prima di utilizzare il connettore SharePoint, svolgi le seguenti attività:

  • Nel tuo progetto Google Cloud:
    • Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
    • Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
    • Concedi i seguenti ruoli IAM all'account di servizio che vuoi utilizzare per il connettore:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Un account di servizio è un tipo speciale di Account Google destinato a rappresentare un utente "non umano" che deve eseguire l'autenticazione ed essere autorizzato ad accedere ai dati nelle API Google. Se non hai un account di servizio, devi crearne uno. Per maggiori informazioni, consulta Creare un account di servizio.

    • Attiva i seguenti servizi:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Per scoprire come attivare i servizi, consulta Abilitazione dei servizi.

    Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli durante la configurazione del connettore.

Configura il connettore

Per configurare il connettore devi creare una connessione all'origine dati (sistema di backend). Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione distinta per ciascuna. Per creare una connessione:

  1. Nella console Cloud, vai alla pagina Connettori di integrazione > Connessioni, quindi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + Crea nuovo per aprire la pagina Crea connessione.
  3. Nella sezione Località, scegli la località della connessione.
    1. Regione: seleziona una località dall'elenco a discesa.

      Le regioni supportate per i connettori includono:

      Per l'elenco di tutte le regioni supportate, consulta Località.

    2. Fai clic su Avanti.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona SharePoint dall'elenco a discesa dei connettori disponibili.
    2. Versione del connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
    3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.

      I nomi delle connessioni devono soddisfare i seguenti criteri:

      • I nomi delle connessioni possono contenere lettere, numeri o trattini.
      • Le lettere devono essere minuscole.
      • I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
      • I nomi delle connessioni non possono superare i 49 caratteri.
    4. (Facoltativo) Inserisci una Descrizione per l'istanza di connessione.
    5. Se vuoi, attiva Cloud Logging e poi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
    6. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
    7. (Facoltativo) Configura le impostazioni del nodo di connessione:

      • Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
      • Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.

      Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Per elaborare più transazioni per una connessione sono necessari più nodi e, al contrario, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi per i nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita il numero minimo di nodi è impostato su 2 (per una maggiore disponibilità) e il numero massimo di nodi è impostato su 50.

    8. Se vuoi, fai clic su + Aggiungi etichetta per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
    9. Fai clic su Avanti.
  5. Nella sezione Destinazioni, inserisci i dettagli dell'host remoto (sistema di backend) a cui vuoi connetterti.
    1. Tipo di destinazione: seleziona un Tipo di destinazione. Ad esempio, l'indirizzo host è https://xxxxx.sharepoint.com.
      • Seleziona Indirizzo host dall'elenco per specificare il nome host o l'indirizzo IP della destinazione.
      • Se vuoi stabilire una connessione privata ai tuoi sistemi di backend, seleziona Allegato endpoint dall'elenco, quindi seleziona l'allegato endpoint richiesto dall'elenco Allegato endpoint.

      Se vuoi stabilire una connessione pubblica ai tuoi sistemi di backend con una maggiore sicurezza, puoi prendere in considerazione la configurazione di indirizzi IP statici in uscita per le tue connessioni, quindi configurare le regole del firewall in modo da inserire nella lista consentita solo gli indirizzi IP statici specifici.

      Per inserire altre destinazioni, fai clic su + Aggiungi destinazione.

    2. Fai clic su Avanti.
  6. Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
    1. Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.

      La connessione a SharePoint supporta i seguenti tipi di autenticazione:

      • Credenziali di Windows. Seleziona questa opzione se utilizzi la versione on-premise di SharePoint.
      • AzureAD. Seleziona questa opzione se utilizzi la versione online di SharePoint.
      • Credenziali client OAuth 2.0 con token JWT bearer. Seleziona questa opzione se utilizzi le credenziali client OAuth 2.0 con il token JWT bearer per l'autenticazione.
      • Credenziali client OAuth 2.0 con client secret. Seleziona questa opzione se utilizzi le credenziali client OAuth 2.0 con il client secret per l'autenticazione.

      2. Per capire come configurare questi tipi di autenticazione, consulta Configurare l'autenticazione.

    2. Fai clic su Avanti.
  7. Rivedi: controlla i dettagli di connessione e autenticazione.
  8. Fai clic su Crea.

Configura autenticazione

Il connettore SharePoint supporta i seguenti tipi di autenticazione:

Tipo di autenticazione delle credenziali Windows

Per attivare il tipo di autenticazione delle credenziali di Windows, devi completare i seguenti passaggi:
  1. Configura PSC e crea un collegamento endpoint.
  2. Specifica le credenziali in Google Cloud.

Configura PSC e crea un collegamento dell'endpoint

  1. Crea un gruppo di istanze con l'IP su cui è ospitato SharePoint.
  2. Crea un bilanciatore del carico di rete passthrough interno e utilizza il gruppo di istanze che hai creato come backend. Il bilanciatore del carico interno TCP deve avere l'accesso globale abilitato.
  3. Pubblica il bilanciatore del carico in Private Service Connect. Un allegato del servizio viene generato dopo la pubblicazione del bilanciatore del carico.
  4. Pubblica il servizio e specifica il bilanciatore del carico che hai creato.
  5. Utilizza il collegamento al servizio per creare un collegamento endpoint.
  6. Dopo aver creato il collegamento dell'endpoint, crea una connessione a SharePoint con l'IP del collegamento dell'endpoint.

    7. Per ulteriori informazioni sulla creazione di un collegamento dell'endpoint, vedi Creare un collegamento dell'endpoint.

Specifica i dettagli delle credenziali di Windows in Google Cloud

Quando crei la connessione in Integration Connectors , devi specificare i seguenti dettagli:

Nella sezione Autenticazione, seleziona Credenziali Windows come tipo di autenticazione, quindi inserisci i seguenti dettagli:

  • Nome utente: inserisci il nome utente.
  • Password: seleziona la password.
  • Versione del secret: inserisci la versione del secret.

Tipo di connessione delle credenziali Windows

La tabella seguente elenca i valori di configurazione di esempio per il tipo di connessione delle credenziali di Windows.
Nome campo Dettagli
Regione us-central1
Connettore SharePoint
Versione del connettore 1
Nome collegamento sharepoint-staging-psc
Account di servizio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Numero minimo di nodi 2
Numero massimo di nodi 50
Tipo di destinazione Indirizzo host
host 1 http://192.0.2.0
porta 1 24
Autenticazione Credenziali Windows
Nome utente USER_NAME
Password PASSWORD
Versione secret 1

Tipo di autenticazione Azure AD

Per attivare il tipo di autenticazione Azure AD, devi completare i seguenti passaggi:
  1. Registra la tua app e ottieni OAuthClientId e OAuthClientSecret.
  2. Specifica le credenziali in Google Cloud.
  3. Autorizza la connessione in Google Cloud.
  4. Aggiungi l'URL di reindirizzamento alla tua app.

Registra la tua app e ottieni OAuthClientId e OAuthClientSecret

Per registrare l'app e ottenere OAuthClientId e OAuthClientSecret per l'app:
  1. Accedi al portale di Azure.
  2. In Servizi Azure, seleziona Registrazioni app e poi Nuova registrazione.
  3. Inserisci un nome dell'applicazione e seleziona Qualsiasi tenant Microsoft Entra ID - Multitenant. La seguente immagine mostra la pagina Registra un'applicazione:
  4. Dopo aver creato l'app, vai alla sezione Certificati e secret, crea un client secret per l'applicazione e salva il relativo valore. La seguente immagine mostra la pagina Certificati e segreti:
  5. In Autorizzazioni API, seleziona le autorizzazioni di applicazione e le autorizzazioni delegate richieste. Affinché la connessione sia attiva, devi concedere la seguente autorizzazione minima:AllSites.Manage

    La tabella seguente elenca le autorizzazioni necessarie per eseguire operazioni nell'applicazione.

    Autorizzazioni delegate Autorizzazioni di applicazione
    ConsentRequest.Read.All AllSites.FullControl
    ConsentRequest.ReadWrite.All AllSites.Manage
    DelegatedAdminRelationship.Read.All AllSites.Read
    DelegatedAdminRelationship.ReadWrite.All AllSites.Write
    DelegatedPermissionGrant.Read.All EnterpriseResource.Read
    DelegatedPermissionGrant.ReadWrite.All EnterpriseResource.Write
    Files.Read.All MyFiles.Read
    Files.ReadWrite.All MyFiles.Write
    Group.Create Project.Read
    Group.Read.All Project.Write
    Group.ReadWrite.All ProjectWebApp.FullControl
    Sites.FullControl.All ProjectWebAppReporting.Read
    Sites.FullControl.All Sites.FullControl.All
    Sites.Manage.All Sites.Manage.All
    Sites.Read.All Sites.Read.All
    Sites.ReadWrite.All Sites.ReadWrite.All
    Sites.Selected Sites.Search.All
    User.Export.All Sites.Selected
    User.Read TaskStatus.Submit
    User.Read.All TermStore.Read.All
    User.ReadWrite.All TermStore.Read.All
    TermStore.ReadWrite.All
    TermStore.ReadWrite.All
    User.Read.All
    User.Read.All
    User.ReadWrite.All
    User.ReadWrite.All
  6. Salva le modifiche.
  7. Se hai selezionato l'utilizzo di autorizzazioni che richiedono il consenso dell'amministratore, puoi concederle dall'utente corrente nella pagina Autorizzazioni API. La seguente immagine mostra la pagina delle autorizzazioni API:
  8. Per aggiungere l'ambito, vai alla sezione Esporre un'API, aggiungi gli ambiti AllSites.Manage, Sites.FullControl.All e seleziona chi può eseguire il controllo (amministratori e utenti). La seguente immagine mostra la pagina Esponi un'API:
  9. Fai clic su Salva.

Specifica le credenziali in Google Cloud

Quando crei la connessione in Integration Connectors , devi specificare i seguenti dettagli:

Nella sezione Autenticazione, seleziona AzureAD come tipo di autenticazione, quindi inserisci i seguenti dettagli:

  • ID client: inserisci l'ID client utilizzato per richiedere i token di accesso.
  • Ampi dello spettro: inserisci un elenco separato da virgole degli ambiti desiderati. Ad esempio, Sites.FullControl.All
  • Client secret: inserisci il secret che contiene il client secret per l'app collegata che hai creato.
  • Versione del secret: la versione del secret selezionato sopra.
  • URL di autorizzazione: URL di autorizzazione generato durante la creazione del client. Inserisci l'URL nel seguente formato: https://login.microsoftonline.com/<tenant_identifier>/oauth2/v2.0/authorize. Ad esempio: https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize.

Autorizza la connessione in Google Cloud

  1. Nella pagina Connessioni, individua la connessione appena creata.

    Lo stato del nuovo connettore sarà Autorizzazione richiesta.

  2. Fai clic su Autorizzazione obbligatoria.

    Viene visualizzato il riquadro Modifica autorizzazione.

  3. Copia il valore URI di reindirizzamento nell'applicazione esterna. Per ulteriori informazioni, vedi Aggiungere l'URL di reindirizzamento all'app.
  4. Verifica i dettagli dell'autorizzazione.
  5. Fai clic su Autorizza.

    Se l'autorizzazione va a buon fine, lo stato della connessione verrà impostato su Attivo nella pagina Connessioni.

Aggiungi l'URL di reindirizzamento all'app

  1. Nel portale di Azure, fai clic su Servizi Azure > Registrazioni app.
  2. Fai clic sul nome dell'app.
  3. Fai clic su Aggiungi URI di reindirizzamento.
  4. Fai clic su Aggiungi una piattaforma.
  5. Nella finestra di dialogo Web, incolla l'URI di reindirizzamento che hai copiato quando hai autorizzato la connessione in Google Cloud.

Tipo di connessione Azure AD

La tabella seguente elenca i valori di configurazione di esempio per il tipo di connessione Azure AD:
Nome campo Dettagli
Regione us-central1
Connettore SharePoint
Versione del connettore 1
Nome collegamento sharepoint-google-cloud-con
Account di servizio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Numero minimo di nodi 2
Numero massimo di nodi 50
Tipo di destinazione Indirizzo host
host 1 http://z8**.sharepoint.com
Autenticazione AzureAD
ID client CLIENT_ID
Ambiti Sites.FullControl.All
Client secret CLIENT_SECRET
Versione secret 1
URL di autorizzazione https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

OAuth 2.0 - Credenziali client con tipo di autenticazione JWT bearer

Per attivare le credenziali client OAuth 2.0 con il tipo di autenticazione JWT bearer, devi completare i seguenti passaggi:
  1. Crea un certificato.
  2. Carica il certificato nel portale di Azure.
  3. Ottieni una chiave privata.
  4. Completa la configurazione.
  5. Specifica le credenziali JWT con mittente OAuth 2.0 in Google Cloud.

Per attivare il tipo di autenticazione JWT con token di accesso, devi creare un certificato, caricarlo nel portale di Azure e ottenere una chiave privata.

Crea un certificato

  1. Crea una cartella vuota sul computer.
  2. Crea un file di testo nella cartella.
  3. Copia lo script PowerShell dalla pagina Concedi l'accesso tramite l'app solo per Azure AD e incollalo nel file di testo.
  4. Rinomina il file di testo con il seguente nome: Create-SelfSignedCertificate.ps1.
  5. Esegui Windows PowerShell nella cartella.
  6. Vai alla directory che contiene il file di testo.
  7. Copia il seguente comando: .\Create-SelfSignedCertificate.ps1 -CommonName "CERTIFICATE_NAME" -StartDate 2022-09-25 -EndDate 2023-10-25

    Inserisci un nome univoco per CERTIFICATE_NAME. Modifica StartDate impostandolo sulla data corrente e EndDate su una data a tua scelta.

  8. Incolla il comando copiato con le modifiche in Windows PowerShell e premi Invio.

    Windows PowerShell ti chiede di inserire la password per proteggere la chiave privata. Assicurati di salvare la password per utilizzarla in un secondo momento.

    Windows PowerShell crea due file: MyCertificate.pfx e MyCertificate.cer.

Carica il certificato nel portale di Azure

  1. Accedi al portale di Azure e registra una nuova applicazione specificando i seguenti dettagli:
    • Nome: inserisci un nome per l'applicazione.
    • Tipi di account supportati: seleziona Solo account in questa directory dell'organizzazione (solo nome account - singolo tenant).
  2. Vai a Autorizzazioni API > Aggiungi autorizzazione > Richiedi autorizzazioni API > SharePoint.
  3. Seleziona Autorizzazioni di accesso all'app e aggiungi le autorizzazioni richieste.
  4. Seleziona Concedi il consenso amministratore e poi Sì.
  5. Dopo aver creato l'app, vai alla sezione Certificati e secret.
  6. Seleziona Carica certificato e carica il certificato CER dal computer. Al termine del caricamento, seleziona Aggiungi.

    Non aggiungere client secret nell'app perché interferiscono con il flusso di autenticazione basata su certificati.

  7. Vai a Manifest, individua KeyCredentials e poi copia customKeyIdentifier come impronta. Lo utilizzerai in seguito. Ora hai registrato l'app e collegato il certificato.

Ottenere una chiave privata

Puoi ottenere una chiave privata convertendo il file PFX in un file PEM utilizzando OpenSSL.

  1. Dal prompt dei comandi, vai alla cartella con il file PFX ed esegui il seguente comando: openssl pkcs12 -in MyCertificate.pfx -out MyCertificate.pem -nodes
  2. Inserisci la password PFX che hai utilizzato nella procedura di creazione del certificato.
  3. Apri il file PEM in un editor di testo e copia la seguente sezione della chiave privata: 
    -----BEGIN PRIVATE KEY----- 

-----END PRIVATE KEY-----

Completare la configurazione

  1. Copia l'ID client e l'ID tenant dall'app appena registrata nel portale di Azure.
  2. Accedi con l'autenticazione del principale del servizio di elenco di SharePoint con le seguenti credenziali:
    • ID client
    • ID tenant
    • Chiave privata
    • Impronta (password della chiave privata)

Specifica le credenziali JWT con mittente OAuth 2.0 in Google Cloud

Quando crei la connessione in Integration Connectors , devi specificare i seguenti dettagli:

Nella sezione Autenticazione, seleziona Credenziali client OAuth 2.0 con token JWT bearer come tipo di autenticazione e poi inserisci i seguenti dettagli:

  • ID client: inserisci l'ID client utilizzato per richiedere i token di accesso. Si tratta della chiave consumer generata quando hai registrato l'app nel portale di Azure.
  • Chiave privata: seleziona il segreto Secret Manager contenente i contenuti del file della chiave privata in formato PEM. La chiave privata deve corrispondere alla chiave pubblica/al certificato fornito a Connector.
  • Versione del secret: la versione del secret selezionato sopra.
  • Password della chiave privata: seleziona il segreto Secret Manager contenente la password (parafrasi) del file della chiave privata.
  • Versione del secret: la versione del secret selezionato sopra.
  • Tenant Azure: il tenant Microsoft Online utilizzato per accedere ai dati.

Tipo di connessione del certificato JWT Bearer

La tabella seguente elenca i valori di configurazione di esempio per il tipo di connessione del certificato JWT Bearer OAuth 2.0.
Nome campo Dettagli
Regione europe-west1
Connettore SharePoint
Versione del connettore 1
Nome collegamento sharepoint-jwt-certificate
Account di servizio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Numero minimo di nodi 2
Numero massimo di nodi 50
Tipo di destinazione Indirizzo host
host 1 http://z8**.sharepoint.com
porta 1 ****
Autenticazione Credenziali client OAuth 2.0 con token JWT bearer
ID client OAuth CLIENT_ID
Chiave privata KEY
Versione secret 1
Password chiave privata PASSWORD
Versione secret 1
Tenant Azure AZURE_TENANT_ID

OAuth 2.0 - tipo di connessione del client secret

Per attivare il tipo di connessione con client secret OAuth 2.0, devi completare i seguenti passaggi:

  1. Registra il componente aggiuntivo.
  2. Concedi le autorizzazioni al componente aggiuntivo.
  3. Specifica le credenziali client OAuth 2.0 in Google Cloud
  4. Nuova autorizzazione per il codice di autorizzazione

Registra il componente aggiuntivo

  1. Vai alla pagina Registra componente aggiuntivo utilizzando il seguente URL: https://<SITE_NAME>.SharePoint.com/_layouts/15/appregnew.aspx.
  2. Nella sezione Informazioni sull'app, genera l'ID client e il client secret.
  3. Specifica i valori per Titolo, Dominio app e URI di reindirizzamento.
  4. Fai clic su Crea.Il componente aggiuntivo viene registrato e l'app SharePoint mostra le informazioni create.

Concedi le autorizzazioni al componente aggiuntivo

  1. Vai al sito SharePoint utilizzando il seguente URL: https://<SITE_NAME>-admin.sharepoint.com/_layouts/15/appinv.aspx. Verrà visualizzata la pagina Concedi autorizzazione.
  2. Nel campo ID app, inserisci l'ID client generato in precedenza e fai clic su Cerca. I valori di Titolo, Dominio app e URL di reindirizzamento sono compilati.
  3. Inserisci la seguente richiesta di autorizzazione in formato XML: 
    <AppPermissionRequests AllowAppOnlyPolicy="true">
<AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl"/>
</AppPermissionRequests>
  4. Fai clic su Crea. L'app SharePoint mostra una finestra di dialogo per il consenso all'autorizzazione.
  5. Fai clic su Attendibile.

Specifica le credenziali client OAuth 2.0 in Google Cloud

Quando crei la connessione in Integration Connectors , devi specificare i seguenti dettagli:

Nella sezione Autenticazione, seleziona Credenziali client OAuth 2.0 con secret client come tipo di autenticazione e poi inserisci i seguenti dettagli:

  • ID client: inserisci l'ID client fornito dal connettore per l'app che hai creato.
  • Client secret: seleziona il segreto di Secret Manager contenente il client secret per l'app collegata che hai creato.
  • Versione del secret: seleziona la versione del client secret.

Nuova autorizzazione per il codice di autorizzazione

Se utilizzi il tipo di autenticazione Authorization code e hai apportato modifiche alla configurazione dell'applicazione SharePoint, devi autorizzare di nuovo la connessione a SharePoint. Per autorizzare di nuovo una connessione:

  1. Fai clic sulla connessione richiesta nella pagina Connessioni.

    Viene visualizzata la pagina dei dettagli della connessione.

  2. Fai clic su Modifica per modificare i dettagli della connessione.
  3. Verifica i dettagli di OAuth 2.0 - Codice di autorizzazione nella sezione Autenticazione.

    Se necessario, apporta le modifiche necessarie.

  4. Fai clic su Salva. Viene visualizzata la pagina dei dettagli della connessione.
  5. Fai clic su Modifica autorizzazione nella sezione Autenticazione. Viene visualizzato il riquadro Autorizza.
  6. Fai clic su Autorizza.

    Se l'autorizzazione va a buon fine, lo stato della connessione verrà impostato su Attivo nella pagina Connessioni.

Tipo di connessione delle credenziali client

La tabella seguente elenca i valori di configurazione di esempio per il tipo di connessione delle credenziali client OAuth 2.0.
Nome campo Dettagli
Regione europe-west1
Connettore SharePoint
Versione del connettore 1
Nome collegamento sharepoint-client-credentials
Account di servizio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Numero minimo di nodi 2
Numero massimo di nodi 50
Tipo di destinazione Indirizzo host
host 1 http://z8**.sharepoint.com
porta 1 ****
Autenticazione Credenziali client OAuth 2.0 con client secret
ID client CLIENT_ID
Client secret CLIENT_SECRET
Versione secret 1

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione collegata. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione viene mostrata come entità, operazioni e azioni.

  • Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio collegato. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database le tabelle sono le entità, in un connettore di file server le cartelle sono le entità e in un connettore di sistema di messaggistica le code sono le entità.

    Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

  • Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire su un'entità una delle seguenti operazioni:

    La selezione di un'entità dall'elenco disponibile genera un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta nessuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

  • Azione : un'azione è una funzione di prima classe resa disponibile all'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da un connettore all'altro. In genere, un'azione avrà alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca alcune delle azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione DeleteAttachment

Questa azione elimina un allegato.

Parametri di input dell'azione DeleteAttachment

Nome parametro Tipo di dati Obbligatorio Descrizione
ListTitle Stringa Sì Titolo dell'elemento dell'elenco.
ItemId Stringa Sì ID dell'elemento dell'elenco.
FileName Stringa Sì Nome del file da eliminare dalla raccolta di documenti.

Per capire come configurare l'azione DeleteAttachment, consulta Esempi di azioni.

Azione CheckInDocument

Questa azione ti consente di eseguire il check-in di un documento.

Parametri di input dell'azione CheckInDocument

Nome parametro Tipo di dati Obbligatorio Descrizione
RelativeURL Stringa Sì URL relativo della cartella.
DocumentName Stringa Sì Nome del file da sottoporre a check-in.
Commento Stringa No Un messaggio di check-in facoltativo.

Per capire come configurare l'azione CheckInDocument, consulta Esempi di azioni.

Azione CheckOutDocument

Questa azione ti consente di eseguire il check-out di un file.

Parametri di input dell'azione CheckOutDocument

Nome parametro Tipo di dati Obbligatorio Descrizione
RelativeURL Stringa Sì URL relativo della cartella.
DocumentName Stringa Sì Nome del file da eseguire il check-out.

Per capire come configurare l'azione CheckOutDocument, consulta Esempi di azioni.

Azione DiscardCheckOutDocument

Questa azione consente di annullare il check-out di un file.

Parametri di input dell'azione DiscardCheckOutDocument

Nome parametro Tipo di dati Obbligatorio Descrizione
RelativeURL Stringa Sì URL relativo della cartella.
DocumentName Stringa Sì Nome del file per cui è necessario annullare il check-out.

Per capire come configurare l'azione DiscardCheckOutDocument, consulta Esempi di azioni.

Azione CopyDocument

Questa azione ti consente di copiare un file da una posizione a un'altra.

Parametri di input dell'azione CopiaDocumento

Nome parametro Tipo di dati Obbligatorio Descrizione
SourceFileRelativeUrl Stringa Sì URL relativo del file di origine.
DestFileRelativeUrl Stringa Sì URL relativo del file di destinazione.

Per capire come configurare l'azione CopyDocument, consulta Esempi di azioni.

Azione UploadDocument

Questa azione ti consente di caricare un file.

Parametri di input dell'azione CaricaDocumento

Nome parametro Tipo di dati Obbligatorio Descrizione
FileName Stringa Sì Nome del file da caricare.
RelativeUrl Stringa Sì URL relativo della cartella.
Contenuti Stringa No Contenuti da caricare come file.
ContentBytes Stringa No Contenuti in byte (come stringa Base64) da caricare come file. Utilizzalo per caricare dati binari.
HasBytes Booleano No Specifica se i contenuti da caricare sono in formato binario. Il valore predefinito è false.

Per capire come configurare l'azione UploadDocument, consulta Esempi di azioni.

Azione DownloadDocument

Questa azione ti consente di scaricare un file.

Parametri di input dell'azione DownloadDocument

Nome parametro Tipo di dati Obbligatorio Descrizione
RemoteFile Stringa Sì URL completo del file da scaricare.
Raccolta Stringa Sì Nome della raccolta sul server SharePoint.
HasBytes Booleano No Specifica se i contenuti devono essere scaricati come byte. Il valore predefinito è false.

Per capire come configurare l'azione DownloadDocument, consulta Esempi di azioni.

Azione SpostaAllegatoODocumento

Questa azione ti consente di spostare un file da una cartella all'altra.

Parametri di input dell'azione SpostaAllegatoODocumento

Nome parametro Tipo di dati Obbligatorio Descrizione
SourceFileURL Stringa Sì URL del file di origine da spostare.
DestinationFolderURL Stringa Sì URL della cartella di destinazione.

Per capire come configurare l'azione MoveAttachmentOrDocument, consulta Esempi di azioni.

Azione CreateFolder

Questa azione ti consente di creare una cartella.

Parametri di input dell'azione CreateFolder

Nome parametro Tipo di dati Obbligatorio Descrizione
RelativeURL Stringa Sì URL relativo della cartella.
FolderName Stringa Sì Nome della cartella da creare.

Per capire come configurare l'azione CreateFolder, consulta Esempi di azioni.

Azione AddAttachments

Questa azione ti consente di aggiungere un allegato.

Parametri di input dell'azione AddAttachments

Nome parametro Tipo di dati Obbligatorio Descrizione
ListTitle Stringa Sì Nome dell'elenco di allegati.
FileName Stringa Sì Nome del file allegato.
ItemId Stringa Sì ID dell'allegato da aggiungere.
Contenuti Stringa Sì Contenuti dell'allegato.
ContentBytes Stringa No Contenuti in byte (come stringa Base64) da caricare come allegato. Utilizzalo per caricare dati binari.
HasBytes Booleano No Specifica se i contenuti da caricare sono in formato binario. Il valore predefinito è false.

Per capire come configurare l'azione AddAttachments, consulta Esempi di azioni.

Azione DownloadAttachments

Questa azione ti consente di scaricare gli allegati.

Parametri di input dell'azione DownloadAttachments

Nome parametro Tipo di dati Obbligatorio Descrizione
RemoteFile Stringa Sì URL relativo del file.
HasBytes Booleano No Specifica se i contenuti da scaricare sono binari. Il valore predefinito è false.

Per capire come configurare l'azione DownloadAttachments, consulta Esempi di azioni.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio: eliminare un allegato

Questo esempio elimina il file specificato.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DeleteAttachment e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"ListTitle": "My lists",
"ItemId": "1",
"FileName": "sitepages.txt"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task DeleteAttachment avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: check-in di un documento

Questo esempio esegue il check-in di un documento.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CheckInDocument e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.txt",
"Comment": "Comment test"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task CheckInDocument avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: estrarre un file

Questo esempio estrae un file.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CheckOutDocument e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.txt"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task CheckOutDocument avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: eliminare un pagamento

Questo esempio ripristina il check-out di un file.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DiscardCheckOutDocument e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.docx"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task DiscardCheckOutDocument avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: copiare un file

Questo esempio copia un file da una posizione a un'altra.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CopyDocument e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"SourceFileRelativeUrl": "/Shared Documents/Document.docx",
"DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task CopyDocument avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: caricamento di un file di testo

Questo esempio carica un file di testo nella posizione specificata.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione UploadDocument e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"FileName": "test.txt",
"RelativeUrl": "/Shared Documents/TestFolder",
"Content": "abcd"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UploadDocument avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: caricamento di un file binario

Questo esempio carica un file binario nella posizione specificata. Quando carichi un file binario, specifica i contenuti da caricare come stringa con codifica base64.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione UploadDocument e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"FileName": "test.txt",
"RelativeUrl": "/Shared Documents/TestFolder",
"ContentBytes": "SGVsbG8gd29ybGQK",
"HasBytes": "true"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UploadDocument avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: scaricare un file

Questo esempio scarica un file.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DownloadDocument e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"RemoteFile": "/TestFolder/test.txt",
"Library": "Shared Documents"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task DownloadDocument avrà un valore simile al seguente:

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

Esempio: scarica un file binario

Questo esempio scarica un file binario.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DownloadDocument e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"RemoteFile": "/TestFolder/test1.png",
"Library": "Shared Documents"
"HasBytes": "true"  
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task DownloadDocument avrà un valore simile al seguente:

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

Esempio: spostare un allegato

Questo esempio sposta un allegato da una posizione a un'altra.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione MoveAttachmentOrDocument e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"SourceFileURL": "/Shared Documents/test.txt",
"DestinationFolderURL": "/Shared Documents/TestFolder"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task MoveAttachmentOrDocument avrà un valore simile al seguente:

    [{
"Result": "Success"
}]

Esempio: creare una cartella

Questo esempio crea una cartella nella posizione specificata.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CreateFolder e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"FolderName": "TestFolder123"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task CreateFolder avrà un valore simile al seguente:

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

Esempio: aggiungere un allegato

Questo esempio aggiunge un allegato all'elenco specificato.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione AddAttachments e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"ListTitle": "My Lists",
"FileName": "TestAttachment2",
"Content": "abcd text",
"ItemId": "1"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task AddAttachments avrà un valore simile al seguente:

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

Esempio: aggiungi un allegato binario

Questo esempio aggiunge un allegato binario all'elenco specificato.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione AddAttachments e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"ListTitle": "My Lists",
"FileName": "TestAttachment3",
"ContentBytes": "VGVzdCBGaWxl",
"HasBytes": "true",  
"ItemId": "1"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task AddAttachments avrà un valore simile al seguente:

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

Esempio: scaricare un allegato

Questo esempio scarica un allegato.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DownloadAttachments e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"RemoteFile": "/Shared Documents/Document.txt"
}

    4. Se l'azione ha esito positivo, il parametro risposta connectorOutputPayload della task DownloadAttachments avrà un valore simile al seguente:

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

Esempio: scarica un allegato binario

Questo esempio scarica un allegato binario.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DownloadAttachments e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e inserisci un valore simile al seguente nel campo Default Value: 
    {
"RemoteFile": "/Shared Documents/Document.docx",
"HasBytes": "true"
}

    4. Se l'azione ha esito positivo, il parametro risposta connectorOutputPayload della task DownloadAttachments avrà un valore simile al seguente:

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

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elenca tutti i file

Questo esempio elenca tutti i file nell'entità Files.

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Files dall'elenco Entity.
  3. Seleziona l'operazione List e poi fai clic su Fine.
  4. Se vuoi, nella sezione Input dell'attività dell'attività Connettori, puoi filtrare il set di risultati specificando una clausola di filtro. Puoi anche specificare più condizioni di filtro utilizzando gli operatori logici.

Esempio: ottieni un elenco

Questo esempio recupera un elenco con l'ID specificato dall'entità My Lists.

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona My Lists dall'elenco Entity.
  3. Seleziona l'operazione Get e poi fai clic su Fine.
  4. Nella sezione Input dell'attività dell'attività Connettori, fai clic su EntityId e poi inserisci 3 nel campo Valore predefinito.

    Qui, 3 è un valore della chiave primaria nell'entità My Lists.

Esempio: crea un record

Questo esempio crea un record nell'entità My Lists.

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona My Lists dall'elenco Entity.
  3. Seleziona l'operazione Create e fai clic su Fine.
  4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
"AuthorId": 11.0, 
"BaseName": "3_",
"Attachments": false,
"Title": "Created List New"
}

    Se l'integrazione è andata a buon fine, il campo connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [{
"ID": 3.0
}]

Esempio: eliminare un record

Questo esempio elimina il record con l'ID specificato nell'entità My Lists.

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona My Lists dall'elenco Entity.
  3. Seleziona l'operazione Delete e fai clic su Fine.
  4. Nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci 2 nel campo Valore predefinito.

Utilizzare la connessione a SharePoint in un'integrazione

Una volta creata, la connessione diventa disponibile sia nell'Apigee Integration sia nell'Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

  • Per informazioni su come creare e utilizzare l'attività Connectors in Apigee Integration, consulta Attività Connectors.
  • Per informazioni su come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Ricevere assistenza dalla community Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community Google Cloud ai forum di Cloud.

Passaggi successivi