Đăng nhập vào Global Admin Console. Trong thẻ Organizations , hãy sử dụng bộ chọn tổ chức để Chọn cấu trúc phân cấp tổ chức nơi bạn muốn thực hiện xuất dữ liệu. Dữ liệu cho tất cả các tổ chức trong cấu trúc phân cấp được xuất.
Tìm hiểu cách quản trị viên toàn cầu có thể tối ưu hóa việc quản lý tổ chức và sản phẩm bằng các tính năng xuất và nhập trong Global Admin Console.
Truy cập tab Tổ chức trong Global Admin Console để xuất hoặc nhập cấu trúc tổ chức và chuyển đến tab Phân bổ sản phẩm để xem dữ liệu phân bổ. Sử dụng biểu tượng Thêm tùy chọn để chọn xuất hoặc nhập.
Xuất cấu trúc tổ chức
Với tư cách là quản trị viên toàn cầu, bạn có thể xuất hệ thống phân cấp tổ chức. Bạn có thể tải xuống biểu diễn JSON, CSV hoặc XLSX của toàn bộ hệ thống phân cấp tổ chức hoặc một phần của nó. Sau đó, bạn có thể sử dụng dữ liệu này để phân tích hoặc thực hiện các sửa đổi.
Định dạng xuất được chọn sẽ ảnh hưởng đến cấu trúc của dữ liệu được xuất.
- Định dạng CSV chỉ cho phép xuất một loại dữ liệu tại một thời điểm. Khi xuất hồ sơ sản phẩm ở định dạng CSV, các hồ sơ và tài nguyên được kết hợp thành một bảng. Có nhiều mục trong hồ sơ sản phẩm, mỗi tài nguyên một mục.
- Định dạng XLSX khiến từng chi tiết tổ chức hiển thị trong một sheet riêng biệt.
Các bản ghi được kết nối giữa các loại đối tượng khác nhau bằng id tham chiếu. Trong một số trường hợp, có thể có nhiều hàng cho một đối tượng cụ thể, chẳng hạn như trong trường hợp đối tượng Tài nguyên khi có một tập hợp các giá trị liên quan đến tài nguyên nhất định.
- Định dạng JSON là linh hoạt nhất. Định dạng này có thể tận dụng các mối quan hệ cấu trúc giữa các đối tượng được xuất. Ví dụ, các sản phẩm trong tổ chức xuất hiện trực tiếp trong phần tử tổ chức. Các trường giống nhau được xuất trong cả ba định dạng nhưng một số giá trị thừa trong định dạng JSON.
Chọn biểu tượng More Options và chọn Export.
Trong hộp thoại Export , hãy chọn nội dung cần xuất và định dạng để xuất dữ liệu.
Chọn Export. Tập tin xuất có thể mất vài phút để tạo. Sau khi hoàn tất, để tải xuống báo cáo, hãy điều hướng đến Global Admin Console > Insights > Export Reports. Tìm hiểu thêm về tính năng Export Reports.
Các tập tin JSON được xuất ở định dạng zip. Bạn có thể mở chúng bằng tiện ích zip hoặc các tính năng zip của hệ điều hành.
Sau khi tải xuống tập tin, bạn có thể thao tác với dữ liệu, sau đó nhập lại. Các bản cập nhật được nhập sẽ xuất hiện trong Global Admin Console như thể bạn đã chỉnh sửa dữ liệu thủ công.
Nhập cấu trúc tổ chức
Với tư cách là quản trị viên toàn cục, bạn có thể nhập dữ liệu đã được chỉnh sửa.Khi được tải lên, dữ liệu mới được so sánh với dữ liệu hiện tại và mọi thay đổi được áp dụng cho cấu trúc phân cấp tổ chức. Tất cả các thao tác nhập được thực hiện trên bản sao đã cập nhật của cấu trúc phân cấp tổ chức. Nếu bạn có bất kỳ thay đổi nào đang chờ xử lý, các thay đổi nhập sẽ được thêm vào trên cùng các thay đổi đang chờ xử lý trong cấu trúc phân cấp.
Đăng nhập vào Global Admin Console. Trong tab Organizations , sử dụng trình chọn tổ chức để Chọn hệ thống phân cấp tổ chức mà bạn muốn thực hiện nhập dữ liệu.
Chọn biểu tượng More Options
và chọn Import.Tùy thuộc vào kích thước và độ phức tạp của tệp nhập, quá trình xử lý có thể mất từ vài giây đến vài phút.
Chọn Select a file, và chọn tệp JSON, CSV, hoặc XLSX để tải lên.Đối với CSV, chỉ có thể nhập thông tin của một tổ chức tại một thời điểm và không hỗ trợ nhập sản phẩm.
Những thay đổi đã nhập xuất hiện như thể bạn đã chỉnh sửa dữ liệu thủ công.
Chọn Đóng.
Chọn Xem lại các thay đổi đang chờ xử lý.Sau đó, Chọn Submit Changes để thực thi chúng.
Trước khi thực thi các thay đổi, các hành động đang chờ xử lý được hiển thị theo cách tương tự như khi chỉnh sửa thủ công trong Global Admin Console.
Xuất và nhập lược đồ
Khi nhập dữ liệu bằng tập tin CSV, các trường có thể xuất hiện theo thứ tự bất kỳ nhưng phải luôn khớp với hàng tiêu đề tương ứng.
Khi nhập dữ liệu, bạn phải chỉ định một thao tác cho mỗi thành phần. Thao tác có thể là bất kỳ một trong những cái sau:
- Update: cho biết một chỉnh sửa.
- Create: chỉ ra việc tạo một đối tượng mới (ví dụ: tổ chức, nhóm người dùng hoặc quản trị viên).
- Delete: chỉ ra việc xóa một đối tượng (ví dụ: tổ chức, nhóm người dùng hoặc quản trị viên).
Bản ghi đầu vào không có hoặc trường thao tác trống sẽ bị bỏ qua.
| Tên trường | Mô tả | Ghi chú |
|---|---|---|
| id | ID Tổ chức. Khi thêm tổ chức mới, điều này có thể để trống hoặc đặt thành định danh giữ chỗ, ví dụ: new_org_1. Định danh giữ chỗ được sử dụng trong trường hợp các mục nhập khác được nhập cần tham chiếu đến tổ chức này. Sau khi tạo, id tổ chức thực tế sẽ được gán và thay thế tất cả các sử dụng của id tổ chức giữ chỗ. |
Có thể được đặt thành giá trị tạm thời khi operation=create |
| tên | Tên đơn giản của tổ chức. Độ dài tối thiểu 4, tối đa 100.Tên có thể chứa các ký tự UTF-8 lên đến 3-byte, không hỗ trợ ký tự 4-byte. |
Có thể được đặt hoặc cập nhật khi operation=create hoặc operation=update tương ứng |
| countryCode | Mã quốc gia hoặc khu vực | Phải được đặt khi operation=create, có thể được cập nhật khi operation=Update |
| type | Loại tổ chức | Chỉ đọc |
| parentOrgId | ID tổ chức mẹ. Để trống cho tổ chức gốc. Khi cập nhật, các hạn chế đáng kể được áp dụng bao gồm tổ chức mẹ mới phải ở cùng cây phân cấp và có các sản phẩm hiện có trong tổ chức. |
Có thể được đặt hoặc cập nhật khi operation=create hoặc operation=update tương ứng |
| adminCount | Số lượng quản trị viên | Chỉ đọc |
| domainCount | Số lượng miền | Chỉ đọc |
| userCount | Số lượng người dùng | Chỉ đọc |
| userGroupCount | Số lượng nhóm người dùng | Chỉ đọc |
| quản trị viên | Tập hợp các đối tượng quản trị đại diện cho quản trị viên của tổ chức này |
Có thể bị thiếu nếu không được chọn để xuất. Hiển thị trong tab riêng biệt trong tập tin XLSX. |
| domains | Tập hợp các đối tượng miền đại diện cho các miền trong tổ chức này |
|
| products | Tập hợp các đối tượng sản phẩm đại diện cho sản phẩm trong tổ chức này |
|
| productProfiles | Tập hợp các đối tượng hồ sơ sản phẩm đại diện cho hồ sơ sản phẩm trong tổ chức này |
|
| userGroups | Tập hợp các đối tượng nhóm người dùng đại diện cho nhóm người dùng trong tổ chức này |
|
| orgPolicies | Cấu trúc đại diện cho các chính sách và giá trị của chúng | |
| operation | Một trong các tùy chọn: để trống, Tạo, Cập nhật hoặc Xóa. Hành động cần thực hiện khi nhập dữ liệu | Luôn để trống khi xuất. |
Yêu cầu nhập:
- Để cập nhật hoặc xóa, orgId phải tham chiếu đến một tổ chức hiện có trong hệ thống phân cấp của bạn.
- Nếu bạn đang tạo tổ chức mới, bạn có thể để trống trường orgId hoặc đặt thành id duy nhất mà bạn có thể tạo ra, chẳng hạn như new-1 hoặc new-2. Điều này cung cấp một id có thể được sử dụng để tham chiếu đến tổ chức sẽ được tạo.
- Mã quốc gia phải hợp lệ.
- orgId cho hoạt động Cập nhật và Xóa phải đã có trong hệ thống phân cấp tổ chức.
- orgId được đánh dấu là DELETE không được chọn làm parentOrgId cho các tổ chức có hoạt động Cập nhật hoặc Tạo .
- Các tổ chức con ở cùng cấp độ và cùng tổ chức cha không được có cùng orgNames.
- Để tạo một tổ chức hoặc cập nhật tên tổ chức, tên của tổ chức không được trùng với tên của tổ chức con hiện có cùng tổ chức cha.
| Tên trường | Mô tả | Sử dụng |
|---|---|---|
| orgId | Tham chiếu đến tổ chức mà quản trị viên thuộc về. | Được sử dụng làm tham chiếu để tìm các đối tượng chứa hoặc liên quan. |
| firstName | Tên của người dùng quản trị. Tên và Họ cho người dùng Adobe ID có thể được thay thế bằng giá trị do người dùng cung cấp khi người dùng chấp nhận lời mời. |
Có thể được thiết lập hoặc cập nhật khi operation=create hoặc operation=update tương ứng |
| lastName | Họ của người dùng quản trị | |
| Địa chỉ email của người dùng quản trị. Đây là khóa chính cho người dùng và phải là duy nhất. | ||
| countryCode | Mã quốc gia hoặc khu vực nơi người dùng hoạt động. Chỉ áp dụng cho các loại Federated và Enterprise ID. |
|
| userType | Một trong "Adobe ID", "Enterprise ID", hoặc "Federated ID". | Chỉ đọc |
| adminType | Một trong "GLOBAL ADMIN", "GLOBAL VIEWER", "SYSTEM ADMIN", "USER GROUP ADMIN", "PRODUCT ADMIN", "PRODUCT PROFILE ADMIN", "DEPLOYMENT ADMIN", và "STORAGE_ADMIN". | Có thể được thiết lập khi operation=Create |
| groupId | ID của nhóm mà người dùng này là quản trị viên.Chỉ áp dụng cho quản trị viên nhóm người dùng và hồ sơ sản phẩm. | |
| licenseId | ID giấy phép sản phẩm của sản phẩm mà người dùng này là quản trị viên. Chỉ liên quan đến quản trị viên sản phẩm. | |
| domain | Tên miền của người dùng nếu không sử dụng miền email | |
| userName | Tên người dùng nếu không sử dụng địa chỉ email | |
| operation | Một trong các giá trị trống, Create, Update hoặc Delete. Hành động thực hiện khi dữ liệu được nhập. |
Yêu cầu nhập khẩu:
- orgId, email, adminType và userType phải chứa các giá trị hợp lệ.
- countryCode phải hợp lệ.
- Nếu người dùng đã tồn tại và đang được cập nhật, userType phải khớp với người dùng.
- Kiểm tra địa chỉ email trùng lặp trong tổ chức.
Xuất và nhập hồ sơ sản phẩm gồm hai phần: chi tiết hồ sơ sản phẩm và tập hợp tài nguyên liên kết với hồ sơ sản phẩm. Các tài nguyên này xác định dịch vụ có thể được cấu hình, thường chỉ để bật hoặc tắt chúng.
- Các đối tượng tài nguyên được lồng trong hồ sơ sản phẩm ở định dạng JSON.
- Khi sử dụng CSV hoặc XLSX với hồ sơ sản phẩm, các hồ sơ và tài nguyên được kết hợp thành một bảng. Sẽ có nhiều mục cho hồ sơ sản phẩm, một mục cho mỗi tài nguyên.
- Trường "selected" trong tài nguyên kiểm soát việc dịch vụ có được bật hay không.
- Khi nhập hồ sơ sản phẩm, phải có thao tác Tạo hoặc Cập nhật trên chính hồ sơ sản phẩm đó và trên bất kỳ đối tượng tài nguyên nào sẽ được cập nhật hoặc tạo.
| Tên trường | Mô tả | Sử dụng |
|---|---|---|
| productProfileId | Mã định danh của hồ sơ sản phẩm Giá trị giữ chỗ có thể được sử dụng khi tạo để các đối tượng khác có thể tham chiếu đến hồ sơ mới. |
Có thể được đặt thành giá trị tạm thời khi operation=create |
| productProfileName | Tên của hồ sơ sản phẩm. Không thể trùng lặp với các hồ sơ sản phẩm khác hoặc nhóm người dùng trong cùng một tổ chức. |
Có thể được đặt hoặc cập nhật khi operation=create hoặc operation=update, tương ứng |
| productProfileDescription | Mô tả dạng văn bản cho hồ sơ sản phẩm | |
| licenseId | Tham chiếu ID giấy phép đến sản phẩm | Được sử dụng làm tham chiếu để tìm đối tượng chứa hoặc liên kết |
| orgId | Tổ chức chứa nhóm người dùng | |
| thông báo | Đúng hoặc sai để chỉ ra liệu thông báo email có nên được gửi cho người dùng khi họ được thêm vào hoặc xóa khỏi hồ sơ sản phẩm này | Có thể được đặt hoặc cập nhật khi operation=create hoặc operation=update, tương ứng |
| resources | Mảng tài nguyên được liên kết với hồ sơ sản phẩm này. Trường resources chỉ có trong định dạng JSON.Đối với định dạng CSV và XLSX, tài nguyên được biểu diễn bằng các trường bổ sung sau: resourceName, resourceId, resourceDescription, icon, selected, quota, resourceType. Để biết chi tiết về các trường này, xem Sản phẩm và Tài nguyên. Nếu hồ sơ sản phẩm có nhiều hơn một tài nguyên, sẽ có nhiều hàng xuất hiện, một cho mỗi tài nguyên. Các trường khác sẽ có cùng giá trị cho từng tài nguyên. |
|
| operation | Một trong số trống, Tạo, Cập nhật hoặc Xóa. Hành động thực hiện khi dữ liệu được nhập. |
Yêu cầu nhập:
- productProfileId, licenseId và orgId phải có giá trị hợp lệ.
- Khi tạo hồ sơ sản phẩm, productProfileName phải là tên hợp lệ và không được trùng lặp với tên hồ sơ sản phẩm khác hoặc tên nhóm người dùng khác trong cùng tổ chức.
- Trường quota phải có giá trị hợp lệ cho loại đơn vị. Đây là giá trị số hoặc "unlimited" khi resourceType=QUOTA hoặc để trống trong các trường hợp khác.
- Trường notification phải là true hoặc false.
- Đối với việc nhập CSV và XLSX, xác thực productProfileId, tất cả các mục nhập của nó phải có cùng orgId, licenseId và productProfileName.
- Xác thực productProfileName trùng lặp trong tập tin đầu vào và tổ chức.
- Hồ sơ cần được cập nhật và xóa phải có mặt trong tổ chức.
- Tài nguyên cần được cập nhật và xóa (hủy kích hoạt) phải có mặt trong hồ sơ.
- Đối với hồ sơ cần được tạo, đảm bảo những điều sau:
- OrgId nên là tổ chức mới hoặc tổ chức hiện có.
- LicenseId nên là sản phẩm mới hoặc sản phẩm hiện có.
- Xác thực tài nguyên cho hồ sơ.
Tài nguyên trong hồ sơ sản phẩm:
| Tên trường | Mô tả | Sử dụng |
|---|---|---|
| resourceName | Tên của tài nguyên | Chỉ đọc |
| resourceId | Định danh của tài nguyên | Chỉ đọc |
| resourceDescription | Mô tả văn bản của tài nguyên | Chỉ đọc |
| biểu tượng | URL đến hình ảnh cho tài nguyên | Chỉ đọc |
| đã chọn | Đối với mục nhập cấu hình, liệu tính năng có được bật hay không.Trường này chỉ có mặt trong JSON. |
Có thể được thiết lập hoặc cập nhật khi operation=create hoặc operation=update, tương ứng |
| hạn ngạch | Số lượng tài nguyên chính có thể được cấp cho người dùng thông qua hồ sơ sản phẩm này.Trường này chỉ có mặt trong JSON. |
|
| resourceType | Nếu có mặt, giá trị là SERVICE.Điều này cho biết tài nguyên này đại diện cho một dịch vụ có thể được bật hoặc tắt dựa trên giá trị của trường đã chọn.Trường này chỉ có mặt trong JSON. |
Chỉ đọc |
| thao tác | Một trong số trống, Create, Update hoặc Delete.Hành động thực hiện khi dữ liệu được nhập. |
Yêu cầu nhập:
Trường operation trên tài nguyên bị bỏ qua khi hồ sơ sản phẩm mà chúng thuộc về có operations được thiết lập là Delete hoặc Create.
- Không tài nguyên nào nên được đánh dấu để xóa, đây là thao tác không hợp lệ.
- Để tạo hồ sơ sản phẩm, số lượng tài nguyên phải khớp với số lượng tài nguyên của hồ sơ sản phẩm nguồn.
- Đối với tài nguyên có thao tác Cập nhật , tài nguyên phải có trong hồ sơ sản phẩm.
| Tên trường | Mô tả | Sử dụng |
|---|---|---|
| userGroupId | Định danh của nhóm người dùng Giá trị giữ chỗ có thể được sử dụng khi tạo để các đối tượng khác có thể tham chiếu đến nhóm người dùng mới. |
Có thể đặt thành giá trị tạm thời khi operation=create |
| userGroupName | Tên của nhóm người dùng | Có thể đặt hoặc cập nhật khi operation=create hoặc operation=update tương ứng |
| userGroupDescription | Mô tả dạng văn bản cho nhóm người dùng | |
| userCount | Số lượng người dùng trong nhóm người dùng | Chỉ đọc |
| hồ sơ | Mảng các id hồ sơ sản phẩm mà nhóm người dùng được liên kết. XLSX có một hàng cho mỗi giá trị với các giá trị giống nhau cho các trường khác. |
Có thể đặt hoặc cập nhật khi operation=create hoặc operation=update tương ứng |
| orgId | Tổ chức chứa nhóm người dùng | Được sử dụng như một tham chiếu để tìm đối tượng chứa hoặc có liên kết. |
| operation | Một trong các giá trị trống, Create, Update hoặc Delete.Hành động thực hiện khi dữ liệu được nhập. |
Yêu cầu nhập:
- orgId phải tham chiếu đến một tổ chức hiện có hoặc một tổ chức đang được tạo trong cùng một lần nhập.
- userGroupId phải tham chiếu đến một nhóm hiện có để cập nhật hoặc xóa, và có thể là một id bạn định nghĩa cho các nhóm người dùng mới.
- Để cập nhật hoặc tạo, userGroupNameorganization không được để trống và không được trùng lặp với tên nhóm người dùng hoặc hồ sơ sản phẩm khác trong cùng một tổ chức.
- Đảm bảo userGroupName không trùng lặp trong tập tin đầu vào và tổ chức.
- Các userGroups cần được cập nhật hoặc xóa phải có mặt trong tổ chức.
- Hồ sơ cần được loại bỏ khỏi nhóm người dùng phải có mặt trong nhóm người dùng.Các thao tác cập nhật không thể được thực hiện trên hồ sơ của một nhóm người dùng.
- Đối với các nhóm người dùng cần được tạo, hãy đảm bảo những điều sau:
- orgId phải là một tổ chức mới hoặc một tổ chức hiện có.
- licenseId, nếu có, phải là một sản phẩm mới hoặc một sản phẩm hiện có.
- productProfileId phải là một hồ sơ sản phẩm mới hoặc một hồ sơ sản phẩm hiện có.
Thông tin miền cung cấp thông tin chỉ đọc về các miền có sẵn trong mỗi tổ chức.Dữ liệu này không thể chỉnh sửa được.
|
Tên trường |
Mô tả |
Sử dụng |
|---|---|---|
|
orgId |
Tham chiếu đến tổ chức trong đó miền này được liệt kê |
Được sử dụng như một tham chiếu để tìm các đối tượng chứa hoặc liên quan. |
|
domainName |
Tên của miền, ví dụ, adobe.com. |
Chỉ đọc |
|
directoryName |
Tên của thư mục trong đó miền được liệt kê |
Chỉ đọc |
|
directoryType |
Một trong các loại Federated ID hoặc Enterprise ID. |
Chỉ đọc |
|
domainStatus |
Một trong "ACTIVE", "RESERVED", "UNCLAIMED", "CLAIMED", "VALIDATED", "WITHDRAWN", "ACTIVE", "EXPIRED". |
Chỉ đọc |
Trong các tập tin XLSX, có hai trang tính – một cho sản phẩm và một cho tài nguyên. Trong JSON, các đối tượng tài nguyên được lồng trong đối tượng sản phẩm.
Sản phẩm:
| Tên trường | Mô tả | Sử dụng |
|---|---|---|
| licenseId | id xác định sản phẩm. Mỗi sản phẩm có một id giấy phép duy nhất trong tổ chức mà sản phẩm được liệt kê. ID giấy phép cho cùng một sản phẩm sẽ khác nhau ở các tổ chức khác nhau.Khi thêm sản phẩm mới, trường này có thể để trống hoặc sử dụng một định danh tạm thời, ví dụ: new_product_1. Định danh tạm thời được sử dụng trong trường hợp các mục nhập khác cần tham chiếu đến phiên bản sản phẩm này. Sau khi tạo, một id giấy phép thực tế sẽ được gán để thay thế tất cả việc sử dụng id giấy phép tạm thời. |
Có thể được đặt thành giá trị tạm thời khi operation=create |
| productName | Tên sản phẩm | Chỉ đọc |
| productDescription | Mô tả sản phẩm bằng văn bản | Chỉ đọc |
| allowOverallocation | Boolean cho biết liệu việc phân bổ quá mức của phiên bản sản phẩm này có được phép hay không. Phân bổ quá mức đề cập đến khả năng cấp số lượng nhiều hơn cho tổ chức con so với số lượng bạn đã được cấp. |
Có thể thiết lập hoặc cập nhật khi operation=create hoặc operation=update tương ứng |
| biểu tượng | URL của biểu tượng sản phẩm | Chỉ đọc |
| sourceLicenseId | Id giấy phép của phiên bản sản phẩm trong tổ chức mà sản phẩm này được phân bổ từ đó. Giá trị là null nếu phiên bản này không phải là sản phẩm được phân bổ mà là sản phẩm đã mua. | Có thể thiết lập khi operation=Create |
| productId | Định danh của sản phẩm. | Chỉ đọc |
| orgId | Định danh của tổ chức chứa phiên bản sản phẩm này | Được sử dụng như một tham chiếu để tìm đối tượng chứa hoặc liên quan. |
| redistributable | Giá trị Boolean cho biết sản phẩm này có tài nguyên có thể cấp cho các tổ chức con hay không. | Chỉ đọc |
| resources | đối tượng chứa một tập hợp các đối tượng tài nguyên đại diện cho các tài nguyên và thiết đặt trong sản phẩm này | |
| thao tác | Một trong các giá trị: trống, Create, Update hoặc Delete.Hành động thực hiện khi dữ liệu được nhập. |
Yêu cầu nhập:
- Đối với create, licenseId phải là id duy nhất do bạn tạo.
- Đối với update, licenseId phải là id của sản phẩm hiện có trong tổ chức được chỉ định.
- orgId phải tham chiếu đến một tổ chức hiện có hoặc tổ chức đang được tạo trong cùng một thao tác nhập.
- Đối với thao tác tạo, sourceLicenseId phải tham chiếu đến sản phẩm hiện có hoặc id bạn đã định nghĩa cho sản phẩm đang được tạo trong cùng một thao tác nhập.
- licenseId và sourceLicenseId không được giống nhau đối với các sản phẩm có thao tác Tạo.
- Xác thực tổ chức của các sản phẩm, tổ chức phải là tổ chức mới hoặc phải đã có trong hệ thống phân cấp tổ chức.
- Đối với thao tác Cập nhật và Xóa, sản phẩm phải đã có trong hệ thống phân cấp tổ chức.
- licenseId được đánh dấu là Xóa không được sử dụng làm sourceLicenseId của các sản phẩm có thao tác Tạo và Cập nhật.
- Đối với các sản phẩm có thao tác Tạo, xác thực rằng sourceLicenseId phải có trong tổ chức cha.
Tài nguyên cho sản phẩm:
Các đối tượng tài nguyên có thể xuất hiện trong sản phẩm và trong hồ sơ sản phẩm.
| Tên trường | Mô tả | Sử dụng |
|---|---|---|
| resourceName | Tên của tài nguyên | Chỉ đọc |
| resourceId | Mã định danh của tài nguyên | Chỉ đọc |
| resourceDescription | Mô tả văn bản của tài nguyên | Chỉ đọc |
| icon | URL đến hình ảnh cho tài nguyên | Chỉ đọc |
| productName | Tên sản phẩm mà tài nguyên này là một phần. | Chỉ đọc |
| licenseId | ID giấy phép (thực thể sản phẩm) của sản phẩm mà tài nguyên này là một phần của. | Được sử dụng làm tham chiếu để tìm đối tượng chứa hoặc liên kết. |
| grantedQuantity | Số lượng được cấp của tài nguyên này: số lượng tài nguyên mà tổ chức này có sẵn để sử dụng cục bộ hoặc phân bổ cho các tổ chức con. | Có thể được thiết lập hoặc cập nhật khi operation=create hoặc operation=update tương ứng |
| unit | Tên đơn vị của số lượng cấp phát. | Chỉ đọc |
| currentQuantity | Số lượng có thể sử dụng hiện tại trong tổ chức này. Đây là grantedQuantity trừ đi các tài nguyên được phân bổ cho các tổ chức con. Đây là giá trị được hiển thị trong Admin Console cho sản phẩm/tài nguyên này. | Chỉ đọc |
| provisionedQuantity | Số lượng thực sự được cung cấp: có thể ít hơn số lượng cấp phát hoặc số lượng hiện tại, có thể ít hơn currentQuantity nếu có một số hạn chế được áp dụng. | Chỉ đọc |
| operation | Một trong các giá trị: để trống, Create, Update hoặc Delete.Hành động cần thực hiện khi dữ liệu được nhập. |
Yêu cầu nhập:
Trường Operation trên tài nguyên sẽ bị bỏ qua khi sản phẩm mà chúng thuộc về có các thao tác được thiết lập là Delete hoặc Create.
- Không có tài nguyên nào được đánh dấu để xóa, đây là một thao tác không hợp lệ.
- Đối với các sản phẩm được tạo, số lượng tài nguyên phải khớp với số lượng tài nguyên của sản phẩm nguồn.
- Đối với các tài nguyên có thao tác Update , tài nguyên phải tồn tại trong sản phẩm.
Nhập và xuất dữ liệu phân bổ sản phẩm
Với tư cách là Global Administrator, bạn có thể xuất dữ liệu phân bổ sản phẩm dưới dạng tập tin JSON hoặc CSV. Sau đó, bạn có thể điều chỉnh dữ liệu này và tải lên lại để nhập các thay đổi. Khi dữ liệu có khả năng đã được sửa đổi được tải lên, dữ liệu mới sẽ được so sánh với dữ liệu hiện tại và mọi thay đổi sẽ được áp dụng vào dữ liệu phân bổ sản phẩm. Sau đó, bạn có thể xem xét và gửi các thay đổi đang chờ xử lý để chúng có hiệu lực.
Xuất mô hình phân bổ sản phẩm
Để xuất mô hình phân bổ sản phẩm, hãy thực hiện các bước sau:
- Đăng nhập vào Global Admin Console và điều hướng đến tab Product Allocation .
- Chọn biểu tượng More Options
và Chọn Export CSV hoặc Export JSON. Tập tin của bạn được tải xuống. Tìm hiểu thêm về các định dạng xuất.
Nhập mô hình phân bổ sản phẩm
Bạn có thể xuất dữ liệu, sửa đổi và sau đó nhập tập tin đã được sửa đổi. Để nhập mô hình phân bổ sản phẩm, hãy thực hiện các bước sau:
- Đăng nhập vào Global Admin Console và điều hướng đến tab Product Allocation .
- Chọn biểu tượng More Options
và Chọn Import. - Chọn tập tin JSON hoặc CSV để tải lên.
- Chọn Review Pending Changes. Sau khi xem xét, chọn Submit Changes để thực thi chúng.
Định dạng xuất và nhập cho phân bổ sản phẩm
Định dạng xuất và nhập là giống nhau. Khi nhập dưới định dạng CSV, các trường có thể xuất hiện theo bất kỳ thứ tự nào nhưng phải luôn khớp với hàng tiêu đề của chúng.Khi nhập dưới định dạng JSON, các trường có thể xuất hiện theo bất kỳ thứ tự nào.
Bạn phải chỉ định thao tác khi nhập dữ liệu phân bổ sản phẩm. Thao tác có thể là một trong những cách sau:
- Cập nhật: cho biết việc chỉnh sửa (thay đổi grantedQuantity, allowOverAllocation values).
- Tạo: cho biết việc thêm tài nguyên sản phẩm vào tổ chức được chỉ định.
- Xóa: cho biết việc xóa sản phẩm.
Nếu không có thao tác nào được đưa ra, thì sẽ không có thay đổi nào xảy ra khi dữ liệu được nhập cho hàng đó trong CSV hoặc đối tượng trong JSON.
Trong tập tin đã xuất, có một hàng hoặc bản ghi cho mỗi tài nguyên sản phẩm. Một số sản phẩm có nhiều hơn một tài nguyên.
Nếu một sản phẩm có nhiều hơn một tài nguyên, thao tác Cập nhật có thể áp dụng cho các tài nguyên độc lập, thao tác Xóa sẽ xóa sản phẩm bao gồm tất cả tài nguyên khỏi tổ chức, và thao tác Tạo cần một bản ghi cho mỗi tài nguyên trong tập tin nhập để có thể chỉ định số lượng thích hợp cho từng tài nguyên. Trường allowOverAllocation áp dụng cho toàn bộ sản phẩm và việc cập nhật trường này ở tài nguyên nào không quan trọng.
| Tên trường | Mô tả | Sử dụng |
|---|---|---|
| productName | Tên của sản phẩm. | Chỉ đọc |
| licenseId | ID của sản phẩm (duy nhất trong một tổ chức). Khi thêm sản phẩm mới, mục này có thể để trống hoặc đặt thành một định danh tạm thời, ví dụ: new_product_1. Định danh tạm thời được sử dụng trong trường hợp các mục nhập khác cần tham chiếu đến sản phẩm này. Sau khi tạo, một license id thực tế sẽ được gán và thay thế tất cả việc sử dụng license id tạm thời. |
Có thể được thiết lập khi operation=Create |
| sourceLicenseId | Id của sản phẩm gốc. Trống hoặc null nếu điều này đại diện cho một giao dịch mua thay vì phân bổ. | Có thể được thiết lập khi operation=Create |
| productId | Id xác định lớp sản phẩm này. Id này được chia sẻ giữa các sản phẩm cùng loại và khác với licenseId xác định một phiên bản của sản phẩm này. | Chỉ đọc |
| resourceName | Tên của tài nguyên sản phẩm này. Ví dụ, Giấy phép người dùng. | Chỉ đọc |
| resourceId | Id xác định tài nguyên sản phẩm này. | Có thể được thiết lập khi operation=Create |
| orgPathName | Đường dẫn của tổ chức chứa tài nguyên sản phẩm này. Các phần được phân cách bằng "/". | Chỉ đọc |
| orgName | Tên đơn giản của tổ chức chứa tài nguyên sản phẩm này. Đây là phần cuối cùng của orgPathName. | Chỉ đọc |
| orgId | Id tổ chức của tổ chức chứa tài nguyên sản phẩm này. | Có thể được thiết đặt khi operation=Create |
| grantedQuantity | Số lượng đơn vị tài nguyên được cấp cho tổ chức này bởi tổ chức gốc hoặc số lượng đã mua nếu mục nhập tài nguyên sản phẩm này đại diện cho một giao dịch mua. Trường này có thể cập nhật ngoại trừ các sản phẩm đã mua hoặc phân bổ gốc mà quản trị viên toàn cầu không có quyền thay đổi. |
Có thể cập nhật khi operation=Update hoặc operation=Create |
| đơn vị | Tên của đơn vị tài nguyên. Ví dụ: Người dùng. | Chỉ đọc |
| totalAllocations | Tổng số cấp phát cho các tổ chức con từ tổ chức này cho tài nguyên sản phẩm này. Giá trị này bao gồm các khoản cấp trực tiếp cho các tổ chức con trực tiếp cộng với phân bổ vượt mức từ các tổ chức đó. Ví dụ, nếu tổ chức này cấp cho một tổ chức con 10 và tổ chức con đó sau đó phân bổ cho tổ chức con của nó 25, thì totalAllocations sẽ là 25: 10 được cấp cho tổ chức con cộng với phần vượt mức 15 trong tổ chức con đó. | Chỉ đọc |
| grantOverage | Số lượng mà totalAllocations vượt quá grantedQuantity. Nếu totalAllocations không vượt quá grantedQuantity, giá trị này là null hoặc 0. | Chỉ đọc |
| localLicensedQuantity | Số lượng tài nguyên này được cấp cho tổ chức này còn lại để sử dụng sau khi trừ đi số lượng đã phân bổ cho các tổ chức con. Đây là số lượng hiển thị là có sẵn trong Admin Console. Giá trị này có thể bằng không nhưng không bao giờ âm ngay cả khi tổ chức này đã phân bổ vượt mức tài nguyên cho các tổ chức con của mình. | Chỉ đọc |
| localUsage | Số lượng đơn vị tài nguyên được sử dụng trong tổ chức này. Ví dụ, việc ủy quyền giấy phép Người dùng cho một người dùng sẽ được tính là 1 đơn vị sử dụng. | Chỉ đọc |
| totalUsage | Số lượng đơn vị tài nguyên được sử dụng bởi tổ chức này và tất cả tổ chức con. Điều này hiển thị việc sử dụng tài nguyên này trong phần cấu trúc phân cấp tổ chức có gốc từ tổ chức này. | Chỉ đọc |
| useOverage | Lượng tổng sử dụng vượt quá mức cấp phép của tổ chức (tổ chức và tổ chức con đã sử dụng nhiều tài nguyên hơn mức có sẵn). Điều này hiển thị giá trị khác không khi totalUsage vượt quá localLicensedQuantity, | Chỉ đọc |
| allowOverAllocation | Cho biết liệu người dùng có được phép cấp thêm tài nguyên cho tổ chức con mặc dù không còn tài nguyên để cấp (được phép cấp bất chấp việc vượt mức cấp phép) Giá trị này áp dụng cho tất cả tài nguyên của sản phẩm này. Nếu có nỗ lực cập nhật allowOverallocation cho nhiều hơn một tài nguyên của cùng một sản phẩm với các giá trị khác nhau, kết quả sẽ ngẫu nhiên. | Có thể được cập nhật khi operation=Update |
| isPurchasedProduct | true nếu sản phẩm là sản phẩm được mua (không được phân bổ bởi tổ chức cha).Điều này tương đương với sourceLicenseId có giá trị trống. | Chỉ đọc |
| redistributable | true nếu sản phẩm có thể được phân bổ cho tổ chức con, false có nghĩa là sản phẩm chỉ có sẵn trong tổ chức mà nó được hiển thị và tài nguyên không thể được phân bổ cho tổ chức khác. | Chỉ đọc |
| operation | Một trong các giá trị: trống, Create, Update hoặc Delete. Hành động thực hiện khi dữ liệu được nhập. |
Xác thực dữ liệu
- Trường operation phải có một thao tác hợp lệ.
- Dữ liệu nhập sản phẩm phải có thuộc tính và giá trị cho các trường bắt buộc.
- Các thuộc tính dữ liệu nhập sản phẩm phải đúng kiểu dữ liệu.
- Trường chính sách sản phẩm (overAllocation) không được cung cấp cho các tài nguyên khác nhau.
- Trường grantedQuantity:
- Không thể thay đổi thành không giới hạn nếu hiện không ở trạng thái không giới hạn.
- Phải là số nguyên không âm hoặc giá trị chuỗi không giới hạn.
Xác thực quyền truy cập/khả năng truy cập
- Tổ chức liên kết với dữ liệu nhập phải tồn tại.Nếu bạn đang cập nhật, hãy đảm bảo rằng sản phẩm và tài nguyên liên kết với dữ liệu nhập thực sự tồn tại.
Xác thực thêm sản phẩm
- SourceLicenseId phải tồn tại.
- Tổ chức liên kết với sản phẩm mới phải tồn tại.
- Sản phẩm đang được tạo không được tồn tại (sản phẩm có cùng licenseId).
- Các tài nguyên liên kết với sản phẩm đang được tạo phải có productId tương ứng trùng khớp với sản phẩm đó.