create CONTROL(a,b,c,d,e,f,g,h)

Gruppe

EDI Functions


Erzeugt eine CONTRL-Nachricht (eine Antwortnachricht auf eine EDIFACT-Übertragung) und ruft das Profil mit Namen a auf, das die Verarbeitung (normalerweise den Versand) der erzeugten Nachricht übernimmt. Die Art des Profilstarts kann über b festgelegt werden. sync lässt das aufrufende Profil auf das Ende des Nachfolgeprofils warten, async lässt das aktuelle Profile parallel zum aufgerufenen weiterarbeiten.


Der Message Identifier der CONTRL-Nachricht wird in c, die Sender-ID der originalen Nachricht in d und die Empfänger-ID der originalen Nachricht in e festgelegt. f ist der Message Identifier, auf den sich die erzeugte CONTRL-Nachricht bezieht, g bezeichnet den Action Identifier für das globale UCI-Segment (bezogen auf die komplette EDIFACT-Übertragung). Dies erfolgt über einen Action Code mit optionalen Syntax Codes. Action Code 7 heißt akzeptiert, Code 4 heißt abgelehnt. Wenn abgelehnt, dann kann zu dem Action Code noch ein Syntax Code und ein Segment-Identifier angegeben werden. Beispiel: "UNH fehlt": 4+13+UNH (4 = abgelehnt, 13 = missing, UNH = Segment Identifier). Ein Action Code 8 bedeutet, dass nur der Empfang der EDIFACT-Nachricht bestätigt, jedoch noch keine Aussage über den Inhalt getroffen wird. Dies kann/muss in einer gesonderten CONTRL-Nachricht geschehen.

Zusätzliche Segmente (z.B. UCM) werden in h als Text übergeben. Die einzelnen Elemente müssen bereits durch Hochkommata getrennt als Text vorliegen.

Fehlercodes in UC*-Segmenten


Folgende Fehlercodes können in Segmenten wie UCM verwendet werden.


Code

Fehlermeldung

Bedeutung

2

Syntax version or level not supported.

Notification that the syntax version and/or level is not supported by the recipient.

7

Interchange recipient not actual recipient.

Notification that the Interchange recipient (S003) is different from the actual recipient.

12

Invalid value.

Notification that the value of a simple data element, composite data element or component data element does not conform to the relevant specifications for the value.

13

Missing.

Notification that a mandatory (or otherwise required) service or user segment, data element, composite data element or component data element is missing

14

Value not supported in this position.

Notification that the recipient does not support use of the specific value of an identified simple data element, composite data element or component data element in the position where it is used. The value may be valid according to the relevant specifications and may be supported if it is used in another position.

15

Not supported in this position.

Notification that the recipient does not support use of the segment type, simple data element type, composite data element type or component data element type in the specific in the identified position.

16

Too many constituents.

Notification that the identified segment contained to many data elements or that the identified composite data element contained too many component data elements.

17

No agreement.

No agreement exists that allows receipt of an interchange, functional group or message with the value of the identified simple data element, composite data element or component data element.

18

Unspecified error.

Notification that an error has been identified, but the nature of the error is not reported.

19

Invalid decimal notation.

Notification that the character indicated as decimal notation in UNA is invalid, or the decimal notation used in a data element is not consistent with the one indicated in UNA.

20

Character invalid as service character.

Notification that a character advised in UNA is invalid as service character.

21

Invalid character(s).

Notification that one or more character(s) used in the interchange is not a valid character as defined by the syntax level indicated in UNB. The invalid character is part of the referenced level or followed immediately after the identified part of the interchange.

22

Invalid service character(s).

Notification that the service character(s) used in the interchange is not a valid service character as advised in UNA or not one of the service characters in the syntax level indicated in UNB or defined in an interchange agreement. If the code is used in UCS or UCD, the invalid character followed immediately after the identified part of the interchange.

23

Unknown Interchange sender.

Notification that the Interchange sender (S002) is unknown.

24

Too old.

Notification that the received interchange or functional group is older than a limit specified in an IA or determined by the recipient.

25

Test indicator not supported.

Notification that a test processing could not be performed for the identified interchange, functional group or message.

26

Duplicate detected.

Notification that a possible duplication of a previously received interchange, functional group or message has been detected. The earlier transmission may have been rejected.

27

Security function not supported.

Notification that a security function related to the referenced level or data element is not supported.

28

References do not match.

Notification that the control reference in UNB/UNG/UNH does not match the one in UNZ/UNE/UNT.

29

Control count does not match number of instances received.

Notification that the number of functional groups/messages/segments does not match the number given in UNZ/UNE/UNT.

30

Functional groups and messages mixed.

Notification that individual messages and functional groups have been mixed at the same level in the interchange.

31

More than one message type in group.

Notification that different message types are contained in a functional group.

32

Lower level empty.

Notification that the interchange did not contain any messages or functional groups or a functional group did not contain any messages.

33

Invalid occurrence outside message or functional group.

Notification that an invalid segment or data element occurred in the interchange, between messages or between functional groups. Rejection is reported at the level above.

34

Nesting indicator not allowed.

Notification that explicit nesting has been used in a message where it shall not be used.

35

Too many segment repetitions.

Notification that a segment was repeated too many times.

36

Too many segment group repetitions.

Notification that a segment group is repeated too many times.

37

Invalid type of character(s).

Notification that one or more numeric characters were used in an alphabetic (component) data element or that one or more alphabetic characters were used in a numeric (component) data element.

38

Missing digit in front of decimal sign.

Notification that a decimal sign is not preceded by one or more digits.

39

Data element too long.

Notification that the length of the data element received exceeded the maximum length specified in the data element description.

40

Data element too short.

Notification that the length of the data element received is shorter than the minimum length specified in the data element description.

41

Permanent communication network error.

Notification that a permanent error was reported by the communication network used for transfer of the interchange. Re-transmission of an identical interchange with the same parameters at network level will not succeed.

42

Temporary communication network error.

Notification that a temporary error was reported by the communication network used for transfer of the interchange. Re-transmissions of an identical interchange may succeed.

43

Unknown interchange recipient.

Notification that the interchange recipient is not known by a network provider.

Parameterbeschreibung


Parameter

Description

a

Name des Profils (mit Eingangsagent Message), an das die CONTRL-Nachricht für die weitere Verarbeitung übergeben werden soll.

b

(optional) sync bei synchronem Aufruf, async bei asynchronem Aufruf des Nachfolgeprofils. Default: sync

c

Message Identifier für das UNB-Segment.

d

ID des Senders der originalen Nachricht.

e

ID des Empfängers der originalen Nachricht.

f

Message Identifier der originalen Nachricht.

g

Action Code für das UCI-Segment. Der Action Code gibt an, ob Übertragung als gesamtes akzeptiert oder abgelehnt wird.

h

Durch Hochkomma getrennte UCM-Segmente, die den Status der einzelnen, in einer EDIFACT-Nachricht enthaltenen, Dokumente beschreiben.


Beispiele


Das Datum zum Zeitpunkt des Beispiels sei 2011-09-06 08:20:23. Die eingegangene Nachricht enthält keine Dokumente


UNA:+.? '
UNB+UNOC:3+SENDERID:14+RECEIVERID:14+110905:1109+27'
UNZ+1+27'

Parameter a

b

c

d

e

f

g

h

Ergebnis

NextProfile

sync

CONTRLID

SENDERID

RECEIVERID

27

4+13+UNH


true, wenn das Nachfolgeprofil erfolgreich durchlaufen wurde, ansonsten false.

Das nachfolgende Profil erhält mit diesem Aufruf folgende CONTRL-Nachricht.

UNB+UNOC:2+RECEIVERID+SENDERID+110906:0820+CONTRLID'
UNH+1+CONTRL:D:3:UN'
UCI+27+SENDERID+RECEIVERID+4+13+UNH'
UNT+3+1'
UNZ+1+CONTRLID'

Die eingegangene Nachricht enthält Dokumente, die zum Teil abgelehnt werden.

UNA:+.? '
UNB+UNOC:3+SENDERID:14+RECEIVERID:14+110905:1109+27'
UNH+1+IFTSTA:D:01B:UN'
...
UNT:10+1'
UNH+2+IFTSTA:D:01B:UN'
...
UNT:10+2'
UNH+3+IFTSTA:D:01B:UN'
...
UNT:10+3'
UNZ+1+27'

Parameter a

Parameter b

Parameter c

Parameter d

Parameter e

Parameter f

Parameter g

Parameter h

Ergebnis

NextProfile

async

CONTRLID

SENDERID

RECEIVERID

27

7

UCM+1+IFTSTA:D:01B:UN+4+18'

UCM+2+IFTSTA:D:01B:UN+7'

UCM+3+IFTSTA:D:01B:UN+7'

Immer true, da das Nachfolgeprofil asynchron gerufen wird.

Die Werte von Parameter h stehen zur Erhöhung der Lesbarkeit in mehreren Zeilen, die Zeilenumbrüche dürfen nicht übernommen werden. Das nachfolgende Profil erhält mit diesem Aufruf folgende CONTRL-Nachricht:

UNB+UNOC:2+RECEIVERID+SENDERID+110906:0820+CONTRLID'
UNH+1+CONTRL:D:3:UN'
UCI+27+SENDERID+RECEIVERID+7'
UCM+1+IFTSTA:D:01B:UN+4+18'
UCM+2+IFTSTA:D:01B:UN+7'
UCM+3+IFTSTA:D:01B:UN+7'
UNT+6+1'
UNZ+1+CONTRLID'