Dieses Dokument behandelt die folgenden Themen:
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 | 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. | ||
| 00 | Erfolg |
| 02 | Ungültiger Büroname oder - nur im Batch-Betrieb - Büro gesperrt |
| 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 |
Z-061625
Z-061635
Z-120
Z-122
Z-123
Z-165
Z-175
Z-120&0
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