Z-ADD06

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Einen Termin oder die Basisdaten (Datum, Uhrzeit, Betreff, Ort oder Agenda) für eine Besprechung eingeben.

Der Zeitraum zwischen Startdatum und Enddatum muss entweder kleiner oder gleich 90 Tagen sein (sonst wird der Return-Code 43 ausgegeben).

Startzeit und Endzeit werden als GMT (0) interpretiert.

Wenn Startzeit und Endzeit nicht angegeben werden, wird automatisch der Zeitraum von 0:00 Uhr bis 23:59 Uhr eingetragen.

Wenn der Parameter Keine-Zeitbelegung angegeben ist, belegt der Termin oder die Besprechung keine Zeit im Kalender. Das bedeutet, wenn ein anderer Teilnehmer eine Besprechung eingibt und den Kalender nach freier Zeit durchsucht, gilt dieser Zeitraum nicht als reserviert.

Wenn der Parameter Taegliche-Eintraege angegeben ist, belegt der Termin oder die Besprechung an jedem Tag nur den angegebenen Zeitraum. Wenn der Parameter Taegliche-Eintraege nicht angegeben ist, wird der gesamte Zeitraum reserviert (ab der Startzeit des ersten Tages bis zur Endzeit des letzten Tages).

Wenn Sie eine Besprechung eingeben, müssen Sie auch die folgenden Subprogramme aufrufen:

  1. Z-ADDATT um Teilnehmer und Arbeitsmittel einzugeben (diese können nicht mit Z-ADD06 eingegeben werden).

  2. Z-STIME um die Suche nach freier Zeit zu starten wenn Sie den Parameter Freie-Zeitspanne-suchen markiert haben.

  3. Z-MCONFM um die Einladungen zu bestätigen (d.h. versenden).

Notizen können später mit Z-NOTE an den Termin oder die Besprechung geheftet werden.

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro, in dem der Termin oder die Besprechung eingegeben werden soll.
Passwort A8 E   Das Passwort des o.g. Büros.
Startdatum A8 E   Das Startdatum für den Termin oder die Besprechung. Format yyyymmdd.
Startzeit A4 O   Die Startzeit für den Termin oder die Besprechung. Format hhmm.
Enddatum A8 O   Das Enddatum für den Termin oder die Besprechung. Format yyyymmdd.
Endzeit A4 O   Die Endzeit für den Termin oder die Besprechung. Format hhmm.
Objektnummer N2 E   3=Termin, 16=Besprechung.
Taegliche-Eintraege A1 O   Wenn markiert, belegt der Termin oder die Besprechung an jedem Tag nur den angegebenen Zeitraum. Wenn nicht markiert, wird der gesamte Zeitraum reserviert (ab der Startzeit des ersten Tages bis zur Endzeit des letzten Tages).
Vorhandene-Eintraege-ignorieren A1 O   Wenn markiert, wird der Termin oder die Besprechung eingegeben obwohl der Zeitraum bereits durch einen anderen Kalendereintrag belegt ist.
Betreff A20 E/O   Der Betreff des Termins oder der Besprechung. Sie müssen mindestens einen der folgenden Parameter angeben: Betreff, Beschreibung oder Ort.
Beschreibung A60/1:3 E/O   Eine kurze Beschreibung für den Termin oder die Besprechung. Sie müssen mindestens einen der folgenden Parameter angeben: Beschreibung, Betreff oder Ort.
Ort A60 E/O   Der Ort, an dem der Termin oder die Besprechung stattfindet. Sie müssen mindestens einen der folgenden Parameter angeben: Ort, Betreff oder Beschreibung.
Agenda A32 O   Der Name des Dokuments, das mit dem Termin oder der Besprechung verknüpft werden soll.
Suchbegriffe A15/1:6 O   Suchbegriffe sind hilfreich, wenn Sie ein Objekt suchen. Sie können bis zu 6 Suchbegriffe eingeben. Ein Suchbegriff darf keinen Stern (*) enthalten.
Persoenlich-Flag A1 O   Nur in einem Privatbüro erlaubt. Wenn markiert, ist der Termin oder die Besprechung ein persönliches Objekt.
Berechtigungsstufen A1/1:4 O   Die Berechtigungsstufen für Lesen, Ändern, Kopieren und Drucken. Werte 0 bis 9. Sie können auch den Wert X angeben; dies gewährleistet absoluten Schutz.
Keine-Zeitbelegung A1 O   Wenn markiert, belegt der Termin oder die Besprechung keine Zeit im Kalender.
Freie-Zeitspanne-suchen A1 O   Wenn markiert, wird in den Besprechungsdatensätzen ein spezielles Flag gesetzt. Mit Z-STIME können Sie dann die Kalender aller Teilnehmer nach gemeinsamer freier Zeit durchsuchen. Diese Funktion wird nicht von Z-ADD06 ausgeführt.
Kalender-ISN P10   X Die ISN des ersten Satzes der Besprechung oder des Termins.

Return-Codes

00 Erfolg
02 Ungültiger Büroname oder - nur im Batch-Betrieb - Büro gesperrt
03 Falsches Passwort
13 Ungültige Objektnummer
18 API-Kontext-Buffer ist nicht verfügbar
24 Datenschutz-Sicherheitsübertretung
41 Ungültiges Startdatum
42 Ungültige Startzeit
43 Ungültiges Enddatum
44 Ungültige Endzeit
51 Ungültiger Name (Betreff, Beschreibung oder Ort fehlt)
53 Das gewünschte Objekt (Agenda) existiert nicht
54 Mindestens ein Suchbegriff war ungültig
57 Das Dokument (Agenda) enthält keinen Text
61 Ungültige Berechtigungsstufe(n)
93 Berechtigungsstufen dürfen nicht höher sein als die im Profil
94 Angegebener Zeitraum ist bereits belegt

Subprogramme

N-IDATCM
N-NAMMOD
Z-0106A
Z-0106AN
Z-0106B
Z-0106C
Z-0420
Z-0420A
Z-100
Z-110
Z-120
Z-122
Z-123
Z-124
Z-135
Z-160
Z-165
Z-175
Z-180
Z-185
Z-190
Z-191A
Z-194
Z-197A
Z-201
Z-207
Z-216
Z-209
Z-223
Z-711
Z-711A
Z-728
Z-731
Z-737
Z-740
Z-741
Z-742
Z-743
Z-120&0
Z-1200&0
Z-MOD06

Beispiel

DEFINE DATA
LOCAL
1 RETURN-CODE             (N2)
1 BUERO                   (A8)
1 PASSWORT                (A8)
1 STARTDATUM              (A8)
1 STARTZEIT               (A4)
1 ENDDATUM                (A8)
1 ENDZEIT                 (A4)
1 OBJEKTNUMMER            (N2)
1 TAEGLICHE-EINTRAEGE     (A1)
1 VORHANDENE-EINTRAEGE-IGNORIEREN (A1)
1 BETREFF                 (A20)
1 BESCHREIBUNG            (A60/1:3)
1 ORT                     (A60)
1 AGENDA                  (A32)
1 SUCHBEGRIFFE            (A15/1:6)
1 PERSOENLICH-FLAG        (A1)
1 BERECHTIGUNGSSTUFEN     (A1/1:4)
1 KEINE-ZEITBELEGUNG      (A1)
1 FREIE-ZEITSPANNE-SUCHEN (A1)
1 KALENDER-ISN            (P10)
*
END-DEFINE
*
MOVE 'Buero'    TO BUERO
MOVE 'Passwort' TO PASSWORT
MOVE '20011231' TO STARTDATUM
MOVE '1900'     TO STARTZEIT
MOVE '20020102' TO ENDDATUM
MOVE '2100'     TO ENDZEIT
MOVE 16         TO OBJEKTNUMMER
MOVE 'X'        TO TAEGLICHE-EINTRAEGE
MOVE 'X'        TO VORHANDENE-EINTRAEGE-IGNORIEREN
MOVE 'Neues-Jahr'       TO BETREFF
MOVE 'Erste Zeile'      TO BESCHREIBUNG(1)
MOVE 'Zweite Zeile'     TO BESCHREIBUNG(2)
MOVE 'Ort'              TO ORT
MOVE 'Dok-name1'        TO AGENDA
MOVE 'Suchbegriff-eins' TO SUCHBEGRIFFE(1)
MOVE '9'                TO BERECHTIGUNGSSTUFEN(*)
MOVE 'X'                TO FREIE-ZEITSPANNE-SUCHEN
*
CALLNAT 'Z-ADD06'
  RETURN-CODE
  BUERO
  PASSWORT
  STARTDATUM
  STARTZEIT
  ENDDATUM
  ENDZEIT
  OBJEKTNUMMER
  TAEGLICHE-EINTRAEGE
  VORHANDENE-EINTRAEGE-IGNORIEREN
  BETREFF
  BESCHREIBUNG (*)
  ORT
  AGENDA
  SUCHBEGRIFFE (*)
  PERSOENLICH-FLAG
  BERECHTIGUNGSSTUFEN (*)
  KEINE-ZEITBELEGUNG
  FREIE-ZEITSPANNE-SUCHEN
  KALENDER-ISN
*
WRITE
  '='  BUERO
  '='  PASSWORT
  '='  STARTDATUM
  '='  STARTZEIT
  '='  ENDDATUM
  '='  ENDZEIT
  '='  OBJEKTNUMMER
  '='  TAEGLICHE-EINTRAEGE
  '='  VORHANDENE-EINTRAEGE-IGNORIEREN
  '='  BETREFF
  '='  BESCHREIBUNG(1)
  '='  BESCHREIBUNG(2)
  '='  ORT
  '='  AGENDA
  '='  SUCHBEGRIFFE(1:2)
  '='  PERSOENLICH-FLAG
  '='  BERECHTIGUNGSSTUFEN(1:4)
  '='  KEINE-ZEITBELEGUNG
  '='  FREIE-ZEITSPANNE-SUCHEN
  '='  KALENDER-ISN
*
IF RETURN-CODE NE 0
  WRITE / 'Return-Code' RETURN-CODE
ELSE
  WRITE / 'Return-Status OK'
END-IF
*
END