Utilizzo di Confluence con l' IBM App Connect Enterprise

Confluenza è uno strumento di collaborazione sui contenuti che aiuta i team a creare, condividere e gestire contenuti in un repository centralizzato.

1. Nel Toolkit di IBM App Connect Enterprise, crea un flusso che contenga un nodo "Richiesta Confluence".
2. Selezionare il nodo Richiesta di flusso nel flusso per mostrare le proprietà del nodo nell'editor.
3. Nella scheda Di base , fare clic su 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 politica 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 che le preferenze vengano salvate, deselezionare Salva nelle preferenze del vault.
5. Fare clic su Avvia rilevamento per avviare la procedura guidata Rilevamento connettore per il connettore Confluenza .
   Viene visualizzata la finestra Rilevamento connettore . Se sono disponibili connessioni (account) Confluenza esistenti, viene visualizzato un elenco di tali connessioni. Se non ci sono connessioni esistenti, lo stato del connettore Confluenza viene visualizzato come Not connected.
   • Se sono disponibili una o più connessioni (account) Confluenza , 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, per richiamare gli allegati da Confluenza, fare clic su Allegati e quindi su Richiama allegati.
   • 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 gli allegati da Confluenza, fare clic su Allegati e quindi su Richiama allegati.
     2. Fare clic su Connetti.
        Viene visualizzata una finestra in cui si immettono i dettagli di connessione per l'account Confluenza . Immetti le seguenti informazioni:

        • Endpoint URL :Il server Confluence URL.
        • Nome utente Il nome utente per il tuo account Confluence .
        • Password o token API: la password per il tuo account installato in loco Confluence o il token API per il tuo account Confluence .
        • URI API Rest: (facoltativo): obbligatorio solo se ti stai connettendo a un'istanza in loco Confluence . Per una configurazione in loco personalizzata per la distribuzione con contesto, specifica l'API URI come /<contextName>/rest/api. Per una configurazione senza contesto, specificare l'URI API come /rest/api.
        • Nome proxy : selezionare o specificare il nome del proxy che si desidera App Connect utilizzare per inoltrare le chiamate del connettore. Questo campo è richiesto 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 individuare questi dettagli di connessione, consulta la sezione "Come utilizzare IBM App Connect con Confluence" nella documentazione sulla Continuous Delivery (CD) disponibile all'indirizzo IBM App Connect in containers.

     3. Fare clic su Connetti.
6. Impostare le proprietà del connettore richieste nella procedura guidata.
   È possibile aggiungere condizioni per il richiamo dei dati, facendo clic su Aggiungi condizione e selezionando la proprietà in base alla quale si desidera filtrare. Ad esempio, è possibile richiamare gli allegati con un ID specifico. È inoltre possibile impostare le proprietà che specificano il numero massimo di record 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 connettersi a Confluence sono archiviate nel vault, mentre gli altri dettagli di connessione sono salvati nella policy di Confluence. I valori delle proprietà impostate nella procedura guidata vengono restituiti al nodo "Confluence Request" 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 Confluence" nel Toolkit " IBM App Connect Enterprise ".
   Le proprietà del connettore impostate nella procedura guidata Rilevamento connettore (al passo 6) sono ora visibili sul nodo Richiesta di confluenza nell'editor delle proprietà. La scheda Base mostra i valori delle proprietà Azione e Oggetto impostate nella procedura guidata. Ad esempio, se nella procedura guidata è stata selezionata l'opzione Allegati > Recupera allegati, nella scheda Base del nodo saranno visibili le seguenti proprietà:

   • Azione - RETRIEVEALL
   • Oggetto - Attachments

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

   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 Confluence . 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 questa proprietà viene impostata manualmente prima di eseguire il rilevamento per la prima volta, viene utilizzato il valore impostato. Se si rinominano gli schemi dopo il rilevamento, è necessario modificare questa proprietà in modo che corrisponda al nome base dello schema utilizzato dagli schemi rinominati nel progetto. Se si modifica questa proprietà dopo il rilevamento, è necessario ridenominare i nomi schema in modo che corrispondano o eseguire nuovamente il rilevamento.

   In base all'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.Confluence_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 della propriet ... sul nodo Richiesta di confluenza siano corrette e salvare il flusso di messaggi.
11. Nella scheda Connessione del nodo Richiesta di confluenza , la proprietà Politica mostra il nome della politica che contiene i dettagli dell'identit ... di sicurezza da utilizzare per la connessione. La politica ha un tipo Confluence.
    Per ulteriori informazioni, consulta la politica di Confluence.
12. Facoltativo: impostare la proprietà Timeout nella scheda Connessione per specificare il periodo di tempo (in secondi) in cui il nodo attende che Confluenza elabori l'operazione.
13. La scheda Filtro del nodo Richiesta di confluenza contiene le proprietà che controllano il flusso di messaggi che seleziona i dati. I valori iniziali di queste proprietà vengono presi dai valori delle proprietà impostati per il connettore Confluenza nella procedura guidata Rilevamento connettore, incluse le proprietà delle opzioni di filtro e le eventuali condizioni specificate (come descritto nel passo 6). Quindi, se si ritorna alla procedura guidata Rilevamento connettore e si modificano i valori di qualsiasi proprietà (aggiungendo nuove condizioni, ad esempio), tali aggiornamenti si rifletteranno nelle proprietà impostate sul nodo.

    Le proprietà Opzioni filtro controllano gli oggetti da utilizzare quando viene eseguito il nodo Richiesta di confluenza . 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 Richiesta di confluenza durante l'esecuzione.

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