Importazione di documenti XML personalizzati

I documenti XML personalizzati possono essere trasformati nell'applicazione mediante l'uso di elenchi codici. Per consentire l'implementazione di un'elaborazione di documenti XML personalizzati, questi elenchi codici sono disponibili nell'area Dati principali dell'applicazione:

• CustomMessageTypes
• CustomMessageFormats
• CustomMessageIDs

Prerequisiti

Queste sono le fasi preliminari alla configurazione di questa funzionalità:

• Creare un foglio di stile personalizzato con un documento XML associato.
• Determinare i valori desiderati per il partner commerciale, se non si tratta di un partner commerciale standard.

Impostazione

Questi sono i fabbisogni di configurazione dell'area Dati principali:

• Creare un codice per l'elenco codici CustomTradingPartner utilizzato nel processo.
• Creare un codice per l'elenco codici CustomMessageTypes utilizzato nel processo. Questo valore viene utilizzato nelle caselle a discesa per la selezione dei tipi di messaggi standard. Nella tabella Proprietà elenco codici, creare un codice con l'identificatore corrispondente al tipo di documento definito nel documento XML personalizzato.
• Creare un codice per l'elenco codici CustomMessageFormats utilizzato nel processo. Questo codice viene utilizzato per determinare il tipo di documento XML.
  Nota

  Il processo scorre tutti i formati di messaggio personalizzati per trovare un tipo di documento. Utilizza il primo formato di messaggio personalizzato in cui viene trovato un valore nell'elemento specificato.

  • Nella finestra di dialogo Gestione proprietà codici, è necessario impostare un valore univoco nel campo Identificatore.
  • Impostare il campo Elemento del tipo di messaggio nella scheda Valori 1 sull'elemento del documento XML personalizzato che determina il tipo di documento XML. Nel processo viene utilizzata solo la prima istanza di questo elemento. Gli elementi XML sono supportati, ma non gli attributi.
• Creare un codice per l'elenco codici CustomMessageIDs utilizzato nel processo. Questo codice viene utilizzato per determinare il mittente e il destinatario del documento XML.
  • Specificare un identificatore che corrisponda al codice CustomMessageTypes creato.
  • Nella scheda Valori 1 è necessario specificare almeno l'ID mittente - Posizione 1 e l'ID destinatario - Posizione 1. Questi valori sono elementi XML. Il processo inizia dalla posizione della prima istanza della Posizione 1. Se viene specificata la Posizione 2, il processo passa alla Posizione 2. Se viene specificata la Posizione 3, il processo passa alla Posizione 3. Se viene specificata una posizione, questa deve esistere nel documento XML personalizzato. Il caso contrario, il processo non viene completato.
    Nota

    Non è necessario che la prima posizione sia l'elemento del documento.

• Creare un codice per l'elenco codici CustomStyleSheetRules utilizzato nel processo. Questo codice viene usato per determinare il foglio di stile usato per trasformare il documento XML personalizzato.
  • Nella finestra di dialogo Gestione proprietà codici, specificare un identificatore che viene utilizzato durante l'elaborazione e mostrato nelle ricerche e negli elenchi a discesa. Solitamente questo valore è il nome del file del foglio di stile senza estensione.
  • Nella scheda Valori 1, specificare i valori dei campi:
    • Nel campo Nome file foglio di stile, specificare il nome del file utilizzato per la trasformazione. Il nome del file deve includere l'estensione del file.
    • Nel campo FFD di origine, specificare *nessuno.
    • Nel campo FFD di destinazione, specificare *nessuno.
    • Nel campo Standard messaggio, selezionare XML.

Configurazione di Trasformazione

Qui di seguito sono elencati i passaggi per configurare l'ID partner:

1. Selezionare Trasformazione > Configurazione > ID partner.
2. Fare clic su Crea.
3. Nella pagina ID partner, selezionare il tipo di messaggio personalizzato dall'elenco a discesa Tipo di messaggio.
4. Selezionare il partner commerciale dall'elenco a discesa Partner commerciale.
5. Nella sezione ID mittente/destinatario, specificare un ID mittente e un ID destinatario nei rispettivi campi.
6. Nella sezione Mappatura partner interni/esterni, specificare i valori nei campi di mappatura.

Qui di seguito sono elencati i passaggi per configurare la regola di trasformazione:

1. Selezionare Trasformazione > Configurazione > Regole di trasformazione.
2. Fare clic su Crea per creare la regola di trasformazione.
3. Nella pagina Regole di trasformazione, selezionare il partner commerciale personalizzato, il tipo di messaggio personalizzato e la regola del foglio di stile personalizzato dai campi corrispondenti.

Qui di seguito sono elencati i passaggi per configurare il foglio di stile personalizzato:

1. Selezionare Trasformazione > Configurazione > Fogli di stile.
2. Fare clic su Crea per creare il record del foglio di stile personalizzato.
3. Nella pagina Fogli di stile, utilizzare il partner commerciale personalizzato e il nome del foglio di stile, compresa l'estensione del file, che sono stati creati per la regola del foglio di stile personalizzato.

Elaborazione di documenti XML personalizzati

Qui di seguito sono elencati i passaggi per impostare l'elaborazione di documenti XML personalizzati:

1. Selezionare Trasformazione > Importazione messaggi per importare il documento XML. Oppure, se la Configurazione client on-premises è stata implementata nell'area Comunicazioni, importare il documento XML tramite Exchange Services.
   Nota

   ION Connector non è attualmente supportato.

2. Selezionare Trasformazione > Gestione messaggi.
3. Nella pagina Gestione messaggi, controllare i risultati. Correggere i valori necessari per l'elaborazione.