共享包 (数据管理)

摘要

通过将包上传到 ArcGIS Online 或 ArcGIS Enterprise 对其进行共享。

使用情况

• 以下为受支持的包类型：

  • 地理处理包（.gpk 和 .gpkx）
  • 图层包（.lpk 和 .lpkx）
  • 定位器包 (.gcpk)
  • 地图包（.mpk 和 .mpkx）
  • 切片包（.tpk 和 .tpkx）
  • 移动地图包 (.mmpk)
  • 移动场景包 (.mspk)
  • 场景图层包 (.slpk)
  • 矢量切片包 (.vtpk)
  • 工程包和工程模板（.ppkx 和 .aptx）

• 包文件大小限制为 500 GB。 有关详细信息，请参阅注意事项和限制。

  提示：

  如果您有大于 500 GB 的场景图层包并希望将其作为 web 场景图层发布到 ArcGIS Online，请将其添加到 3D 场景并作为 web 场景进行共享。 场景图层包将作为 Web 场景图层与 Web 场景一同发布。 如果您的场景中存在场景图层包，可以直接将其共享为 Web 场景图层。 右键单击该图层，指向共享菜单，然后单击共享为 Web 图层 。

• 在 ArcGIS Pro 中使用此工具时，您无法输入 ArcGIS Online 或 ArcGIS Enterprise 用户名和密码。 此工具将从 ArcGIS Pro 获取凭据。 您必须先登录并连接到 ArcGIS Online 或 ArcGIS Enterprise，然后才能使用此工具共享包。

• 将包共享至 ArcGIS Enterprise 10.9 或更早版本的门户时，需要摘要和一个或多个标签。 在线搜索这些包时，摘要和标签连同可选包的描述和制作者名单一起发挥作用。

• 如果 ArcGIS Online 或 ArcGIS Enterprise 组织中存在同名的包，则该包将被覆盖。

• 如果要共享切片包、场景图层包或矢量切片包，则可以将其自动发布为相应类型的 Web 图层。 （切片包将发布为 web 切片图层，场景图层包将发布为 web 场景图层，且矢量切片包将发布为矢量切片图层。）要成功发布 Web 图层，您必须在活动门户账户中拥有必要的权限。

• 要将包通过公共账户共享到 ArcGIS Online，需要将 Esri 全球账户注册为 ArcGIS Online 成员。 要创建和注册 Esri 全球账户，请转至 arcgis.com/home/signup.html。

参数

对话框

标注	说明	数据类型
输入包	输入图层（.lpk 或 .lpkx）、场景图层 (.slpk)、地图（.mpk 或 .mpkx）、地理处理（.gpk 或 .gpkx）、切片（.tpk 或 .tpkx）、移动地图 (.mmpk)、矢量切片 (.vtpk)、地址定位器 (.gcpk) 或工程（.ppkx 或 .aptx）包文件。	File
用户名	ArcGIS Online 或 Portal for ArcGIS 用户名。 此参数在地理处理窗格中不可用。 您必须通过应用程序顶部的登录选项登录到活动门户。	String
密码	ArcGIS Online 或 ArcGIS Enterprise 密码。 此参数在地理处理窗格中不可用。 您必须通过应用程序顶部的登录选项登录到活动门户。	Encrypted String
摘要 (可选)	包的摘要信息。 在 ArcGIS Online 或 ArcGIS Enterprise 上，摘要信息将显示在数据包的项目信息中。	String
标签 (可选)	用于描述和识别包的标记。 使用逗号分隔多个标签。	String
制作者 (可选)	包的制作者。 通常是创作和提供包内容的组织的名称。	String
共享给所有人 (公共) (可选)	指定是否将输入包共享并提供给公众。 选中 - 输入包将共享给公众。 任何人均可访问并进行查看。 未选中 - 输入包将共享给包的所有者及选中的任意群组。 这是默认设置。	Boolean
群组 (可选)	将与其共享包的群组。	String
仅在组织内共享 (可选)	指定输入包仅可用于组织内部还是公开共享给所有人。 选中 - 将仅在组织内部共享包。 未选中 - 将与公众共享包。 任何人均可访问并进行查看。 这是默认设置。	Boolean
发布 Web 图层 (可选)	指定是否将包作为 Web 图层发布到门户。 仅支持切片包、矢量切片包和场景图层包。 选中 - 包将被上传并发布为具有相同名称的 web 图层。 未选中 - 包将被上传且不被发布。 这是默认设置。	Boolean
文件夹 (可选)	包在门户上的现有文件夹或新文件夹的名称。 如果发布了 Web 图层，则系统会将其存储在此文件夹中。	String

派生输出

标注	说明	数据类型
工具已成功执行	上传包并发布 Web 图层（如果指定）的结果。 如果成功，则将返回 True。	Boolean
发布结果	包含 Web 图层的服务 URL 和门户项目 ID 的 JSON 响应。	String
包项目 ID	包的门户项目 ID。	String

Python

arcpy.management.SharePackage(in_package, username, password, {summary}, {tags}, {credits}, {public}, {groups}, {organization}, {publish_web_layer}, {portal_folder})

名称	说明	数据类型
in_package	输入图层（.lpk 或 .lpkx）、场景图层 (.slpk)、地图（.mpk 或 .mpkx）、地理处理（.gpk 或 .gpkx）、切片（.tpk 或 .tpkx）、移动地图 (.mmpk)、矢量切片 (.vtpk)、地址定位器 (.gcpk) 或工程（.ppkx 或 .aptx）包文件。	File
username	ArcGIS Online 或 ArcGIS Enterprise 用户名。 此参数已弃用，且其中应包含一个空字符串。 在运行 Python 脚本之前，您必须从应用程序登录到活动门户。 此外，您可以使用 SignInToPortal 函数进行登录。	String
password	ArcGIS Online 或 ArcGIS Enterprise 密码。 此参数已弃用，且其中应包含一个空字符串。 在运行 Python 脚本之前，您必须从应用程序登录到活动门户。 此外，您可以使用 SignInToPortal 函数进行登录。	Encrypted String
summary (可选)	包的摘要信息。 在 ArcGIS Online 或 ArcGIS Enterprise 上，摘要信息将显示在数据包的项目信息中。	String
tags (可选)	用于描述和识别包的标记。 使用逗号分隔多个标签。	String
credits (可选)	包的制作者。 通常是创作和提供包内容的组织的名称。	String
public (可选)	指定是否将输入包共享并提供给公众。 EVERYBODY—输入包将共享给公众。 任何人均可访问并进行查看。 MYGROUPS—输入包将共享给包的所有者及选中的任意群组。 这是默认设置。	Boolean
groups [group_name,...] (可选)	将与其共享包的群组。	String
organization (可选)	指定输入包仅可用于组织内部还是公开共享给所有人。 MYORGANIZATION—包将仅在组织内部共享。 EVERYBODY—包将共享给公众。 任何人均可访问并进行查看。 这是默认设置。	Boolean
publish_web_layer (可选)	指定是否将包作为 Web 图层发布到门户。 仅支持切片包、矢量切片包和场景图层包。 TRUE—包将被上传并发布为具有相同名称的 web 图层。 FALSE—包将被上传且不被发布。 这是默认设置。	Boolean
portal_folder (可选)	包在门户上的现有文件夹或新文件夹的名称。 如果发布了 Web 图层，则系统会将其存储在此文件夹中。	String

派生输出

名称	说明	数据类型
out_results	上传包并发布 Web 图层（如果指定）的结果。 如果成功，则将返回 True。	Boolean
publish_results	包含 Web 图层的服务 URL 和门户项目 ID 的 JSON 响应。	String
package_item_id	包的门户项目 ID。	String

代码示例

SharePackage 示例 1（Python 窗口）

以下脚本可将图层包上传到活动门户。

import arcpy
arcpy.management.SharePackage(r"C:\states.lpkx", "", "", 
                              "My Summary", "tag1, tag2", "My Credits", 
                              "MYGROUPS", "My Group")

SharePackage 示例 2（Python 窗口）

以下脚本可将切片包上传到活动门户并将其发布为 Web 图层。

import arcpy
arcpy.management.SharePackage(r"C:\states.tpk", "", "", 
                              "My Summary", "tag1, tag2", "My Credits", 
                              "MYGROUPS", "My Group", "MYORGANIZATION", "TRUE", 
                              "My Folder")

SharePackage 示例 3（独立脚本）

以下脚本可查找位于指定文件夹中的所有地图包，并将其上传到活动门户。

# Name: SharePackageExample.py
# Description:  Find all map packages that reside in a specified folder 
#               and upload them to the active portal.

# import system modules
import os
import arcpy

# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/data/my_packages" 

# Loop through the workspace to find all map packages 
for mpkx in arcpy.ListFiles("*.mpkx"):
    print("Uploading " + mpkx)
    arcpy.management.SharePackage(mpkx, "", "", 
                                  "My Summary", "tag1, tag2", 
                                  "My Credits", "MYGROUPS", "My Group")

环境

当前工作空间

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是