Aggiungere contratti tra partner negli account di integrazione per i flussi di lavoro in App per la logica di Azure

Si applica a: App per la logica di Azure (consumo + standard)

Dopo aver aggiunto partner all'account di integrazione, specificare il modo in cui i partner scambiano messaggi definendo i contratti nell'account di integrazione. I contratti consentono alle organizzazioni di comunicare tra loro senza problemi definendo il protocollo standard del settore specifico per lo scambio di messaggi e fornendo i vantaggi condivisi seguenti:

  • Consentire alle organizzazioni di scambiare informazioni usando un formato noto.

  • Migliorare l'efficienza quando si eseguono transazioni business-to-business (B2B).

  • Semplificare la creazione, la gestione e l'uso dei contratti per la creazione di soluzioni di integrazione aziendale.

Un contratto richiede un partner host, che è sempre l'organizzazione e un partner guest, ovvero l'organizzazione che scambia messaggi con l'organizzazione. Il partner guest può essere un'altra società o anche un reparto all'interno della stessa organizzazione. Usando questo contratto, si specifica come gestire i messaggi in ingresso e in uscita dal punto di vista del partner host.

Questo articolo illustra come creare e gestire un contratto, che è quindi possibile usare per scambiare messaggi B2B con un altro partner usando le operazioni AS2, X12, EDIFACT o RosettaNet.

Se non si ha familiarità con le app per la logica, vedere Che cos'è App per la logica di Azure? Per altre informazioni sull'integrazione aziendale B2B, vedere Flussi di lavoro di integrazione aziendale B2B con App per la logica di Azure ed Enterprise Integration Pack.

Prerequisiti

  • Un account e una sottoscrizione di Azure. Se non si ha ancora una sottoscrizione, iscriversi per ottenere un account Azure gratuito.

  • Una risorsa dell'account di integrazione in cui si definiscono e archivia elementi, ad esempio partner commerciali, contratti, certificati e così via, per l'uso nei flussi di lavoro di integrazione aziendale e B2B. Questa risorsa deve soddisfare i requisiti seguenti:

    • È associato alla stessa sottoscrizione di Azure della risorsa dell'app per la logica.

    • Esiste nella stessa località o nella stessa area di Azure della risorsa dell'app per la logica.

    • Se si usa il tipo di risorsa App per la logica (consumo), l'account di integrazione richiede un collegamento alla risorsa dell'app per la logica prima di poter usare gli artefatti nel flusso di lavoro.

    • Se si usa il tipo di risorsa App per la logica (Standard), l'account di integrazione non necessita di un collegamento alla risorsa dell'app per la logica, ma è comunque necessario per archiviare altri elementi, ad esempio partner, contratti e certificati, insieme all'uso delle operazioni AS2, X12 ed EDIFACT. L'account di integrazione deve comunque soddisfare altri requisiti, ad esempio l'uso della stessa sottoscrizione di Azure e esistente nella stessa posizione della risorsa dell'app per la logica.

    Nota

    Attualmente solo il tipo di risorsa App per la logica (consumo) supporta le operazioni RosettaNet . Il tipo di risorsa App per la logica (Standard) non include le operazioni di RosettaNet .

  • Almeno due partner commerciali nell'account di integrazione. Un contratto richiede un partner host e un partner guest. Inoltre, un contratto richiede che entrambi i partner usino lo stesso qualificatore di identità aziendale compatibile o appropriato per un contratto AS2, X12, EDIFACT o RosettaNet.

  • Facoltativamente, la risorsa e il flusso di lavoro dell'app per la logica in cui si vuole usare il contratto per scambiare messaggi. Il flusso di lavoro richiede qualsiasi trigger che avvia il flusso di lavoro dell'app per la logica.

Se non si ha familiarità con le app per la logica, vedere Informazioni su App per la logica di Azure e Creare un flusso di lavoro di app per la logica a consumo di esempio.

Aggiungere un contratto

  1. Nella casella di ricerca portale di Azure immettere integration accountse selezionare Account di integrazione.

  2. In Account di integrazione selezionare l'account di integrazione in cui si desidera aggiungere i partner.

  3. Nel menu dell'account di integrazione, in Impostazioni selezionare Contratti.

  4. Nel riquadro Contratti selezionare Aggiungi.

  5. Nel riquadro Aggiungi specificare le informazioni seguenti sul contratto:

    Proprietà Obbligatoria valore Descrizione
    Nome <agreement-name> Nome del contratto
    Tipo di contratto AS2, X12, EDIFACT o RosettaNet Tipo di protocollo per il contratto. Quando si crea il file del contratto, il contenuto in tale file deve corrispondere al tipo di contratto.
    Host Partner (Partner host) <host-partner-name> Il partner host rappresenta l'organizzazione
    Host Identity (Identità host) <host-partner-identifier> Identificatore del partner host
    Guest Partner (Partner guest) <guest-partner-name> Il partner guest rappresenta l'organizzazione che comunica con l'organizzazione
    identità guest <guest-partner-identifier> Identificatore del partner guest
    Receive Settings (Impostazioni di ricezione) Varia Varia Queste proprietà specificano il modo in cui il partner host riceve i messaggi in ingresso dal partner guest nel contratto. Per altre informazioni, vedere il tipo di contratto corrispondente:

    - Impostazioni messaggio AS2
    - Impostazioni dei messaggi EDIFACT
    - Impostazioni messaggio X12

    Send Settings (Impostazioni di invio) Varia Varia Queste proprietà specificano il modo in cui il partner host invia messaggi in uscita al partner guest nel contratto. Per altre informazioni, vedere il tipo di contratto corrispondente:

    - Impostazioni messaggio AS2
    - Impostazioni dei messaggi EDIFACT
    - Impostazioni messaggio X12

    Riferimenti PIP di RosettaNet Varia Varia Questo riquadro specifica informazioni su uno o più processi pip (Partner Interface Processes) per l'uso dei messaggi RosettaNet. Per altre informazioni, vedere Messaggi di Exchange RosettaNet.

    Importante

    La risoluzione di un contratto dipende dalla corrispondenza degli elementi seguenti definiti nel messaggio partner e in ingresso:

    • Qualificatore e identificatore del mittente
    • Qualificatore e identificatore del ricevitore

    Se questi valori cambiano anche per il partner, assicurarsi di aggiornare anche il contratto.

  6. Al termine, fare clic su OK.

    Il contratto viene ora visualizzato nell'elenco Contratti .

Modificare un contratto

  1. Nella casella di ricerca portale di Azure immettere integration accountse selezionare Account di integrazione.

  2. In Account di integrazione selezionare l'account di integrazione in cui si desidera aggiungere i partner.

  3. Nel menu dell'account di integrazione, in Impostazioni selezionare Contratti.

  4. Nel riquadro Contratti selezionare il contratto, selezionare Modifica e apportare le modifiche.

  5. Al termine, fare clic su OK.

Eliminare un contratto

  1. Nella casella di ricerca portale di Azure immettere integration accountse selezionare Account di integrazione.

  2. In Account di integrazione selezionare l'account di integrazione in cui si desidera aggiungere i partner.

  3. Nel menu dell'account di integrazione, in Impostazioni selezionare Contratti.

  4. Nel riquadro Contratti selezionare il contratto da eliminare e quindi selezionare Elimina.

  5. Per confermare che si vuole eliminare il contratto, selezionare .

Passaggi successivi