Importowanie niestandardowych dokumentów XML

Niestandardowe dokumenty XML mogą być przekształcane w aplikacji poprzez wykorzystanie list kodów. Aby umożliwić wdrożenie niestandardowego przetwarzania dokumentów XML, te listy kodowe są dostępne w obszarze Dane główne aplikacji:

  • CustomMessageTypes
  • CustomMessageFormats
  • CustomMessageIDs

Wymagania wstępne

Oto kroki wstępne, które należy wykonać przed skonfigurowaniem tej funkcjonalności:

  • Utworzenie niestandardowego arkusza stylów z powiązanym dokumentem XML.
  • Określenie pożądanych wartości dla partnera handlowego, jeśli nie jest to standardowy partner handlowy.

Konfiguracja

Oto wymagania dotyczące ustawień w obszarze Dane główne:

  • Utwórz kod dla listy kodów CustomTradingPartner, który jest używany w procesie.
  • Utwórz kod dla listy kodów CustomMessageTypes, który jest używany w procesie. Wartość ta jest wykorzystywana w przypadku pól rozwijanych do wyboru standardowych typów komunikatów. W tabeli Właściwości listy kodów utwórz kod z identyfikatorem odpowiadającym typowi dokumentu zdefiniowanemu w niestandardowym dokumencie XML.
  • Utwórz kod dla listy kodów CustomMessageFormats, który jest używany w procesie. Kod ten służy do określenia typu dokumentu XML.
    Uwaga

    Proces przegląda wszystkie niestandardowe formaty komunikatów, aby znaleźć typ dokumentu. Używa pierwszego niestandardowego formatu komunikatu, w którym znajdzie wartość w określonym elemencie.

    • W oknie dialogowym Zarządzanie właściwościami kodów należy ustawić unikalną wartość w polu Identyfikator.
    • Ustaw pole Element typu komunikatu na karcie Wartości 1 na element w niestandardowym dokumencie XML, który określa typ dokumentu XML. W procesie wykorzystywane jest tylko pierwsze wystąpienie tego elementu. Obsługiwane są elementy XML; nie są natomiast obsługiwane atrybuty.
  • Utwórz kod dla listy kodów CustomMessageIDs, który jest używany w procesie. Kod ten służy do określenia nadawcy i odbiorcy dokumentu XML.
    • Określ Identyfikator, który pasuje do utworzonego kodu CustomMessageTypes.
    • Na karcie Wartości 1 należy podać przynajmniej Identyfikator nadawcy - Pozycja 1 i Identyfikator odbiorcy - Pozycja 1. Wartości te są elementami XML. Proces rozpoczyna w miejscu pierwszego wystąpienia Pozycji 1. Jeśli określona jest pozycja 2, przechodzi do Pozycji 2. Jeśli określona jest pozycja 3, przechodzi do Pozycji 3. Gdy określona jest pozycja, musi ona istnieć w dokumencie, w przeciwnym razie przetwarzanie nie może się powieść.
      Uwaga

      Nie jest wymagane, aby pierwsza pozycja była elementem dokumentu.

  • Utwórz kod dla listy kodów CustomStyleSheetRules, który jest używany w procesie. Ten kod służy do określenia arkusza stylów służącego do przekształcenia niestandardowego dokumentu XML.
    • W oknie dialogowym Zarządzanie właściwościami kodów określ identyfikator, który jest używany podczas przetwarzania oraz wyświetlany w wyszukiwaniach i listach rozwijanych. Ta wartość jest zazwyczaj nazwą pliku arkusza stylów bez rozszerzenia pliku.
    • Na karcie Wartości 1 określ następujące wartości pól:
      • Określ nazwę pliku w polu Nazwa pliku arkusza stylów, która jest używana dla transformacji. Nazwa pliku musi zawierać rozszerzenie pliku.
      • W polu Opis pliku formatu źródłowego należy podać *brak.
      • W polu Opis pliku formatu docelowego należy podać *brak.
      • W polu Standard komunikatu wybierz opcję XML.

Konfiguracja transformacji

Oto kroki związane z ustawianiem identyfikatora partnera:

  1. Wybierz z menu Transformacja > Konfiguracja > Identyfikatory partnera.
  2. Kliknij Utwórz.
  3. Na stronie Identyfikator partnera wybierz niestandardowy typ komunikatu z listy rozwijanej Typ komunikatu.
  4. Wybierz partnera handlowego z listy rozwijanej Partner handlowy.
  5. W sekcji Identyfikatory nadawcy/odbiorcy podaj identyfikatory nadawcy i odbiorcy w odpowiednich polach.
  6. W sekcji Mapowanie partnera wewnętrznego/zewnętrznego określ wartości w polach mapowania.

Oto kroki związane z konfiguracją reguły transformacji:

  1. Wybierz z menu Transformacja > Konfiguracja > Reguły transformacji.
  2. Kliknij przycisk Utwórz, aby utworzyć regułę transformacji.
  3. Na stronie Reguły transformacji wybierz niestandardowego partnera handlowego, niestandardowy typ wiadomości i niestandardową regułę arkusza stylów z odpowiednich pól.

Oto kroki konfiguracji niestandardowego arkusza stylów:

  1. Wybierz Transformacja > Konfiguracja > Arkusze stylów.
  2. Kliknij przycisk Utwórz, aby utworzyć rekord niestandardowego arkusza stylów.
  3. Na stronie Arkusze stylów użyj nazwy niestandardowego partnera handlowego i nazwy arkusza stylów wraz z rozszerzeniem pliku, które zostały utworzone dla niestandardowej reguły arkusza stylów.

Przetwarzanie niestandardowych dokumentów XML

Oto etapy przetwarzania niestandardowych dokumentów XML:

  1. Wybierz z menu Transformacja > Importuj komunikaty, aby zaimportować dokument XML. Lub, jeśli Konfiguracja klienta lokalnego została wdrożona w obszarze Komunikacja, zaimportuj dokument XML poprzez Exchange Services.
    Uwaga

    Obecnie usługa ION Connector nie jest obsługiwana.

  2. Wybierz z menu Transformacja > Zarządzanie komunikatami.
  3. Na stronie Zarządzaj komunikatami sprawdź wyniki. Popraw wszystkie wartości wymagane do przetwarzania.