共享包 (数据管理)

摘要

通过将包上传到 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 AllSource 中使用此工具时，您无法输入 ArcGIS Online 或 ArcGIS Enterprise 用户名和密码。 此工具将从 ArcGIS AllSource 获取凭据。 您必须先登录并连接到 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
包项目 ID	包的门户项目 ID。	String
发布结果	包含 Web 图层的服务 URL 和门户项目 ID 的 JSON 响应。	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 (可选)	指定输入包仅可用于组织内部还是公开共享给所有人。 EVERYBODY—将包共享给所有人。 这是默认设置。 MYORGANIZATION—包将仅在组织内部共享。	Boolean
publish_web_layer (可选)	指定是否将包作为 Web 图层发布到门户。 仅支持切片包、矢量切片包和场景图层包。 FALSE—包将被上传且不被发布。 这是默认设置。 TRUE—包将被上传并发布为具有相同名称的 web 图层。	Boolean
portal_folder (可选)	包在门户上的现有文件夹或新文件夹的名称。 如果发布了 Web 图层，则系统会将其存储在同一文件夹中。	String

派生输出

名称	说明	数据类型
out_results	上传包并发布 Web 图层（如果指定）的结果。 成功时返回 True。	Boolean
package_item_id	包的门户项目 ID。	String
publish_results	包含 Web 图层的服务 URL 和门户项目 ID 的 JSON 响应。	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")

环境

当前工作空间