SharePoint

Tipo di autenticazione delle credenziali Windows

Per attivare il tipo di autenticazione delle credenziali Windows, devi completare i seguenti passaggi:

1. Configura PSC e crea un collegamento dell'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 in 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 service attachment 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 del servizio per creare un collegamento endpoint.
6. Dopo aver creato il collegamento dell'endpoint, crea una connessione SharePoint con l'IP del collegamento dell'endpoint.

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 di Windows

La seguente tabella elenca i valori di configurazione di esempio per il tipo di connessione delle credenziali Windows.

Tipo di autenticazione Azure AD

Per abilitare 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 la tua 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 di Microsoft Entra ID - Multitenant.
4. Fai clic su Register (Registrati).
5. Dopo aver creato l'app, vai alla sezione Certificati e secret, crea un client secret per l'applicazione e salva il valore del client secret.
6. In Autorizzazioni API, seleziona le autorizzazioni dell'applicazione e le autorizzazioni delegate richieste. Affinché la connessione sia attiva, devi concedere la seguente autorizzazione minima:Sites.Read.All.

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

   Autorizzazioni delegate	Autorizzazioni dell'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

7. Salva le modifiche.
8. Se hai scelto di utilizzare autorizzazioni che richiedono il consenso amministratore, puoi concederle dal tenant corrente nella pagina Autorizzazioni API.
9. Per aggiungere l'ambito, vai alla sezione Esporre un'API, aggiungi gli ambiti AllSites.Manage, Sites.FullControl.All e seleziona chi può controllare (amministratori e utenti).
10. 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.
• Ambiti: 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 connessa che hai creato.
• Versione del secret: la versione del secret selezionata sopra.
• URL di autorizzazione: l'URL di autorizzazione che generi quando crei un client OAuth. Inserisci l'URL nel seguente formato: https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent. Ad esempio: https://login.microsoftonline.com/9byyyyyyyyy8112/oauth2/v2.0/authorize?prompt=consent.

Autorizzare 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 saperne di più, 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.

Aggiungere l'URL di reindirizzamento all'app

1. Nel portale 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 seguente tabella elenca i valori di configurazione di esempio per il tipo di connessione Azure AD:

OAuth 2.0 - credenziali client con tipo di autenticazione Bearer JWT

Per attivare OAuth 2.0 - credenziali client con tipo di autenticazione JWT Bearer, devi completare i seguenti passaggi:

1. Crea un certificato.
2. Carica il certificato nel portale Azure.
3. Ottieni una chiave privata.
4. Completa la configurazione.
5. Specifica le credenziali JWT bearer OAuth 2.0 in Google Cloud.

Creare un certificato

1. Crea una cartella vuota sul computer.
2. Crea un file di testo nella cartella.
3. Copia lo script di PowerShell dalla pagina Concessione dell'accesso tramite Azure AD solo app 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 con la data corrente e EndDate con 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 un utilizzo successivo.

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

Caricare il certificato nel portale di Azure

1. Accedi al portale 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 applicazione e aggiungi le autorizzazioni richieste.
4. Seleziona Grant admin consent (Concedi il consenso amministratore) e poi Yes (Sì).
5. Dopo aver creato l'app, vai alla sezione Certificati e secret.
6. Seleziona Carica certificato e poi carica il certificato CER dal computer. Al termine del caricamento, seleziona Aggiungi.

   Non aggiungere client secret nell'app, in quanto interferiscono con il flusso di autenticazione basato su certificati.

7. Vai a Manifest, trova KeyCredentials e copia customKeyIdentifier come Thumbprint. Lo utilizzerai in un secondo momento. 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 l'intero testo, che corrisponde alla tua chiave privata.

Completa la configurazione

1. Copia l'ID client e l'ID tenant dalla nuova app registrata nel portale Azure.
2. Accedi con l'autenticazione del service principal di SharePoint List con le seguenti credenziali:
• ID client
• ID tenant
• Chiave privata
• Identificazione personale (password della chiave privata)

Specifica le credenziali JWT bearer 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 JWT bearer come tipo di autenticazione, quindi inserisci i seguenti dettagli:

• Nel campo ID client, inserisci l'ID client utilizzato per richiedere i token di accesso. Questa è la chiave utente generata quando hai registrato l'app nel portale Azure.
• Nel campo Chiave privata, seleziona il secret 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.
• Nel campo Versione del secret, seleziona la versione del secret selezionato in precedenza.
• Nel campo Password della chiave privata, seleziona il segreto di Secret Manager contenente la password (parafrasi) del file della chiave privata. Utilizza la stessa password che hai impostato per proteggere la chiave privata quando hai creato il certificato.
• Nel campo Versione del secret, seleziona la versione del secret selezionato in precedenza.
• Nel campo Tenant Azure, inserisci il tenant online Microsoft utilizzato per accedere ai dati.

Tipo di connessione del certificato JWT Bearer

La seguente tabella elenca i valori di configurazione di esempio per il tipo di connessione Certificato di autenticazione JWT OAuth 2.0.

OAuth 2.0 - Tipo di connessione 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. Specificare le credenziali client OAuth 2.0 in Google Cloud
4. Nuova autorizzazione per il codice di autorizzazione

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

Concedere le autorizzazioni al componente aggiuntivo

1. Vai al sito SharePoint utilizzando il seguente URL: https://<SITE_NAME>-admin.sharepoint.com/_layouts/15/appinv.aspx. Viene 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 vengono compilati.
3. Inserisci la seguente richiesta di autorizzazione in formato XML:

         <AppPermissionRequests AllowAppOnlyPolicy="true">
         <AppPermissionRequest Scope="http://sharepoint.com/content/tenant" Right="FullControl"/>
         </AppPermissionRequests>
           

4. Fai clic su Crea. L'app SharePoint mostra una finestra di dialogo di consenso per le autorizzazioni.
5. Fai clic su Considera attendibile.

Specificare 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 client secret come tipo di autenticazione, quindi inserisci i seguenti dettagli:

• Nel campo ID client, inserisci l'ID client fornito dal connettore per l'app che hai creato.
• Nel campo Client secret, seleziona il secret di Secret Manager contenente il client secret per l'app connessa che hai creato.
• Nel campo 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 nell'applicazione SharePoint, devi autorizzare nuovamente la connessione a SharePoint. Per autorizzare nuovamente 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 Attiva nella pagina Connessioni.

Tipo di connessione delle credenziali client

La seguente tabella elenca i valori di configurazione di esempio per il tipo di connessione Credenziali client OAuth 2.0.

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

Azione CheckInDocument

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

Parametri di input dell'azione CheckInDocument

Azione CheckOutDocument

Questa azione ti consente di estrarre un file.

Parametri di input dell'azione CheckOutDocument

Azione DiscardCheckOutDocument

Questa azione ti consente di annullare l'estrazione di un file.

Parametri di input dell'azione DiscardCheckOutDocument

Azione CopyDocument

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

Parametri di input dell'azione CopyDocument

Azione UploadDocument

Questa azione ti consente di caricare un file.

Parametri di input dell'azione UploadDocument

Azione DownloadDocument

Questa azione ti consente di scaricare un file.

Parametri di input dell'azione DownloadDocument

Azione MoveAttachmentOrDocument

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

Parametri di input dell'azione MoveAttachmentOrDocument

Azione CreateFolder

Questa azione ti consente di creare una cartella.

Parametri di input dell'azione CreateFolder

Azione AddAttachments

Questa azione ti consente di aggiungere un allegato.

Parametri di input dell'azione AddAttachments

Azione DownloadAttachments

Questa azione ti consente di scaricare gli allegati.

Parametri di input dell'azione DownloadAttachments

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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "ListTitle": "My lists",
   "ItemId": "1",
   "FileName": "sitepages.txt"
   }

Se l'azione ha esito positivo, il parametro DeleteAttachment della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: controllo in 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.txt",
   "Comment": "Comment test"
   }

Se l'azione ha esito positivo, il parametro CheckInDocument della risposta connectorOutputPayload dell'attività 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.txt"
   }

Se l'azione ha esito positivo, il parametro CheckOutDocument della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: annullare un pagamento

Questo esempio annulla l'estrazione di un file.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DiscardCheckOutDocument, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.docx"
   }

Se l'azione ha esito positivo, il parametro DiscardCheckOutDocument della risposta connectorOutputPayload dell'attività 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "SourceFileRelativeUrl": "/Shared Documents/Document.docx",
   "DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
   }

Se l'azione ha esito positivo, il parametro CopyDocument della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: carica 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "FileName": "test.txt",
   "RelativeUrl": "/Shared Documents/TestFolder",
   "Content": "abcd"
   }

Se l'azione ha esito positivo, il parametro UploadDocument della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: carica un file binario

Questo esempio carica un file binario nella posizione specificata. Quando carichi un file binario, specifica i contenuti da caricare come stringa codificata in Base64.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UploadDocument, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "FileName": "test.txt",
   "RelativeUrl": "/Shared Documents/TestFolder",
   "ContentBytes": "SGVsbG8gd29ybGQK",
   "HasBytes": "true"
   }

Se l'azione ha esito positivo, il parametro UploadDocument della risposta connectorOutputPayload dell'attività 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "RemoteFile": "/TestFolder/test.txt",
   "Library": "Shared Documents"
   }

Se l'azione ha esito positivo, il parametro DownloadDocument della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: scaricare 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "RemoteFile": "/TestFolder/test1.png",
   "Library": "Shared Documents"
   "HasBytes": "true"  
   }

Se l'azione ha esito positivo, il parametro DownloadDocument della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: scaricare un file da un sito specifico

Questo esempio scarica un file da un sito specifico.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DownloadDocument, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "RemoteFile": "	http://z8**.sharepoint.com/sites/SharepointGCS/Docs/SharpointGCS.docx",
     "Library": "Docs",
     "HasBytes": true
   }
   

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività DownloadDocument avrà un valore simile al seguente:

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

Per scaricare un file da un sito specifico, devi fornire l'indirizzo completo del file remoto.

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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "SourceFileURL": "/Shared Documents/test.txt",
   "DestinationFolderURL": "/Shared Documents/TestFolder"
   }

Se l'azione ha esito positivo, il parametro MoveAttachmentOrDocument della risposta connectorOutputPayload dell'attività 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "FolderName": "TestFolder123"
   }

Se l'azione ha esito positivo, il parametro CreateFolder della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: aggiunta di 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "ListTitle": "My Lists",
   "FileName": "TestAttachment2",
   "Content": "abcd text",
   "ItemId": "1"
   }

Se l'azione ha esito positivo, il parametro AddAttachments della risposta connectorOutputPayload dell'attività 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "ListTitle": "My Lists",
   "FileName": "TestAttachment3",
   "ContentBytes": "VGVzdCBGaWxl",
   "HasBytes": "true",  
   "ItemId": "1"
   }

Se l'azione ha esito positivo, il parametro AddAttachments della risposta connectorOutputPayload dell'attività 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "RemoteFile": "/Shared Documents/Document.txt"
   }

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

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

Esempio: scaricare 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, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "RemoteFile": "/Shared Documents/Document.docx",
   "HasBytes": "true"
   }

Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta DownloadAttachments dell'attività 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, quindi fai clic su Fine.
4. (Facoltativo) Nella sezione Input 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: recuperare 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, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su EntityId e poi inserisci 3 nel campo Valore predefinito.

   In questo caso, 3 è un valore della chiave primaria nell'entità My Lists.

Esempio: creare 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, quindi 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 ha esito positivo, il campo connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   [{
   "ID": 3.0
   }]

Esempio: elimina 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, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci 2 nel campo Valore predefinito.