OP

OpenProject Import Docs
Docs · OpenProject CSV Import

Hướng dẫn lấy session cookie và import file CSV vào OpenProject

Đây là trang tài liệu đơn giản để bạn thao tác đúng từ đầu: lấy _open_project_session, chuẩn bị file CSV, map dữ liệu và import lên OpenProject mà không phải dò lại từng bước.

Xem cách lấy cookie Xem chuẩn file CSV

Overview

Bạn cần chuẩn bị gì trước khi import?

Tài liệu thao tác nhanh

Để import dữ liệu thành công, bạn cần đủ 4 thành phần: domain OpenProject, session cookie hợp lệ, project ID hoặc key, và file CSV đúng cấu trúc. Nếu thiếu một trong 4 phần này, quá trình import thường lỗi ở bước xác thực hoặc validate dữ liệu.

1. Xác thực

Lấy cookie _open_project_session từ trình duyệt đang đăng nhập OpenProject.

2. Dữ liệu

Xuất dữ liệu từ Google Sheets hoặc Excel sang CSV UTF-8 và giữ tên cột rõ ràng.

Data Preparation

Chuẩn bị file CSV đúng định dạng

Bạn có thể làm dữ liệu ở Google Sheets hoặc Excel, sau đó export sang CSV. Cột quan trọng nhất là subject.

Cột Bắt buộc Ý nghĩa Ví dụ
subject Có Tiêu đề công việc Tạo docs hướng dẫn import
description Không Mô tả chi tiết Hướng dẫn cookie và CSV
type_id Không ID loại task 1
status_id Không ID trạng thái 1
priority_id Không ID độ ưu tiên 2
start_date Không Ngày bắt đầu YYYY-MM-DD 2026-06-04
due_date Không Ngày kết thúc YYYY-MM-DD 2026-06-10
estimated_time Không Thời lượng ước tính 8 hoặc 1.5
assignee_id Không ID người nhận việc 15

Xuất từ Google Sheets

  • Chọn File → Download → Comma Separated Values (.csv).
  • Kiểm tra lại hàng tiêu đề trước khi import.
  • Nên dọn các dòng trống trước khi xuất file.

Xuất từ Excel

  • Chọn Save As.
  • Lưu dưới dạng CSV UTF-8.
  • Tránh merged cell và định dạng ngày không đồng nhất.

Workflow

Các bước import file CSV

Bước 1

Nhập OpenProject URL

Ví dụ: https://project.greenglobal.vn.

Bước 2

Dán Session Cookie

Chỉ dán phần value, không dán cả tên cookie.

Bước 3

Nhập Project ID / Key

Dùng đúng project đích để tránh import nhầm.

Bước 4

Chọn file CSV

Kéo thả hoặc chọn file rồi kiểm tra preview dữ liệu.

Bước 5

Map các cột

Khớp các cột CSV với trường tương ứng trong OpenProject.

Bước 6

Bắt đầu import

Theo dõi log thành công / thất bại để xử lý nếu cần.

Troubleshooting

Các lỗi thường gặp

HTTP 401 / 403

Cookie hết hạn, copy sai value hoặc tài khoản không có quyền với project.

Không thấy cookie trong DevTools

Bạn có thể chưa đăng nhập đúng domain hoặc đang xem nhầm website trong tab Application.

Import lỗi từng dòng

Dữ liệu có thể thiếu subject, sai định dạng ngày hoặc dùng ID không hợp lệ.

Tiếng Việt bị lỗi font

Hãy lưu file dưới dạng CSV UTF-8 trước khi upload.