Z-ENC11

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Dokumente an ein Hauptdokument heften oder Anlagen vom Hauptdokument entfernen.

Die folgenden Funktionen stehen zur Verfügung:

Funktionscode 1 - Anlagen an das Hauptdokument heften

Sie können bis zu 10 Dokumente an das Hauptdokument heften.

Sie können die zu heftenden Dokumente entweder im Array Anlagenname oder Anlagen-ISN angeben. Die Ausprägungen des Arrays müssen lückenlos hintereinander gefüllt werden. Die erste Ausprägung des Arrays legt fest, ob die Anlagen mit dem Namen oder der ISN angegeben werden müssen; d.h. wenn Sie in der ersten Ausprägung eine ISN angeben, müssen Sie auch in allen anderen Ausprägungen ISNs angeben. In einem Array dürfen Sie Namen und ISNs nicht zusammen benutzen.

Es ist jedoch möglich, den Parameter Hauptdokument-ISN mit der ISN zu füllen und die Ausprägungen des Arrays Anlagenname mit den Namen.

Die Dokumente werden in derselben Reihenfolge geheftet, wie sie im Array definiert wurden. Wenn das Hauptdokument bereits Anlagen enthält, werden die neuen Anlagen dahinter gestellt.

Funktionscode 2 - Namen der Anlagen anzeigen

Um die Namen der Dokumente anzuzeigen, die an ein Hauptdokument geheftet sind, müssen Sie die Arrays Anlagenname und Anlagen-ISN leer lassen.

Die Namen der Anlagen werden im Array Anlagenname ausgegeben.

Funktionscode 3 - Anlagen vom Hauptdokument entfernen

Wenn Sie mit diesem Subprogramm Anlagen von einem Hauptdokument entfernen, werden die entfernten Anlagen aus Con-nect gelöscht. Sie werden nicht in den Papierkorb gestellt. Begleitschreiben und Notizen werden von diesem Subprogramm nicht berücksichtigt.

Sie müssen die Namen der zu entfernenden Anlagen im Array Anlagenname angeben.

Wenn Sie einen nicht vorhandenen Dokumentnamen angeben, bleibt der Name dieses Dokuments im Array Anlagenname stehen, nachdem alle Anlagen entfernt wurden. Dieses Array ist normalerweise leer, nachdem alle definierten Anlagen gefunden und entfernt wurden.

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro, in dem das Hauptdokument abgelegt ist.
Passwort A8 E   Das Passwort des o.g. Büros.
Hauptdokumentname A32 E*   Der Name des Hauptdokuments. Entweder Hauptdokumentname oder Hauptdokument-ISN, nicht beides.
Hauptdokument-ISN P10 E*   Die ISN des Hauptdokuments. Entweder Hauptdokument-ISN oder Hauptdokumentname, nicht beides.
Anlagenname A32/1:10 E* X Die Namen der Anlagen. Eingabe: entweder Anlagenname oder Anlagen-ISN, nicht beides.
Anlagen-ISN P10/1:10 E*   Die ISNs der Anlagen. Entweder Anlagen-ISN oder Anlagenname, nicht beides. Sie können Anlagen-ISN nur angeben, wenn Sie Anlagen heften. Sie dürfen Anlagen-ISN nicht angeben, wenn Sie Anlagen entfernen. Sie können den Anlagennamen jedoch in beiden Fällen benutzen.
Index P3   X Bei den Return-Codes 4, 9, 51 und 53 wird ein Wert ausgegeben. Die Werte 1 bis 10 verweisen sich auf die Positionen (Ausprägungen) der Anlagen im Array; der Wert 0 verweist auf das Hauptdokument.
Funktionscode N2 E   1=Anlagen heften, 2=Namen der Anlagen zeigen, 3=Anlagen entfernen.

Return-Codes

00 Erfolg
02 Ungültiger Büroname oder - nur im Batch-Betrieb - Büro gesperrt
03 Falsches Passwort
04 Dokument-ISN wurde nicht gefunden
08 Geben Sie entweder ISN oder Name ein - nicht beides
09 ISN zeigt nicht auf das richtige Dokument
51 Ungültiger Dokumentname
53 Das gewünschte Objekt existiert nicht
91 Weitere Anlagen sind nicht möglich
92 Sie haben zu viele Dokumente zum Heften angegeben
93 Dokumente können nicht an ein Dokument in einem Systemfach geheftet werden
94 Falscher Funktionscode
95 Das Hauptdokument enthält keine Anlagen
96 Um eine Anlage zu entfernen, müssen Sie den Namen angeben (nicht die ISN)
97 Die angegebenen Anlagen sind keine Anlagen des Hauptdokuments

Subprogramme

Z-120
Z-122
Z-123
Z-180
Z-185
Z-1200&0

Beispiel

0010 DEFINE DATA
0020 LOCAL
0030 1 RETURN-CODE        (N2)
0040 1 BUERO              (A8)
0050 1 PASSWORT           (A8)
0060 1 HAUPTDOKUMENTNAME  (A32)          /* Hauptdokument
0070 1 HAUPTDOKUMENT-ISN  (P10)
0080 1 ANLAGENNAME        (A32/1:10)     /* Anlagen
0090 1 ANLAGEN-ISN        (P10/1:10)
0100 1 INDEX              (P3)
0110 1 FUNKTIONSCODE      (N2)
0120 *
0130 * FUNKTIONSCODE:
0140 *    1 = Anlagen heften
0150 *    2 = Namen der Anlagen zeigen
0160 *    3 = Anlagen entfernen
0170 *
0180 END-DEFINE
0190 *
0200 RESET RETURN-CODE
0210       INDEX
0220 *
0230 MOVE  1               TO  FUNKTIONSCODE       /* Anlagen heften
0240 MOVE 'BUERO'          TO  BUERO
0250 MOVE 'PASSWORT'       TO  PASSWORT
0260 MOVE 177271           TO  HAUPTDOKUMENT-ISN   /* Hauptdokument
0270 *
0280 MOVE 'Anlage1'        TO  ANLAGENNAME(1)
0290 MOVE 'Anlage2'        TO  ANLAGENNAME(2)
0300 *
0310 CALLNAT 'Z-ENC11'  RETURN-CODE
0320    BUERO
0330    PASSWORT
0340    HAUPTDOKUMENTNAME
0350    HAUPTDOKUMENT-ISN
0360    ANLAGENNAME(*)
0370    ANLAGEN-ISN (*)
0380    INDEX
0390    FUNKTIONSCODE
0400 *
0410 IF RETURN-CODE EQ 0
0420    WRITE 'Anlagen wurden geheftet'
0430 ELSE
0440    WRITE 'Return-Code' RETURN-CODE
0450 END-IF
0460 *
0470 END