共享包 (数据管理工具)

汇总

通过将包上传到 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

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 图层发布到门户。仅支持切片包、矢量切片包和场景图层包。 `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")

环境

当前工作空间

许可信息

基本: 是
标准: 是
高级: 是

共享包 (数据管理工具)

汇总

用法

提示：

参数

派生输出

环境

许可信息

相关主题