Utilizzo di Microsoft OneDrive per le aziende con IBM App Connect Enterprise

Microsoft OneDrive for Business è un servizio di archiviazione cloud Microsoft fornito con Office 365 e Microsoft SharePoint. È fondamentale per archiviare e condividere i file nel cloud. Gli associati all'interno e all'esterno dell'organizzazione possono accedere, modificare e condividere file e cartelle di documenti da qualsiasi dispositivo anche quando sono offline. IBM® App Connect Enterprise fornisce un nodo "Richiesta di Microsoft OneDrive for Business", che è possibile utilizzare per connettersi a Microsoft OneDrive for Business ed eseguire operazioni su oggetti quali unità, file, cartelle, elementi delle cartelle, autorizzazioni, collegamenti condivisi e utenti.

1. Nel Toolkit di IBM App Connect Enterprise, crea un flusso contenente un nodo " Microsoft OneDrive " per le richieste aziendali.
2. Selezionare il nodo Microsoft OneDrive for Business Request nel flusso per mostrare le proprietà del nodo nell'editor.
3. Nella scheda Di base , selezionare Avvia rilevamento connettore.
   Viene visualizzato un pannello in cui è possibile specificare il nome del progetto di politica e i dettagli del vault da utilizzare durante il rilevamento del connettore.
4. Specificare i dettagli del progetto di politiche e del vault da utilizzare durante il rilevamento del connettore:
   1. Nel campo Progetto politica , specificare il progetto di politica utilizzato per memorizzare le politiche create durante il rilevamento del connettore.
      In alternativa, è possibile creare un nuovo progetto di politica facendo clic su Nuovo e specificando il nome del nuovo progetto di politica. Quindi, fare clic su Fine.
   2. Specificare il vault da utilizzare durante il rilevamento del connettore. Per impostazione predefinita, le credenziali utilizzate durante il rilevamento del connettore vengono archiviate in un vault della directory esterna, che è un vault App Connect Enterprise che può essere utilizzato da qualsiasi server di integrazione. In alternativa, è possibile memorizzare le credenziali in un vault del server di integrazione, che viene creato nella directory di lavoro del server di integrazione e può essere utilizzato soltanto da tale server di integrazione.
      Per specificare il vault da utilizzare per l'archiviazione delle credenziali, completare i passi riportati nella sezione Utilizzo della procedura guidata Rilevamento connettore di uno dei seguenti argomenti:

      • Configurazione di un vault di directory esterno
      • Configurazione di un vault del server di integrazione
   3. Nel campo Chiave vault , immettere la chiave vault utilizzata per accedere alle credenziali memorizzate nel vault. La chiave del vault deve essere lunga almeno 8 caratteri.
   4. Facoltativo: per impostazione predefinita, l'ubicazione del vault e la chiave del vault specificate vengono salvate come preferenze nel Toolkit in modo che i valori siano preimpostati quando si avvia Connector Discovery. Se non si desidera salvare le preferenze, deselezionare Salva nelle preferenze del vault.
5. Fare clic su Avvia rilevamento per avviare la procedura guidata Rilevamento connettore per il connettore Microsoft OneDrive for Business
   Viene visualizzata la finestra Rilevamento connettore . Se sono disponibili connessioni Microsoft OneDrive for Business (account) esistenti, viene visualizzato un elenco di tali connessioni. Se non sono presenti connessioni, lo stato del connettore Microsoft OneDrive for Business viene visualizzato come Not connected.
   • Se sono disponibili una o più connessioni (account) Microsoft OneDrive for Business , completare la seguente procedura:
     1. Selezionare la connessione (account) che si desidera utilizzare facendo clic su di essa.
     2. Fare clic sul tipo di oggetto richiesto e selezionare l'azione che si desidera eseguire sull'oggetto. Ad esempio, fare clic su Unità e quindi su Richiama unità.
   • Se non ci sono connessioni esistenti (account), completare la seguente procedura:
     1. Fare clic sul tipo di oggetto richiesto e selezionare l'azione che si desidera eseguire su tale oggetto. Ad esempio, per richiamare un'unità da Microsoft OneDrive per Business, fare clic su Unità e quindi su Richiama unità.
     2. Fare clic su Connetti.
        Viene visualizzata una finestra in cui è possibile immettere i dettagli di connessione per il proprio account Microsoft OneDrive for Business . Immetti le seguenti informazioni:

        • Token di accesso : il token di accesso generato dall'ID client dell'applicazione e dal segreto client.
        • Token di aggiornamento : il token di aggiornamento generato dall'ID client dell'applicazione e dal segreto client.
        • ID client: l'identificatore univoco generato dopo che la registrazione dell'app Microsoft Azure viene associata alle richieste di progetti specifici.
        • Segreto client: il segreto del client delle applicazioni per un ID client delle applicazioni univoco specifico del progetto.
        • Nome del proxy : selezionare o specificare il nome del proxy che si desidera che App Connect utilizzi per inoltrare le chiamate al connettore. Questo campo è obbligatorio solo se le chiamate devono passare attraverso un proxy. Quando si utilizza il Toolkit " IBM App Connect Enterprise ", il nome del proxy deve essere specificato nel formato: {PolicyProjectName}:HTTPProxyPolicyName

        Per ulteriori informazioni su come identificare o generare questi dettagli di connessione, consultare la sezione "Come utilizzare IBM App Connect con Microsoft OneDrive for Business" nella documentazione sulla Continuous Delivery (CD) disponibile all'indirizzo IBM App Connect in containers.

     3. Fare clic su Connetti.
6. Impostare tutte le proprietà del connettore richieste nella procedura guidata.
   Facoltativamente, è possibile aggiungere condizioni. Ad esempio, se si desidera richiamare un'unità con un determinato ID, è possibile fare clic su Aggiungi condizione, selezionare ID dal menu a discesa e specificare l'identificativo univoco per l'unità nel campo Uguale a . È inoltre possibile impostare le proprietà che specificano il numero massimo di elementi da richiamare e l'azione da intraprendere se tale limite viene superato.
7. Una volta specificate le proprietà nella procedura guidata Rilevamento connettore, fare clic su Salva.
   Le credenziali utilizzate per la connessione a Microsoft OneDrive for Business sono memorizzate nel vault e gli altri dettagli di connessione vengono salvati nella politica Microsoft OneDrive for Business . I valori delle proprietà impostate nella procedura guidata vengono restituiti al nodo " Microsoft OneDrive " per la richiesta aziendale nel Toolkit " IBM App Connect Enterprise ".
8. Una volta terminato il rilevamento e salvati i valori delle proprietà, uscire dalla procedura guidata Rilevamento connettore facendo clic sulla X nell'angolo in alto a destra della finestra o premendo Alt+F4.
9. Torna alla modifica del nodo "Richiesta di servizio" ( Microsoft OneDrive ) nel Toolkit " IBM App Connect Enterprise ".
   Le proprietà del connettore che erano state impostate nella procedura guidata Rilevamento connettore (nel passo 6) sono ora visibili nel nodo . La scheda Di base mostra i valori delle proprietà Azione e Oggetto impostate nella procedura guidata. Ad esempio, se nella procedura guidata hai selezionato Unità > Recupera unità, nella scheda "Base" del nodo saranno visibili le seguenti proprietà:

   • Azione - RETRIEVEALL
   • Oggetto - Drive

   i valori delle proprietà Azione e Oggetto vengono visualizzati in formato di sola lettura. Se si desidera modificare questi valori, è possibile farlo facendo nuovamente clic su Avvia rilevamento connettori e impostando nuovi valori nella procedura guidata Rilevamento connettori. È possibile modificare altre proprietà facendo clic su Modifica accanto alla proprietà.

   La proprietà Nome base schema specifica il nome base dei file schema che descrivono il formato dei messaggi di richiesta e risposta inviati e ricevuti dal connettore Microsoft OneDrive for Business . Il nome di base dello schema viene impostato automaticamente la prima volta che si esegue il rilevamento per il nodo e si basa sul nome del flusso corrente e sul nome del nodo. Se si imposta questa proprietà manualmente prima di eseguire il rilevamento per la prima volta, verrà utilizzato il valore impostato. Se si ridenominano gli schemi dopo il rilevamento, è necessario modificare questa proprietà in modo che corrisponda al nome di base dello schema utilizzato dagli schemi ridenominati nel progetto. Se si modifica questa proprietà dopo il rilevamento, è necessario ridenominare i nomi dello schema in modo che corrispondano o eseguire nuovamente il rilevamento.

   A seconda dell'azione selezionata durante il rilevamento, la procedura guidata Rilevamento connettore genera uno schema di richiesta e uno schema di risposta o solo uno schema di risposta. Uno schema di richiesta viene generato solo se l'azione e l'oggetto selezionati richiedono un messaggio di richiesta. Lo schema di richiesta generato viene utilizzato per la convalida del messaggio di richiesta. Se l'azione era RETRIEVE o DELETE, solo lo schema di risposta viene restituito dal connettore.

   I file di schema generati vengono aggiunti al progetto e possono essere utilizzati da un nodo Mapping per la trasformazione dei dati di input o di output. Il nome file completo dello schema deriva dal nome di base dello schema (come gen/MyMessageFlow/Microsoft_OneDrive_for_Business_Request), con suffisso response.schema.json o request.schema.json. È possibile aprire lo schema facendo clic su Apri schema di richiesta o Apri schema di risposta.

10. Verificare che le impostazioni delle proprietà sul nodo Microsoft OneDrive for Business Request siano corrette e salvare il flusso di messaggi.
11. Nella scheda Connessione del nodo Microsoft OneDrive per richiesta di business , la proprietà Politica mostra il nome del criterio che contiene i dettagli dell'identit ... di sicurezza da utilizzare per la connessione. Il tipo di politica è Microsoft OneDrive for Business. Per ulteriori informazioni, consultare la politica di Microsoft OneDrive for Business.
12. Facoltativo: Impostare la proprietà Timeout nella scheda Connessione per specificare il periodo di tempo (in secondi) in cui il nodo attende Microsoft OneDrive for Business per elaborare l'operazione.
13. La scheda Filtro del nodo Microsoft OneDrive for Business Request contiene le proprietà che controllano il modo in cui il flusso di messaggi seleziona i dati. I valori iniziali di queste proprietà vengono ricavati dai valori delle proprietà impostati per il connettore Microsoft OneDrive for Business nella procedura guidata Rilevamento connettore, incluse le eventuali condizioni specificate (come descritto nel passo 6). Se successivamente si ritorna alla procedura guidata Rilevamento connettore e si modificano i valori di qualsiasi proprietà, tali aggiornamenti si rifletteranno nelle proprietà impostate sul nodo.

    Le proprietà Opzioni filtro controllano gli oggetti da utilizzare quando viene eseguito il nodo Microsoft OneDrive for Business Request . Le proprietà Limite filtro controllano il numero massimo di elementi da richiamare e l'azione da eseguire se il limite viene superato.

    È possibile modificare i valori facendo clic su Modifica accanto al valore che si desidera modificare nella sezione Opzioni filtro e modificando i valori delle proprietà impostati nella sezione Limite filtro .

    I valori delle proprietà possono essere valori di testo o espressioni ESQL o XPATH risolte dal contenuto del messaggio passato al nodo Microsoft OneDrive for Business Request durante l'esecuzione.

14. Nella scheda Richiesta , impostare la proprietà Ubicazione dati per specificare la posizione nella struttura ad albero dei messaggi in entrata contenente i dati oggetto da creare in Microsoft OneDrive for Business. Questi dati formano la richiesta inviata dal nodo Microsoft OneDrive for Business Request al sistema Microsoft OneDrive for Business .
15. Nella scheda Risultato , impostare la proprietà Ubicazione dati di output per specificare l'ubicazione nella struttura ad albero del messaggio di output che conterrà i dati del record creato in Microsoft OneDrive for Business.
16. Per impostazione predefinita, i messaggi di richiesta vengono convalidati rispetto allo schema di richiesta generato durante il rilevamento del connettore. È possibile disabilitare la convalida della richiesta o modificare le impostazioni di convalida utilizzando le proprietà Convalida del nodo Microsoft OneDrive for Business Request .
17. Salvare il flusso di messaggi.