Google Drive Connector

Google Drive Connector: Stellt eine Verbindung zum Google Drive Cloud-Service her und bietet Cloud-Storage-Datenverwaltungsfunktionen.

Google Drive erlaubt es, mehrere Objekte mit dem gleichen Namen zu haben. Beim Ausführen von Operationen, die sich auf mehrfach vorhandene Objekte beziehen, wird aktuell eine Fehlermeldung ausgegeben und die Operation wird nicht ausgeführt.

Eigenschaften (Properties)

Operation

Vom Adapter ausgeführte Operation

Mögliche Werte:

CopyFile: Kopiert eine bereits vorhandene Datei innerhalb des Google-Drive-Kontos
CreateComment: Legt einen Kommentar an
CreateFolder: Legt einen neuen Ordner im Google-Drive-Konto an
DeleteFolder: Löscht einen bereits vorhandenen Ordner
DeleteFile: Löscht eine bereits vorhandene Datei
ExtractArchiveToFolder: Extrahiert Dateien innerhalb eines ZIP-Ordners in einen Ordner
GetFileContent: Ruft die Inhalte eines bereits vorhandenen Dokuments ab
GetFileMetadata: Ruft die Metadaten einer Datei ab
ListFiles: Führt alle Dateien und Ordner des Wurzelverzeichnisses auf
ListFilesInFolder: Führt alle Dateien und Ordner innerhalb eines angegebenen Ordners auf
ReadComments: Liest bereits vorhandene Kommentare aus
RevokePermission: Widerruft Berechtigung gemäß der Parameterkonfiguration
SetPermission: Legt an oder aktualisiert Berechtigungen gemäß der Parameterkonfiguration
UpdateFile: Aktualisiert den Inhalt oder den Namen einer Datei
UpdateFolderName: Aktualisiert den Namen eines bereits vorhandenen Ordners
UploadFile: Lädt eine Datei in das Google-Drive-Konto hoch

Parameters

`Adapter`	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: de.softproject.integration.adapter.google.cloud.drive.GoogleCloudDriveAdapter: Hauptklasse (Standard)
`serviceAccountFile`	Pfad der Servicekontodatei für die Authentifizierung Mögliche Werte: Zeichenkette mit dem Pfad der Servicekontodatei
`folderPath`	Ordnerpfad, in dem die extrahierte Datei abgelegt wird Ist der Pfad nicht spezifiziert, wird der Pfad des Wurzelverzeichnisses verwendet. Dieser Parameter wird für die Operationen `ListFilesInFolder`, `DeleteFile`, `GetFileContent` und `GetFileMetadata` verwendet. Mögliche Werte: Zeichenkette mit dem Ordnerpfad; Die Pfadangabe muss mit einem Schrägstrich `/` enden.
`sourcePath`	Pfad der Quelldatei Dieser Parameter wird für die Operationen `UploadFile`, `UpdateFile`, `CopyFile` und `ExtractArchiveToFolder` verwendet. Mögliche Werte: Zeichenkette mit dem Pfad zur Quelldatei
`destinationPath`	Pfad zum Zielordner oder zur Zieldatei Dieser Parameter wird für die Operationen `CopyFile`, `UploadFile`, `UpdateFile` und `ExtractArchiveToFolder` verwendet. Mögliche Werte: Zeichenkette mit dem Pfad zur Zieldatei oder zum Zielordner; Die Pfadangabe muss mit einem Schrägstrich `/` enden.
`fileName`	Dateiname – In einigen Fällen wird der Parameter zum Setzen oder Ändern des Dateinamen verwendet. Dieser Parameter wird für die Operationen `UploadFile`, `DeleteFile`, `GetFileContent`, `GetFileMetadata`, `UpdateFile` und `CopyFile` verwendet. Mögliche Werte: Zeichenkette mit dem Dateinamen
`folderName`	Ordnername Für die Operation `ExtractArchiveToFolder` wird der Parameter verwendet, um einen neuen Ordner anzulegen, in dem die Dateien aus dem ZIP-Ordner entpackt werden. Der Parameter wird zudem für die Operationen `CreateFolder`, `UpdateFolderName` und `DeleteFolder` verwendet. Mögliche Werte: Zeichenkette mit dem Ordnernamen
`comment`	Kommentar Dieser Parameter wird für create- und read-Operationen verwendet. Mögliche Werte: Zeichenkette mit dem Kommentar
`overwrite`	Angabe, ob bereits vorhandene Dateien überschrieben werden sollen Dieser Parameter wird außer für die Operation `CreteFolder` für alle create-, copy- oder update-Operationen verwendet. Für `false` wird eine a Meldung ausgegeben, wenn die Datei/der Ordner bereits vorhanden ist. Mögliche Werte: Boolescher Wert `true` oder `false`.
`scope`	Geltungsbereich der Berechtigung Dieser Parameter wird für die Operation `SetPermission` verwendet. Mögliche Werte: `DOMAIN` `GROUP` `USER` `ANYONE`
`role`	Rolle der Berechtigung Dieser Parameter wird für die Operation `SetPermission` verwendet. Mögliche Werte: `FILE_ORGANIZER` `READER` `OWNER` `WRITER` `COMMENTER`
`account`	Domain oder E-Mail-Adresse des Benutzers oder der Gruppe Dieser Parameter wird für die Operationen `SetPermission` und `RevokePermission` verwendet. Mögliche Werte: Zeichenkette mit der Domain oder E-Mail-Adresse

Statuswerte

`1`	Die Adapter-Operation wurde erfolgreich ausgeführt
`-1`	Bei der Ausführung des Adapters kam es zu einem Fehler

Input

Der Adapter wird über Parameter verwaltet. Für einige Operationen wie ExtractArchiveToFolder, UploadFile oder UpdateFile kann jedoch ein Input übergeben werden, der den hochzuladenden oder zu aktualisierenden Inhalt darstellt. Wenn bei diesen Operationen kein Input übergeben wird, wird der Parameter sourcePath verwendet.

Output

Der Adapter gibt folgende Struktur aus, wenn eine list-Operation verwendet wird:

Ausgabe für list-Operationen

XML

<?xml version="1.0" encoding="UTF-8"?>
<Files>
       <File FullName="X4-ADK.pdf" id="1_nNnJVwCyNXrFWiGDok1GNKmdZeAcXK7"/>
       <File FullName="X4-Activities.pdf" id="1soJS2I4JgG4pNxypbI9MnTKSON1iLWcI"/>
       <File FullName="X4-Release-Notes.pdf" id="1C8dh8I6r2LDsPP3avdkYNIVLCGmvf54T"/>
       <File FullName="X4-ESB.pdf" id="1lPatZJT2yxI1IdfzlYy8hINO56TOhCdC"/>
       <File FullName="X4-BPM.pdf" id="1R5_mJ4x6_qcPZhrnaP-z_zoFd6kJJmAn"/>
       <File FullName="X4-Administration-Guide.pdf" id="1di3dhqUe3bLXx8OWQqtqcBLcIeXPS4N-"/>
</Files>

Für die Operation GetFileMetadata werden folgende Informationen ausgegeben:

Ausgabe für die Operation GetFileMetadata

XML

<?xml version="1.0" encoding="UTF-8"?>
<File FullName="X4-Release-Notes-Comment.pdf" Id="18upYSTk8pkGMm8YVT46LHa9R9myYzf7I">
    <Kind>drive#file</Kind>
    <Parents>
        <Id>0AOvK1n-M5IHmUk9PVA</Id>
    </Parents>
    <Permissions>
        <Permission>
            <Id>03478937985708787222</Id>
            <Account>service-account@shaped-fx-259808.iam.gserviceaccount.com</Account>
            <Scope>user</Scope>
            <Role>owner</Role>
        </Permission>
    </Permissions>
    <Created>2020-01-07T10:45:33.338</Created>
    <Size>4376271</Size>
</File>