Creazione o modifica di un accordo
In questo argomento viene descritto come creare o modificare un contratto tra partner commerciali. Un accordo tra partner commerciali configura la relazione tra due partner commerciali, incluse le loro identità; processo PIP (Partner Interface Process); l'azione, il segnale e gli URL di sincronizzazione; e i protocolli associati.
Un contratto tra partner commerciali include le impostazioni per una configurazione del processo, un'organizzazione domestica, un partner e un contratto. Tutte queste impostazioni sono necessarie per un contratto. È possibile creare una configurazione di processo basata su un PIP RosettaNet o su uno schema personalizzato, ma è necessario creare la configurazione. È anche necessario definire sia un'organizzazione principale che un'organizzazione partner. Microsoft BizTalk Accelerator per RosettaNet (BTARN) non supporta lo scambio di messaggi tra parti sconosciute.
BTARN elabora e convalida un messaggio in base a tutte queste impostazioni. Ad esempio, per un messaggio CIDX, BTARN viene convalidato in base alla versione di RosettaNet Implementation Framework (solo RNIF) (solo 1.1), al contratto 0A1 (solo 0A1) e Is Single Action alla proprietà (solo azione singola). Un messaggio CIDX verrà convalidato solo se si imposta la versione RNIF su "1.1", il contratto 0A1 su "No 0A1" e la Is Single Action proprietà su True. BTARN verifica inoltre che tutte le proprietà del contratto siano coerenti con le impostazioni del profilo di configurazione del processo. Ad esempio, verificherà di aver impostato la Standard proprietà del profilo su "CIDX" e che la proprietà del contratto 0A1 del contratto sia impostata su "No 0A1".
Se si modifica un contratto mentre è attivo un processo, è possibile che si verifichino risultati imprevedibili. Le modifiche apportate alle proprietà del contratto verranno applicate non appena si fa clic su Applica o OK per accettarle, ma non è possibile prevedere quale fase di un processo è in esecuzione. Dopo aver modificato il contratto, qualsiasi nuova attività in un processo corrente o qualsiasi nuovo processo userà le proprietà del contratto modificate. Tuttavia, un processo in esecuzione quando si modifica il contratto potrebbe aver già utilizzato le proprietà del contratto precedenti per un messaggio che sta elaborando.
Dopo aver creato un contratto, è necessario attivarlo per consentire l'invio o la ricezione dei messaggi associati al contratto. È anche possibile disattivare un contratto per impedire l'invio o la ricezione di messaggi associati al contratto. È necessario disattivare un contratto per modificarlo e riattivarlo dopo la modifica.
BTARN salva queste informazioni nella tabella TPAConfig nel database BTARNCONFIG.
Le impostazioni nel contratto tra partner commerciali sono illustrate nella tabella seguente, disposte per scheda. Le impostazioni predefinite sono i valori più usati in genere. Le procedure per la creazione e la modifica di queste impostazioni vengono visualizzate dopo la tabella.
| Scheda | Impostazione | Uso |
|---|---|---|
| Generale | Nome | Nome univoco per il contratto, ad esempio Fabrikam_To_Contoso_3A2. Campo obbligatorio. |
| Generale | Configurazione del processo | Identificatore del PIP. Questo numero identifica la configurazione del processo associata al contratto. Il valore predefinito è il primo nell'elenco delle configurazioni del processo. L'elenco a discesa include tutte le configurazioni del processo immesse in precedenza. Campo obbligatorio. |
| Generale | Organizzazione personale | L'organizzazione principale, selezionata da un elenco a discesa. Campo obbligatorio. |
| Generale | Organizzazione partner | L'organizzazione partner, selezionata da un elenco a discesa. Campo obbligatorio. |
| Generale | Descrizione | Descrizione dell'accordo tra partner commerciali. |
| Generale | Versione RNIF | Versione di RNIF che BTARN userà per le comunicazioni con contratto. Può essere V01.10.00 o V02.00.01 (impostazione predefinita). Deve essere V01.10.00 per CIDX. |
| Generale | Ruolo Home | Ruolo dell'organizzazione principale. Può essere un ruolo iniziatore o un ruolo risponditore. |
| Generale | Contratto 0A1 | Indica se BTARN restituirà una notifica del messaggio di errore (PIP 0A1) quando si verifica un errore. Può essere No 0A1 (impostazione predefinita) o 0A1. Deve essere No 0A1 per CIDX. |
| Generale | Utilizzo | Indica il tipo di scenario che verrà utilizzato dal contratto. Può essere Test (impostazione predefinita) o Production. |
| Generale (area adattatore applicazione ) |
Nome assembly | Nome file dell'ApplicationAdapter che è possibile selezionare dal file system. Il valore predefinito è una stringa vuota. |
| Generale (area adattatore applicazione) |
Nome classe | Nome della classe che BTARN userà da ApplicationAdapter. Il valore predefinito non è <nessuno>. |
| Generale (area adattatore di convalida) |
Nome assembly | Nome file dell'oggetto ValidationAdapter che è possibile selezionare dal file system. Il valore predefinito è una stringa vuota. |
| Generale (area adattatore di convalida) |
Nome classe | Nome della classe che BTARN userà da ValidationAdapter. Il valore predefinito non è <nessuno>. |
| Ports | Action URL | URL a cui l'organizzazione principale trasmetterà un messaggio di azione. Ad esempio: http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Si tratta di un campo obbligatorio se sono soddisfatte tutte le condizioni seguenti: - L'impostazione Is Synchronous process-configuration è False.- L'impostazione Is Single Action process-configuration è True.- L'impostazione Del contratto del ruolo Home è Iniziatore. Si tratta anche di un campo obbligatorio se sono vere le condizioni seguenti( in tal caso, è necessario anche il campo URL segnale): - L'impostazione Is Synchronous process-configuration è False.- L'impostazione Is Single Action process-configuration è False.- È necessario immettere un URI valido in questo campo, uno che inizia con "< http://domain>" o "".<https://domain> |
| Ports | Signal URL | URL a cui l'organizzazione principale trasmetterà un messaggio di segnale. Ad esempio: http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Si tratta di un campo obbligatorio se sono vere le condizioni seguenti: - L'impostazione Is Synchronous process-configuration è False.- L'impostazione Is Single Action process-configuration è True.- L'impostazione Del contratto del ruolo Home è Risponditore. Si tratta anche di un campo obbligatorio se il seguente è true (in tal caso, è necessario anche il campo URL azione ): - L'impostazione Is Synchronous process-configuration è False.- L'impostazione Is Single Action process-configuration è False.È necessario immettere un URI valido in questo campo, uno che inizia con "< http://domain>" o "".<https://domain> |
| Ports | Sync URL | URL che l'organizzazione principale userà per stabilire una connessione tramite la scheda HTTP. Ad esempio: http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Si tratta di un campo obbligatorio se sono vere le condizioni seguenti: - L'impostazione Is Synchronous process-configuration è True.- L'impostazione Del contratto del ruolo Home è Iniziatore. È necessario immettere un URI valido in questo campo, uno che inizia con "< http://domain>" o "".<https://domain> |
| Protocollo | Metodo Digest | Protocollo utilizzato per calcolare il digest dei messaggi in ingresso per scopi non ripudio. A partire da BizTalk Server 2016 e versioni più recenti, il supporto SHA2 viene incluso automaticamente. Le opzioni includono: MD5, SHA-1, SHA-256 (impostazione predefinita), SHA-384 e SHA-512. Per le versioni precedenti BizTalk Server, le opzioni includono MD5 o SHA-1 (impostazione predefinita). La pipeline di ricezione BTARN riceve e decrittografa un messaggio anche se il protocollo usato per crittografare il messaggio e l'impostazione Codifica in questa scheda del contratto non corrispondono. BTARN riceve quindi messaggi crittografati in RC2-40 o 3DES. Tutti i messaggi firmati in uscita hanno un digest di SHA-1. |
| Protocollo | Codificare tutte le parti | Indica se il sistema codifica tutte le parti del messaggio multiparte insieme. Può essere True o False (impostazione predefinita).Quando True, tutte le parti del messaggio multipart verranno codificate insieme usando il metodo indicato dalla Encoding proprietà .Quando False, il sistema codifica solo gli allegati usando il metodo indicato dalla Encoding proprietà . Gli allegati vengono sempre codificati dalla pipeline di trasmissione usando il metodo indicato dalla Encoding proprietà . Per impostazione predefinita, quando si imposta questa proprietà su False, BTARN codifica le altre parti del messaggio (quattro parti in RNIF 2.01, tre parti in RNIF 1.1) in formato stampabile tra virgolette. |
| Protocollo | Encoding | Protocollo usato per codificare tutte le parti (se la casella Codifica tutte le parti è True) o l'allegato (se la casella Codifica tutte le parti è False).Può essere 8 bit, base 64 (impostazione predefinita) o stampabile tra virgolette. |
| Protocollo | Algoritmo di crittografia | Algoritmo utilizzato per crittografare i messaggi in ingresso e in uscita. A partire da BizTalk Server 2016 e versioni più recenti, il supporto AES viene incluso automaticamente. Le opzioni includono RC2-40, 3DES, AES128 (impostazione predefinita), AES192 e AES256. Per le versioni BizTalk Server precedenti, le opzioni includono RC2-40 (impostazione predefinita) o 3DES. L'algoritmo di crittografia ha effetto solo se è stata impostata la Is Persistent Confidentiality Required proprietà su Payload o Payload Container nella configurazione del processo corrispondente. |
| Protocollo | Direzione della crittografia | Indica se il sistema crittograferà il messaggio in arrivo o il messaggio in uscita o entrambi. Può essere Inbound, Outbound o Inbound/Outbound (impostazione predefinita). L'impostazione della direzione di crittografia ha effetto solo se è stata impostata la Is Persistent Confidentiality Required proprietà su Payload o Payload Container nella configurazione del processo corrispondente. |
| Proprietà personalizzate | Nome | Nome della proprietà personalizzata. È possibile impostare proprietà personalizzate in base al contratto. Se si crea un nuovo processo privato personalizzato, è possibile usare queste proprietà personalizzate nell'elaborazione di contratti diversi. È possibile usare il RuntimeConfig.GetTPACustomConfigValue metodo in BTARN SDK per recuperare proprietà personalizzate dalla configurazione BTARN.La Name proprietà deve essere univoca e non vuota.È possibile immettere i valori personalizzati seguenti: - AAR. Si tratta della proprietà personalizzata Acknowledgementment Required .This is the Acceptance Acknowledgementment Required custom property. Questo vale solo per RNIF 1.1. Impostare questo valore su false (che non fa distinzione tra maiuscole e minuscole) per richiedere solo un riconoscimento della ricevuta, non un riconoscimento di accettazione. Se AAR è impostato su un valore diverso da false, il processo pubblico del risponditore deve inviare un riconoscimento di accettazione e il processo pubblico iniziatore prevede un riconoscimento di accettazione. Se AAR è impostato su false, i processi pubblici verranno completati dopo il riconoscimento della ricevuta. - HPCC. Questo è il codice di classificazione home partner. Questo vale solo per RNIF 1.1. In questo modo è possibile impostare l'elemento GlobalPartnerClassificationCode per il partner principale nell'intestazione del servizio di un messaggio in uscita sulla voce nella colonna Valore. Questo valore esegue l'override della proprietà di classificazione dell'organizzazione Home nella configurazione dell'organizzazione principale. Usare questa proprietà personalizzata quando l'organizzazione principale può avere più di una classificazione. - PPCC. Si tratta del codice di classificazione del profilo partner. Questo vale solo per RNIF 1.1. In questo modo è possibile impostare l'elemento GlobalPartnerClassificationCode per il partner nell'intestazione del servizio di un messaggio in uscita alla voce nella colonna Value. Questo valore esegue l'override della proprietà di classificazione Partner nella configurazione partner. Utilizzare questa proprietà personalizzata quando il partner può avere più di una classificazione. |
| Proprietà personalizzate | Valore | Valore della proprietà personalizzata. |
Creare un accordo tra partner commerciali
Fare clic su Start, scegliere Tutti i programmi, MicrosoftBizTalk Accelerator per RosettaNet, quindi fare clic su BizTalk Accelerator per RosettaNetManagement Console.
Nella Console di gestione BTARN espandere BizTalk Accelerator per RosettaNet.
Fare clic con il pulsante destro del mouse su Contratti, scegliere Nuovoe quindi fare clic su Contratto.
Nella finestra di dialogo Proprietà nuovo contratto immettere i valori per le impostazioni nelle schede Generale, Porte, Protocollo e Proprietà personalizzate . Per informazioni su queste impostazioni, vedere la tabella precedente.
Fare clic su OK.
Nota
BTARN non accetterà messaggi correlati al contratto fino a quando non si attiva il contratto.
Fare clic con il pulsante destro del mouse sul nome del contratto nel riquadro destro e quindi scegliere Attiva.
Nota
Se è già stato attivato un contratto, è possibile fare clic con il pulsante destro del mouse sul nome del contratto nel riquadro destro e quindi scegliere Disattiva per impedire l'invio o la ricezione di messaggi associati al contratto.
Modificare un contratto tra partner commerciali
Fare clic su Start, scegliere Tutti i programmi, MicrosoftBizTalk Accelerator per RosettaNet, quindi fare clic su BizTalk Accelerator per RosettaNetManagement Console.
Nella Console di gestione BTARN espandere BizTalk Accelerator per RosettaNet e quindi fare clic sul nodo Contratti .
Fare clic con il pulsante destro del mouse sul contratto che si desidera modificare, quindi scegliere Proprietà.
< Nella finestra di dialogo Proprietà nome> contratto, nelle schede Generale e Proprietà contatto modificare le impostazioni in base alle esigenze. Per informazioni su queste impostazioni, vedere la tabella precedente.
Fare clic su OK.
Vedere anche
Gestire configurazione, certificati, database e protezione
Amministrazione della configurazione di BTARN