uip df 文件

“uip df files”的语法和选项，用于管理 Data Fabric 记录文件字段上的 Blob 附件。

uip df files管理存储在记录文件字段中的 Blob 附件。所有三个动词都采用相同的三个位置参数，即实体 ID、记录 ID 和字段名称（区分大小写）。字段名称可以通过uip df entities get发现。

大纲

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

每个动词还接受 --folder-key <key>（文件夹 GUID，适用于属于文件夹作用域实体的记录）。

动词

动词	用途
upload	上传文件至记录字段。
download	下载附加到记录字段的文件。
delete	删除附加到记录字段的文件。

uip df 文件上传

上传文件至记录字段。

参数

名称	必填	用途
<entity-id>	是	实体 ID (UUID)。
<record-id>	是	记录 ID (UUID)。
<field-name>	是	文件字段的名称 (区分大小写)。

选项

短	长	值	默认	描述
-f	--file	路径	必填	要上传的文件的路径。
—	--folder-key	键值	—	对于文件夹范围内的实体，包含实体的文件夹的文件夹密钥 (GUID)。

示例

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

数据形状（--输出 json）

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

uip df 文件下载

下载附加到记录字段的文件。

参数

名称	必填	用途
<entity-id>	是	实体 ID (UUID)。
<record-id>	是	记录 ID (UUID)。
<field-name>	是	文件字段的名称 (区分大小写)。

选项

短	长	值	默认	描述
—	--destination	路径	<record-id>_<field-name>.bin	输出文件路径。
—	--folder-key	键值	—	对于文件夹范围内的实体，包含实体的文件夹的文件夹密钥 (GUID)。

示例

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

数据形状（--输出 json）

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

uip df 文件删除

删除附加到记录字段的文件。记录本身不受影响，只会删除命名字段上的 Blob。

参数

名称	必填	用途
<entity-id>	是	实体 ID (UUID)。
<record-id>	是	记录 ID (UUID)。
<field-name>	是	文件字段的名称 (区分大小写)。

选项

短	长	值	默认	描述
-y	--yes	标记	—	必需。确认这是一个不可逆的操作。
—	--reason	text	—	必需。删除原因 — 在响应中回显，以便调用者可以记录。
—	--folder-key	键值	—	对于文件夹范围内的实体，包含实体的文件夹的文件夹密钥 (GUID)。

示例

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

数据形状（--输出 json）

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

相关内容

• uip df entities — 发现包含entities get字段名称。
• uip df records — 管理拥有这些附件的记录。

另请参阅

• Data Fabric 工具概述
• 全局选项
• 退出代码