Cargo-Planner Docs
사용자 정의 가능한 적재 계획 레이아웃
Cargo-Planner는 적재 계획이 어떻게 제시되는지를 결정할 수 있게 합니다. 고정된 형식 대신, 캔버스에 정보 블록을 배치하여 레이아웃을 구성합니다. 이를 통해 다양한 청중에게 무엇을 보여줄지, 어떻게 구성할지를 제어할 수 있습니다 - 창고 직원에게는 상세한 계획을, 고객에게는 간결한 요약을 제공합니다.
개요
레이아웃을 통해 다음을 수행할 수 있습니다:
- 드래그 앤 드롭으로 적재 계획을 구성
- 20개 이상의 블록 유형 선택 (3D 뷰, 테이블, 노트, 지침 등)
- 각 블록을 자체 설정으로 구성
- 조건에 따라 블록 표시 또는 숨기기 (예: 사진이 있는 경우에만 사진 표시)
- 다양한 목적을 위한 여러 레이아웃 생성 (창고, 고객, 관리자)
- 결과를 인쇄 및 공유
레이아웃 빌더 접근
적재 계획 페이지에서
- 적재 계획을 엽니다
- 도구 모음의 레이아웃 선택기에서 레이아웃을 선택합니다
- 해당 레이아웃을 편집하려면 옆의 연필 아이콘을 클릭합니다
연필 아이콘은 레이아웃을 편집할 수 있는 사용자에게만 표시됩니다.
환경 설정에서
환경 설정 → 4. 적재 계획, 적재 계획 레이아웃 아래의 레이아웃 관리를 클릭하세요. 여기에서 모든 레이아웃의 목록이 열리며, 이를 생성, 편집, 복사 및 삭제할 수 있습니다.
레이아웃 빌더 인터페이스
레이아웃 빌더는 세 개의 주요 영역으로 구성됩니다:
1. 블록 팔레트 (왼쪽 사이드바)
블록 추가 팔레트는 카테고리별로 사용 가능한 블록을 나열합니다:
- 글로벌 블록 - 전체 적재 계획에 한 번 표시 (요약, 노트, 적재되지 않은 항목 등)
- 세트 블록 - 다중 컨테이너 세트 시각화
- 컨테이너 블록 - 각 컨테이너에 표시 (3D 뷰, 항목 테이블, 지침 등)
- 사용자 정의 블록 - 사용자 정의 텍스트, 스페이서 및 페이지 나누기
블록을 캔버스로 드래그하여 추가합니다. **블록 검색…**을 사용하여 이름으로 블록을 찾습니다.
2. 캔버스 (중앙)
블록이 12열 그리드에 배치되는 주요 편집 영역입니다. 다음을 수행할 수 있습니다:
- 블록의 핸들을 드래그하여 블록 이동
- 오른쪽 하단 모서리를 드래그하여 블록 크기 조정
- 블록의 메뉴를 열어 (⋮ 아이콘) 설정에 접근하거나 블록을 제거
각 블록은 크기를 표시하며, 가시성 조건이 있는 경우 조건부 레이블을 표시합니다.
3. 도구 모음 (상단)
| 제어 | 기능 |
|---|---|
| 연필 아이콘 | 레이아웃 이름 변경. Enter 키를 누르거나 외부를 클릭하여 유지 |
| 복사 | 레이아웃 복사본 생성 |
| 삭제 | 레이아웃 삭제 |
| 저장 | 이전 페이지로 돌아가기 |
도구 모음 아래에 레이아웃의 설명을 추가할 수 있습니다.
편집하는 동안 변경 사항이 자동으로 저장됩니다. 저장은 단지 돌아가는 것입니다.
템플릿은 템플릿 레이블을 표시하며 이름 변경, 삭제 또는 편집할 수 없습니다. 템플릿 사용을 참조하세요.
섹션 이해하기
레이아웃은 블록이 얼마나 자주 렌더링되는지를 제어하는 세 개의 섹션으로 나뉩니다:
| 섹션 | 렌더링 | 일반적인 블록 |
|---|---|---|
| 헤더 | 상단에 한 번 | 제목, 요약, 노트, 적재되지 않은 항목, 그룹 분배 |
| 컨테이너 | 각 컨테이너마다 한 번 | 3D 뷰, 컨테이너 정보, 항목 테이블, 지침 |
| 푸터 | 하단에 한 번 | 약관 및 조건, 연락처 정보, 면책 조항 |
글로벌 및 사용자 정의 블록은 모든 섹션에 배치할 수 있습니다. 컨테이너 및 세트 블록은 컨테이너 섹션에만 배치할 수 있습니다.
다른 섹션으로 블록을 이동하려면 해당 섹션으로 드래그하거나 설정에서 섹션 배치를 변경하세요.
사용 가능한 블록 유형
글로벌 블록
적재 계획 제목
적재 목록의 이름을 제목으로 표시합니다.
작성자
적재 목록을 작성한 사람과 선택적으로 작성 시기를 표시합니다.
| 설정 | 설명 |
|---|---|
| 아이콘 표시 | 이름 옆에 아이콘 표시 |
| 레이블 표시 | 이름 위에 레이블 표시 |
| 작성 날짜 표시 | 적재 목록이 작성된 날짜 표시 |
| 사용자 정의 레이블 | 기본 “작성자” 레이블 대체 |
| 사용자 정의 아이콘 | 사용할 Material Design 아이콘 이름 |
| 텍스트 크기 | 작음, 중간 또는 큼 |
| 카드 변형 | 카드 스타일: 윤곽선, 평면, 텍스트 또는 상승 |
| 카드 색상 | 카드의 배경색 |
요약 테이블
데이터 페이지에 입력된 전체 적재 목록과 함께 접을 수 있는 적재 목록 요약입니다.
| 설정 | 설명 |
|---|---|
| 기본적으로 확장됨 | 테이블을 접힌 상태 대신 확장된 상태로 표시 |
노트
적재 목록 노트와 적재 계획 노트를 표시합니다.
| 설정 | 설명 |
|---|---|
| 적재 목록 노트 표시 | 적재 목록 노트 포함 |
| 적재 계획 노트 표시 | 적재 계획 노트 포함 |
적재되지 않은 항목
어떤 컨테이너에도 적재되지 않은 화물을 나열합니다.
| 설정 | 설명 |
|---|---|
| 기본적으로 확장됨 | 목록을 접힌 상태 대신 확장된 상태로 표시 |
그룹 분배
각 선적이 어디에 적재되었는지를 보여줍니다: 어떤 컨테이너에 적재되었는지, 각 컨테이너에 몇 개의 조각이 들어갔는지, 그리고 얼마나 많이 적재되지 않았는지. 기본적으로 분할된 선적만 나열되므로 여러 컨테이너에 분산된 선적을 한눈에 확인할 수 있습니다.
각 행은 선적, 총 조각 수 및 들어간 컨테이너를 보여줍니다. 예를 들어 1: 40HC (7) · 2: 20GP (5). 선적의 일부가 적재되지 않은 경우 적재되지 않음 열이 나타납니다. 행은 선적 순으로 정렬됩니다.
| 설정 | 설명 |
|---|---|
| 그룹 기준 | 그룹화할 화물 속성. 기본값은 선적이지만, 주문 번호나 목적지와 같은 모든 화물 속성 또는 사용자 정의 필드가 작동합니다. |
| 모든 그룹 표시 | 분할된 것뿐만 아니라 모든 그룹 나열 |
| 혼합 컨테이너만 | 다른 그룹도 포함하는 컨테이너만 나열. 단일 그룹을 포함하는 컨테이너는 수로 요약됩니다. 예: +3 with only this group |
그룹은 둘 이상의 컨테이너에 적재되었거나 일부만 적재된 경우 분할된 것으로 간주됩니다.
팔레트 및 번들에 있는 조각은 개별적으로 계산되며, 팔레트나 번들 자체는 계산되지 않습니다. 선택한 속성에 대한 값이 없는 화물은 제외됩니다. 동일한 컨테이너가 함께 표시될 때 (예: 1 to 3), 수량은 컨테이너당입니다.
세트 블록
세트 개요
세트의 컨테이너가 함께 배열된 방식을 보여줍니다 (플랫랙, 오픈탑 등에 유용). 두 개 이상의 컨테이너가 있는 각 세트의 첫 번째 컨테이너에 표시됩니다.
컨테이너 블록
컨테이너 제목
컨테이너 번호와 이름을 표시합니다. 동일한 컨테이너가 함께 표시되면 범위가 표시됩니다. 예: 1 to 3.
| 설정 | 설명 |
|---|---|
| 컨테이너 제목 스타일 | 번호 및 이름, 번호만, 이름만 |
3D 뷰
적재된 컨테이너의 3D 뷰를 표시합니다. 여러 개를 추가하여 컨테이너를 다양한 각도에서 보여줍니다.
| 설정 | 설명 |
|---|---|
| 뷰 유형 | 메인, 측면 1, 측면 2, 상단, 전면, 3D, 3D 직교, 또는 네 가지 3D 관점 중 하나 (전면-오른쪽, 후면-오른쪽, 후면-왼쪽, 전면-왼쪽) |
| 캔버스 너비 / 높이 (px) | 뷰의 크기 |
| 눈금자 표시 | 치수 마커 표시 |
| 눈금자 세분화 표시 | 눈금자에 더 세밀한 마커 추가 |
| 중심점 마커 숨기기 | 중심점 마커 숨기기 |
| 폭발 뷰 | 화물 라벨을 컨테이너 주위에 배치하고, 선을 통해 화물로 연결 |
| 설명 | 뷰와 함께 표시되는 캡션 |
화물 필터링은 컨테이너의 일부만 보여주도록 제한합니다. 예를 들어 문에 적재된 것을 보여주기 위해:
| 설정 | 설명 |
|---|---|
| 화물 필터 활성화 | 필터 켜기 |
| 위치 | 컨테이너의 어느 부분: 하단, 상단, 전면, 후면, 측면 1 또는 측면 2 |
| 임계값 (%) | 부분이 컨테이너의 크기 비율로 얼마나 멀리 도달하는지 (기본값 33%) |
| 모드 | 보이기만은 다른 화물을 숨기고, 강조는 흐리게 합니다. |
컨테이너 이미지
컨테이너에 첨부된 사진을 표시합니다. 블록에서 직접 사진을 추가할 수도 있으며, 컨테이너당 사진 수는 제한됩니다.
컨테이너 정보
컨테이너의 내부 길이, 너비 및 높이, 적재량 및 비용을 표시합니다.
| 설정 | 설명 |
|---|---|
| 글꼴 크기 | 텍스트 크기, XXS에서 XXL까지. 기본값: S |
| 비용 표시 | 컨테이너에 비용이 있는 경우 비용 행 포함 |
컨테이너 활용도
컨테이너가 얼마나 사용되었는지를 보여줍니다: 부피, 순중량 및 여유 공간, 그리고 배송 요인이 설정된 경우 청구 중량. 중량이 한계에 가까울 때 경고가 표시됩니다.
| 설정 | 설명 |
|---|---|
| 글꼴 크기 | 텍스트 크기, XXS에서 XXL까지. 기본값: S |
컨테이너 총계
적재된 화물의 총 길이, 너비 및 높이와 총중량을 보여줍니다. 화물이 게이지를 벗어난 경우 (OoG), 돌출부도 나열됩니다.
| 설정 | 설명 |
|---|---|
| 글꼴 크기 | 텍스트 크기, XXS에서 XXL까지. 기본값: S |
중심점 / 축
중심점 (X, Y 및 Z)과 축이 있는 차량의 경우 순 및 총 축 중량을 표시합니다. 한계를 초과한 축은 표시됩니다.
| 설정 | 설명 |
|---|---|
| 글꼴 크기 | 텍스트 크기, XXS에서 XXL까지. 기본값: S |
OoG 경고
게이지를 벗어난 화물이 있는 컨테이너에만 나타나는 경고 플래그입니다.
지침
컨테이너를 적재하기 위한 단계별 지침입니다.
| 설정 | 설명 |
|---|---|
| 적재 모드 | 레이어별, 스택별 또는 속성별. 보기 설정에서 단일 적재 계획에 대해 변경할 수 있습니다 |
| 단계 그룹화 기준 | 속성별: 각 단계가 그룹화되는 화물 속성 |
| 그래픽 크기 | 작은, 중간 또는 큰 단계 그래픽 |
| 카메라 각도 | 단계 그래픽의 카메라 각도. 인터랙티브 가이드에서도 사용됩니다 |
| 보조 장비 숨기기 | 팔레트 및 기타 보조 장비에 대한 단계 생략 |
| 보조 장비 평면화 | 위와 함께: 팔레트의 내용을 팔레트 대신 나열 |
| 중심점 마커 숨기기 | 단계 그래픽에서 중심점 마커 숨기기 |
인터랙티브 가이드 링크
컨테이너에 대한 인터랙티브 적재 가이드를 여는 버튼으로, 작업자가 인쇄된 적재 계획을 스캔하고 태블릿에서 가이드를 열 수 있는 QR 코드 옵션이 있습니다.
| 설정 | 설명 |
|---|---|
| 버튼 텍스트 | 버튼의 텍스트. 기본값: “적재 가이드 열기” |
| 적재 모드 | 가이드가 단계를 그룹화하는 방식. 레이아웃 기본값은 지침 블록을 따릅니다 |
| 카메라 각도 | 가이드가 열리는 카메라 각도 |
| 단계 수 숨기기 | 버튼 아래의 단계 수 숨기기 |
| QR 코드 표시 | 가이드를 여는 QR 코드 표시 |
항목 테이블
컨테이너의 화물 테이블입니다.
| 설정 | 설명 |
|---|---|
| 테이블 밀도 | 컴팩트, 기본 또는 편안한 글꼴 크기 및 간격 |
| 총계 행 숨기기 | 하단의 합계 행 생략 |
| 중첩 항목 평면화 | 팔레트 및 번들의 내용을 중첩 대신 평면 목록으로 나열 |
| 체크박스 열 추가 | 화물을 적재하면서 체크할 수 있는 열 추가 |
| 표시 열 | 테이블이 표시하는 열 |
| 항목 순서 | 화물이 나열되는 순서 |
| 추가 치수 | 적재 목록의 자체 단위 옆에 표시할 추가 길이 및 중량 단위 |
컨테이너 노트
컨테이너의 노트를 표시합니다. 컨테이너에 노트가 없는 경우 아무것도 표시되지 않습니다.
컨테이너 메타데이터
컨테이너의 사용자 정의 메타데이터 필드를 표시합니다. 잠겨 있지 않으면 적재 계획에서 직접 값을 입력할 수 있습니다.
블록 설정에서 이 레이아웃이 표시할 회사의 메타데이터 필드를 선택하세요. 필드 편집을 통해 필드를 추가하거나 변경할 수 있습니다.
사용자 정의 블록
사용자 정의 텍스트
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 경고
- 블록이 예상한 섹션에 있는지 (헤더, 컨테이너 또는 푸터)
블록 이동 후 사라짐
컨테이너 및 세트 블록은 컨테이너 섹션에서만 작동합니다. 헤더나 푸터로 이동하면 제거되며 경고가 표시됩니다.
템플릿을 편집할 수 없음
템플릿 (클래식, 간단 및 컴팩트)은 읽기 전용입니다. 템플릿을 복사하고 복사본을 편집하세요. 템플릿 사용을 참조하세요.
관련 문서
- 적재 계획 보기 설정 - 임시 표시 옵션
- 적재 계획 공유 - 고객과 적재 계획 공유
- 적재 계획 생성 - 시작하기 튜토리얼