Nhập hàng loạt người dùng bằng tệp CSV
Có thể nhập tệp CSV từ bảng điều khiển quản trị Shopify để tạo người dùng quản trị hoặc người dùng Điểm bán hàng (POS) mới cho Điểm bán hàng Shopify và quản lý hàng loạt quyền truy cập cửa hàng của họ.
Có thể dùng tính năng nhập tệp CSV để thực hiện các thay đổi sau đối với tài khoản người dùng:
- Tạo người dùng quản trị mới
- Tạo người dùng điểm bán hàng (POS) mới cho Shopify POS bằng mã PIN đã gán
- Đình chỉ và kích hoạt lại tài khoản người dùng quản trị và POS hiện tại
Trên trang này
- Lưu ý về tệp CSV quản lý người dùng
- Tải xuống tệp CSV quản lý người dùng mẫu
- Định nghĩa cột cho tệp CSV quản lý người dùng
- Tạo người dùng mới trong tệp CSV
- Đình chỉ hoặc kích hoạt lại người dùng hiện tại trong tệp CSV
- Chỉ định nhiều vai trò, địa điểm và cửa hàng cho người dùng
- Gán nhóm cho người dùng trong tệp CSV
- Nhập tệp CSV quản lý người dùng từ trang quản trị Shopify
- Giải pháp cho các vấn đề thường gặp khi nhập thông tin quản lý người dùng
- Khắc phục thông báo lỗi khi nhập
Lưu ý về tệp CSV quản lý người dùng
Một số thay đổi đối với tài khoản người dùng không được hỗ trợ khi nhập tệp CSV. Đối với những nội dung cập nhật không thể hoàn tất bằng cách nhập tệp CSV, hãy quản lý tài khoản người dùng thủ công trong bảng điều khiển quản trị Shopify hoặc trong ứng dụng Điểm bán hàng Shopify. Xem lại các lưu ý sau đây khi nhập người dùng bằng tệp CSV:
- Tính năng nhập tệp CSV không hỗ trợ xóa hàng loạt người dùng.
- Không thể thiết lập hoặc cập nhật yêu cầu xác thực hai yếu tố đối với người dùng.
- Không thể thay đổi mã PIN hiện tại của người dùng đối với Điểm bán hàng Shopify.
- Không thể tạo vai trò, nhóm hoặc địa điểm mới từ tệp CSV đã nhập. Tên vai trò, tên nhóm và tên địa điểm trong tệp phải khớp với nội dung đã có trong bảng điều khiển quản trị Shopify.
- Chỉ có thể đình chỉ hoặc kích hoạt lại người dùng hiện tại thông qua việc nhập tệp CSV. Không thể thay đổi vai trò, nhóm đã chỉ định, địa điểm hoặc quyền truy cập cửa hàng của người dùng hiện tại.
- Không thể thay đổi loại người dùng, chẳng hạn như đổi người dùng chỉ dùng POS thành người dùng quản trị.
Tải xuống tệp CSV quản lý người dùng mẫu
Tệp mẫu bao gồm tiêu đề cột bắt buộc và giá trị ví dụ cho từng cột. Bạn có thể sử dụng tệp này làm cơ sở trước khi thêm người dùng của riêng mình.
Tải xuống và xem tệp CSV quản lý người dùng mẫu từ trang này, hoặc tải xuống bản mẫu từ trang Nhập trong bảng điều khiển quản trị Shopify.
Để tìm hiểu cách lưu và chỉnh sửa tệp CSV trong ứng dụng bảng tính, hãy tham khảo phần Mở và chỉnh sửa tệp CSV.
Định nghĩa cột cho tệp CSV quản lý người dùng
Bảng sau đây liệt kê mọi cột trong tệp CSV mẫu về quản lý người dùng. Mỗi định nghĩa giải thích cách sử dụng cột khi bạn tạo người dùng, hoặc khi đình chỉ hay kích hoạt lại người dùng hiện tại, bao gồm cả điểm khác biệt giữa người dùng quản trị và người dùng chỉ dùng POS.
| Cột CSV | Định nghĩa |
|---|---|
| id | ID người dùng duy nhất của mỗi tài khoản. Khi xuất thông tin quản lý người dùng dưới dạng tệp CSV, ID của từng người dùng sẽ hiển thị trong cột id. Bạn cũng có thể tìm ID người dùng trong URL trình duyệt khi mở hồ sơ của họ trong bảng điều khiển quản trị Shopify. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| user_type | Loại người dùng, ví dụ như Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
Địa chỉ email hợp lệ. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
| |
| phone | Số điện thoại của người dùng. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| given_name | Tên của người dùng. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| family_name | Họ của người dùng. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| status | Trạng thái tài khoản người dùng, chẳng hạn như Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| role_name | Tên vai trò được gán cho người dùng. Tên vai trò phải tồn tại và hợp lệ với loại người dùng đó. Một hàng trong tệp CSV có thể gán vai trò hoặc nhóm, nhưng không thể gán cả hai. Nếu nhập giá trị vào cả role_name và group_name trên cùng một hàng, quá trình nhập cho hàng đó sẽ thất bại. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| group_name | Nhóm được gán cho người dùng. Nhóm chỉ khả dụng đối với các tổ chức dùng gói Shopify Plus. Một hàng trong tệp CSV có thể gán nhóm hoặc vai trò, nhưng không thể gán cả hai. Nếu nhập giá trị vào cả group_name và role_name trên cùng một hàng, quá trình nhập cho hàng đó sẽ thất bại. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| store_name | Cửa hàng mà người dùng có thể truy cập. Phải khớp chính xác với tên cửa hàng trong trang quản trị Shopify. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| pos_location_name | Điểm bán hàng (POS) mà người dùng có thể truy cập. Tên địa điểm phải khớp với một địa điểm trong cửa hàng đó. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| all_current_and_future_locations | Nhập Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
| pin | Mã PIN để đăng nhập vào Điểm bán hàng Shopify: gồm 4–6 chữ số. Mã PIN phải giống nhau trên mỗi hàng trong tệp CSV chỉ định quyền POS cho cùng một người dùng tại một cửa hàng. Mã PIN có thể khác nhau giữa các cửa hàng đối với cùng một người dùng. Trong mỗi cửa hàng, mỗi mã PIN phải là duy nhất cho một tài khoản người dùng. Để tạo:
Để đình chỉ hoặc kích hoạt lại:
|
Tạo người dùng mới trong tệp CSV
Để tạo người dùng mới, hãy để trống id trên hàng đó. Sau khi tạo người dùng, quá trình nhập sẽ tự động gán giá trị cho id.
Để cấp cho người dùng quyền truy cập vào nhiều địa điểm, vai trò hoặc cửa hàng, hãy tham khảo phần Gán nhiều vai trò, địa điểm và cửa hàng cho người dùng.
Tạo người dùng POS
Để tạo người dùng POS, hãy nhập giá trị cho các trường sau:
- Nhập
Point of salevào user_type. - Nhập given_name và family_name.
- Để thiết lập quyền của người dùng, hãy nhập giá trị cho một trong các trường sau:
- role_name và store_name: Nếu tổ chức có nhiều cửa hàng, bạn phải nhập cả hai trường này.
- group_name: Chỉ khả dụng trên gói Shopify Plus. Để tìm hiểu cách gán nhóm, tham khảo Gán nhóm cho người dùng trong tệp CSV.
- Để thiết lập quyền truy cập địa điểm, hãy nhập giá trị cho các trường sau:
- Để cho phép truy cập các địa điểm cụ thể, hãy nhập pos_location_name và đặt all_current_and_future_locations thành
FALSE. - Để cho phép truy cập mọi địa điểm, hãy đặt all_current_and_future_locations thành
TRUEvà để trống pos_location_name.
- Để cho phép truy cập các địa điểm cụ thể, hãy nhập pos_location_name và đặt all_current_and_future_locations thành
- Không bắt buộc: Nhập email, phone hoặc pin. Mã PIN phải là số có 4–6 chữ số và là duy nhất trong cửa hàng.
Tạo người dùng quản trị
Để tạo người dùng quản trị, hãy nhập giá trị cho các trường sau:
- Nhập
Adminvào user_type. - Nhập email.
- Để thiết lập quyền của người dùng, hãy nhập giá trị cho các trường sau:
- role_name và store_name: Nếu tổ chức chỉ có một cửa hàng, bạn không cần nhập store_name. Nếu vai trò này ở cấp độ tổ chức, hãy để trống store_name.
- group_name: Chỉ khả dụng trên gói Shopify Plus. Để tìm hiểu cách gán nhóm, tham khảo Gán nhóm cho người dùng trong tệp CSV.
- Không bắt buộc: Khi role_name là vai trò thuộc danh mục POS, bạn có thể nhập giá trị cho pin trên hàng đó. Nếu không chỉ định mã PIN, quá trình nhập sẽ tạo mã PIN cho người dùng.
- Nếu role_name là vai trò thuộc danh mục POS, bạn phải thiết lập quyền truy cập địa điểm cho người dùng. Nhập giá trị cho các trường sau:
- Để cho phép truy cập các địa điểm cụ thể, hãy nhập pos_location_name và đặt all_current_and_future_locations thành
FALSE. - Để cho phép truy cập mọi địa điểm, hãy đặt all_current_and_future_locations thành
TRUEvà để trống pos_location_name.
- Để cho phép truy cập các địa điểm cụ thể, hãy nhập pos_location_name và đặt all_current_and_future_locations thành
Đình chỉ hoặc kích hoạt lại người dùng hiện tại trong tệp CSV
Bạn có thể đình chỉ hoặc kích hoạt lại người dùng hiện tại bằng cách thêm một hàng cho mỗi người dùng vào tệp CSV quản lý người dùng. Hệ thống nhận dạng người dùng thông qua id.
Để đình chỉ hoặc kích hoạt lại người dùng hiện tại, hãy nhập giá trị cho các trường sau:
- Nhập id của người dùng.
- Nhập user_type của người dùng.
- Nếu đây là người dùng quản trị, hãy nhập giá trị cho các trường sau:
- email: Bắt buộc.
- given_name: Không bắt buộc. Nếu nhập giá trị, giá trị này phải khớp với tên của người dùng trong trang quản trị Shopify.
- family_name: Không bắt buộc. Nếu nhập giá trị, giá trị này phải khớp với họ của người dùng trong trang quản trị Shopify.
- phone: Không bắt buộc. Nếu nhập giá trị, giá trị này phải khớp với số điện thoại của người dùng trong trang quản trị Shopify.
- Nếu đây là người dùng POS, hãy nhập giá trị cho các trường sau:
- given_name: Bắt buộc.
- family_name: Bắt buộc.
- email: Nếu tài khoản của người dùng có email thì đây là trường bắt buộc.
- phone: Nếu tài khoản của người dùng có số điện thoại thì đây là trường bắt buộc.
- status: Nhập
Suspendedđể đình chỉ người dùng hoặcActiveđể kích hoạt lại người dùng. Bạn chỉ có thể đình chỉ người dùng khi trạng thái hiện tại của họ trong trang quản trị Shopify làActivehoặcInactive. Bạn chỉ có thể kích hoạt lại người dùng khi trạng thái hiện tại của họ làSuspended.
Chỉ định nhiều vai trò, địa điểm và cửa hàng cho một người dùng
Khi tạo người dùng mới, bạn có thể gán nhiều vai trò, điểm bán hàng và cửa hàng cho người dùng đó trong một lần nhập tệp CSV. Mỗi kiểu kết hợp vai trò, địa điểm hoặc cửa hàng cần nằm trên một hàng riêng trong tệp.
Thêm một hàng cho mỗi giá trị mà bạn muốn chỉ định cho cùng một người dùng. Trên mỗi hàng của người dùng đó, nhập cùng một giá trị nhận dạng để quá trình nhập áp dụng mọi hàng cho một tài khoản người dùng duy nhất đó. Để trống id trên mỗi hàng. Quá trình nhập sẽ chỉ định id sau khi người dùng được tạo.
Giá trị nhận dạng bắt buộc trên mỗi hàng
Để quá trình nhập nhận dạng cùng một người dùng, hãy nhập các giá trị sau trên mỗi hàng trong tệp CSV của bạn đối với người dùng đó:
- Đối với người dùng quản trị, phải nhập cùng một email và user_type trên mỗi hàng cho người dùng đó.
- Đối với người dùng POS, phải nhập cùng một user_type, given_name, family_name, email và phone cho người dùng đó trên mọi hàng.
Chỉ định nhiều vai trò cho một người dùng trong cùng một cửa hàng
Một người dùng duy nhất có thể giữ nhiều vai trò tại cùng một cửa hàng khi mỗi vai trò được thể hiện trên một hàng riêng trong tệp CSV.
Để chỉ định cho một người dùng nhiều hơn một vai trò tại cùng một cửa hàng, bạn phải thêm một hàng cho mỗi vai trò trong tệp CSV. Trên mỗi hàng, nhập cùng một giá trị nhận dạng đối với người dùng đó, sau đó bao gồm chính xác store_name và role_name giống như thông tin hiển thị trong trang quản trị Shopify.
Chỉ định nhiều điểm bán hàng trong cùng một cửa hàng
Khi người dùng chỉ được phép truy cập một số điểm bán hàng nhất định trong một cửa hàng, hãy liệt kê mỗi địa điểm trên một hàng riêng.
Để cấp cho người dùng quyền truy cập vào nhiều địa điểm POS cụ thể, phải thêm một hàng cho mỗi địa điểm trong tệp CSV. Trên mọi hàng, nhập cùng giá trị nhận dạng cho người dùng đó, nhập pos_location_name được liệt kê trong bảng điều khiển quản trị Shopify và đặt all_current_and_future_locations thành FALSE trên mỗi hàng.
Ví dụ: để cấp cho người dùng cùng một vai trò tại hai địa điểm cụ thể trong một cửa hàng, hãy thêm một hàng cho mỗi địa điểm.
| role_name | pos_location_name | all_current_and_future_locations |
|---|---|---|
Cashier | Location 1 | FALSE |
Cashier | Location 2 | FALSE |
Hoặc để cấp quyền truy cập vào tất cả địa điểm hiện tại và tương lai, hãy sử dụng một hàng duy nhất với all_current_and_future_locations được đặt thành TRUE và để trống pos_location_name. Sử dụng cùng giá trị TRUE hoặc FALSE trên mọi hàng cho người dùng đó trong cửa hàng. Không được sử dụng lẫn lộn các giá trị này giữa các hàng.
Chỉ định quyền truy cập của người dùng trên nhiều cửa hàng
Tổ chức có nhiều cửa hàng có thể cấp quyền truy cập cho cùng một người vào mỗi cửa hàng theo nhu cầu.
Khi cùng một người dùng cần quyền truy cập vào nhiều cửa hàng, hãy sử dụng một hàng cho mỗi tổ hợp vai trò-cửa hàng-địa điểm. Trên mỗi hàng, phải nhập cùng giá trị nhận dạng cho người dùng đó, cùng với store_name chính xác được liệt kê trong bảng điều khiển quản trị Shopify.
Có thể chỉ định nhiều vai trò và nhiều điểm bán hàng cho cùng một người dùng đối với mỗi cửa hàng.
Đối với all_current_and_future_locations và pos_location_name trên các hàng tạo mới, hãy sử dụng cùng quy tắc hàng như trong mục chỉ định nhiều địa điểm POS trong cùng cửa hàng. Không được đặt all_current_and_future_locations thành TRUE khi pos_location_name có giá trị trên hàng đó.
Ví dụ sau gán cùng một người dùng POS quyền truy cập vào các địa điểm khác nhau trên hai cửa hàng khác nhau.
| store_name | role_name | pos_location_name | all_current_and_future_locations |
|---|---|---|---|
StoreName_USA | Cashier | StoreName_USA_SF_01 | FALSE |
StoreName_CAN | Store Teller | TRUE |
Nếu bất kỳ hàng nào của một người dùng bị lỗi, tất cả hàng của người dùng đó sẽ bị từ chối. Sau khi khắc phục lỗi, hãy bao gồm mọi hàng của người dùng đó trong lần nhập tiếp theo.
Gán nhóm cho người dùng trong tệp CSV
Nhóm chỉ khả dụng đối với các tổ chức dùng gói Shopify Plus. Một nhóm bao gồm một hoặc nhiều vai trò, do đó việc gán nhóm có thể cấp cho người dùng nhiều vai trò cùng lúc.
Gán nhóm hoặc một vai trò duy nhất
Mỗi hàng trong tệp CSV có thể gán một nhóm hoặc một vai trò duy nhất, nhưng không thể gán cả hai:
- Để gán nhóm, hãy nhập nhóm vào group_name và để trống role_name.
- Để gán một vai trò duy nhất, hãy nhập vai trò vào role_name và để trống group_name.
Gán nhóm cho người dùng đủ điều kiện
Bạn có thể gán nhóm cho người dùng khi có ít nhất một vai trò trong nhóm áp dụng cho loại người dùng đó. Các vai trò trong nhóm không áp dụng cho loại người dùng sẽ không được cấp, nhưng cũng không gây ra lỗi. Nhóm vẫn được gán thành công dựa trên các vai trò áp dụng được.
Không thể gán nhóm không có vai trò nào.
Gán nhóm trên các cửa hàng và địa điểm
Phải bao gồm một hàng trong tệp CSV cho mỗi cửa hàng mà tại đó nhóm cấp vai trò tại điểm bán hàng. Trên mỗi hàng đó, cũng phải thiết lập quyền truy cập địa điểm:
- Để truy cập vào các địa điểm cụ thể, hãy nhập pos_location_name và đặt all_current_and_future_locations thành
FALSE. Để cấp quyền cho nhiều địa điểm cụ thể trong một cửa hàng, hãy thêm mỗi địa điểm một hàng, với cùng một nhóm và cửa hàng trên mỗi hàng. - Để cho phép truy cập mọi địa điểm, hãy đặt all_current_and_future_locations thành
TRUEvà để trống pos_location_name.
Quyền truy cập địa điểm của nhóm được xác thực theo cách giống như vai trò tại điểm bán hàng không được gán qua nhóm, bao gồm cả việc quyền này không thể xung đột với quyền truy cập địa điểm mà người dùng đó được cấp trên một hàng khác.
Thiết lập mã PIN khi gán nhóm
Mã PIN tuân theo các quy tắc giống như đối với người dùng có nhiều vai trò:
- Chỉ nhập pin trên một hàng trong tệp CSV cho cửa hàng mà tại đó nhóm cấp vai trò tại điểm bán hàng.
- Mã PIN phải là duy nhất trong một cửa hàng, nhưng có thể khác nhau giữa các cửa hàng.
- Không nhập pin trên hàng của cửa hàng mà tại đó nhóm chỉ cấp các vai trò không thuộc điểm bán hàng.
Gán nhóm bao gồm vai trò trong tổ chức
Khi nhóm bao gồm vai trò trong tổ chức có các quyền POS, vai trò này sẽ tự động cấp quyền truy cập vào mọi địa điểm, do đó yêu cầu về địa điểm cho từng cửa hàng không áp dụng với vai trò này. Bạn có thể gán loại nhóm này theo một trong các cách sau:
- Một hàng duy nhất chỉ dành cho nhóm: Nhập nhóm vào group_name, sau đó để trống store_name, pos_location_name, all_current_and_future_locations và pin. Vai trò trong tổ chức tự động cấp quyền truy cập vào tất cả địa điểm.
- Các hàng rõ ràng cho từng cửa hàng: Thêm một hàng cho mỗi cửa hàng mà tại đó nhóm cấp vai trò tại điểm bán hàng. Trên mỗi hàng này, đặt all_current_and_future_locations thành
TRUE. Không thể giới hạn người dùng có vai trò trong tổ chức vào một địa điểm duy nhất.
Các ví dụ về gán nhóm
Các ví dụ sau minh họa cách gán một nhóm trên nhiều cửa hàng và địa điểm khác nhau. Mỗi hàng liệt kê các giá trị cho group_name, store_name, pos_location_name và all_current_and_future_locations.
Trong các ví dụ sau, nhóm cấp một vai trò tại cửa hàng và một vai trò tại điểm bán hàng ở Store 1, và một vai trò tại điểm bán hàng ở Store 2:
- Ví dụ 1 gán nhóm có quyền truy cập vào tất cả địa điểm trong hai cửa hàng. Vì nhóm cấp vai trò tại điểm bán hàng trong mỗi cửa hàng, bạn phải thêm một hàng cho mỗi cửa hàng trong tệp CSV.
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Group name | Store 1 | TRUE | ||
Group name | Store 2 | TRUE |
- Ví dụ 2 chỉ định nhóm ở hai cửa hàng, nhưng nhóm chỉ cấp vai trò tại điểm bán hàng ở Cửa hàng 1 và vai trò chỉ dành cho cửa hàng ở Cửa hàng 2. Chỉ thêm một hàng trong tệp CSV cho cửa hàng có vai trò tại điểm bán hàng. Vai trò chỉ dành cho cửa hàng ở Cửa hàng 2 được cấp mà không cần thêm hàng.
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Group name | Store 1 | TRUE |
- Ví dụ 3 chỉ định nhóm có quyền truy cập vào các địa điểm cụ thể ở hai cửa hàng. Bạn phải thêm một hàng cho mỗi địa điểm trong tệp CSV.
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Group name | Store 1 | Địa điểm 11 | FALSE | |
Group name | Store 1 | Địa điểm 12 | FALSE | |
Group name | Store 2 | Địa điểm 21 | FALSE | |
Group name | Store 2 | Địa điểm 22 | FALSE |
Ví dụ 4 chỉ định một nhóm bao gồm vai trò tổ chức có quyền đối với POS, ngoài vai trò cửa hàng và vai trò tại điểm bán hàng. Bạn có thể chỉ định nhóm này theo một trong các cách sau:
- Tùy chọn đầu tiên là một hàng duy nhất chỉ dành cho nhóm, trong đó vai trò tổ chức cấp quyền truy cập vào tất cả địa điểm.
- Tùy chọn thứ hai sử dụng một hàng riêng biệt cho mỗi cửa hàng mà nhóm cấp vai trò tại điểm bán hàng. Trên mỗi hàng, all_current_and_future_locations phải là
TRUE, vì vai trò tổ chức không thể bị giới hạn ở một địa điểm duy nhất.
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Group name |
| group_name | store_name | pos_location_name | all_current_and_future_locations | pin |
|---|---|---|---|---|
Group name | Store 1 | TRUE | ||
Group name | Store 2 | TRUE |
Nhập tệp CSV quản lý người dùng từ trang quản trị Shopify
Sau khi xây dựng tệp CSV và lưu theo đúng định dạng, bạn có thể tải lên từ trang Người dùng của tổ chức. Quá trình nhập sẽ chạy trong bảng điều khiển quản trị Shopify và báo cáo mọi hàng không thể xử lý.
Các bước thực hiện:
Từ bảng điều khiển quản trị Shopify, đi tới Cài đặt > Người dùng.
Nhấp vào Nhập.
Tùy chọn: Nhấp vào liên kết để tải xuống tệp CSV mẫu, sau đó dùng làm mẫu cho tệp của bạn.
Nhấp vào Tải tệp lên, rồi chọn tệp
.csvcủa bạn.
Sau khi quá trình nhập hoàn tất, hãy xem lại xác nhận trong bảng điều khiển quản trị Shopify. Nếu có bất kỳ hàng nào bị lỗi, bạn sẽ nhận được email có thông tin chi tiết để có thể sửa tệp và nhập lại.
Giải pháp cho các sự cố nhập quản lý người dùng thường gặp
Nếu gặp sự cố khi tải lên tệp CSV quản lý người dùng, hãy kiểm tra xem sự cố đó có được liệt kê trong các giải pháp sau không.
Khi cần trợ giúp về khắc phục sự cố cho thông báo lỗi cụ thể, hãy tham khảo Khắc phục sự cố về thông báo lỗi khi nhập.
Nhập lại sau khi khắc phục lỗi
Khi nhập không thành công, bạn sẽ nhận được email liệt kê các hàng bị lỗi. Cẩn thận nhập lại tệp để không tạo người dùng trùng lặp.
Chỉ nhập lại những người dùng bị lỗi, không nhập toàn bộ tệp. Áp dụng các biện pháp sau:
- Sửa các hàng bị lỗi, sau đó đưa mọi hàng của mỗi người dùng bị ảnh hưởng vào tệp mới. Nếu người dùng có 3 hàng và 1 hàng gây ra lỗi, tất cả 3 hàng của người dùng đó sẽ bị từ chối. Hãy đưa cả 3 hàng đã sửa vào bản nhập lại.
- Không đưa vào những người dùng đã nhập thành công. Các tài khoản đó đã tồn tại. Việc nhập lại có thể trả về lỗi
user already exists, tạo người dùng trùng lặp hoặc cả hai.
Nếu nhập lại toàn bộ tệp gốc, bao gồm các hàng của người dùng đã được tạo thành công, bạn có thể gặp các kết quả sau:
- Người dùng quản trị: Nếu một địa chỉ email đã được sử dụng, bạn có thể nhận được lỗi
user already existshoặc trùng lặp email. - Người dùng POS: Hệ thống có thể tạo các bản ghi người dùng POS trùng lặp. Người dùng POS được đối chiếu bằng tên và các trường liên quan thay vì email duy nhất, do đó, người dùng thứ hai có thể được tạo với cùng tên và vai trò.
- Giới hạn số lượng người dùng: Nếu thao tác nhập tính cả những người dùng đã được tạo, bạn có thể nhận được lỗi giới hạn số lượng người dùng. Để tìm hiểu thêm, hãy tham khảo số lượng người dùng tối đa cho từng gói định giá.
Tạo nhiều người dùng POS trùng tên
Nếu giá trị nhận dạng của một người dùng POS khớp nhau trên nhiều hàng trong một lần nhập, kể cả các hàng không liên tiếp, thì quá trình nhập sẽ coi các hàng đó là cùng một người dùng.
Để tạo các người dùng POS riêng biệt có cùng given_name và family_name trong một lần nhập, bạn phải nhập giá trị khác nhau cho ít nhất một trong các trường sau đối với mỗi người dùng:
- phone
Nếu không thể phân biệt nhiều người dùng có cùng given_name và family_name bằng giá trị email hoặc phone khác nhau, bạn phải nhập từng người dùng bằng một tệp CSV riêng.
Định dạng tệp và kích thước tải lên
Các vấn đề sau liên quan đến kích thước hoặc định dạng tệp CSV, không liên quan đến giá trị trong các hàng người dùng:
- Định dạng tệp sai: Tệp của bạn phải là tệp
.csvđược lưu với bảng mã như mô tả trong Mở và chỉnh sửa tệp CSV. - Tệp quá lớn: Nếu tệp của bạn có quá nhiều hàng, hãy chia nhỏ thành nhiều tệp hơn và nhập từng tệp một.
Người dùng POS hiển thị thành nhiều người dùng thay vì một người dùng có nhiều vai trò
Quá trình nhập sẽ khớp các hàng với cùng một người dùng POS khi user_type, given_name, family_name, email và phone khớp nhau trên mọi hàng của người đó. Nếu bất kỳ giá trị nào khác biệt giữa các hàng, quá trình nhập sẽ tạo những người dùng riêng biệt.
Các tình huống sau đây thường dẫn đến trùng lặp người dùng POS khi bạn chỉ muốn có một người dùng nhiều vai trò:
- Một hàng có email nhưng hàng khác thì không: Nếu bạn đưa email vào hàng đầu tiên của người dùng POS nhưng để trống ở hàng khác, thì quá trình nhập sẽ tạo các người dùng riêng biệt. Hãy đưa email vào mọi hàng của người dùng đó hoặc để trống trên mọi hàng.
- Lỗi chính tả trong tên: Lỗi chính tả ở các hàng tên có thể tạo ra các người dùng riêng biệt. Ví dụ:
Janetrên một hàng vàjanetrên hàng khác có thể được coi là các người dùng khác nhau nếu việc đối chiếu phân biệt chữ hoa chữ thường. Hãy viết tên người dùng giống nhau trên mỗi hàng. - Số điện thoại có trên hàng này nhưng không có trên hàng khác: Nếu có phone trên hàng đầu tiên của người dùng POS nhưng để trống ở hàng khác, quá trình nhập sẽ tạo những người dùng riêng biệt. Cần nhập phone trên mọi hàng của người dùng đó, hoặc để trống trên mọi hàng.
Để tránh trùng lặp người dùng, hãy đảm bảo user_type, given_name, family_name, email và phone giống hệt nhau trên mọi hàng của cùng một người dùng POS trong tệp CSV.
Lỗi giới hạn chỗ
Giới hạn chỗ áp dụng cho người dùng quản trị trên gói giá của tổ chức. Khi gặp lỗi giới hạn chỗ lúc nhập, quá trình nhập sẽ đếm số lượng người dùng quản trị mới mà tệp sẽ tạo và so sánh với giới hạn chỗ của gói. Nếu đã đạt hoặc gần đạt giới hạn chỗ, hãy giảm số lượng người dùng quản trị mới trong tệp CSV, hoặc xem xét giới hạn người dùng cho gói giá trước khi nhập lại.
Xuất danh sách người dùng để tìm người dùng POS trùng lặp
Có thể xuất danh sách người dùng ra tệp CSV và so sánh các hàng trong bảng tính khi nghi ngờ có người dùng POS trùng lặp. Tệp xuất bao gồm dấu thời gian cho biết tài khoản nào được tạo trước.
Để tìm hiểu cách phân phối bản xuất và ai có thể tải xuống, hãy tham khảo phần xuất thông tin quản lý người dùng dưới dạng tệp CSV.
Các bước thực hiện:
Từ bảng điều khiển quản trị Shopify, đi tới Cài đặt > Người dùng.
Nhấp vào Xuất.
Trong hộp thoại Xuất người dùng, nhấp vào Xuất.
Khi nhận được email, nhấp vào Tải tệp xuống để lưu tệp CSV vào thiết bị.
Mở tệp trong ứng dụng bảng tính, sau đó sắp xếp theo cột
GIVEN_NAME.Kiểm tra những người dùng POS có trùng giá trị tên, họ, email và điện thoại trong tệp xuất và có thời gian
CREATED_ATgiống nhau hoặc rất sát nhau. Đây có khả năng là các tài khoản trùng lặp.
Xóa thủ công người dùng POS trùng lặp
Có thể xóa thủ công tài khoản người dùng POS trùng lặp trong bảng điều khiển quản trị Shopify mà không cần dùng tệp CSV.
Các bước thực hiện:
Từ bảng điều khiển quản trị Shopify, đi tới Cài đặt > Người dùng.
Chọn tài khoản người dùng trùng lặp.
Nhấp vào Gỡ bỏ.
Xóa hàng loạt người dùng POS trùng lặp bằng tệp CSV
Có thể tạm ngưng các tài khoản trùng lặp bằng cách nhập tệp CSV, sau đó xóa hàng loạt các tài khoản bị tạm ngưng đó từ trang Người dùng trong bảng điều khiển quản trị Shopify. Việc tạm ngưng tài khoản trước giúp xác nhận chính xác các tài khoản cần gỡ bỏ trước khi xóa.
Các bước thực hiện:
- Xuất danh sách người dùng hiện tại.
- Xác định tài khoản trùng lặp bằng phương pháp so sánh được mô tả trong phần Xuất danh sách người dùng để so sánh người dùng POS trùng lặp.
- Đối với mỗi tài khoản trùng lặp, sao chép các giá trị id, user_type, email, phone, given_name và family_name sang một tệp CSV mới. Sử dụng cùng cấu trúc cột với tệp CSV quản lý người dùng mẫu.
- Đặt status thành
Suspendedcho mỗi hàng trùng lặp. Để trống role_name, group_name, store_name, pos_location_name, all_current_and_future_locations và pin. - Nhập tệp CSV để tạm ngưng những người dùng đó.
- Đi tới Cài đặt > Người dùng.
- Nếu có, hãy lọc danh sách người dùng theo các tài khoản Bị tạm ngưng (Suspended). Chọn các tài khoản trùng lặp đã bị tạm ngưng, sau đó xóa hàng loạt.
Khắc phục sự cố về thông báo lỗi khi nhập
Khi thao tác nhập CSV quản lý người dùng không thành công, bạn sẽ nhận được email bao gồm thông báo lỗi và các hàng bị ảnh hưởng. Các phần sau đây giải thích ý nghĩa của từng loại thông báo và những gì có thể thay đổi trong tệp CSV trước khi nhập lại.
Nếu vẫn gặp sự cố khi nhập tệp CSV, hãy liên hệ với Bộ phận hỗ trợ của Shopify.
Lỗi tệp CSV
CSV headers are missing or invalid
Tệp không có hàng tiêu đề hoặc không thể phân tích cú pháp tiêu đề. Sử dụng mẫu quản lý người dùng từ trang Nhập và giữ nguyên hàng đầu tiên như đã cung cấp.
CSV file is empty
Tệp không có hàng dữ liệu dưới tiêu đề. Thêm ít nhất một hàng hoặc xác nhận rằng đã xuất hoặc lưu toàn bộ tệp.
Missing required CSV headers
Thiếu một hoặc nhiều cột bắt buộc. Quá trình nhập yêu cầu các tiêu đề sau khi nhập tệp CSV quản lý người dùng:
- id
- user_type
- phone
- given_name
- family_name
- status
- role_name
- group_name
- store_name
- pos_location_name
- all_current_and_future_locations
- pin
Không xóa hoặc đổi tên cột từ tệp CSV quản lý người dùng mẫu.
Found extra CSV headers: [...]
Tệp có chứa các cột không nằm trong danh sách cho phép. Xóa bỏ bất kỳ tiêu đề nào không có trong mẫu tệp CSV quản lý người dùng.
Lỗi nhận dạng người dùng
user_type must be 'Admin' or 'Point of sale'
Giá trị được thiết lập cho user_type không được chấp nhận. Đặt user_type thành Admin hoặc Point of sale.
Lỗi tạo người dùng quản trị hoặc POS
Các bước khắc phục sự cố sau áp dụng khi trường id của người dùng bị bỏ trống để tạo người dùng mới.
Status is required
Trên các hàng tạo người dùng, hãy để trống cột status. Quá trình nhập sẽ tự động đặt status. Nếu nhập giá trị vào cột status trên hàng tạo mới, quá trình nhập sẽ thất bại đối với người dùng đó. Trên các hàng tạm ngưng hoặc kích hoạt lại, đặt status thành Suspended hoặc Active sao cho phù hợp.
user_type must be 'Admin' or 'Point of sale'
user_type đã nhập không hợp lệ. Phải nhập Admin hoặc Point of sale.
Lỗi tạo người dùng quản trị
Các bước khắc phục sự cố sau áp dụng khi id bị bỏ trống và user_type được đặt thành Admin.
Email is required
Bạn phải nhập giá trị cho email trên mỗi hàng khi tạo người dùng quản trị.
Lỗi tạo người dùng POS
Thông tin khắc phục sự cố sau đây áp dụng khi để trống id và user_type được đặt thành Point of sale.
given_name is required
Bạn phải nhập giá trị cho given_name đối với mỗi hàng người dùng POS mới.
family_name is required
Bạn phải nhập giá trị cho family_name đối với mỗi hàng người dùng POS mới.
Lỗi tạm ngưng người dùng
Hướng dẫn khắc phục sự cố sau đây được áp dụng khi id có giá trị và khi thay đổi status cho người dùng hiện có.
Suspend operation must have exactly 1 row.
Tệp nhập của bạn có nhiều hơn một hàng tạm ngưng hoặc kích hoạt lại cùng một người dùng. Chỉ đưa vào một hàng tạm ngưng hoặc kích hoạt lại đối với mỗi người dùng trong từng lần nhập.
Status is required
Trường status đang trống. Phải đặt thành Suspended hoặc Active sao cho phù hợp.
[...] does not match with user.
Lỗi này có nghĩa là giá trị trong hàng không khớp với thông tin đã lưu cho người dùng được liên kết với id trong trang quản trị Shopify. Hãy xác nhận rằng giá trị bạn đã nhập cho mỗi cột này trong tệp CSV khớp với thông tin được liệt kê đối với người dùng đó trong trang quản trị Shopify:
- given_name
- family_name
- phone
- user_type
Status must be 'suspended' or 'active'.
Đặt status thành Suspended hoặc Active.
[...] must be blank when suspending a user.
Trên các hàng chỉ thay đổi status, hãy để trống những trường này:
- role_name
- group_name
- store_name
- pos_location_name
- all_current_and_future_locations
- pin