Zuletzt geändert von YellowFox_RD am 2025/01/20 15:36
Zeige letzte Bearbeiter
1 (% class="box" %)
2 (((Inhaltsverzeichnis)))
3 {{toc/}}
4
5 Erlaubt das Bearbeiten und Anlegen von Ordnern in der Dateiablage.
6 = Beschreibung =
7 **(% class="green mark" %)GET(%%)**//**  /file_storage/modify_directory.php?company**=RTI_COMPANYKEY**&import**=IMPORTKEY**&****action**=action//
8
9 = Parameter =
10 |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
11 |company|RTI Firmenschlüssel|string||ja
12 |import|RTI Importschlüssel|string||ja
13 |action|Aktionstyp|string|mögliche Werte:
14 (((
15 * NEW: neuen Ordner anlegen(((
16 * wenn Sie einen Ordner an einem Pfad anlegen der bereits einmal existierte und Inhalte enthielt aber welcher gelöscht wurde, so wird dieser inklusive all seiner Unterordner
17 )))
18
19 * RENAME: bestehenden Ordner umbenennen
20 * MOVE: Ordner verschieben
21 * DELETE: Ordner löschen, enthaltene Dateien werden dabei in den Papierkorb verschoben
22 )))|ja
23 |source_path|Pfad zum Ordner|string|Format: Ordner/Unterordner/...,betroffener Ordner (Schrägstrich-getrennt)
24 Wurzelverzeichnis muss nicht mit angegeben werden. Um die Datei dorthin zu verschieben, kann der Parameter einfach weggelassen werden.
25 Pfadangaben sind case-insensitive.
26 nicht relevant bei Aktionstyp NEW|(ja)
27 |name|Ordnername|string|Name des Ordners
28 nur bei Aktionstypen
29 (((
30 * NEW (= Name des neuen Ordners)
31 * RENAME (= neuer Name des Ordners)
32 )))|(ja)
33 |destination_path|Pfad zum Ordner||Format: Ordner/Unterordner/.../betroffener Ordner (Schrägstrich-getrennt)
34 Wurzelverzeichnis muss nicht mit angegeben werden. Um die Datei dorthin zu verschieben, kann der Parameter einfach weggelassen werden.
35 Pfadangaben sind case-insensitive.
36 nur bei Aktionstypen
37 (((
38 * NEW (=Pfad des übergeordneten Ordners)
39 * MOVE (=Pfad des neuen übergeordneten Ordners)
40 )))|(ja)
41 |recursive||string|Gibt an ob der angegebene destination_path existieren muss. Relevant für Aktionstypen
42 (((
43 * NEW
44 * MOVE
45 )))
46 Wenn auf 'true' gesetzt, werden ggf. nicht vorhandene Ordner im Pfad zunächst erstellt bevor die eigentliche Aktion ausgeführt wird. Standardmäßig false (unter dieser Einstellung wird stattdessen UNKNOWN_DESTINATION_PATH zurückgegeben wenn ein nicht existenter Pfad angesprochen wird.|nein
47
48 Systemordner können nicht gelöscht werden.
49 Das Wurzelverzeichnis kann nicht umbenannt werden.
50
51 = Rückgabe =
52 Bei Erfolg erhalten Sie "OK". Bei fehlenden Pflichtparametern oder Fehlern wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben.
53
54 == Mögliche Fehlerwerte ==
55 |=Fehler|=Beschreibung
56 |MISSING_COMPANY|Firmenschlüssel fehlt
57 |INVALID_COMPANY|Firma nicht gefunden. Dies kann an einem fehlerhaften Firmen- oder Import-Schlüssel liegen.
58 |ERROR_MAINTENANCE|Ihre Firma wird gerade gewartet, währenddessen sind keine RTI Abfragen möglich.
59 |MISSING_IMPORT|Import-Schlüssel fehlt.
60 |UNKNOWN_ACTION|Aktionstyp fehlt oder ist unbekannt.
61 |UNKNOWN_DIRECTORY|Kein Ordner mit dem angegebenen source_path gefunden.
62 |CAN_NOT_MODIFY_ROOT|Das Wurzelverzeichnis kann nicht bearbeitet werden.
63 |CAN_NOT_DELETE_SYSTEM_DIRECTORIES|Systemordner können nicht gelöscht werden.
64 |MISSING_NAME / MISSING_NEW_NAME|Es wurde kein Name angegeben (bei Aktionstyp NEW/RENAME).
65 |NAME_SHOULD_NOT_BE_EMPTY|Der Name kann kein Leerstring sein.
66 |INVALID_DIRECTORY_NAME|Ihr Ordnername enthält ungültige Zeichen. Nicht erlaubt: ~,",#,%,*,<,>,?,/,\,{,~|,}
67 |UNKNOWN_DESTINATION_PATH|Der Zielpfad ist ungültig. Dieser Fehler kommt nicht wenn recursive auf true gesetzt ist, in diesem Fall würde der unbekannte Pfad erstellt werden.
68 |DIRECTORY_DOES_ALREADY_EXIST|Sie versuchen einen neuen Ordner anzulegen, aber im angegebenen Verzeichnis existiert bereits ein Ordner mit diesem Namen.
69 |DIRECTORY_WITH_THIS_PATH_DOES_ALREADY_EXIST|Sie versuchen einen Ordner zu verschieben, aber im angegebenen Verzeichnis existiert bereits ein Ordner mit demselben Namen.
70 |MOVE_FAILED|Verschieben ist fehlgeschlagen.
71 |RENAME_FAILED|Umbenennen ist fehlgeschlagen.
72 |DELETE_FAILED|Löschen ist fehlgeschlagen.
73
74 = Beispiele =
75 **Neuen Ordner anlegen**
76 {{code language="java"}}https://map.yellowfox.de/rti/file_storage/modify_directory.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&action=NEW&destination_path=Bilder&name=Fotos{{/code}}
77
78 **Neuen Namen setzen**
79 {{code language="java"}}https://map.yellowfox.de/rti/file_storage/modify_directory.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&action=RENAME&source_path=Bilder&name=neuer name{{/code}}
80
81 **Verschieben**
82 {{code language="java"}}https://map.yellowfox.de/rti/file_storage/modify_directory.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&action=MOVE&destination_path=Bilder,Fotos&source_path=Erinnerungen{{/code}}
83