Utilizzo di MailChimp con IBM App Connect Enterprise

MailChimp è un servizio di email marketing che consente di progettare e inviare newsletter via email, inviti, promemoria e altro ancora, agli elenchi di sottoscrittori. IBM® App Connect Enterprise mette a disposizione i nodi "Input" ( MailChimp ) e "Request" ( MailChimp ), che è possibile utilizzare per interagire con MailChimp.

La seguente procedura mostra come connettersi a un account MailChimp e configurare un nodo MailChimp Request utilizzando il rilevamento del connettore. È possibile seguire una procedura simile per configurare un nodo MailChimp Input per monitorare MailChimp per gli oggetti nuovi o aggiornati, creando un flusso contenente un nodo MailChimp Input e configurandolo tramite il rilevamento del connettore.

1. Nel Toolkit di IBM App Connect Enterprise, crea un flusso contenente un nodo "Richiesta" ( MailChimp ).
2. Per mostrare le proprietà del nodo nell'editor, selezionare il nodo MailChimp Request nel flusso.
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 MailChimp
   Viene visualizzata la finestra Rilevamento connettore . Se sono disponibili connessioni (account) MailChimp , viene visualizzato un elenco di tali connessioni. Se non sono presenti connessioni esistenti, lo stato del connettore MailChimp viene visualizzato come Not connected.
   • Se sono disponibili una o più connessioni MailChimp (account), 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 recuperare le campagne da MailChimp, fare clic Campagne poi Recupera le campagne.
   • 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 recuperare le campagne da MailChimp, fare clic Campagne poi Recupera le campagne.
     2. Fare clic su Connetti.
        Viene visualizzata una finestra in cui è possibile immettere i dettagli di connessione per il proprio account MailChimp . Immetti le seguenti informazioni:

        • Token di accesso: registra un'applicazione nel tuo account MailChimp per creare un ID client e un segreto client. Viene generato un token di accesso dall'ID client, dal segreto client, dall'URI di reindirizzamento e dal codice di autorizzazione utilizzato per l'autenticazione con MailChimp.

        Per ulteriori informazioni su come ottenere questi dati di connessione, consulta la sezione "Come utilizzare IBM App Connect con Mailchimp" nella documentazione sulla Continuous Delivery (CD) di IBM App Connect in containers.

     3. Fare clic su Connetti.
6. Impostare le proprietà del connettore richieste nella procedura guidata.
   È anche possibile condizioni per il recupero dei dati, facendo clic su Aggiungi condizione e selezionando la proprietà che si desidera filtrare. Ad esempio, se è stato selezionato Campagne e quindi Richiama campagne, è possibile specificare le campagne con un ID campagnaspecifico. È inoltre possibile impostare le proprietà che specifichino 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.
   La credenziale utilizzata per la connessione a MailChimp viene memorizzata nel vault e gli altri dettagli di connessione vengono salvati nella politica MailChimp . I valori delle proprietà impostati nella procedura guidata vengono restituiti al nodo " MailChimp 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 di MailChimp " 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 MailChimp MailChimp nell'Editor delle proprietà. La scheda Di base mostra i valori delle proprietà Azione e Oggetto impostate nella procedura guidata. Ad esempio, se si seleziona Campagne > Richiama campagne nella procedura guidata, le seguenti proprietà saranno visibili nella scheda Di base del nodo:

   • Azione - RETRIEVEALL
   • Oggetto - Campaigns

   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.

   La proprietà Nome base schema specifica il nome base dei file di schema che descrivono il formato dei messaggi di richiesta e risposta inviati e ricevuti dal connettore MailChimp . 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 nodo e del flusso correnti. 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 base dello schema utilizzato dagli schemi rinominati 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.Mailchimp_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 MailChimp Richiesta siano corrette e salvare il flusso di messaggi.
11. Nella scheda Connessione del nodo MailChimp Richiesta , 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 è MailChimp. Per ulteriori informazioni, consultare PoliticaMailChimp.
12. Facoltativo: Impostare la proprietà Timeout nella scheda Connessione per specificare il periodo di tempo (in secondi) in cui il nodo attende MailChimp per elaborare l'operazione.
13. La scheda Filter del nodo MailChimp 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 MailChimp nella procedura guidata Rilevamento connettore, incluse le proprietà delle opzioni di filtro e 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à (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 MailChimp 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 MailChimp Request durante l'esecuzione.

14. Nella scheda Richiesta , impostare la proprietà Ubicazione dati per specificare l'ubicazione nella struttura ad albero del messaggio in entrata che contiene i dati dell'oggetto da creare in MailChimp. Questi dati formano la richiesta inviata dal nodi MailChimp Richiesta al sistema MailChimp .
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 MailChimp.
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 MailChimp Request .
17. Salvare il flusso di messaggi.