Share via


Come esportare associazioni per una soluzione EDI-AS2

In questo argomento viene descritto come esportare la configurazione da un computer impostato come soluzione EDI e/o AS2. Questa operazione consente di impostare la stessa configurazione su un altro computer in modo automatico. È possibile esportare i binding da un'applicazione, un gruppo o un assembly.

Si crea un file di associazione dall'interno della console di amministrazione di BizTalk Server. Il file di associazione .xml contiene tutte le informazioni pertinenti alla configurazione BizTalk Server. Sono incluse tutte le proprietà di configurazione EDI e AS2, ad eccezione di alcune informazioni di sicurezza. Per informazioni dettagliate sui nodi in un file di associazione (inclusi i nodi EDI e AS2), vedere Struttura di un file di associazione. Per informazioni generali sulle associazioni EDI/AS2, vedere "Nodi EDI e AS2 nel file di associazione BizTalk Server" di seguito.

È inoltre possibile esportare i binding durante l'esportazione di un'applicazione mediante un file con estensione msi. Per altre informazioni, vedere Come esportare un'applicazione BizTalk. In alternativa, è possibile utilizzare il comando BTSTask per esportare e importare i binding. Per altre informazioni su BTSTask, vedere BTSTask Command-Line Reference (Informazioni di riferimento su BTSTask).

Esportazione di binding

Quando si esporta la configurazione, BizTalk Server esporta automaticamente le proprietà EDI e altre informazioni sulle parti associate. Se si attiva l'esportazione di informazioni sulle parti globali, BizTalk Server esporta anche le proprietà per le parti che non sono associate a un'orchestrazione e le proprietà EDI globali. È possibile esportare informazioni sull'entità globale in tre modi:

  • Selezionando la proprietà Esporta informazioni sull'entità globale nella finestra di dialogo Esporta binding.

  • Selezionando la casella di controllo Entità globali nel riquadro Seleziona risorse dell'Esportazione guidata file MSI.

  • Utilizzando l'opzione GlobalParties nello strumento da riga di comando BTSTask, come illustrato di seguito:

    BTSTask ExportBindings -Destination:value ((([-ApplicationName:value] | [-AssemblyName:value]) [-GlobalParties]) | [-GroupLevel])  
    

    Per ragioni di sicurezza, quando si esporta un file di associazione, le password per i binding vengono rimosse dal file. BizTalk Server rimuove i campi UNB6.1 e UNB6.2 dalle proprietà EDIFACT e dai campi ISA1, ISA2, ISA3 e ISA4 dalle proprietà X12.

    Oltre a utilizzare i comandi export-bindings, export-application o BTSTask, è possibile creare un file di associazione XML manualmente. In questo modo, è possibile esportare impostazioni EDI e delle entità da un'applicazione line-of-business. È quindi possibile importare i binding mediante il comando import-bindings o il comando BTSTask.

Prerequisiti

È necessario accedere con un account membro del gruppo Amministratori BizTalk Server. Per altre informazioni, vedere "Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk" nella documentazione di BizTalk Server.

Esportazione della configurazione in un file di associazione

  1. Nel computer da cui si vuole esportare la configurazione aprire la console di amministrazione di BizTalk Server.

  2. Fare clic con il pulsante destro del mouse sull'applicazione BizTalk da cui si vuole copiare la configurazione, scegliere Esportae quindi fare clic su Associazioni.

    Nota

    È inoltre possibile utilizzare l'utilità BTSTask per esportare o importare la configurazione.

  3. Selezionare l'opzione di esportazione, ovvero specificare se esportare dall'applicazione o dal gruppo corrente oppure esportare i binding per un assembly.

  4. Se si desidera esportare tutte le parti e le relative proprietà non sensibili, anche se un'orchestrazione non è associata ad esse, fare clic su Esporta informazioni sulle entità globali.

    Nota

    Se non si fa clic su Esporta informazioni sulle entità globali, BizTalk Server esporta le proprietà per tutte le parti associate a un'orchestrazione nel file di associazione. Tuttavia, non esporta alcuna parte che non è associata a un'orchestrazione, a meno che non si fa clic su Esporta informazioni di entità globali.

    Nota

    Il file di associazione generato mentre è selezionata la proprietà Export Global Party information (Esporta informazioni sulle entità globali) includerà la configurazione di tutte le parti definite nel computer. Non è possibile esportare la configurazione di un subset del set completo delle entità definite in un computer.

  5. Fare clic su OK per esportare le associazioni.

    Nota

    BizTalk Server non esportare campi sensibili EDI, ad esempio password o informazioni di sicurezza/autenticazione. Al posto di tali campi verrà esportata una stringa vuota. Dopo l'importazione dei binding in un altro computer, è necessario impostare manualmente i valori relativi ai campi riservati EDI.

  6. Annotare manualmente tutti i campi EDI riservati, quali le password o le informazioni di sicurezza o di autenticazione, per poterli impostare successivamente nel computer in cui verranno importati i binding.

Nodi EDI e AS2 nel file di associazione di BizTalk Server

Se si esporta la configurazione con la proprietà Export Global Party information selezionata, BizTalk Server genererà un file di associazione con i nodi seguenti:

EdiData  
   PartyEDIProperties  
      PartnerAgreement  
         Contacts  
      PartnerEdifact  
         PartnerEdifactReceiverGroups  
         PartnerEdifactSenderGroups  
      PartnerAckValidation  
      PartnerX12  
      PartnerX12ReceiverGroups  
      PartnerX12SenderGroups  
      PartnerBatchUpdatable  
      PartnerAS2CommonUpdatable  
      PartnerAS2  

Le proprietà globali EDI verranno aggiunte al file di associazione nei nodi seguenti.

EDIGlobalProperties  
   EDIGlobalProperties  
      GlobalCommon  
      GlobalEdiFact  
      GlobalX12  

I nodi EDI e AS2 vengono aggiunti alla fine del file di associazione BizTalk Server. Il nodo EdiData viene aggiunto al sottonodo Party sotto il nodo Party Collection, mentre il nodo EdiGlobalProperties viene aggiunto dopo, ma allo stesso livello del nodo Party Collection. Per altre informazioni sui nodi EDI e AS2 nel file di associazione BizTalk, vedere Struttura di un file di associazione.

Il nodo EdiData è facoltativo. Tuttavia, se il nodo EdiData è presente, i sottonodi di EdiData sono obbligatori. In modo analogo, il nodo EdiGlobalProperties è facoltativo, tuttavia, se il nodo EdiGlobalProperties è presente, i relativi sottonodi sono obbligatori.

I nodi dei file di associazione EDI e AS2 non corrispondono direttamente alle pagine delle proprietà di Partner Agreement Manager nella console di amministrazione di BizTalk Server. Alcuni nodi del file di associazione EDI e AS2 includono proprietà utilizzate per ruoli e proprietà di mittenti utilizzate per ruoli di ricevitore. Il ruolo è indicato dalla proprietà IsSender del nodo. Per i nodi che non vengono utilizzati per entrambi i ruoli di mittente e ricevitore (PartnerAgreement, PartnerBatchUpdatable, PartnerAS2Updatable e GlobalCommon), IsSender è sempre False.

I nodi PartnerEdifact e PartnerX12 contengono proprietà sia per il ruolo di ricevitore che per quello di mittente, indipendentemente dal fatto che IsSender sia impostata su True o False. Ad esempio, PartnerEdifact include un campo Una1, utilizzato per l'entità come ricevitore dell'interscambio, anche se IsSender è True. PartnerEdifact include inoltre un campo Unb5CheckDup, utilizzato per l'entità come mittente dell'interscambio, anche se IsSender è False. Se tuttavia IsSender è True, i campi per l'entità come ricevitore dell'interscambio non vengono utilizzati nell'interfaccia utente o dal motore e vengono impostati con i valori predefiniti. In modo analogo, se IsSender è False, i campi per l'entità come mittente dell'interscambio non vengono utilizzati nell'interfaccia utente o dal motore e vengono impostati con i valori predefiniti.

Se il valore predefinito di una proprietà è null, il campo non verrà incluso nel file di associazione, a meno che a tale campo non sia stato assegnato un valore.

I dati dei file di associazione vengono salvati nelle tabelle del database di gestione di BizTalk (BizTalkMgmtDb).