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>]

Every verb also accepts --folder-key <key> (a folder GUID, for records that belong to a folder-scoped entity).

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	–	Folder key (GUID) of the folder containing the entity, for folder-scoped entities.

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	–	Folder key (GUID) of the folder containing the entity, for folder-scoped entities.

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	–	Required. Acknowledges this is an irreversible operation.
–	--reason	text	–	Required. Reason for the deletion — echoed back in the response so the caller can log it.
–	--folder-key	Schlüssel	–	Folder key (GUID) of the folder containing the entity, for folder-scoped entities.

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