Import tekstów

Krótkie teksty mogą być przechowywane w wielu miejscach w systemie, w tym w aplikacjach obszarów Podstawowe, Zakup, Logistyka magazynowa, Produkcja i Sprzedaż. Teksty są wykorzystywane przede wszystkim w dokumentach w celu uzupełnienia dokumentów o dodatkowe informacje i teksty, które nie pochodzą z rzeczywistych danych dokumentu, takich jak warunki zamówienia, dane partnera i dane poszczególnych pozycji dokumentu. Teksty mogą być również wykorzystywane do dodatkowej dokumentacji lub wyjaśnień, np. poprzez wprowadzenie dowolnego tekstu dla partnera lub artykułu. Teksty mogą być wprowadzane jako elementy tekstowe lub jako pojedyncze teksty. Alternatywnie, pliki mogą być załączane i wysyłane pocztą elektroniczną.

Wymiana danych między systemami jest opisana w artykułach Import danych i Eksport danych. W tym artykule znajdują się przykłady importu tekstów i linków do załączników. Teksty i linki do załączników plików są zawsze importowane z odpowiednią jednostką biznesową. Na przykład teksty dla artykułu sprzedaży są importowane za pośrednictwem jednostki biznesowej Artykuł sprzedaży.

Definicje terminów

  • Typ załącznika — oprócz tekstów do dokumentu użytkownik może dołączać również pliki. Typ załącznika określa, w jaki sposób tekst może zostać przypisany do dokumentu.
  • Elementy tekstowe — wielokrotnego użytku teksty oraz ich fragmenty mogą być zapisane jako elementy tekstowe. Elementy tekstowe są tworzone jednokrotnie i mogą być później wielokrotnie wykorzystywane. Przypisuje się je np. do dokumentów lub danych podstawowych, a zawarte w nich teksty są następnie wyprowadzane do dokumentów.
  • Teksty — teksty mogą być rejestrowane jako teksty indywidualne lub jako elementy tekstowe w dokumentach lub niektórych danych podstawowych, np. partnerach i artykułach. Zarejestrowane teksty służą przede wszystkim do uzupełniania dokumentów o informacje, które nie wynikają już z samych danych dokumentu, jak Warunki zamówieniaDane partnera czy Dane artykułu. Dodatkowo teksty mogą także pełnić funkcję dokumentacyjną lub objaśniającą, np. w postaci swobodnego tekstu opisującego artykuł.
  • Typ tekstu — każdemu tekstowi przypisuje się Typ tekstuTyp tekstu określa, gdzie i w jaki sposób tekst może być wykorzystany oraz w którym miejscu dokumentu pojawią się zarejestrowane lub przypisane teksty.
    Typy tekstów dzielą się na:
    • Tekst nagłówka,
    • Tekst stopki oraz
    • Tekst pozycji.

Obsługiwane atrybuty

Poniższa tabela zawiera listę obsługiwanych atrybutów do importowania tekstów i załączników do plików, które mogą być przechowywane dla kilku typów dokumentów.

Teksty (TextAssignments)
Atrybut Relacja Znaczenie
sequence Numer 
document Dokument 
type Typ tekstu 
code Element tekstowy
text Tekst w różnych językach (używany tylko, gdy nie wskazano Elementu tekstowego)
Typ tekstu (type)
Atrybut Relacja Znaczenie
HEADER Tekst nagłówka
FOOTER Tekst stopki
DETAIL Tekst pozycji
ITEM Tekst pozycji wg artykułu
ITEM_ATTACHMENT Załącznik pliku wg artykułu
EMAIL_ATTACHMENT Załącznik pliku e-mail
Treść tekstu (text)
Atrybut Relacja Znaczenie
language Język
text Treść tekstu
contentType Typ zawartości (np. text/plain)

Przykład importowania tekstów i załączników do plików dla kilku typów dokumentów

Poniższy przykład importuje tekst podstawowy i tekst elementu:

  • Tekst nagłówka (HEADER) odwołuje się do modułu tekstowego TXT1.
  • Tekst stopki (FOOTER) zawiera wolny tekst dla języków de i en.
  • Tekst artykułu (ITEM) nie zawiera żadnego tekstu.
  • Plik załącznika do artykułu (ITEM_ATTACHMENT) nie zawiera żadnego tekstu.
  • Załącznik pliku do wiadomości e-mail (EMAIL_ATTACHMENT) zawiera łącze do pliku w Knowledge Store.
  • Tekst elementu (DETAIL) zawiera dowolny tekst.

Można także użyć różnych opcji formatowania tekstu. Jeśli potrzebujesz przykładów określonego formatowania, najlepiej jest utworzyć przykładowy dokument z żądanym formatowaniem tekstu i wyeksportować go.

Uwaga
Podczas importowania tekstów zwykle obowiązuje zasada „Jeśli teksty istnieją w pliku importu, wszelkie wartości domyślne z danych podstawowych itp. są ignorowane”. Jeśli właściwość serwera com.cisag.app.general.order.bi.applyAllwaysTextDefaults ma wartość true, wartości domyślne są zawsze określane i łączone z wszelkimi istniejącymi tekstami w pliku importu. Należy zwrócić uwagę, że numery wierszy tekstu muszą być odpowiednio wybrane, a wynikiem jest tylko jeden wiersz tekstu z tekstem artykułu.

Przykład

<?xml version="1.0" encoding="UTF-8"?>
<semiramis xmlns="com.cisag.app.sales.obj.SalesOrder" xsi:schemaLocation="com.cisag.app.sales.obj.SalesOrder SalesOrder.xsd" created="2005-12-28T07:36:29.729Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SalesOrder xmlns="com.cisag.app.sales.obj.SalesOrder">
    <invoicingPartyData>
      <Partner>00000</Partner>
    </invoicingPartyData>
    <Type>100</Type>
    <customerData>
      <CustomerPartner>10020</CustomerPartner>
    </customerData>
    <TextAssignments>
      <code>TXT1</code>
      <sequence>10</sequence>
      <document index="0">ORDER_CONFIRMATION</document>
      <document index="1">PICKING_SLIP</document>
      <document index="2">DELIVERY_SLIP</document>
      <document index="3">CUSTOMER_INVOICE</document>
      <document index="4">PROFORMA_INVOICE</document>
      <document index="5">SHIPPING_LOAD</document>
      <document index="6">PRODUCTION_ORDER</document>
      <type>HEADER</type>
    </TextAssignments>
    <TextAssignments>
      <code></code>
      <sequence>20</sequence>
      <document index="0">ORDER_CONFIRMATION</document>
      <document index="1">PICKING_SLIP</document>
      <document index="2">DELIVERY_SLIP</document>
      <document index="3">CUSTOMER_INVOICE</document>
      <document index="4">PROFORMA_INVOICE</document>
      <document index="5">SHIPPING_LOAD</document>
      <document index="6">PRODUCTION_ORDER</document>
      <type>FOOTER</type>
      <text>
        <language>de</language>
        <text>Dies ist ein Beispieltext.</text>
        <contentType>text/plain</contentType>
      </text>
      <text>
        <language>en</language>
        <text>This is an example text.</text>
        <contentType>text/plain</contentType>
      </text>
    </TextAssignments>
    <TextAssignments>
      <code></code>
      <sequence>30</sequence>
      <document index="0">ORDER_CONFIRMATION</document>
      <document index="1">PICKING_SLIP</document>
      <document index="2">DELIVERY_SLIP</document>
      <document index="3">CUSTOMER_INVOICE</document>
      <document index="4">PROFORMA_INVOICE</document>
      <document index="5">SHIPPING_LOAD</document>
      <document index="6">PRODUCTION_ORDER</document>
      <type>ITEM</type>
    </TextAssignments>
    <TextAssignments>
      <code></code>
      <sequence>40</sequence>
      <document index="0">ORDER_CONFIRMATION</document>
      <document index="1">PICKING_SLIP</document>
      <document index="2">DELIVERY_SLIP</document>
      <document index="3">CUSTOMER_INVOICE</document>
      <document index="4">PROFORMA_INVOICE</document>
      <document index="5">SHIPPING_LOAD</document>
      <document index="6">PRODUCTION_ORDER</document>
      <type>ITEM_ATTACHMENT</type>
    </TextAssignments>
    <TextAssignments>
      <code></code>
      <sequence>40</sequence>
      <document index="0">ORDER_CONFIRMATION</document>
      <document index="1">PICKING_SLIP</document>
      <document index="2">DELIVERY_SLIP</document>
      <document index="3">CUSTOMER_INVOICE</document>
      <document index="4">PROFORMA_INVOICE</document>
      <document index="5">SHIPPING_LOAD</document>
      <document index="6">PRODUCTION_ORDER</document>
      <type>EMAIL_ATTACHMENT</type>
      <text>
        <language>de</language>
        <text>kstore://comarch/Documents/Werbeflyer.pdf</text>
        <contentType>text/plain</contentType>
      </text>
    </TextAssignments>
   <Details> 
    <number>10</number> 
     <TextAssignments>
       <code></code>
       <sequence>10</sequence>
       <document index="0">ORDER_CONFIRMATION</document>
       <document index="1">PICKING_SLIP</document>
       <document index="2">DELIVERY_SLIP</document>
       <document index="3">CUSTOMER_INVOICE</document>
       <document index="4">PROFORMA_INVOICE</document>
       <document index="5">SHIPPING_LOAD</document>
       <document index="6">PRODUCTION_ORDER</document>
       <type>DETAIL</type>
        <text>
         <language>de</language>
         <text>Dies ist ein Positionstext.</text>
         <contentType>text/plain</contentType>
        </text>
     </TextAssignments>
   </Details>
  </SalesOrder>
</semiramis>

Czy ten artykuł był pomocny?