Z-STIME5

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Eine Liste mit Zeiträumen ausgeben, in denen alle oder die meisten der angegebenen Teilnehmer und/oder Büros zur Verfügung stehen.

Dieses Subprogramm entspricht Z-STIME mit folgenden Ausnahmen: es werden Zeitscheiben benutzt, die aus 5 Minuten bestehen (nicht volle Viertelstunden) und der Work-Parameter hat ein anderes Format.

Dieses Subprogramm kann zum Beispiel in folgenden Situationen benutzt werden:

  • Situation: die Basisinformationen für eine Besprechung und die Teilnehmer wurden noch nicht eingegeben.
    Führen Sie dieses Subprogramm mit dem Parameter Teilnehmer-ISN vor dem Aufruf folgender Subprogramme aus: Z-ADD06 (Basisinformationen einer Besprechung eingeben) und Z-ADDATT (Teilnehmer und Arbeitsmittel für eine Besprechung eingeben). Den Parameter Kalender-ISN zu verwenden macht erst dann Sinn, wenn Basisinformationen und Teilnehmer bereits gespeichert sind (siehe unten).

  • Situation: die Basisinformationen für eine Besprechung und die Teilnehmer wurden bereits eingegeben, die Einladungen wurden jedoch noch nicht versendet (die Besprechung ist "in Arbeit"). Sie wollen entweder die Büros der bereits eingegebenen Teilnehmer oder die Büros neu eingegebener Teilnehmer nach freier Zeit durchsuchen.
    Um die Büros der bereits eingegebenen Teilnehmer nach freier Zeit zu durchsuchen, geben Sie nur den Parameter Kalendar-ISN an, ohne den Parameter Teilnehmer-ISN. Die ersten 50 Teilnehmer werden auf freie Zeit überprüft. Die ISNs aller überprüften Teilnehmer werden ausgegeben.

    Um die Büros der neu eingegebenen Teilnehmer nach freier Zeit zu durchsuchen, geben Sie nur den Parameter Teilnehmer-ISN an, ohne den Parameter Kalender-ISN.

  • Situation: Die Einladungen für eine Besprechung (Version n) wurden bereits versendet. Sie wollen die Basisinformationen der Besprechung ändern oder neue Teilnehmer eingeben (die Versionsnummer der Besprechung wird um 1 erhöht).
    Um die Büros der bereits eingegebenen Teilnehmer nach dem Ändern der Basisinformationen nach freier Zeit zu durchsuchen, geben Sie nur den Parameter Kalendar-ISN an, ohne den Parameter Teilnehmer-ISN. Die Büros der ersten 50 bereits eingeladenen Teilnehmer werden nach freier Zeit durchsucht. Der Zeitraum, der von der vorherigen Version belegt ist, wird als freie Zeit angesehen. Die ISNs der geprüften Teilnehmer werden ausgegeben.

    Um die Büros der neu eingegebenen Teilnehmer nach freier Zeit zu durchsuchen, geben Sie nur den Parameter Teilnehmer-ISN an, ohne den Parameter Kalender-ISN.

Mit den Parametern Suche-nach-Stunden und Suche-nach-Minuten können bis zu 24 Stunden angegeben werden.

Bei der Suche wird immer mit Zeitscheiben gearbeitet, die aus 5 Minuten bestehen. Beispiel: wenn Sie den Zeitraum von 1:14 bis 2:37 angeben, wird dies automatisch geändert in 1:15 bis 2:35.

Die Werte, die mit den Parametern Suche-nach-Stunden und Suche-nach-Minuten angegeben werden, werden ebenfalls auf volle 5 Minuten geändert. Beispiel: wenn Sie 38 Minuten angeben, wird dies geändert in 40 Minuten.

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

Der Zeitraum zwischen Startdatum und Enddatum muss entweder kleiner oder gleich 90 Tagen sein.

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

Alle Zeit-Parameter werden als GMT (0) interpretiert. Wenn der vorgeschlagene Zeitraum in das Zeitformat des Benutzers geändert wird, ist es möglich, dass ein ununterbrochener Zeitraum in zwei Tage aufgeteilt wird.

Mit dem Parameter Anzahl-der-Teilnehmer kann das Array der Teilnehmer-ISNs eingeschränkt werden.

Jede Teilnehmer-ISN wird geprüft und im Parameter Ausgabestatus ausgegeben.

Die gefundene freie Zeit wird im Freie-Zeit-Array ausgegeben. Dies können bis zu 20 Zeiträume sein. Der Parameter Gefundene-Teilnehmer gibt die Anzahl der Teilnehmer an, bei denen freie Zeit gefunden wurde. Wenn bei einigen der Teilnehmer keine freie Zeit gefunden wurde, werden im Freie-Zeit-Array die 20 besten Vorschläge ausgegeben (in diesem Fall sind keine iterativen Aufrufe mehr erforderlich).

Dieses Subprogramm kann solange iterativ aufgerufen werden, bis der Return-Code 77 ausgegeben wird.

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro, in dem die Besprechung eingegeben oder geändert werden soll.
Passwort A8 E   Das Passwort des o.g. Büros.
Kalender-ISN P10 E/O   Erforderlich, wenn die Teilnehmer-ISN nicht angegeben wird. Die ISN der Besprechung, bei der der Zeitraum geändert werden soll. Wenn dieTeilnehmer-ISN nicht angegeben wird, werden die ersten 50 Teilnehmer auf freie Zeit überprüft. Der Zeitraum, der von der vorhergehenden Besprechungsversion belegt wird, wird als freie Zeit angesehen.
Startdatum A8 E   Das Startdatum für die Besprechung. Format yyyymmdd.
Startzeit A4 O   Die Startzeit für die Besprechung. Format hhmm.
Enddatum A8 O   Das Enddatum für die Besprechung. Format yyyymmdd.
Endzeit A4 O   Die Endzeit für die Besprechung. Format hhmm.
Taegliche-Eintraege A1 O   Wenn markiert, belegt 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).
Suche-nach-Stunden N2 E   Suche nach freier Zeit: die Anzahl der Stunden.
Suche-nach-Minuten N2 E   Suche nach freier Zeit: die Anzahl der Minuten.
Anzahl-Teilnehmer I1 E   Die Anzahl der Teilnehmer deren Kalender nach freier Zeit gesucht werden soll. Vorgabe und Maximum: 50.
Teilnehmer-ISN P10/1:50 E/O X Erforderlich, wenn die Kalender-ISN nicht angegeben wird. Die ISN jedes Teilnehmerbüros, das nach freier Zeit durchsucht werden soll. Für einen Teilnehmer (Objektnummer 1) nehmen Sie die ISN, die vorher mit einem der Z-GET01-Subprogramme ermittelt wurde. Für ein Büro (Objektnummer 5) nehmen Sie die ISN, die vorher mit Z-DIS05 ermittelt wurde. Ausgabe: wenn die Kalender-ISN ohne die Teilnehmer-ISN angegeben wird, werden die ISNs aller geprüften Teilnehmer ausgegeben.
Ausgabestatus I1/1:50   X Ausgabestatus über die freie Zeit für die ausgegebene Teilnehmer-ISN. 00=Adresse akzeptiert, 01= Adresse zurückgewiesen, 04=Teilnehmer-ISN nicht gefunden, 33=Teilnehmer nicht eindeutig.
Freie-Zeit-Array (20)
  Gefundenes-Startdatum A8   X Startdatum der gefundenen freien Zeit.
  Gefundene-Startzeit A4   X Startzeit der gefundenen freien Zeit.
  Gefundene-Endzeit A4   X Endzeit der gefundenen freien Zeit.
  Gefundene-Teilnehmer I1   X Die Anzahl der Teilnehmer, bei denen freie Zeit gefunden wurde.
Work-Parameter B1/1:1214     Für den internen Gebrauch. Siehe Der Work-Parameter.

Return-Codes

00 Erfolg
02 Ungültiger Büroname
03 Falsches Passwort
04 ISN wurde nicht gefunden
18 API-Kontext-Buffer ist nicht verfügbar
24 Datenschutz-Sicherheitsübertretung
33 Teilnehmer ist nicht eindeutig
39 Zeitraum ist zu klein für Suche
40 Zeitraum ist negativ oder größer als 90 Tage
41 Ungültiges Startdatum
42 Ungültige Startzeit
43 Ungültiges Enddatum
44 Ungültige Endzeit
49 Ungültiger Wert für Suche-nach-Stunden/Suche-nach-Minuten
50 Wert für Suche-nach-Stunden/Suche-nach-Minuten ist größer als der angegebene Zeitraum
77 Ende der Liste
96 Keine freie Zeit gefunden

Subprogramme

Z-061625
Z-061635
Z-120
Z-122
Z-123
Z-165
Z-175
Z-120&0

Beispiel

DEFINE DATA
LOCAL
*
1 RETURN-CODE             (N2)
1 BUERO                   (A8)
1 PASSWORT                (A8)
1 KALENDER-ISN            (P10)
1 STARTDATUM              (A8)
1 STARTZEIT               (A4)
1 ENDDATUM                (A8)
1 ENDZEIT                 (A4)
1 TAEGLICHE-EINTRAEGE     (A1)
1 SUCHE-NACH-STUNDEN      (N2)
1 SUCHE-NACH-MINUTEN      (N2)
1 ANZAHL-TEILNEHMER       (I1)
1 TEILNEHMER-ISN          (P10/1:50)
1 AUSGABESTATUS           (I1/1:50)
1 FREIE-ZEIT-ARRAY        (20) 
  2 GEFUNDENES-STARTDATUM (A8)
  2 GEFUNDENE-STARTZEIT   (A4)
  2 GEFUNDENE-ENDZEIT     (A4)
  2 GEFUNDENE-TEILNEHMER  (I1)
1 WORK-PARAMETER          (B1/1:1214)
END-DEFINE
*
MOVE 'Buero'    TO BUERO
MOVE 'Passwort' TO PASSWORT
* MOVE 117412   TO KALENDER-ISN /* vorherige Version nicht beruecksichtigen!
MOVE '20010505' TO STARTDATUM 
MOVE '1900'     TO STARTZEIT 
MOVE '20010508' TO ENDDATUM
MOVE '2100'     TO ENDZEIT
MOVE 'X'        TO TAEGLICHE-EINTRAEGE
MOVE 2          TO SUCHE-NACH-STUNDEN
MOVE 00         TO SUCHE-NACH-MINUTEN
MOVE 2          TO ANZAHL-TEILNEHMER
MOVE 29300      TO TEILNEHMER-ISN (1)
MOVE 2191       TO TEILNEHMER-ISN (2)
*
CALLNAT 'Z-STIME5'
  RETURN-CODE
  BUERO
  PASSWORT
  KALENDER-ISN
  STARTDATUM
  STARTZEIT
  ENDDATUM
  ENDZEIT
  TAEGLICHE-EINTRAEGE
  SUCHE-NACH-STUNDEN
  SUCHE-NACH-MINUTEN
  ANZAHL-TEILNEHMER
  TEILNEHMER-ISN (*)
  AUSGABESTATUS (*)
  FREIE-ZEIT-ARRAY (*)
  WORK-PARAMETER (*)
*
WRITE
  '=' BUERO /
  '=' PASSWORT /
  '=' KALENDER-ISN /
  '=' STARTDATUM
  '=' STARTZEIT /
  '=' ENDDATUM
  '=' ENDZEIT /
  '=' TAEGLICHE-EINTRAEGE /
  '=' AUSGABESTATUS(1:3) /
  'Gefundene Zeitraeume: Datum       Von       Bis   Teilnehmer' /
  '               '   GEFUNDENES-STARTDATUM(1) ' '   GEFUNDENE-STARTZEIT(1)
  ' '                 GEFUNDENE-ENDZEIT (1)    ' '   GEFUNDENE-TEILNEHMER (1) /
  '               '   GEFUNDENES-STARTDATUM(2) ' '   GEFUNDENE-STARTZEIT(2)
  ' '                 GEFUNDENE-ENDZEIT (2)    ' '   GEFUNDENE-TEILNEHMER (2) /
  '               '   GEFUNDENES-STARTDATUM(3) ' '   GEFUNDENE-STARTZEIT(3)
  ' '                 GEFUNDENE-ENDZEIT (3)    ' '   GEFUNDENE-TEILNEHMER (3) /
  '               '   GEFUNDENES-STARTDATUM(4) ' '   GEFUNDENE-STARTZEIT(4)
  ' '                 GEFUNDENE-ENDZEIT (4)    ' '   GEFUNDENE-TEILNEHMER (4) /
  '               '   GEFUNDENES-STARTDATUM(5) ' '   GEFUNDENE-STARTZEIT(5)
  ' '                 GEFUNDENE-ENDZEIT (5)    ' '   GEFUNDENE-TEILNEHMER (5) /
*
IF RETURN-CODE NE 0
  WRITE / 'Return-Code' RETURN-CODE
ELSE
  WRITE / 'Return-Status OK'
END-IF
*
END