UIP-df-Dateien

Syntax und Optionen für „uip df files“, das Blob-Anhänge für Data Fabric-Datensatzdateifelder verwaltet.

uip df files Verwaltet Blob-Anhänge, die im Dateifeld eines Datensatzes gespeichert sind. Alle drei Verben verwenden dieselben drei Positionargumente – Entitäts-ID, Datensatz-ID und Feldname (Groß-/Kleinschreibung beachten). Feldnamen sind über uip df entities get auffindbar.

Zusammenfassung

uip df files upload <entity-id> <record-id> <field-name> -f <path> [--folder-key <key>]
uip df files download <entity-id> <record-id> <field-name> [--destination <path>] [--folder-key <key>]
uip df files delete <entity-id> <record-id> <field-name> -y --reason <text> [--folder-key <key>]

Jedes Verb akzeptiert auch --folder-key <key> (eine Ordner-GUID für Datensätze, die zu einer Ordner-Scope-Entität gehören).

Verben

Verb	Zweck
upload	Laden Sie eine Datei in ein Datensatzfeld hoch.
download	Laden Sie die Datei herunter, die an ein Datensatzfeld angehängt ist.
delete	Löschen Sie die Datei, die an ein Datensatzfeld angehängt ist.

UIP-DF-Dateien hochladen

Laden Sie eine Datei in ein Datensatzfeld hoch.

Argumente

Name	Erforderlich	Zweck
<entity-id>	ja	Entitäts-ID (UUID).
<record-id>	ja	Datensatz-ID (UUID).
<field-name>	ja	Name des Dateifelds (Groß-/Kleinschreibung wird beachtet).

Optionen

Short	Long	Wert	Standard	Beschreibung
-f	--file	Pfad	erforderlich	Pfad zur hochzuladenden Datei.
–	--folder-key	Schlüssel	–	Ordnerschlüssel (GUID) des Ordners, der die Entität enthält, für Entitäten mit Ordner-Scope.

Beispiele

uip df files upload a1b2c3d4-0000-0000-0000-000000000001 \
    b2c3d4e5-0000-0000-0000-000000000001 invoice \
    --file ./invoice.pdf

Datenform (--output json)

{
  "Code": "FileUploaded",
  "Data": {
    "EntityId": "a1b2c3d4-0000-0000-0000-000000000001",
    "RecordId": "b2c3d4e5-0000-0000-0000-000000000001",
    "FieldName": "invoice",
    "FileName": "invoice.pdf"
  }
}

UIP-df-Dateien herunterladen

Laden Sie die Datei herunter, die an ein Datensatzfeld angehängt ist.

Argumente

Name	Erforderlich	Zweck
<entity-id>	ja	Entitäts-ID (UUID).
<record-id>	ja	Datensatz-ID (UUID).
<field-name>	ja	Name des Dateifelds (Groß-/Kleinschreibung wird beachtet).

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--destination	Pfad	<record-id>_<field-name>.bin	Pfad der Ausgabedatei.
–	--folder-key	Schlüssel	–	Ordnerschlüssel (GUID) des Ordners, der die Entität enthält, für Entitäten mit Ordner-Scope.

Beispiele

uip df files download a1b2c3d4-0000-0000-0000-000000000001 \
    b2c3d4e5-0000-0000-0000-000000000001 invoice \
    --destination ./invoice.pdf

# Default destination
uip df files download a1b2c3d4-0000-0000-0000-000000000001 \
    b2c3d4e5-0000-0000-0000-000000000001 invoice

Datenform (--output json)

{
  "Code": "FileDownloaded",
  "Data": {
    "EntityId": "a1b2c3d4-0000-0000-0000-000000000001",
    "RecordId": "b2c3d4e5-0000-0000-0000-000000000001",
    "FieldName": "invoice",
    "OutputPath": "./invoice.pdf"
  }
}

UIP-DF-Dateien löschen

Löschen Sie die Datei, die an ein Datensatzfeld angehängt ist. Der Datensatz selbst ist nicht betroffen – nur der Blob auf dem benannten Feld wird entfernt.

Argumente

Name	Erforderlich	Zweck
<entity-id>	ja	Entitäts-ID (UUID).
<record-id>	ja	Datensatz-ID (UUID).
<field-name>	ja	Name des Dateifelds (Groß-/Kleinschreibung wird beachtet).

Optionen

Short	Long	Wert	Standard	Beschreibung
-y	--yes	Markieren	–	Erforderlich. Bestätigt, dass dies ein nicht rückgängig zu machender Vorgang ist.
–	--reason	text	–	Erforderlich. Grund für das Löschen – wird in der Antwort zurückgegeben, damit der Aufrufer ihn protokollieren kann.
–	--folder-key	Schlüssel	–	Ordnerschlüssel (GUID) des Ordners, der die Entität enthält, für Entitäten mit Ordner-Scope.

Beispiele

uip df files delete a1b2c3d4-0000-0000-0000-000000000001 \
    b2c3d4e5-0000-0000-0000-000000000001 invoice \
    --yes --reason "wrong file attached"

Datenform (--output json)

{
  "Code": "FileDeleted",
  "Data": {
    "EntityId": "a1b2c3d4-0000-0000-0000-000000000001",
    "RecordId": "b2c3d4e5-0000-0000-0000-000000000001",
    "FieldName": "invoice",
    "Reason": "wrong file attached"
  }
}

Zugehörig

• uip df entities – Feldnamen mit entities get erkennen.
• uip df records – Verwalten Sie die Datensätze, die diese Anhänge besitzen.

Siehe auch

• Übersicht über das Data Fabric-Tool
• Globale Optionen
• Exitcodes