Guida alla configurazione dell hub

Transcript

1 IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition Guida alla configurazione dell hub Versione 6.1.1

2

3 IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition Guida alla configurazione dell hub Versione 6.1.1

4 Nota! Prima di utilizzare queste informazioni e il relatio prodotto, leggere le informazioni presenti in Informazioni particolari a pagina 413. Seconda edizione (marzo 2008) Questa edizione è alida per IBM WebSphere Partner Gateway Enterprise Edition (5724-L69), ersione 6.1.1, e Adanced Edition (5724-L68), ersione 6.1.1, e a tutti i successii rilasci e modifiche, fino a quando non diersamente indicato nelle nuoe edizioni. Per iniare commenti relatii a questa documentazione, iniare un a: doc-comments@us.ibm.com. I commenti degli utenti sono i benenuti. IBM può utilizzare o distribuire qualsiasi informazione fornita dall utente in qualsiasi modo ritenga appropriato senza incorrere in obblighi erso l utente. Copyright International Business Machines Corporation 2004, Tutti i diritti riserati.

5 Indice Informazioni sul presente manuale xi Destinatari xi Conenzioni tipografiche xi Documenti correlati xii Noità in questo rilascio xii Noità nel rilascio xii Noità nel rilascio xiii Capitolo 1. Introduzione alla configurazione dell hub Panoramica della configurazione dell hub Informazioni necessarie per l impostazione dell hub Panoramica dei trasporti Panoramica delle definizioni del documento Panoramica sull elaborazione del documento Configurazione dei componenti di elaborazione del documento con i gestori Destinatari Gestore documenti Destinazioni Panoramica della configurazione dell hub Configurazione dell hub Creazione di partner Definizione delle connessioni del documento Capitolo 2. Creazione ed impostazione di partner Creazione dei profili del partner Creazione delle destinazioni Impostazione delle funzioni B2B Caricamento dei certificati Creazione di utenti Configurazione dell utente FTP Creazione di gruppi Creazione di contatti Creazione di indirizzi Capitolo 3. Preparazione alla configurazione dell hub Creazione di una destinazione directory file Configurazione del serer FTP per riceere i documenti Configurazione della struttura di directory richiesta sul serer FTP Modalità di elaborazione dei file iniati su FTP Configurazione aggiuntia del serer FTP Considerazioni di protezione per il serer FTPS Configurazione dell hub per il protocollo di trasporto JMS Creazione di una directory per JMS Modifica della configurazione JMS predefinita Creazione delle code e del canale Aggiunta di un runtime Jaa all ambiente Definizione della configurazione JMS Configurazione delle librerie di runtime Configurazione compressione RNIF Utilizzo degli script FTP per le destinazioni ed i destinatari Script FTP Utilizzo di mappe dal client Data Interchange Serices Completamento delle attiità di configurazione post-installazione Capitolo 4. Aio del serer e isualizzazione della Console comunità Copyright IBM Corp. 2004, 2008 iii

6 Aio dei componenti di WebSphere Partner Gateway Collegamento alla Console comunità Capitolo 5. Configurazione di Console comunità Specifica delle informazioni locali e del marchio della console Marchi della console Modifica del foglio di calcolo Localizzazione dei dati sulla console Impostazione della politica della password Configurazione delle autorizzazioni Modalità di concessione delle autorizzazioni agli utenti Abilitazione e disabilitazione delle autorizzazioni Capitolo 6. Definizione dei destinatari Panoramica dei destinatari Caricamento dei gestori definiti dall utente Programmi generici di gestione pre-elaborazione Impostazione dei alori globali di trasporto Impostazione di un destinatario HTTP/S Dettagli destinatario Configurazione destinatario Gestori Impostazione di un destinatario FTP Dettagli destinatario Configurazione destinatario Gestori Impostazione di un destinatario SMTP Dettagli destinatario Configurazione destinatario Pianificazione Impostazione di un destinatario JMS Dettagli destinatario Configurazione destinatario Gestori Impostazione di un destinatario File-system Dettagli destinatario Configurazione destinatario Gestori Impostazione di un destinatario Script FTP Creazione dello script FTP Comandi di script FTP Dettagli destinatario Configurazione destinatario Attributi definiti dall utente Pianifica Gestori Impostazione di un destinatario per un trasporto definito dall utente Modifica dei punti di configurazione Preelaborazione SyncCheck Postelaborazione Modifica dell elenco configurato Capitolo 7. Configurazione delle azioni e delle fasi del flusso di laoro fisso Caricamento di gestori Configurazione dei flussi di laoro fissi Flussi di laori fissi Flusso di laoro in uscita Configurazione azioni Azioni fornite dal prodotto i IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition: Guida alla configurazione dell hub

7 Conalida busta SOAP e Corpo SOAP Sbustamento busta SOAP Modifica di un azione definita dall utente Creazione di azioni Capitolo 8. Configurazione dei tipi di documenti Panoramica dei tipi di documenti Fase 1: Verificare che la definizione del documento sia disponibile Fase 2: Creare le interazioni Fase 3: Creare i profili del partner, le destinazioni e le funzioni B2B Fase 4: Attiare le connessioni Un esempio di flusso Documenti binari Documenti EDI con azione Passaggio Creazione delle definizioni del documento Creazione di interazioni Documenti RosettaNet Panoramica dei documenti RosettaNet Pacchetti del tipo di documenti RNIF e PIP Creazione delle definizioni del documento Configurazione dei alori dell attributo Creazione di interazioni Visualizzazione dei documenti RosettaNet Documenti CIDX Panoramica dei documenti CIDX Pacchetti del tipo di documento RNIF e PIP per CIDX Creazione delle definizioni del documento Configurazione dei alori dell attributo Creazione di interazioni Visualizzazione dei documenti CIDX Documenti ebms Panoramica dei documenti ebms Creazione delle definizioni del documento Configurazione dei alori dell attributo Creazione di interazioni Associazione di CPA ebms alla configurazione di WebSphere Partner Gateway Mappatura delle intestazioni SOAP ebms alle intestazioni di WebSphere Partner Gateway Visualizzazione dei documenti ebms Esecuzione del ping dei partner ebms Serizi Web Identificazione dei partner per un serizio Web Creazione delle definizioni del documento Creazione di interazioni Restrizioni e limitazioni del supporto del serizio Web Documenti cxml Panoramica dei documenti cxml Creazione delle definizioni del documento Creazione di interazioni Documenti XML personalizzati Panoramica dell elaborazione del documento XML personalizzato Creazione di formati XML Creazione di una definizione del protocollo Creazione di una definizione di tipo di documento Termine della configurazione Utilizzo delle mappe di conalida Aggiunta mappe di conalida Associazione delle mappe alle definizioni di documento Utilizzo delle associazioni di trasformazione Visualizzazione dei documenti Configurazione della registrazione di non rifiuto Configurazione memorizzazione messaggio Indice

8 Capitolo 9. Configurazione dei flussi di documenti EDI Panoramica su EDI Struttura dello scambio EDI Mappe Panoramica dei documenti XML e ROD Documenti XML Documenti ROD Separatori e più documenti Panoramica della creazione dei tipi di documenti e impostazione di attributi Fase 1: Verificare che la definizione del documento sia disponibile Fase 2: Creare le interazioni Fase 3: Creare i profili del partner, le destinazioni e le funzioni B2B Fase 4: Attiare le connessioni Panoramica sui flussi possibili Flusso EDI in EDI Flusso EDI in XML o ROD Flusso da XML o ROD a EDI Flusso di più documenti XML o ROD in scambio EDI Flusso da XML a ROD o da ROD a XML Flusso XML in XML o ROD in ROD Modalità di elaborazione degli scambi EDI Modalità di elaborazione dei documenti XML o ROD Impostazione dell ambiente EDI Eneloper Profili busta Profili connessione Numeri di controllo Inizializzazione numeri di controllo Numeri di controllo correnti Definizione degli scambi del documento Definizione degli scambi del documento mediante procedure guidate Definizione manuale degli scambi del documento Visualizzazione di scambi e transazioni EDI Capitolo 10. Creazione delle destinazioni Panoramica delle destinazioni Impostazione dei alori globali di trasporto Configurazione di un proxy di inoltro Impostazione di una destinazione HTTP Dettagli della destinazione Configurazione della destinazione Impostazione di una destinazione HTTPS Dettagli della destinazione Configurazione della destinazione Impostazione di una destinazione FTP Dettagli della destinazione Configurazione della destinazione Impostazione di una destinazione SMTP Dettagli della destinazione Configurazione della destinazione Impostazione di una destinazione JMS Dettagli della destinazione Configurazione della destinazione Impostazione di una destinazione file-directory Dettagli della destinazione Configurazione della destinazione Impostazione di una destinazione FTPS Dettagli della destinazione Configurazione della destinazione Impostazione di una destinazione Script FTP Creazione dello script FTP i IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition: Guida alla configurazione dell hub

9 Comandi script FTP Destinazioni Script FTP Dettagli della destinazione Configurazione della destinazione Attributi definiti dall utente Pianifica Configurazione dei gestori Impostazione di una destinazione per un trasporto definito dall utente Specifica di una destinazione predefinita Capitolo 11. Gestione delle connessioni Panoramica delle connessioni Configurazione più partner interni Attiazione delle connessioni del partner Specifica e modifica di attributi Capitolo 12. Abilitazione della sicurezza per gli scambi del documento Panoramica della protezione Meccanismi di protezione e protocolli utilizzati in WebSphere Partner Gateway Certificati e meccanismi di protezione Utilizzo di certificati per abilitare la codifica Creazione e installazione dei certificati di codifica in entrata Installazione dei certificati di codifica in uscita Utilizzo dei certificati per abilitare la firma digitale Creazione di un certificato di firma in uscita Installazione di un certificato di firma in entrata Utilizzo di certificati per abilitare SSL Handshake SSL Configurazione dei certificati SSL in entrata Configurazione dei certificati SSL in uscita Aggiunta di un CRL (Certificate Reocation List) Abilitazione dell accesso ai punti di distribuzione CRL Configurazione di SSL in entrata per la Console comunità e il Destinatario Caricamento certificati utilizzando la procedura guidata Creazione insiemi di certificato Eliminazione insieme certificato Whereused certificato Impostazione di SSL per il destinatario/destinazione script FTP Fornitura certificato predefinito per tutti i partner interni Riepilogo di certificato Conformità FIPS Configurazione di WebSphere Partner Gateway per l esecuzione in modalità FIPS Configurazione di WebSphere Partner Gateway per l esecuzione in modalità predefinita Configurazione dei proider IBM JSSE per la modalità FIPS Algoritmi supportati in modalità FIPS e non FIPS Capitolo 13. Gestione di aisi Panoramica di aisi Visualizzazione o modifica di contatti e dettagli dell aiso Ricerca di aisi Disabilitazione o abilitazione di un aiso Rimozione di un aiso Aggiunta di un nuoo contatto ad un aiso esistente Creazione di un aiso in base al olume Creazione di un aiso in base all eento Capitolo 14. Inizializzazione flusso di errori Configurazione documento flusso di errori Limitazioni Indice ii

10 Capitolo 15. Termine della configurazione Supporto file di dimensione eleata per i documenti AS Abilitazione all utilizzo degli API Specifica delle code utilizzate per gli eenti Specifica degli eenti notificabili Aggiornamento di un trasposto definito dall utente Esempi Appendice A. Esempi di base Configurazione di base Scambio di documenti EDI autorizzati Configurazione dell hub Creazione dei partner e delle connessioni del partner Configurazione di base - Configurazione della protezione per documenti in entrata e in uscita Impostazione dell autenticazione SSL per i documenti in entrata Impostazione della codifica Impostazione della firma del documento Estensione della configurazione di base Creazione di un destinatario FTP Impostazione dell hub per la ricezione di file binari Impostazione dell hub per i documenti XML personalizzati Appendice B. Esempi EDI Esempio EDI in ROD Sbustamento e trasformazione di uno scambio EDI Aggiunta di un TA1 ad uno scambio Aggiunta di una mappa FA Esempio EDI in XML Importazione della mappa di trasformazione Verifica delle definizioni documenti e della mappa di conersione Configurazione di un destinatario Creazione delle interazioni Creazione di partner Creazione delle destinazioni Impostazione delle funzioni B2B Attiazione delle connessioni Esempio da XML a EDI Importazione della mappa di trasformazione Verifica delle definizioni documenti e della mappa di conersione Configurazione di un destinatario Creazione delle interazioni Creazione di partner Creazione delle destinazioni Impostazione delle funzioni B2B Creazione del profilo busta Creazione del formato XML Attiazione delle connessioni Configurazione di attributi Esempio ROD in EDI Importazione della mappa di trasformazione Verifica delle definizioni documenti e della mappa di conersione Configurazione di un destinatario Creazione delle interazioni Creazione di partner Creazione delle destinazioni Impostazione delle funzioni B2B Creazione del profilo busta Attiazione delle connessioni Configurazione di attributi Appendice C. Informazioni aggiuntie su RosettaNet iii IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition: Guida alla configurazione dell hub

11 Disattiazione dei PIP Come fornire la notifica dell errore PIP 0A Aggiornamento delle informazioni sul contatto Modifica dei alori degli attributi di RosettaNet Creazione dei pacchetti della definizione del documento PIP Creazione di file XSD Creazione del file XML Creazione del pacchetto Conalida Cardinalità Formato Enumerazione Pacchetti di definizione del documento PIP A1 Notifica di errore V A1 Notifica di errore V A1 Distribuzione informazioni nuoo prodotto A12 Distribuzione master prodotto A1 Richiesta quotazione A2 Richiesta prezzo e disponibilità A4 Richiesta ordine di acquisto V A4 Richiesta ordine di acquisto V A5 Query stato ordine A6 Distribuzione stato ordine A7 Notifica aggiornamento ordine di acquisto A8 Richiesta modifica ordine di acquisto V A8 Richiesta modifica ordine di acquisto V A9 Richiesta cancellazione ordine di acquisto B2 Notifica anticipo spedizione B3 Distribuzione stato spedizione B11 Notifica ordine di spedizione B12 Richiesta ordine di spedizione B13 Notifica conferma ordine di spedizione B14 Richiesta cancellazione ordine di spedizione B18 Notifica documentazione di spedizione C1 Restituzione prodotto C3 Notifica della fattura C4 Notifica della fattura rifiutata C6 Notifica dell aiso di pagamento C7 Notifica di auto-fatturazione D8 Distribuzione attiità in esecuzione A1 Notifica di preisione strategica A3 Notifica di preisione soglia rilascio A4 Notifica di preisione pianificazione rilascio A5 Notifica di replica preisione B2 Notifica di ricezione della spedizione B3 Notifica di consumo C1 Distribuzione report inentario V C1 Distribuzione report inentario V C1 Distribuzione elenco prodotto C2 Richiesta registrazione progetto C4 Distribuzione stato registrazione D1 Richiesta sped. da magazzino e autorizzazione addebito C1 Query concessione serizio C2 Richiesta garanzia reclamo B1 Distribuzione attiità in esecuzione B5 Notifica ordine attiità industriale B6 Notifica replica ordine attiità industriale Appendice D. Ulteriori informazioni CIDX Supporto per l abilitazione del processo CIDX Indice ix

12 Creazione dei pacchetti di definizione del documento CIDX Appendice E. Attributi Attributi EDI attributi profilo busta Attributi di connessione e definizione del documento Proprietà del client Data Interchange Serices Attributi AS Attributi RosettaNet Attributo Integrazione di backend Attributi ebms Attributi generali Informazioni particolari Informazioni interfaccia di programmazione Marchi e marchi di serizio Indice analitico x IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition: Guida alla configurazione dell hub

13 Informazioni sul presente manuale In questo documento, iene descritto in che modo configurare il serer (R) WebSphere Partner Gateway. (R) Destinatari Conenzioni Questo documento è indirizzato alla persona responsabile per la configurazione del serer di WebSphere Partner Gateway, meglio noto come hub. Per configurare l hub, è necessario essere l amministratore hub. L amministratore hub può utilizzare tutte le funzioni della Console comunità di WebSphere Partner Gateway per configurare e gestire l hub. tipografiche Questo documento utilizza le seguenti conenzioni. Tabella 1. Conenzioni tipografiche Conenzione Carattere a spaziatura fissa Descrizione Questo tipo di testo indica il testo inserito, i alori degli argomenti o le opzioni di comando, gli esempi e gli esempi di codice oppure le informazioni che il sistema stampa nella schermata (testo del messaggio o prompt). grassetto Il testo in grassetto indica i controlli dell interfaccia utente grafica (ad esempio, i nomi dei pulsanti in linea, i nomi o le opzioni dei menu) e le intestazioni della colonna nelle tabelle e il testo. corsio Il testo in corsio indica enfasi, titoli di manuali, nuoi termini e termini definiti nel testo, nomi di ariabili o lettere dell alfabeto utilizzate come lettere. Carattere a spaziatura fissa corsio Questo tipo di testo indica nomi ariabili nel testo a spaziatura fissa. DirProdotto DirProdotto rappresenta la directory in cui è installato il prodotto. Tutti i nomi del percorso IBM WebSphere Partner Gateway sono relatii alla directory in cui il prodotto WebSphere Partner Gateway è installato sul sistema. %testo% e $testo Il testo fra segni di percentuale (%) indica il alore della ariabile utente o della ariabile di sistema text di Windows (R). La notazione equialente in un ambiente (R) UNIX è $text, che indica il alore della ariabile di ambiente UNIX text. Testo colorato sottolineato Il testo colorato sottolineato indica un riferimento incrociato. Fare clic sul testo per andare all oggetto del riferimento. Testo in un contorno blu (Solo nei file PDF) un contorno intorno al testo indica un riferimento incrociato. Fare clic sul testo con contorni per andare all oggetto del riferimento. Questa conenzione è l equialente per i file PDF della conenzione testo colorato sottolineato inclusa in questa tabella. (irgolette) (Solo nei file PDF) Le irgolette racchiudono i riferimenti incrociati ad altre sezioni del documento. Copyright IBM Corp. 2004, 2008 xi

14 Tabella 1. Conenzioni tipografiche (Continua) Conenzione Descrizione { } In una riga di sintassi, le parentesi graffe racchiudono una serie di opzioni dalle quali l utente dee effettuare un unica scelta. [ ] In una riga di sintassi, le parentesi quadre racchiudono parametri facoltatii. < > Le parentesi angolari racchiudono i singoli elementi di nome per distinguerli l uno dall altro. Ad esempio, <nome_serer><nome_connettore>tmp.log. /, \ Le barre roesciate (\) engono utilizzate come separatori nei percorsi di directory delle installazioni di Windows. Per le installazioni UNIX, sostituire le barre roesciate con quelle in aanti (/). Documenti correlati Noità in questo rilascio La serie completa della documentazione disponibile con questo prodotto include tutte le informazioni relatie all installazione, alla configurazione e alla gestione ed utilizzo di WebSphere Partner Gateway Connect Enterprise Edition e Adanced Edition. È possibile eseguire il download di questa documentazione o leggerla direttamente online sul seguente sito Web: wspartnergateway/library/ Nota: le informazioni importanti su questo prodotto sono disponibili nelle Technote di supporto tecnico e nei Flash pubblicati dopo questo documento. Tali informazioni possono essere troate sul sito Web di supporto per WebSphere Business Integration, al seguente indirizzo integration/wspartnergateway/support. Selezionare l area d interesse relatia al componente ed esaminare le sezioni relatie a Technote e Flash. Noità nel rilascio WebSphere Partner Gateway supporta le seguenti nuoe funzioni: Nei rilasci precedenti, il supporto di autenticazione di base era disponibile solo per i messaggi del serizio web. Questa funzione è ora estesa a tutti i protocolli. Il consiglio per l autenticazione di base è l utilizzo della connessione HTTP sicura, cioè, HTTPS inece di HTTP. Oltre la firma e la codifica, iene fornito il supporto per la compressione e la decompressione per i messaggi RNIF. Il supporto iene fornito per la conalida del corpo e la busta SOAP. Inoltre, è possibile sbustare una busta SOAP. Il timeout massimo sincrono e le connessioni massime sincrone possono essere controllate in modo locale per ogni destinatario HTTP. Il serer FTP iene integrato con WebSphere Partner Gateway per supportare il protocollo AS3, il gateway di script FTP, il destinatario di script FTP, il destinatario e il gateway FTP / FTPS. xii IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition: Guida alla configurazione dell hub

15 Il documento dell errore può essere iniato al partner iniziale, al partner destinatario o a entrambi. Il flusso del documento dell errore può essere configurato nella console di WebSphere Partner Gateway e può essere iniato nel formato WebSphere Partner Gateway o nel formato serizi Web. Le prestazioni del programma di archiiazione sono state migliorate. Il supporto iene fornito per più partner interni. È possibile iniare nuoamente documenti in entrata e in uscita in modo simultaneo. Viene fornito il supporto per la modalità FIPS. Il prodotto può essere configurato per essere eseguito in modalità FIPS o predefinita. La funzione Delete e Whereused iene fornita per la destinazione, le mappe di conalida, le definizioni documento, le interazioni e gli utenti. Viene fornito supporto per la compressione del file di dimensione eleata per i documenti AS2 e AS3. Viene fornito il supporto per la codifica e la firma. Le dipendenze del tipo di configurazione per la migrazione includono anche i codici eento e le notifiche alert. Inoltre, la funzionalità di migrazione del partner è stata migliorata per fornire il supporto per le definizioni di importazione / esportazione di eenti notificabili. Viene fornito supporto per caricare più certificati. La nuoa procedura guidata iene inclusa nella console per caricare e configurare certificati. Il prodotto ora supporta AIX 6.1, RHEL 5 (32 e 64 bit), SLES 10 (64 bit) e Windows Serer 2003 a 64 bit. Noità nel rilascio 6.1 WebSphere Partner Gateway V6.1 supporta le seguenti nuoe funzioni: dei nuoi protocolli commerciali: AS3, SOAP con allegati, CIDX e supporto ebms (ebxml Message Serice) 2.0 il supporto migliorato per i documenti XML personalizzati include una migliore organizzazione, un supporto completo delle espressioni XPath, dei campi di ricerca, degli attributi definiti dall utente ed il supporto sincrono un nuoo supporto IP6 e Script FTP migliorato per supportare AS3 la riorganizzazione degli attributi Definizione documento dei nuoi attributi Definizione documento per l utilizzo con le uscite utente. un non rifiuto configurabile in base al liello di tipo di documento e di partner commerciale. il isualizzatore documenti ha degli ulteriori campi di ricerca definiti dall utente. un supporto di Visualizzatore AS migliorato basato sullo stato di ritorno MDN La procedura guidata di configurazione EDI e la procedura guidata di importazione EIF (precedentemente distribuite nel pacchetto di supporto GA02) Una nuoa modalità di notifica di aiso per iniare notifiche a tutte le parti correlate (partner origine e destinazione o a tutti i contatti sottoscritti, con una conseguente riduzione della configurazione degli aisi) le autorizzazioni di reinio e gateway sono ora disponibili per gli utenti diersi dall amministratore hubadmin un nuoo gruppo utenti per consentire a più utenti di poter essere amministratori hub un supporto LDAP per l autenticazione di accesso Informazioni sul presente manuale xiii

16 l utilizzo delle funzioni di registrazione nei log e di traccia di WebSphere Application Serer per i componenti WebSphere Partner Gateway i dati di configurazione dei file di proprietà sono ora memorizzati e gestiti centralmente dalla console di WebSphere Partner Gateway WebSphere MQ non è più un prodotto prerequisito; per le comunicazioni interne iene ora utilizzato il supporto WebSphere Platform Messaging archiio selettio basato sul tipo di documento e/o partner migrazione della configurazione di WebSphere Partner Gateway esportando ed importando definizioni da una istanza di WebSphere Partner Gateway ad un altra istanza una opzione di installazione di macchina singola semplificata (modalità semplice) WebSphere Application Serer Network Deployment iene ora utilizzato per distribuzioni su più macchine, abilitando il clustering e la gestione centrale dell infrastruttura supporto per l utilizzo di WebSphere Process Serer, ersione 6.1 come un sistema di integrazione di backend Note: 1. La API di gestione basata su XML è considerata obsoleta nella ersione WebSphere Partner Gateway ersione 6.0, e le ersioni successie, non supportano l algoritmo RC5. xi IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition: Guida alla configurazione dell hub

17 Capitolo 1. Introduzione alla configurazione dell hub Una olta installato WebSphere Partner Gateway e prima di poter scambiare i documenti tra il partner interno ed i partner esterni, è necessario configurare il serer di WebSphere Partner Gateway (l hub). In questo capitolo engono riportate le seguenti sezioni: Panoramica della configurazione dell hub Informazioni necessarie per l impostazione dell hub a pagina 2 Panoramica sull elaborazione del documento a pagina 8 Configurazione dei componenti di elaborazione del documento con i gestori a pagina 10 Panoramica della configurazione dell hub a pagina 16 Panoramica della configurazione dell hub L obiettio è consentire al partner interno di iniare un documento o una serie di documenti (in maniera elettronica) ad un partner esterno o riceere un documento o una serie di documenti da un partner esterno. L hub gestisce la ricezione dei documenti, la trasformazione in altri formati (se necessaria) e la consegna degli stessi. L hub può, inoltre, essere configurato per fornire la protezione per i documenti in entrata e in uscita. I documenti trasferiti tra l hub ed un partner sono, di solito, in un formato standard e rappresentano una determinata interazione commerciale. Ad esempio, un partner potrebbe iniare una richiesta di ordine di acquisto come RosettaNet 3A4 PIP, un documento cxml OrderRequest o uno scambio EDI-X12 con una transazione 850. L hub trasforma il documento in un formato che può essere utilizzato da un applicazione sul partner interno. Allo stesso modo, un applicazione di back-end del partner interno potrebbe iniare una risposta dell ordine di acquisto nel proprio formato personalizzato che iene trasformato in un formato standard. Quindi il documento trasformato iene iniato al partner. Applicazione backend partner interno Serer WebSphere Partner Gateway Partner esterno Partner interno Figura 1. Flusso dei documenti nell hub In questa guida, iene descritto il modo in cui configurare l hub e quindi il modo in cui impostare i partner. È inoltre possibile imparare a configurare la protezione per l hub. Copyright IBM Corp. 2004,

18 Notare nella Figura 1 a pagina 1 che il serer WebSphere Partner Gateway e l applicazione di back-end del partner interno sono tutti di proprietà del partner interno. Il partner interno è l azienda che possiede l hub. Come descritto nei successii capitoli, si definisce un profilo per il partner interno come per i partner esterni. Nota: questo documento mostra come creare le connessioni trasferite dall applicazione di back-end del partner interno ad una destinazione del partner e da un partner esterno alla destinazione del partner interno. Dopo l arrio dei documenti alla destinazione del partner interno, si desidererà forse integrarli con un applicazione di back-end, come ad esempio WebSphere InterChange Serer o WebSphere MQ Broker. Le attiità richieste per l integrazione tra WebSphere Partner Gateway e tali applicazioni di back-end sono definite nel manuale WebSphere Partner Gateway Enterprise Integration Guide. Informazioni necessarie per l impostazione dell hub Per impostare l hub, è necessario disporre di alcune informazioni sui tipi di scambi in cui parteciperà il partner interno. Ad esempio, sono necessarie le seguenti informazioni: Quali tipi di documenti (ad esempio, EDI-X12 o XML personalizzato) il partner interno ed i partner esterni inieranno mediante l hub? Quali tipi di trasporti (ad esempio, HTTP o FTP) il partner interno ed i partner esterni utilizzeranno per iniare i documenti? Sarebbe opportuno diidere un documento che arria sull hub in più documenti o che singoli documenti engano raggruppati prima di essere iniati? I documenti engono trasformati prima di essere recapitati? I documenti engono conalidati prima di essere recapitati? Un documento sarà controllato per erificare se è un duplicato prima di essere recapitato? I documenti engono codificati o digitalmente firmati o utilizzano altre tecniche di protezione? Quando queste informazioni engono stabilite, si è pronti per iniziare la configurazione dell hub. Una olta definito l hub, è possibile definire i partner esterni, mediante le informazioni (come, ad esempio, l indirizzo IP e i numeri DUNS) fornite dai partner esterni. Come descritto in precedenza, si definisce anche il partner interno come un tipo speciale di partner dell hub. Panoramica dei trasporti I documenti possono essere iniati dai partner a WebSphere Partner Gateway (l hub) mediante una arietà di trasporti. Un partner può iniare i documenti mediante reti pubbliche utilizzando HTTP, HTTPS, JMS, FTP, FTPS, Script FTP, SMTP o una directory file. Un partner può iniare i documenti mediante una rete VAN (Value Added Network), una rete priata, utilizzando il Trasporto script FTP. È inoltre possibile creare un trasporto personalizzato. Nota: quando il trasporto directory file iene utilizzato tra un partner e l hub, l amministratore dee erificare tutte le problematiche relatie alla protezione. 2 IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition: Guida alla configurazione dell hub

19 Allo stesso modo, l hub inia documenti ad applicazioni back-end tramite una arietà di trasporti. I trasporti più comunemente utilizzati tra l hub e le applicazioni back-end sono HTTP, HTTPS, JMS e directory di file. La Figura 2 mostra i trasporti HTTP, HTTPS, JMS e directory file. FTP FTP/S JMS File-directory HTTP HTTPS INTERNET o altra rete pubblica SMTP File-directory HTTP HTTPS Hub Scripting FTP Partner JMS VAN (rete priata) Scripting FTP Applicazione backend partner interno Serer WebSphere Partner Gateway Partner Figura 2. Trasporti più comuni supportati da WebSphere Partner Gateway Il tipo di trasporto utilizzato per iniare e riceere i documenti influenza l impostazione dei destinatari e delle destinazioni. Un destinatario è un punto di entrata nell hub, il punto in cui i documenti iniati dai partner o dalle applicazioni di back-end sono riceuti sull hub. Una destinazione è un punto di entrata nel computer del partner o nel sistema di back-end, il punto in cui l hub inia i documenti. Per prepararsi all utilizzo dei trasporti FTP, FTPS, Script FTP, JMS e directory di file, eseguire la configurazione, come descritto in Capitolo 3, Preparazione alla configurazione dell hub, a pagina 29. Panoramica delle definizioni del documento Durante l impostazione dello scambio di documenti tra i partner esterni ed il partner interno, si specificano ari elementi del documento: Il tipo di impacchettamento del documento Il protocollo commerciale che definisce una classe di documenti che condiide alcune caratteristiche comuni Il tipo di documento che identifica uno dei documenti forniti dal protocollo commerciale L impacchettamento del documento, il protocollo del documento ed il tipo di documento che costituisce la definizione del documento. Utilizzare la definizione del documento fornita dal prodotto di: Pacchetto: AS Protocollo: EDI-X12 Tipo documento: ISA Si erifica quando iene riceuto un documento che è conforme a questa definizione di instradamento. Una olta che l hub ricee il documento, la fase di spacchettamento del flusso di laoro in entrata fisso determina che dal documento iene utilizzato l impacchettamento AS. Si erifica a causa della presenza delle intestazioni del trasporto, specificate per l impacchettamento AS. Gli altri tipi di Capitolo 1. Introduzione alla configurazione dell hub 3

20 impacchettamento sono rileati dall hub in un modo simile, di solito, esaminando le intestazioni del trasporto fornite con il documento. Quando non esistono corrispondenze con alcun tipo di impacchettamento, al documento iene assegnato il tipo di impacchettamento Nessuno. Nel caso dell impacchettamento AS, gli identificatii commerciali from e to sono ottenuti dalle intestazioni di trasporto del messaggio. Nelle intestazioni di trasporto AS sono riportate anche le altre intestazioni che è possibile specificare se il messaggio sia codificato, compresso o firmato. Una olta identificato l impacchettamento, la fase di analisi del protocollo del flusso di laoro in entrata fisso determina il protocollo ed il tipo di documento. Tale condizione si erifica esaminando il contenuto del messaggio corrente e ricercando le caratteristiche nel documento che identificano il protocollo ed il tipo di documento. La fase del flusso di laoro per l analisi del protocollo estrae anche altre informazioni proenienti dal documento a seconda del protocollo in uso. Una olta definito il documento per utilizzare un particolare pacchetto, protocollo e tipo di documento, l hub può proseguire con l elaborazione del documento. Quindi, erranno rileati gli ID commerciali from e to oltre al pacchetto, protocollo e al tipo documento. Una olta fornite tali informazioni, l hub può ricercare una connessione tra i partner from e to che dispone del pacchetto in entrata, protocollo e del tipo documento. Una olta rileata la connessione, l hub rilea come instradare ed il documento poiché può rileare le seguenti informazioni aggiuntie: Certificati per i partner from e to (se richiesto) Impostazioni di attributo per l instradamento from e to L azione da eseguire durante l instradamento del documento La mappa di conersione alida (se presente) La mappa di conalida alida (se presente) Impacchettamento L impacchettamento fornisce informazioni che riguardano la trasmissione del documento. Come descritto nella sezione precedente, se l impacchettamento è AS, l hub utilizza le informazioni contenute nell intestazione AS per stabilire l origine e le destinazione per il documento. Se un partner sta iniando un PIP RosettaNet al partner interno, il PIP iene impacchettato come RNIF. La Figura 3 a pagina 5 mostra i tipi di impacchettamento che è possibile impostare per i documenti trasferiti tra l hub e un partner esterno e tra l hub ed un applicazione di back-end. 4 IBM WebSphere Partner Gateway Enterprise Edition e Adanced Edition: Guida alla configurazione dell hub

21 RNIF AS INTERNET o altra rete pubblica Integrazione backend Nessuno Hub Nessuno Partner VAN (rete priata) Applicazione backend partner interno Serer WebSphere Partner Gateway Nessuno Partner Figura 3. Tipi di impacchettamento del documento I pacchetti sono associati a protocolli specifici. Ad esempio, un partner dee specificare l impacchettamento RNIF durante l inio di un documento RosettaNet all hub. Integrazione backend: Come descritto in Figura 3, l integrazione backend è disponibile solo tra l hub e l applicazione di back-end. Quando si specifica l impacchettamento integrazione backend, i documenti iniati dall hub al sistema back-end hanno informazioni speciali sull intestazione aggiunte. Similmente, quando un applicazione inia documenti con l impacchettamento integrazione backend all hub, è necessario aggiungere informazioni sull intestazione. Il pacchetto di integrazione di backend e i requisiti per le informazioni di intestazione sono descritti nel manuale WebSphere Partner Gateway Enterprise Integration Guide. AS: Il pacchetto AS è quello più comunemente utilizzato tra i partner e l hub. Il pacchetto AS può essere utilizzato per i documenti che aderiscono agli standard AS1, AS2 e AS3. AS1 è uno standard utilizzato per una trasmissione protetta di documenti su SMTP e AS2 è uno standard utilizzato per la trasmissione protetta di documenti su HTTP o HTTPS. AS3 è un nuoo standard utilizzato per la trasmissione protetta di documenti su FTP o FTPS. I documenti iniati da un partner con l impacchettamento AS hanno le informazioni sull intestazione AS1, AS2 o AS3. I documenti iniati ad un partner che preede le intestazioni AS1, AS2 o AS3 deono essere impacchettati (sull hub) come AS. Nessuno: Il pacchetto Nessuno consente di iniare e riceere i documenti tra l hub ed i partner e tra l hub ed un applicazione di back-end. Non iene aggiunta (o non è preista) alcuna informazione sull intestazione quando un documento iene impacchettato come Nessuno. RNIF: Il pacchetto RNIF iene fornito sul supporto di installazione. Si carica il pacchetto RNIF (insieme ai PIP che si desidera scambiare), come descritto in Documenti RosettaNet a pagina 93. Il pacchetto RNIF consente di iniare i documenti RosettaNet dal partner all hub o dall hub al partner. ebms: Il meccanismo ebms (ebxml Message Serice) fornisce un metodo standard per trasferire i messaggi commerciali tra i partner commerciali ebxml. Fornisce un supporto affidabile per scambiare i messaggi commerciali senza dipendere dalle soluzioni e dalle tecnologie esclusie. Un messaggio ebxml Capitolo 1. Introduzione alla configurazione dell hub 5