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ówienia, Dane 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 tekstu. Typ 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.
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>