Khắc phục sự cố thêm hàng loạt của người dùng từ tệp CSV | Adobe Admin Console

Áp dụng đối với doanh nghiệp và nhóm.

Tổng quan

Tính năng Thêm người dùng từ tệp CSV có sẵn trên trang Người dùng cho phép quản trị viên tạo nhiều tài khoản người dùng trong Admin Console bằng tệp CSV. Trạng thái và tiến trình tạo tài khoản người dùng được hiển thị trên trang Kết quả thao tác hàng loạt. Bạn có thể hủy bỏ quá trình tạo Tài khoản người dùng bất cứ lúc nào.

Lưu ý:

Các tệp CSV sử dụng trong các quy trình được mô tả trong bài viết này có thể sử dụng dấu phẩy (,) hoặc dấu chấm phẩy (;) làm dấu phân cách.

Để biết thêm chi tiết về cách quản lý người dùng trong Admin Console, vui lòng tham khảo bài viết Quản lý người dùng.

Yêu cầu về tệp

Quản trị viên cần đáp ứng những yêu cầu xử lý sau trước khi tải tệp lên:

  • Định dạng tệp và tiêu đề
  • Yêu cầu về dữ liệu hoặc hàng trong tệp

Định dạng tệp và tiêu đề

  • Tệp có định dạng giá trị được phân tách bằng dấu phẩy hoặc dấu chấm phẩy, đồng thời có hậu tố .csv. Mỗi bản ghi nằm trong một dòng riêng biệt, được phân cách bằng dấu ngắt dòng (CRLF). Ví dụ: aaa,bbb,ccc CRLF. Để biết thêm thông tin chi tiết, vui lòng xem bài viết RFC 4180 (thông số kỹ thuật tệp CSV)
  • Tiêu đề cột hợp lệ. Hàng Tiêu đề không được để trống. Để biết thêm thông tin về các trường bắt buộc hoặc tùy chọn và định dạng tệp, vui lòng tham khảo bảng Định dạng tệp CSV trong trang Quản lý người dùng.

Cách giải quyết

Thận trọng:

Những thay đổi được mô tả dưới đây có thể ảnh hưởng đến các ứng dụng và bảng tính khác. Do đó, hãy thực hiện những thay đổi cần thiết trong tệp CSV rồi khôi phục lại phần cài đặt này. 

Windows 10

  1. Truy cập phần Cài đặt của Windows.

  2. Vào mục Thời gian & Ngôn ngữ > Khu vực & Ngôn ngữ > Cài đặt ngày, giờ & khu vực bổ sung > Thay đổi định dạng ngày, giờ & số.

  3. Trong danh sách Định dạng thả xuống, chọn Tiếng Anh (Vương quốc Anh).

Windows 7

  1. Vào mục Bảng điều khiển > Tất cả các mục trong Bảng điều khiển > Khu vực và ngôn ngữ.

  2. Trong danh sách Định dạng thả xuống, chọn Tiếng Anh (Vương quốc Anh).

Yêu cầu về dữ liệu hoặc hàng

Hãy đảm bảo rằng bạn đã đáp ứng các yêu cầu sau đối với mỗi hàng dữ liệu:

  • Phải bao gồm một địa chỉ email hợp lệ.
  • Hồ sơ sản phẩm (hoặc cấu hình) đều hợp lệ, nếu có.
Lưu ý:

Nếu bạn là khách hàng nhóm, hãy đổi tiêu đề cột Cấu hình sản phẩm thành Sản phẩm của nhóm. Ngoài ra, đối với dữ liệu trong cột này, hãy nhập tên sản phẩm (không phải tên hồ sơ sản phẩm).

  • Các tùy chọn (nếu có) đều hợp lệ.
Lưu ý:

Mã quốc gia phải là mã hai chữ cái ISO 3166 (alpha-2).

Yêu cầu về kích thước tệp

Tệp CSV của bạn có thể chứa tối đa 25.000 hàng (5.000 để có hiệu suất tối ưu). Nếu tệp có nhiều hơn 5000 hàng, bạn sẽ gặp phải sự cố về hiệu suất khi tệp đang được xử lý trên Admin Console (xem bài viết Xử lý tệp). Tuy nhiên, chúng tôi sẽ từ chối bất kỳ tệp CSV nào có quá 25.000 hàng.

Nếu bạn muốn tải lên hơn 25.000 người dùng, chúng tôi khuyên bạn nên thực hiện một trong những phương án sau:

  1. Chia nhỏ tệp CSV của bạn thành nhiều tệp, mỗi tệp chứa tối đa 25.000 hàng.  Để tối ưu hóa hiệu suất, hãy sử dụng 5000 hàng hoặc ít hơn.
  2. Sử dụng Công cụ đồng bộ hóa người dùng của Adobe. Công cụ dòng lệnh giúp tổ chức bạn di chuyển thông tin nhóm và thông tin người dùng từ hệ thống thư mục doanh nghiệp (chẳng hạn như Active Directory hoặc hệ thống LDAP khác) sang thư mục trong Adobe Admin Console.
  3. Sử dụng User Management REST API (API Quản Lý Người Dùng Theo REST) của Adobe. Bạn có thể ứng dụng API này cho các quy trình quản trị của tổ chức mình.
  4. Nếu bạn đã thiết lập Federated ID trên Admin Console bằng cách liên kết với Microsoft Azure hoặc Google, hãy sử dụng trình kết nối Admin Console tương ứng. Tham khảo bài viết Thiết lập liên kết Google cho SSO với Adobe hoặc Thiết lập SSO với Trình kết nối Azure AD.
  5. Nếu bạn không thể thêm hàng loạt người dùng với bất kỳ phương pháp nào nêu trên, vui lòng đăng nhập vào Admin Console, truy cập mục Hỗ trợ và liên hệ với bộ phận Chăm sóc khách hàng của Adobe.

Xử lý tệp

Khi một tệp đang được xử lý, mỗi mục được xử lý riêng lẻ dựa trên miền cụ thể, được mô tả trong bảng sau.

Khi mọi quá trình xử lý đã hoàn tất, bản tóm tắt sẽ được tới quản trị viên ban đầu qua email. Quá trình xử lý sẽ dừng lại nếu thao tác nhập bị hủy. Tuy nhiên, các hàng đã được xử lý sẽ không thể khôi phục.

Phân loại danh tính

Thao tác

Ngoại lệ

Federated ID

  • Tài khoản người dùng được tạo bằng tên người dùng đã được chỉ định.
  • Tài khoản được thêm vào hồ sơ sản phẩm đã chỉ định.
  • Địa chỉ email không được sử dụng trừ khi dùng để xác định tên miền.
  • Một email sẽ được gửi tới người dùng nếu bật cài đặt thông báo cho Hồ sơ sản phẩm.

  • Tên người dùng đã tồn tại
  • Quốc gia chưa nằm trong danh sách cung cấp dịch vụ của Adobe (nếu có)*
  • Tùy thuộc vào loại hình của tổ chức hoặc hợp đồng, nếu không có đủ giấy phép thông qua hồ sơ sản phẩm đã chỉ định: thì một trong các trường hợp sau sẽ xảy ra:
    • Nhóm : Xảy ra lỗi "Không đủ giấy phép"
    • VIP: Tài khoản đã được thêm vào hồ sơ sản phẩm đã chỉ định. Tuy nhiên, do vượt quá hạn mức giấy phép nên các sản phẩm sẽ không khả dụng cho người dùng
    • ETLA: Tài khoản đã được thêm vào hồ sơ sản phẩm đã chỉ định. Người dùng có quyền truy cập vào các sản phẩm được chỉ định. Số tiền bạn phải thanh toán có thể thay đổi khi gia hạn

Enterprise ID

  • Bạn đã tạo tài khoản với địa chỉ email được cung cấp.
  • Tài khoản được thêm vào cấu hình sản phẩm đã chỉ định.
  • Email chào mừng sẽ được gửi đến người dùng.

  • Đã có lời mời đang được xử lý hoặc tài khoản có email đã tồn tại
  • Quốc gia chưa nằm trong danh sách cung cấp dịch vụ của Adobe (nếu có)*
  • Tùy thuộc vào loại hình của tổ chức hoặc hợp đồng, nếu không có đủ giấy phép thông qua hồ sơ sản phẩm đã chỉ định: thì một trong các trường hợp sau sẽ xảy ra:
    • Nhóm : Xảy ra lỗi "Không đủ giấy phép"
    • VIP: Tài khoản đã được thêm vào hồ sơ sản phẩm đã chỉ định. Tuy nhiên, do vượt quá hạn mức giấy phép nên các sản phẩm sẽ không khả dụng cho người dùng
    • ETLA: Tài khoản đã được thêm vào hồ sơ sản phẩm đã chỉ định. Người dùng có quyền truy cập vào các sản phẩm được chỉ định. Số tiền bạn phải thanh toán có thể thay đổi khi gia hạn

Adobe ID

  • Bạn đã tạo tài khoản với địa chỉ email được cung cấp.
  • Tài khoản được thêm vào cấu hình sản phẩm đã chỉ định.
  • Email chào mừng sẽ được gửi đến người dùng nếu bạn bật tùy chọn Thông báo cho người dùng qua email trong phần Chỉnh sửa hồ sơ sản phẩm.

 

  • Đã có lời mời đang được xử lý hoặc tài khoản có email đã tồn tại.
  • Quốc gia chưa nằm trong danh sách cung cấp dịch vụ của Adobe (nếu có)*
  • Tùy thuộc vào loại hình của tổ chức hoặc hợp đồng, nếu không có đủ giấy phép thông qua hồ sơ sản phẩm đã chỉ định: thì một trong các trường hợp sau sẽ xảy ra:
    • Nhóm : Xảy ra lỗi "Không đủ giấy phép"
    • VIP: Tài khoản đã được thêm vào hồ sơ sản phẩm đã chỉ định. Tuy nhiên, do vượt quá hạn mức giấy phép nên các sản phẩm sẽ không khả dụng cho người dùng
    • ETLA: Tài khoản đã được thêm vào hồ sơ sản phẩm đã chỉ định. Người dùng có quyền truy cập vào các sản phẩm được chỉ định. Số tiền bạn phải thanh toán có thể thay đổi khi gia hạn

 

Cảnh báo:

Dịch vụ và phần mềm mà Adobe cung cấp nằm dưới sự kiểm soát của luật xuất khẩu của Hoa Kỳ, luật này hạn chế việc xuất khẩu và sử dụng các dịch vụ và phần mềm của Adobe tại một số khu vực nhất định, bao gồm nhưng không giới hạn ở Cuba, Iran, Bắc Triều Tiên, Sudan, Syria và khu vực Crimea của Ukraine.

Lưu ý:

Tính năng Thêm người dùng không hỗ trợ biệt danh người dùng có các ký tự đặc biệt như dấu phẩy (,) hoặc dấu chấm phẩy (;).

Thông tin chi tiết về hiệu suất

Quy tắc chu kỳ nhiệm vụ 66,6% được áp dụng trong quá trình xử lý để tránh hiện tượng quá tải.  Nếu thời gian xử lý một mục nhập chênh lệch hơn 10% so với thời gian trung bình thì tốc độ sẽ được điều chỉnh sao cho việc xử lý yêu cầu chỉ tiêu tốn 2/3 thời gian thực.

Ngoài ra, nhóm vận hành cũng quản lý cơ chế điều tiết để giới hạn tốc độ xử lý.  Nếu cơ chế điều tiết được thiết lập rõ ràng thì cơ chế điều khiển chu kỳ nhiệm vụ sẽ bị vô hiệu hóa. Lệnh gọi API sẽ chuyển về lại chế độ điều tiết dựa trên chu kỳ nhiệm vụ.

Số lượng yêu cầu được xử lý mỗi giây sẽ được hiển thị để phản hồi thông tin về hiệu suất.

Tốc độ mục tiêu để tạo 1000 tài khoản, mỗi tài khoản được thêm vào 2 cấu hình sản phẩm là 1 tài khoản/giây, không tính chu kỳ nhiệm vụ 66,6%, do đó tốc độ xử lý biểu kiến có thể là 0,66 tài khoản/giây hoặc khoảng 40 tài khoản/phút.  Với tốc độ này thì sẽ tốn 25 phút để tạo 1000 tài khoản.  Còn khi tạo 5000 tài khoản, hệ thống sẽ tốn hai tiếng và năm phút.

Khắc phục sự cố

Các mục Xử lý sự cố sẽ giúp bạn khắc phục lỗi hoặc các vấn đề khác có thể phát sinh khi sử dụng chức năng nhập hàng loạt của Adobe Admin Console.

Lỗi khi tải lên

Việc tải lên tệp có thể không thành công nếu bạn không đáp ứng một số điều kiện cần thiết.

Thông báo lỗi sẽ được hiển thị trong các trường hợp sau:

  • Tệp không phải là định dạng CSV.
  • Tiêu đề cột bắt buộc (ví dụ: Email) không hợp lệ hoặc bị thiếu.
  • Thiếu cột bắt buộc.

Hãy thực hiện các bước sau:

  • Chỉ sử dụng tệp có định dạng .csv.
  • Đảm bảo tiêu đề cột là hợp lệ.
  • Đảm bảo rằng các giá trị của cột là hợp lệ.

Để biết thêm thông tin về các trường bắt buộc hoặc tùy chọn và định dạng tệp, vui lòng tham khảo bảng Định dạng tệp CSV trong trang Quản lý người dùng.

Cách khắc phục sự cố về định dạng dữ liệu trong tệp CSV:

  1. Mở tệp CSV trong Microsoft Excel.

  2. Chọn (tô sáng) bất kỳ cột nào có chứa dữ liệu trong trang tính.

  3. Vào tab Dữ liệu và nhấp vào Chuyển văn bản thành cột.

  4. Trong hộp thoại hiển thị, tiếp tục nhấp vào Tiếp theo cho đến khi nút Tiếp theo bị vô hiệu hóa và nút Hoàn tất được bật.

  5. Nhấp vào nút Hoàn tất rồi lưu và đóng tệp.

  6. Tải tệp CSV đã cập nhật lên Admin Console.

Thông báo lỗi sẽ được hiển thị trong trường hợp sau:

  • Khi có đủ tiêu đề cột bắt buộc (ví dụ: Email) nhưng thiếu giá trị hàng tương ứng.

Hãy đảm bảo rằng bạn đã nhập các giá trị tương ứng cho mỗi hàng.

Lỗi xử lý

Lỗi xử lý sẽ xảy ra khi hệ thống không thể xử lý các hàng dữ liệu trong tệp đã tải lên. Để biết thêm thông tin chi tiết, vui lòng tham khảo bài viết Kết quả hành động hàng loạt.

Nguyên nhân

Lỗi INTERNAL_SERVER_ERROR xuất hiện do cổng kết nối hết thời gian chờ. Lỗi INTERNAL_SERVER_ERROR sẽ hiển thị trong cột TRẠNG THÁI trên màn hình kết quả lỗi.

Giải pháp

Bạn có thể thử lại sau.

Nguyên nhân

Nếu bạn thêm lại người dùng hiện có mà không thực hiện bất kỳ thay đổi nào, thì thông báo Người dùng đã được thêm sẽ hiển thị trong cột TRẠNG THÁI trên màn hình kết quả lỗi.

Người dùng đã được thêm

Giải pháp

Hãy đảm bảo rằng bạn không thêm lại người dùng đã được thêm trước đó. Xóa các hàng có chứa thông tin của người dùng hiện tại.

Nguyên nhân

Lỗi này xảy ra trong các thư mục liên quan đến Azure Sync hoặc Google Sync. Việc quản lý người dùng được nhà cung cấp danh tính thực hiện.

Giải pháp

Chúng tôi khuyên bạn nên chỉnh sửa và quản lý dữ liệu đã đồng bộ hóa trên cổng thông tin của nhà cung cấp danh tính và cho phép các thay đổi được đồng bộ hóa. Chỉ nên thay đổi dữ liệu theo cách thủ công trong Admin Console trong trường hợp thực sự cần thiết.

Nguyên nhân

Nếu tiêu đề cột bắt buộc (ví dụ: Email) đã có nhưng giá trị hàng tương ứng bị thiếu, thì thông báo Lỗi phân tích dữ liệu sẽ hiển thị trong cột TRẠNG THÁI trên màn hình kết quả. 

Lỗi phân tích

Giải pháp

Hãy đảm bảo rằng bạn đã nhập các giá trị tương ứng cho mỗi hàng.

Nguyên nhân

Lỗi xảy ra đối với người dùng có Enterprise ID hoặc Federated ID nếu tên miền không đáp ứng các tiêu chí sau:

  • Có tên miền hợp lệ trong cột Tên miền
  • ID email có tên miền hợp lệ
  • Tên người dùng có tên miền hợp lệ

Thông báo Không tìm thấy tên miền trong tổ chức của bạn sẽ hiển thị trong cột TRẠNG THÁI trên màn hình kết quả.

Lưu ý:

Lỗi xảy ra khi bạn sử dụng tên miền không hợp lệ, điều đó có nghĩa là tên miền đó chưa được đăng ký hoặc không được tổ chức của bạn tin cậy.

Giải pháp

Hãy thực hiện các bước sau:

  • Nhập Tên miền hợp lệ vào cột Tên miền .
  • Nhập ID email hợp lệ dựa trên Phân loại danh tính.
  • Nhập tên người dùng hợp lệ dựa trên Phân loại danh tính.

Nguyên nhân

Lỗi này xảy ra nếu tổ chức của bạn không sở hữu tên miền mà bạn muốn thêm người dùng vào.

Giải pháp

Để thêm người dùng vào tên miền, bạn có thể thực hiện một trong những thao tác sau:

Nguyên nhân

Lỗi xảy ra đối với người dùng có Enterprise ID hoặc Federated ID nếu Tiêu đề mã quốc gia, giá trị dữ liệu hoặc cả hai trường đều bị thiếu.

Thông báo "Mã quốc gia phải gồm 2 ký tự theo ISO-3166" được hiển thị trong cột TRẠNG THÁI trên màn hình kết quả.

Lỗi mã quốc gia

Giải pháp

Hãy đảm bảo rằng bạn đã nhập hợp lệ tiêu đề cột Mã quốc gia và các giá trị hàng tương ứng.

Nguyên nhân

Lỗi này xảy ra khi tổ chức của bạn đã cập nhật Mô hình lưu trữ doanh nghiệp và bạn đã nhập loại danh tính Adobe ID vào tệp CSV.

Giải pháp

Bạn phải chọn Enterprise ID hoặc Federated ID làm ID người dùng.

Nguyên nhân

Lỗi này thường xảy ra khi Tên người dùng trong tệp CSV không tương ứng với bất kỳ người dùng nào trong Admin Console của tổ chức. Lỗi này xuất hiện trong quá trình thực hiện các thao tác với người dùng hiện có trong Adobe Admin Console.

Người dùng không có trong tổ chức

Giải pháp

Quản trị viên cần xác thực xem giá trị Tên người dùng được cung cấp trong trường CSV đã tồn tại trong thông tin người dùng có trong Adobe Admin Console hay chưa.

Nguyên nhân

Lỗi này chỉ xảy ra trong quá trình chuyển đổi danh tính người dùng. Trong tệp CSV, tên người dùng được cung cấp đã khớp, nhưng email không khớp với email trong thư mục của Admin Console.

Email phải khớp

Giải pháp

Hãy đảm bảo rằng email khớp với tên miền được xác định cho thư mục trong Admin Console.

Nếu bạn vẫn gặp sự cố khi thêm hàng loạt người dùng, vui lòng tạo trường hợp hỗ trợ, bắt đầu trò chuyện hoặc quản lý trường hợp hiện có trong Admin Console Support (tab Hỗ trợ của Admin Console) nếu bạn là quản trị viên Hệ thống hoặc Hỗ trợ.

Để biết thêm thông tin về sự trợ giúp, vui lòng tham khảo bài viết Tạo trường hợp hỗ trợ

Adobe, Inc.

Nhận trợ giúp nhanh chóng và dễ dàng hơn

Bạn là người dùng mới?