Utilizzo dei dati digitali di Commerce Cloud di Salesforce con IBM App Connect Enterprise

Salesforce Commerce Cloud Digital Data (precedentemente noto come "Demandware"), fornisce alle aziende una soluzione basata sul cloud per creare un'esperienza di acquisto unificata online per i propri clienti. La piattaforma consente alle imprese di anticipare le esigenze dei clienti da informazioni preziose acquisite, in modo che i clienti possano sfogliare i prodotti e fare acquisti in modo rapido e semplice. IBM® App Connect Enterprise fornisce i nodi " Salesforce Commerce Cloud Digital Data Input " e " Salesforce Commerce Cloud Digital Data Request ", che è possibile utilizzare per interagire con i dati digitali di Salesforce Commerce Cloud.

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

1. Nel Toolkit di " IBM App Connect Enterprise ", crea un flusso contenente un nodo " Salesforce Commerce Cloud Digital Data Request".
2. Per mostrare le proprietà del nodo nell'editor, selezionare il nodo Salesforce Commerce Cloud Digital Data 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 Salesforce Commerce Cloud Digital Data .
   Viene visualizzata la finestra Rilevamento connettore . Se sono disponibili connessioni (account) Salesforce Commerce Cloud Digital Data esistenti, viene visualizzato un elenco di tali connessioni. Se non vi sono connessioni esistenti, lo stato del connettore Salesforce Commerce Cloud Digital Data viene mostrato come Not connected.
   • Se sono disponibili una o più connessioni (account) Salesforce Commerce Cloud Digital Data , 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 i catalogo da Salesforce Commerce Cloud Digital Data, fare clic su Cataloghi e quindi su Richiama cataloghi.
   • 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 i catalogo da Salesforce Commerce Cloud Digital Data, fare clic su Cataloghi e quindi su Richiama catalogo.
     2. Fare clic su Connetti.
        Viene visualizzata una finestra in cui è possibile immettere i dettagli di collegamento per l'account Salesforce Commerce Cloud Digital Data . Immetti le seguenti informazioni:

        • Base URL : La base URL (o protocollo e hostname) della vostra istanza di Salesforce Commerce Cloud.
        • Versione API: la versione API della tua istanza Salesforce B2C Commerce.
        • ID client: Salesforce L'identificativo del client Commerce Cloud.
        • Segreto client: Salesforce Commerce Cloud.

        Per ulteriori informazioni su come accedere o generare questi dati di connessione, consultare la sezione "Come utilizzare IBM App Connect con i dati digitali di Salesforce Commerce Cloud" 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.
   Per le azioni di richiamo o aggiornamento, è possibile aggiungere condizioni per il richiamo dei dati facendo clic su Aggiungi condizione e selezionando la proprietà in base alla quale si desidera filtrare.

   Se si aggiungono le condizioni per richiamare o aggiornare le azioni, è possibile facoltativamente utilizzare il filtro delle condizioni per perfezionare le condizioni applicate. Per utilizzare il filtro delle condizioni, uscire dalla procedura guidata Rilevamento connettore facendo clic sul pulsante Chiudi (X) e completare le istruzioni in Utilizzo del filtro delle condizioni.

   Per le azioni di creazione, è possibile utilizzare facoltativamente la modalità avanzata. Nella vista di modifica predefinita per un'azione, alcune applicazioni hanno campi nascosti perché non sono richiesti per i casi di utilizzo generali. Per casi di utilizzo più avanzati, è possibile passare alla modifica in modalità avanzata, che fornisce funzionalità aggiuntive per la modifica dei flussi. Per utilizzare la modalità avanzata, uscire dalla procedura guidata Rilevamento connettore facendo clic sul pulsante Chiudi (X) e completare le istruzioni in Utilizzo della modalità avanzata.

   È 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.
   Le credenziali utilizzate per la connessione a Salesforce Commerce Cloud Digital Data vengono memorizzate nel vault e gli altri dettagli di connessione vengono salvati nella politicaSalesforce Commerce Cloud Digital Data. I valori delle proprietà impostati nella procedura guidata vengono restituiti al nodo " Salesforce Commerce Cloud Digital Data 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 " Salesforce Commerce Cloud Digital Data Request" nel Toolkit " IBM App Connect Enterprise ".
   Le proprietà del connettore che erano state impostate nella procedura guidata Rilevamento connettore (nel passaggio 6) sono ora visibili nel nodo Salesforce Commerce Cloud Digital Data Request 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 Cataloghi > Richiama catalogo nella procedura guidata, le seguenti proprietà saranno visibili nella scheda Di base del nodo:

   • Azione - RETRIEVEALL
   • Oggetto - catalog

   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 schema che descrivono il formato dei messaggi di richiesta e risposta inviati e ricevuti dal connettore Salesforce Commerce Cloud Digital Data . 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.Salesforce_Commerce_Cloud_Digital_Data_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 Salesforce Commerce Cloud Digital Data Request siano corrette, quindi salvare il flusso di messaggi.
11. Nella scheda Connessione del nodo Salesforce Commerce Cloud - Richiesta di dati digitali , 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 Salesforce Commerce Cloud Digital Data.
    Per ulteriori informazioni, consultare Salesforce Commerce Cloud Digital Data policy.
12. Facoltativo: Impostare la proprietà Timeout nella scheda Connessione per specificare il periodo di tempo (in secondi) in cui il nodo attende Salesforce Commerce Cloud Digital Data per elaborare l'operazione.
13. La pagina Filtro del nodo Salesforce Commerce Cloud Digital Data Request contiene proprietà che controllano il modo in cui il flusso di messaggi seleziona i dati. I valori iniziali di queste proprietà vengono presi dai valori delle proprietà impostati per il connettore Salesforce Commerce Cloud Digital Data nella procedura guidata Connector Discovery, 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 riflettono nelle proprietà impostate sul nodo.

    Le proprietà Opzioni filtro controllano gli oggetti da utilizzare quando viene eseguito il nodo Salesforce Commerce Cloud Digital Data Request . Le proprietà Limite filtro controllano il numero massimo di elementi da richiamare e l'azione da intraprendere 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 Salesforce Commerce Cloud Digital Data Request durante l'esecuzione.

14. Nella scheda Richiesta , impostare la proprietà Ubicazione dati per specificare l'ubicazione nella struttura ad albero dei messaggi in entrata che contiene i dati oggetto da creare in Salesforce Commerce Cloud Digital Data. Questi dati costituiscono la richiesta inviata dal nodo Salesforce Commerce Cloud Digital Data Request a Salesforce Commerce Cloud Digital Data.
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 Salesforce Commerce Cloud Digital Data.
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 Salesforce Commerce Cloud Digital Data Request .
17. Salvare il flusso di messaggi.