摘要
返回门户信息字典。
GetPortalDescription 函数返回当前匿名或已登录用户所查看的门户的视图。 其中包含门户的名称、徽标、要素项目和支持的协议(HTTP 与 HTTPS)等信息。 如果用户尚未登录,该调用将返回门户的默认视图。 如果用户已登录,将返回用户所属组织特定的门户视图。 门户的默认视图取决于从用户的配置文件中获取的用户语种。
说明
下表包含一系列更重要的门户属性。
属性 | 详细信息 |
---|---|
access | 确定谁可以匿名用户身份查看您的组织。 可通过设置为 public 允许匿名用户访问组织的自定义 URL。 设置为 private 会将访问权限限制为组织成员。 默认为 public。 值:private | public |
allowedBetaFeatures | 为组织启用的一系列测试版功能。 |
allowedOrigins | 一组数量高达 100 个的 Web 应用程序域,用于限制对 REST API 的跨域资源共享 (CORS) 访问。 此属性仅适用于管理员。 |
allowedRedirectUris | 允许的重定向 URI 的 JSON 数组,其中 URI 用于表示与您共享安全内容的门户实例。 这将允许组织中的用户使用组织登录帐户,通过这些门户上托管的 web 应用程序访问受保护内容。 |
allSSL | 指示组织是否使用 HTTPS。 如果设置为 true,则使用属于组织的资源进行的所有调用都将需要使用 HTTPS。 默认为 false。 值:true | false |
analysisLayersGroupQuery | 可识别群组的查询,该群组包含在分析工具的分析图层库中进行显示的图层。 |
appInfo | 有关资源所访问应用程序的信息。 该信息基于用来访问资源的令牌。 |
authorizedCrossOriginDomains | 一组受信任的服务器,通过 CORS 请求访问受 web 层保护的服务时,客户端可以向其发送凭据。 |
authorizedCrossOriginNoCorsDomains | 已在 ArcGIS Enterprise 11.0 中引入。 最初向其发送直接请求的 JavaScript 客户端的一组受信任服务器用于在发出 CORS 请求之前处理身份验证。 所有受信任的服务器必须在添加至此属性之前在 authorizedCrossOriginDomains 属性中列出。 此属性仅适用于 ArcGIS Enterprise。 |
availableCredits | 组织中的配额总数。 |
backgroundImage | 主页上所有其他组件下方显示的背景图像。 接受默认背景图像,指定自定义背景图像的 URL 或指定不使用背景图像。 |
basemapGalleryGroupQuery | 可识别群组的查询,该群组包含在 Map Viewer 底图库中进行显示的 Web 地图。 |
bingKey | 要用于使用 Bing Maps 的 Web 地图的 Bing 密钥。 |
canListApps | 仅当 canListApps 设置为 true 时,组织才能列出应用商店中的应用程序。 值:true | false |
canListData | 仅当 canListData 设置为 true 时,组织才能列出应用商店中的数据服务。 值:true | false |
canListPreProvisionedItems | 仅当 canListPreProvisionedItems 设置为 true 时,组织才能列出应用商店中的预配置项目。 值:true | false |
canProvisionDirectPurchase | 仅当 canProvisionDirectPurchase 设置为 true 时,组织才能在没有客户请求的情况下配置应用商店中的直接购买。 值:true | false |
canSearchPublic | 包括或排除搜索查询中的公共项目、群组和用户。 如果 canSearchPublic 设置为 false,则搜索不包含组织外部的公共项目。 但是,可返回作为组织一部分的公共项目。 默认为 true。 值:true | false |
canShareBingPublic | Bing 密钥可共享给公众并可作为门户描述调用的一部分 (/sharing/rest/portals/<orgid>) 返回。 这需要将门户的 access 属性设置为 public。 canShareBingPublic 属性不会公开返回,且仅对组织内的用户可见。 |
canSharePublic | 指示组织是否可以公开共享群组或项目。 如果 canSharePublic 设置为 false,则无法将内容共享给所有人。 默认为 true。 值:true | false |
canSignInArcGIS | 允许具有已配置企业 IDP 的组织在选项中打开或关闭 ArcGIS 登录。 默认为 true。 值:true | false |
canSignInIDP | 允许具有已配置企业 IDP 的组织打开或关闭企业登录。 默认为 true。 值:true | false |
colorSetsGroupQuery | 可识别群组的查询,该群组包含在 Map Viewer 中进行渲染的颜色集。 |
commentsEnabled | 允许组织禁用评论功能。 默认为 true。 当 commentsEnabled 为 false 时,注释将被隐藏,但不会被移除,并且对于组织中的所有项目,numComments 均设置为零。 用于添加评论和查看评论的调用将失败。 如果组织重新启用评论,则会显示评论并恢复 numComments。 值:true | false |
contacts | 一组选定的管理员 - 当组织成员请求密码重置、有关用户名的帮助、帐户修改或任何与其帐户配额分配相关的问题时,发送给组织成员的自动电子邮件通知会将选定管理员及其电子邮件地址列为联系方。 |
contentCategorySetsGroupQuery | 可识别群组的查询,该群组包含 ArcGIS Online 内容类别集。 |
created | 组织的创建日期,以毫秒为单位表示某一时间点的 UTC 时间。 |
creditAssignments | 指示组织是否已启用配额预算。 默认为 disabled。 值:enabled | disabled |
culture | 默认区域设置(语言和国家/地区)信息。 语种代码格式基于由虚线分隔的语言代码和国家/地区代码:
|
cultureFormat | 符合 CLDR 的首选数字和日期格式。 cultureFormat 属性仅适用于英语和西班牙语,即 culture 设置为 en 或 es 时。 有关支持格式,请参阅语言。 |
customBaseUrl | 门户的自定义基本 URL。 |
defaultBasemap | Map Viewer 中显示的默认底图。 |
defaultDevBasemap | Map Viewer 中针对开发人员订阅显示的默认底图。 |
defaultExtent | 用户创建 web 地图时使用的组织默认范围。 |
defaultUserCreditAssignment | 新成员的默认配额分配。 对于无分配限制,值为 -1。 |
defaultVectorBasemap | 当 useVectorBasemaps 为 true 时,在 Map Viewer 中显示的默认矢量底图。 |
description | 组织的描述。 描述可以为任意长度。 |
devbasemapGalleryGroupQuery | 可识别群组的查询,该群组包含在开发人员订阅的 Map Viewer 底图库中显示的 Web 地图。 |
eueiEnabled | 表示组织是否允许 ArcGIS Online 收集成员的使用情况信息,用于提升用户体验。 |
featuredGroups | 组织的专题群组。 这些群组将在门户主页应用程序中的群组页面上高亮显示。 |
featuredItemsGroupQuery | 可识别群组的查询,该群组包含图库的专题项目。 设置群组 ID,如果为空,则组织中最常查看的项目将显示在库中。 |
galleryTemplatesGroupQuery | 此查询可识别是否允许包含库模板的群组构建在群组内显示 web 地图和 web 制图应用程序的图库。 |
hasCategorySchema | 指示组织是否设置了内容类别。 |
helpBase | 提供组织帮助文档的基础 URL,用于在门户中构建所有帮助 URL。 从 ArcGIS Enterprise 10.8.1 开始,可以更新 helpBase 以将帮助主题提供商设置为公共或已安装源。 默认情况下,来源将设置为本地安装的来源。 当 Internet 可用时,可以启用此选项以从 Enterprise 门户主页应用程序提供 Esri 公共 Web 帮助中的帮助主题。 注:文档源仅对通过 Enterprise 门户主页应用程序访问的文档有影响,不会影响 ArcGIS Server 或者 ArcGIS REST API 文档。 |
helperServices | 客户端应用程序所需的各种服务的 JSON 对象。 帮助程序服务可以覆盖为组织或门户。 服务包括以下内容:
|
homePageFeaturedContent | 包括要在组织主页上显示的专题内容的群组。 |
homePageFeaturedContentCount | 可显示在主页上的专题项目的数量。 最大值为 100。 只能使用整数。 |
httpPort | 门户用于 HTTP 通信的端口。 |
httpsPort | 门户用于 HTTPS 通信的端口。 |
id | 组织 ID。 如果为空,这将成为匿名用户和无组织用户的默认门户。 |
ipCntryCode | 调用 IP 的国家代码(仅限 ArcGIS Online)。 |
isPortal | 指示门户是否为本地门户。 |
isVerified | 用于指示组织身份是否由 Esri 进行了验证。 |
layerTemplatesGroupQuery | 用于识别群组的查询,该群组包含在 Map Viewer 中使用的编辑模板。 |
livingAtlasGroupQuery | 可识别群组的查询,该群组包含分析图层库中使用的图层。 |
maxTokenExpirationMinutes | 为组织用户颁发的 OAuth 和 nonOAuth 令牌的最长有效期(以分钟为单位)。 默认值为 -1,对于 OAuth 访问令牌和 ArcGIS 令牌 (nonOAuth),最大值为 2 周,对于 OAuth 刷新令牌,最大值为 90 天。 这些是受支持的最大值。 指定较小的值将会影响所有三种类型的令牌(ArcGIS 令牌、OAuth 访问令牌和 OAuth 刷新令牌)。 |
metadataEditable | 指示组织是否已启用元数据。 如果 true,则组织的所有成员均可查看元数据。 仅项目所有者和管理员可以更新元数据。 如果 false,则组织中的任何人都无法访问元数据。 值:true | false |
metadataFormats | 用于组织的元数据样式。 默认为 iso19139。 值:fgdc | inspire | iso19139 | iso19139-3.2 | iso19115 |
mfaAdmins | 至少两个指定管理员 - 这些管理员将接收解决成员多因子身份验证问题的请求。 |
mfaEnabled | 显示是否允许组织成员为其个人帐户设置多因子身份验证。 |
modified | 上次修改组织的日期,以毫秒为单位表示某一时间点的 UTC 时间。 |
name | 组织或门户的名称。 字符限制为 250。 |
orgEmail | 显示在 ArcGIS Marketplace 中组织列表的提供者选项卡中的联系人电子邮件。 |
orgPhone | 显示在 ArcGIS Marketplace 中组织列表的提供者选项卡中的联系人电话号码。 |
orgUrl | 在 ArcGIS Marketplace 中组织列表中的提供者选项卡中显示的网站 URL。 |
portalHostname | 门户主机的 URL。 |
portalMode | 识别其是否为 multitenant 或 singletenant。 |
portalName | 门户的名称。 |
portalProperties | 存储组织特定的属性(例如“联系我们”链接、主页、Map Viewer 和搜索配置)。 如果组织是公共组织,则这些属性对匿名用户可见。 |
portalThumbnail | 门户缩略图的 URL。 |
region | 组织的区域。 |
rotatorPanels | 主页的自定义 HTML。 |
showHomePageDescription | 如果为 true,则主页上将显示组织的描述。 值:true | false |
storageQuota | 允许的总存储(以字节为单位)。 从 ArcGIS Enterprise 10.8 开始,组织存储配额已增加到 10 TB。 在 ArcGIS Enterprise 10.8 之前,组织存储为 2 TB。 非组织存储为 2 GB。 |
storageUsage | 所使用的总存储(以字节为单位)。 |
stylesGroupQuery | 可识别群组的查询,该群组包含多种样式,这些样式中包含对可在组织中使用的符号系统的引用。 |
supportsHostedServices | 指示是否支持托管服务。 |
supportsOAuth | 指示是否支持 OAuth。 |
symbolSetsGroupQuery | 可识别符号集组的查询,用于在 Map Viewer 中进行渲染。 |
templatesGroupQuery | 可识别在 Map Viewer 中使用的模板组的查询。 |
thumbnail | 组织缩略图的 URL。 |
units | 设置适用于组织用户的测量单位。 用户默认值来源于组织的区域。 将单位设置为 english(适用于美制)或 metric。 值:english | metric |
updateUserProfileDisabled | 指示是否允许组织成员编辑个人信息以及可以查看其个人资料的用户。 |
urlKey | 由组织管理员选择的要与 customBaseURL 一起使用的前缀,例如 <urlKey>.maps.arcgis.com。 |
user | 仅当传递令牌时,才会返回访问用户的用户信息。 不提供群组信息。 有关响应属性的信息,请参阅用户。 |
useStandardizedQuery | 如果设置为 true,则查询图层和表时,只能使用符合 SQL92 的 WHERE 子句。 建议的安全设置为 true。 值:true | false |
useVectorBasemaps | 如果为 true,则组织将在受支持的 ArcGIS 应用程序中使用 Esri 矢量底图,同时 basemapGalleryGroupQuery 将不可编辑,且将被设置为默认查询。 值:true | false |
vectorBasemapGalleryGroupQuery | 此查询用于识别包含矢量底图的群组,这些底图用于在 Map Viewer 底图库中显示。 仅当 useVectorBasemaps 设置为 true 时才使用此查询。 |
属性 | 详细说明 |
---|---|
orgCapabilities | 通过 ID 返回有关当前门户的订阅信息,用于组织扩展模块的身份验证。 |
语法
GetPortalDescription ({portal_URL})
参数 | 说明 | 数据类型 |
portal_URL | The portal URL. If unspecified, the active portal will be used. | String |
数据类型 | 说明 |
Dictionary | 包含门户信息的字典。 |
代码示例
获取门户帮助服务 URL 的字典。
import arcpy
portal_desc = arcpy.GetPortalDescription()
helper_services = portal_desc['helperServices']
获取门户的用户权限。
import arcpy
portal_desc = arcpy.GetPortalDescription()
user_name = portal_desc['user']['fullName']
user_privileges = portal_desc['user']['privileges']