Cargo-Planner Docs
可定制的装载计划布局
Cargo-Planner 让您决定如何展示您的装载计划。您可以通过在画布上排列信息块来构建布局,而不是使用固定格式。这使您可以控制显示的内容以及如何为不同的受众组织这些内容——为仓库员工提供详细计划,或为客户提供简洁摘要。
概述
使用布局,您可以:
- 拖放块以排列您的装载计划
- 从超过20种块类型中选择(3D视图、表格、备注、说明等)
- 配置每个块的设置
- 根据条件显示或隐藏块(例如,仅在有照片时显示照片)
- 为不同目的创建多个布局(仓库、客户、经理)
- 打印和分享结果

访问布局构建器
从装载计划页面
- 打开任何装载计划
- 在工具栏中的布局选择器中选择一个布局
- 点击旁边的铅笔图标以编辑该布局

铅笔图标仅对可以编辑布局的用户显示。
从偏好设置
进入偏好设置 → 4. 装载计划,然后在装载计划布局下点击管理布局。这将打开所有布局的列表,您可以在其中创建、编辑、复制和删除它们。

布局构建器界面
布局构建器由三个主要区域组成:

1. 块调色板(左侧边栏)
添加块调色板按类别列出可用块:
- 全局块 - 整个装载计划中显示一次(摘要、备注、未装载物品等)
- 集合块 - 多容器集合可视化
- 容器块 - 每个容器显示(3D视图、物品表、说明等)
- 自定义块 - 自定义文本、间隔符和分页符
将块拖到画布上以添加它。使用**搜索块…**按名称查找块。
2. 画布(中心)
主要编辑区域,块在12列网格上排列。您可以:
- 移动块通过拖动块上的手柄
- 调整块大小通过拖动右下角
- 打开块的菜单(⋮图标)以访问设置或移除块
每个块显示其大小,如果它有可见性条件,则显示条件标签。
3. 工具栏(顶部)
| 控件 | 功能描述 |
|---|---|
| 铅笔图标 | 重命名布局。按Enter或点击外部以保存 |
| 复制 | 创建布局的副本 |
| 删除 | 删除布局 |
| 保存 | 返回到前一页 |
工具栏下方您可以添加布局的描述。
在您编辑时更改会自动保存。保存仅将您带回。
模板显示模板标签,不能重命名、删除或编辑。参见使用模板。
理解部分
布局分为三个部分,控制块的渲染频率:
| 部分 | 渲染频率 | 典型块 |
|---|---|---|
| 页眉 | 顶部显示一次 | 标题、摘要、备注、未装载物品、组分布 |
| 容器 | 每个容器显示一次 | 3D视图、容器信息、物品表、说明 |
| 页脚 | 底部显示一次 | 条款和条件、联系信息、免责声明 |
全局和自定义块可以放在任何部分。容器和集合块只能放在容器部分。
要将块移动到另一个部分,请将其拖到那里,或在其设置中更改部分放置。
可用块类型
全局块
装载计划标题
显示装载列表的名称作为标题。
作者
显示谁创建了装载列表,以及可选的创建时间。
| 设置 | 描述 |
|---|---|
| 显示图标 | 在名称旁边显示一个图标 |
| 显示标签 | 在名称上方显示标签 |
| 显示创建日期 | 显示装载列表的创建日期 |
| 自定义标签 | 替换默认的“创建者”标签 |
| 自定义图标 | 要使用的Material Design图标名称 |
| 文本大小 | 小、中或大 |
| 卡片变体 | 卡片样式:外框、平面、文本或提升 |
| 卡片颜色 | 卡片的背景颜色 |
摘要表
一个可折叠的装载列表摘要,包含在数据页面输入的完整货物列表。
| 设置 | 描述 |
|---|---|
| 默认展开 | 显示表格展开而不是折叠 |
备注
显示装载列表备注和装载计划备注。
| 设置 | 描述 |
|---|---|
| 显示装载列表备注 | 包括装载列表备注 |
| 显示装载计划备注 | 包括装载计划备注 |
未装载物品
列出无法装入任何容器的货物。
| 设置 | 描述 |
|---|---|
| 默认展开 | 显示列表展开而不是折叠 |
组分布
显示每个货物最终去向:装入了哪些容器,每个容器装入了多少件,以及有多少件未能装入。默认情况下,它只列出被拆分的货物,因此您可以一目了然地查看哪些货物分布在多个容器中。
每行显示货物、其总件数和装入的容器,例如1: 40HC (7) · 2: 20GP (5)。当部分货物无法装入时,会出现一个未装载列。行按货物排序。
| 设置 | 描述 |
|---|---|
| 按组 | 要分组的货物属性。默认为货物,但任何货物属性或自定义字段都可以使用,例如订单号或目的地 |
| 显示所有组 | 列出每个组,而不仅仅是被拆分的 |
| 仅混合容器 | 仅列出也包含其他组的容器。仅包含单一组的容器以计数形式总结,例如+3仅此组 |
当货物装入多个容器时,或仅部分货物装入时,组被视为拆分。
托盘和捆绑中的件数单独计算,而不是托盘或捆绑本身。没有所选属性值的货物被排除。当相同的容器一起显示时(例如1到3),数量是每个容器的。

集合块
集合概览
显示集合的容器如何排列在一起(对于平板架、开顶等有用)。它显示在每个集合中第一个容器上,且集合中有多个容器。
容器块
容器标题
显示容器编号和名称。相同的容器一起显示时会得到一个范围,例如1到3。
| 设置 | 描述 |
|---|---|
| 容器标题样式 | 编号和名称、仅编号或仅名称 |
3D视图
显示已装载容器的3D视图。添加多个以从不同角度显示容器。
| 设置 | 描述 |
|---|---|
| 视图类型 | 主视图、侧视图1、侧视图2、顶部、前部、3D、3D正交或四个3D透视图之一(前右、后右、后左、前左) |
| 画布宽度/高度(像素) | 视图的大小 |
| 显示标尺 | 显示尺寸标记 |
| 显示标尺细分 | 在标尺上添加更细的标记 |
| 隐藏重心标记 | 隐藏重心标记 |
| 爆炸视图 | 将货物标签放在容器周围,并用线指向货物 |
| 描述 | 与视图一起显示的标题 |
货物过滤限制视图显示容器的一部分,例如显示在门口装载的内容:
| 设置 | 描述 |
|---|---|
| 启用货物过滤 | 打开过滤器 |
| 位置 | 容器的哪个部分:底部、顶部、前部、后部、侧面1或侧面2 |
| 阈值(%) | 部分到达容器的深度,以其大小的百分比表示(默认33%) |
| 模式 | 仅显示隐藏其他货物,高亮淡化其他货物 |
容器图片
显示附加到容器的照片。您还可以直接从块中添加照片;每个容器的照片数量有限制。
容器信息
显示容器的内部长度、宽度和高度,其载重能力及其成本。
| 设置 | 描述 |
|---|---|
| 字体大小 | 文本大小,从XXS到XXL。默认:S |
| 显示成本 | 包括成本行,如果容器有成本 |
容器利用率
显示容器的使用情况:体积、净重和空闲空间,以及设置运输系数时的计费重量。当重量接近限制时,会出现警告。
| 设置 | 描述 |
|---|---|
| 字体大小 | 文本大小,从XXS到XXL。默认:S |
容器总计
显示已装载货物的总长度、宽度和高度以及毛重。如果有任何货物超出尺寸(OoG),还会列出悬垂。
| 设置 | 描述 |
|---|---|
| 字体大小 | 文本大小,从XXS到XXL。默认:S |
重心/轴
显示重心(X、Y和Z),对于有轴的车辆,显示净轴重和毛轴重。超出其限制的轴会被标记。
| 设置 | 描述 |
|---|---|
| 字体大小 | 文本大小,从XXS到XXL。默认:S |
OoG警告
仅在有超出尺寸货物的容器上显示的警告标志。
说明
装载容器的分步说明。
| 设置 | 描述 |
|---|---|
| 装载模式 | 按层、按堆或按属性。可以从视图设置中更改单个装载计划 |
| 按组步骤 | 使用按属性:每个步骤分组的货物属性 |
| 图形大小 | 小、中或大步骤图形 |
| 摄像机角度 | 步骤图形的摄像机角度。也用于交互式指南 |
| 隐藏次要设备 | 不包括托盘和其他次要设备的步骤 |
| 展平次要设备 | 使用上述:列出托盘的内容而不是托盘本身 |
| 隐藏重心标记 | 隐藏步骤图形中的重心标记 |
交互式指南链接
一个按钮,用于打开容器的交互式装载指南,并带有一个可选的二维码,以便工人扫描打印的装载计划并在平板电脑上打开指南。
| 设置 | 描述 |
|---|---|
| 按钮文本 | 按钮上的文本。默认:“打开装载指南” |
| 装载模式 | 指南分组步骤的方式。布局默认遵循说明块 |
| 摄像机角度 | 指南打开时的摄像机角度 |
| 隐藏步骤计数 | 隐藏按钮下方的步骤数量 |
| 显示二维码 | 显示打开指南的二维码 |
物品表
容器中货物的表格。
| 设置 | 描述 |
|---|---|
| 表格密度 | 紧凑、默认或舒适的字体大小和间距 |
| 隐藏总计行 | 不包括底部的总计行 |
| 展平嵌套物品 | 以平面列表而不是嵌套形式列出托盘和捆绑的内容 |
| 附加复选框列 | 添加一列以在装载货物时勾选 |
| 可见列 | 表格显示的列 |
| 物品顺序 | 列出货物的顺序 |
| 附加尺寸 | 在装载列表自己的单位旁显示额外的长度和重量单位 |
容器备注
显示容器的备注。当容器没有备注时,不显示任何内容。
容器元数据
显示容器的自定义元数据字段。除非被锁定,否则可以直接从装载计划中填写这些值。
在块设置中,选择此布局显示的公司元数据字段。编辑字段允许您添加或更改字段本身。
自定义块
自定义文本
您自己的文本,用Markdown编写:标题、列表、加粗、链接等。
| 设置 | 描述 |
|---|---|
| 标题(可选) | 块的标题 |
| 内容 | 文本,以Markdown格式编写 |
| 包裹在卡片中 | 显示带有边框和填充的文本 |
间隔符
在块之间添加垂直空间。
| 设置 | 描述 |
|---|---|
| 高度(像素) | 间隔符的高度 |
分页符
在打印或保存为PDF时,从此处开始新页面。
块设置
要更改块的设置,请在画布上打开其**⋮菜单并选择设置**。

更改在您进行时应用。保存关闭对话框并移动块(如果您更改了其部分)。
除了上述特定于块的设置外,每个块都有:
| 设置 | 描述 |
|---|---|
| 部分放置 | 页眉、容器或页脚。参见理解部分 |
| X位置 | 块开始的列(0-11) |
| Y位置 | 块开始的行 |
| 宽度 | 块跨越的列数(1-12) |
| 高度 | 块跨越的行数(1-12) |
可见性条件
可见性条件使块仅在相关时出现,例如,仅在有照片时显示照片块。

添加条件
- 打开块的设置
- 在可见性条件下,点击添加条件
- 选择一个字段和它应该具有的值(True 或 False)
一个块有多个条件时,只有当所有条件都满足时才显示。
可用字段
| 字段 | 当为True时 |
|---|---|
| 有备注 | 装载列表或装载计划有备注 |
| 在装载计划中显示未装载 | 设置为在装载计划中显示未装载货物 |
| 有未装载物品 | 一些货物无法装载 |
| 是集合中的第一个 | 容器是一个集合中第一个且有多个容器 |
| 有元数据 | 容器有元数据 |
| 有图片 | 容器有照片 |
| 有容器备注 | 容器有备注 |
| 简单模式 | 简单模式开启 |
| 显示照片 | 照片开启 |
| 展平物品 | 物品表展平 |
| 显示说明 | 装载说明开启,在任何模式下 |
| 显示标尺 | 3D视图的标尺开启 |
| 显示水印 | 水印开启 |
| 分组相似容器 | 相同容器一起显示 |
简单模式到分组相似容器遵循装载计划视图设置,因此查看者可以在不更改布局的情况下切换块。
示例
| 目标 | 字段 | 值 |
|---|---|---|
| 仅在有照片时显示照片块 | 有图片 | True |
| 在简单模式下隐藏详细块 | 简单模式 | False |
| 每个集合仅显示一次集合概览 | 是集合中的第一个 | True |
| 当有剩余货物时显示警告文本 | 有未装载物品 | True |
管理布局
所有布局都在偏好设置 → 4. 装载计划 → 管理布局中管理。列表中的每个布局都有图标用于编辑、复制和删除。
创建布局
- 点击新建布局
- 给它命名(例如“仓库布局”、“客户摘要”)
- 新的空布局在构建器中打开
- 添加和排列块
要从现有布局或模板开始,请复制它。
使用模板
Cargo-Planner 包含三个模板:经典,复制传统装载计划格式,简单和紧凑。模板不能编辑或删除,但您可以复制它们:
- 点击模板旁边的复制图标
- 给您的副本命名
- 副本在构建器中打开,准备自定义

如果您在装载计划页面选择模板时点击铅笔图标,系统会询问您是制作副本还是查看模板。
设置默认布局
默认布局在您打开装载计划时使用。在偏好设置 → 4. 装载计划下的活动装载计划布局中设置:
- 公司默认 - 公司中所有人使用的布局
- 用户偏好 - 您自己的默认设置,覆盖公司默认
在装载计划上选择一个布局也会使其成为您的用户偏好。
编辑布局
点击列表中布局旁边的编辑图标,或在装载计划上的布局选择器旁边的铅笔图标。更改会自动保存。
复制布局
- 点击布局旁边的复制图标,或在构建器中点击复制
- 输入副本的名称
- 副本在构建器中打开
重命名布局
- 在构建器中打开布局
- 点击名称旁边的铅笔图标
- 输入新名称并按Enter
删除布局
- 点击布局旁边的删除图标
- 确认删除
模板(经典、简单和紧凑)无法删除。
高级:查询参数
在共享或自动化装载计划链接时,您可以使用查询参数设置布局和显示设置:
/loadlist/123/loadplan?layout=my-custom-layout&showRuler=true&simpleMode=false
| 参数 | 值 | 效果 |
|---|---|---|
layout | 布局ID | 要使用的布局 |
instructions | layers, stacks, by-prop, off | 装载说明模式,或关闭说明 |
simpleMode | true / false | 简单模式 |
flatItems | true / false | 展平物品表 |
showRuler | true / false | 3D视图上的标尺 |
showImages | true / false | 容器照片 |
showUnloaded | true / false | 显示未装载货物 |
showWatermark | true / false | 水印 |
print | 任何值 | 在一页上显示所有容器,便于打印 |
这对于:
- 通过API自动生成PDF
- 共享链接具有特定显示设置
- 模板URL用于一致的格式
一般提示
- 从模板开始 - 复制经典、简单或紧凑,而不是从空开始
- 创建多个布局 - 不同的受众需要不同的信息
- 清晰命名布局 - 使用描述性名称,如“仓库 - 详细”或“客户 - 摘要”
- 保持简单 - 不要让读者信息过载
- 检查打印效果 - 测试布局在打印或保存为PDF时的外观
故障排除
块不显示
检查是否:
- 块有未满足的可见性条件(查找条件标签)
- 块没有要显示的内容,例如没有备注时的备注块,或没有货物超出尺寸时的OoG警告
- 块在您期望的部分(页眉、容器或页脚)
移动后块消失
容器和集合块仅在容器部分中工作。如果您将其移动到页眉或页脚,它将被移除并显示警告。
无法编辑模板
模板(经典、简单和紧凑)是只读的。复制模板并编辑您的副本。参见使用模板。