Altium基础架构服务器

Created: March 7, 2022 | Updated: March 7, 2022

 

对于在多个工作站上运行大量软件安装的电子公司,需要在企业层面上对安装的部署、配置和许可进行管理。为了提供公司设计软件的集中管理解决方案,Altium开发出了Altium基础架构服务器(AIS)——一种在Altium服务器基础平台上实施的免费的基于服务器的Altium软件管理解决方案。

这款新服务器安装在本地公司网络上时,可对Altium软件的离线安装、许可和更新进行集中控制,并对软件用户及其所属角色(用户组)进行管理。

该基础架构服务器提供以下Altium技术服务:

  • 用户配置文件管理和用户角色分配。
  • 客户端连接服务——会话管理、LDAP同步。
  • 私人许可服务——软件许可的获取、分配和跟踪。
  • 网络安装服务——软件安装包的获取、捆绑、网络部署。
请注意:Altium 基础架构服务器不提供设计数据存储或管理功能,例如Altium Concord Pro中提供的高级数据管理功能。

服务器安装

Altium基础架构服务器(AIS)是可从Altium免费下载的安装文件,与运行Windows 7(或更高版本)操作系统的PC兼容。请注意:该文件不能安装在运行Windows操作系统 基本版本(Core、Home、Starter、Base)的系统上,也不能安装在使用旧版Windows XP操作系统的 的PC上。

►请参阅“AIS系统要求”了解更多信息。

只能通过Altium Designer 16.0及更高版本访问基础架构服务器。

解压(解压自Altium_Infrastructure_Server_[version].zip源文件)并运行基础架构服务器安装可执行文件—— “Altium基础架构服务器<版本号> .exe”即可激活安装过程。安装向导中的一系列设置对话框将指导您完成该安装过程。

在随后出现的向导设置对话框中进行操作,以确认或编辑安装位置和网络服务器访问端口。

建立服务器设置和配置后,即可继续安装。最后一个向导对话框内显示用于标准(http)和安全(https)访问的本地PC上的服务器网址。

►有关安装过程及其选项的更多详细信息,请参阅“安装Altium基础架构服务器”。

服务器许可

基础架构服务器需要获得Altium许可才能激活其功能和允许网络连接。所需的许可文件可在已下载的压缩文件中以离散许可文件(*.alf)的形式获取,并通过其浏览器界面在服务器上注册激活——根据安装向导完成对话框中显示的网址(基于主机PC的名称)可访问该浏览器界面,如上所示。

请注意:要登录未经许可的服务器只能通过其所安装的PC。如果在此阶段PC/服务器的名称未知,请使用备用本地URL http://localhost:9780进行登录。

要确认PC的网络名称,请转到“控制面板\系统”和“安全\系统”,并注意“计算机名称”项。在Windows 10中,请参阅设置»系统»关于。如果随后获得许可,则可以根据其“计算机_名称”地址从网络上的所有计算机访问该基础架构服务器。

要确认PC的网络名称,请转到“控制面板\系统”和“安全\系统”,并注意“计算机名称”项。在Windows 10中,请参阅“设置»系统»关于”。如果随后获得许可,则可以根据其“计算机_名称”地址从网络上的所有计算机访问该基础架构服务器。

登录后,界面首页顶部的消息会指示未经许可的服务器。选择关联的添加许可链接以打开“基础架构服务器”的“许可管理器”页面,然后从按钮下拉菜单中选择许可的类型及其来源。可选项包括:

  • 文件许可——浏览并选择本地PC硬盘上的可用许可文件。这是基础架构服务器常见的许可方式。
  • 云许可——连接到“AltiumLive许可服务器门户”,以列出和获取本组织的可用许可。

应用服务器许可文件

选择文件许可选项以导入基础架构服务器的许可文件,例如已下载的安装压缩文件中包含的许可文件。浏览并找到适用的许可文件(*.alf),然后将其上传到服务器。服务器需要两种许可类型方可发挥全部功能:

  • 服务器许可——激活基础架构服务器的功能和服务。
  • 客户端访问许可(CAL)——使组织内的软件用户可通过网络访问基础架构服务器。

然后,将在基础架构服务器的“许可证管理器”页面中列出并注册导入的许可证。要激活服务器的全部功能,需登出然后再次登录。

►有关AIS界面及其功能的概述,请参阅“基于浏览器的访问和管理”。

从云上获取软件许可

Altium基础架构服务器包括Altium私有许可服务(PLS),该服务用于为公司用户或用户群组(角色)获取、配置和分配许可“席位”。它可控制许可租用模式、许可漫游、许可使用记录、用户(LDAP)同步和实时通知等功能,仅举几例。

管理Altium软件许可并将其分发在网络工作站的第一步是通过AltiumLive门户从Altium基于云的许可服务器上获取这些许可。利用服务器“许可管理器”页面上的按钮菜单中的云许可选项可获取云许可。

需要有效的AltiumLive用户帐户从云上访问和获取许可。要建立与AltiumLive许可服务器的初始连接,需在“ AltiumLive登录”对话框中输入您的帐户证书并完成登录。此处假设基础架构服务器可访问互联网。

服务器上保留新输入的AltiumLive登录证书,以备下次需要时使用——请参阅管理员»设置页面中的“常规-Altium Live证书”以编辑帐户名和密码。

与远程Altium许可服务器建立连接后,将在“添加许可”对话框中列出本公司所有可用的许可。如有必要,请使用“产品名称”过滤器字段设置感兴趣的许可类型列表。

选中与许可关联的“选择”框,选择服务器要获取的许可。要下载指定的许可,请通过按钮关闭“添加许可”对话框。然后,列出已获取的许可,并在基础架构服务器的“许可管理器”页面中将其列出。

请注意:默认将新获取的许可分配给“所有用户”,因此,任何与基础架构服务器中的用户帐户连接的Altium软件工作站均可访问新许可——有关如何禁用默认的信息,请参阅“私有许可服务”选项。

用户和角色

Altium基础架构服务器(AIS)在特定网络PC上部署、许可和更新Altium软件产品的能力受所分配的用户证书和/或用户角色限制。该服务器基于软件许可与远程PC连接,而不是直接与机器硬件连接。这样可以根据匹配的AIS用户帐户完全控制已连接的PC可使用的AIS资源(软件和许可)。

`服务器浏览器界面上的“用户管理”页面(在用户选项卡下)上列出并定义了详细的用户名信息和登录证书。 “用户管理”页面上列出了不同类型的用户入口,这些用户入口按以下方式自动或手动创建:

  • AIS系统用户:内部生成的用户配置文件,例如系统用户,供AIS用于自动网络访问。
  • AIS访问用户:管理员添加的手动创建的用户帐户(配置文件),以允许特定用户(通常是需要管理员访问权限的用户)通过浏览器界面直接访问服务器。
  • AIS自动生成的用户:响应远程软件(例如,Altium Designer)的连接时或用户远程登录AIS时通过许可服务(PLS)添加的自动创建的用户配置文件。通常,这些文件是添加到角色(视为角色中的成员)中的用户入口,它们可以限制访问该角色所分配的许可。请参阅下文的“自动生成的用户配置文件”。

►►有关AIS用户帐户使用的更多信息,请参阅“管理用户”(及其子页面)。

添加用户

可通过按钮在“用户管理”页面手动添加用户配置文件,该按钮可打开“添加用户”对话框。

选择相关图标,然后在“编辑用户”对话框中修改配置文件设置即可编辑“用户管理”页面上列出的现有用户配置文件。一个典型的、推荐的用户编辑任务是更改默认管理员帐户的默认名称/密码,以限制对指定AIS管理员的访问。

?

您需要以管理员身份登录方可对基础架构服务器进行全面配置,包括用户和角色。

“添加用户”(和“编辑用户”)对话框中的两个重要输入字段是:

  • 身份验证:默认的内置选项将使用服务器自身的身份服务(IDS)来识别用户连接,而当网络PC是Windows域的一部分时,将应用Windows方法,并且使用Windows域身份验证。对于该选项,请输入与用户的Windows域登录名完全匹配的用户名——该用户名由本组织的网络管理员提供。
  • 新角色:在此字段中输入角色名称,即可将新用户添加到现有角色(例如,管理员)。该字段将动态搜索与您输入的第一个字母匹配的现有角色。“用户”默认不包括在“角色”组中——有关创建用户角色的信息,请参阅下文。

自动创建的用户配置文件

从Altium软件工作站建立连接或用户登录AIS时,AIS许可服务会动态创建自动生成的用户配置文件。

自动用户配置文件创建功能默认处于启用状态,但可通过取消选中“私有许可服务”设置页面中的自动用户创建选项来禁用该功能。请注意:如果以前未创建过自动生成的用户配置文件,则这将阻止对AIS的访问。

从工作站直接连接

通常借助Altium设计软件中提供的内部PLS连接功能来建立与AIS的连接。许可连接功能可在软件的“私有许可服务器设置”对话框中手动配置,该对话框可通过“许可管理”页面上的“设置“私人许可服务器链接打开——从用户帐户下拉菜单(右上方)中选择“许可”选项即可访问该页面。仅需要AIS服务器名称(实际上是其主机PC的名称)及其活动端口。

当软件工作站与基础架构服务器建立连接时,AIS将创建一个配置文件,其用户名与工作站的Windows用户帐户名匹配。所创建的AIS用户配置文件的“第一名称”项也与工作站用户的帐户名匹配;“第二名称”项则与工作站的“计算机名称”(实际上是其网络名称)匹配。

在下文显示的屏幕图像示例中,一台名为ENGINEERING-2的远程工作站PC(有效的Windows用户帐户名为Bruce)已与AIS连接,因此自动创建突出显示的用户配置文件。

所有工作站与AIS连接时生成的这些用户配置文件可成为特定角色(用户群组)的成员,以控制可用于Altium软件工作站的许可——与角色相关的信息见下文。

AIS登录

如果用户(例如,管理员)通过其浏览器界面登录AIS,PLS将自动创建一个新的完整的服务器帐户名。所生成的用户名是AIS名称和用于登录的用户帐户名的组合– AIS_名称:用户_名。

请注意:当用户从同时托管AIS的PC登录时,不会生成服务器帐户的用户配置文件。

在下文显示的屏幕图像示例中,用户已登录AIS Barry帐户,因此PLS生成了新的服务器特定的用户配置文件:SYDPC016:Barry。 其中,AIS的网络名称(源于其主机PC名称)为SYDPC016,该名称也是新用户配置文件中的

与提供完整数据管理功能的Altium主要服务器产品不同,您无法通过Altium Designer登录AIS。实际上,Altium Designer用户会发起与PLS的直接连接,并根据所生成的基于Windows帐户的配置文件来应用角色——该配置文件由管理员管理,管理员通过浏览器界面登录AIS。

添加角色

通常将用户按“角色”分组,以便为具有共同要求的特定用户角色)集合设置服务器的应用条件,例如可用软件许可的范围。例如工程部门可能需要Altium Designer的许可,而工程管理可能只需要Altium Designer Viewer的许可——在这种情况下,将同时创建工程和管理角色,并将适当的用户配置文件添加到这些角色中。

角色在基础架构服务器的“角色”页面中列出、创建和编辑。选择按钮在“添加角色”对话框中添加新角色,否则与要编辑的现有角色相关联的图标是“名称”和“分配的成员用户)”——“新成员”字段将动态搜索包含您输入的第一个字母的现有用户名。

可在“添加角色”对话框中将现有用户变为角色成员,并且作为等效操作,可在“添加用户”对话框中将现有角色设置为包括用户(参阅上文)。

►有关服务器用户配置文件和角色群组的更多详细信息,请参阅“在基础架构服务器中管理用户”。

管理和分配许可

Altium基础架构服务器包括Altium私有许可服务(PLS),该服务用于为公司用户或用户群组(角色)获取、配置和分配许可“席位”。它可控制许可租用模式、许可漫游、许可使用记录、用户(LDAP)同步和实时通知等功能,仅举几例。

基础架构服务器的PLS功能是Altium Vault PLS功能的一部分。

如果由PLS(已配置时)将基础架构服务器获得的许可“用于”网络上的远程软件安装,则该许可将被转换为用于本地访问的私有许可。

获取许可

如上文“获取许可”部分所述,可通过“服务器许可管理”页面获取其他Altium软件产品的许可。例如当(通过门户网站)连接到在线Altium许可服务时,“添加许可”对话框列表中将包括本公司可用的所有许可,根据所需的许可,通过相关复选框进行选择并添加(下载)到AIS。

分配许可

将获取的许可“分配”给角色后,只有作为该角色的成员的用户方可访问该许可。在基础架构服务器的许可列表页面(如上所示)中,选择许可项的图标可查看其详细信息和当前分配情况。

要编辑当前分配设置,可在许可分配列中选择图标——请注意:通过相关的“私有许可服务”选项默认为“所有用户”设置已获取的许可。

在“编辑分配”对话框中可配置许可角色分配、租用选项、漫游设置和用户通知。在以下示例中,将“许可”分配给“工程角色”,并设置自动租用50个可用许可席位中的15个。此处禁用了“许可漫游”和“通知”功能。

提供以下许可分配选项:

  • 自动租用:允许工作站上的Altium软件自动租用(使用)本可用许可。例如在Altium Designer许可管理器中,将自动执行从列表中选择本许可并选择“使用”的正常租用过程。
  • 席位可用性:指定为相关角色提供的许可席位数量(不超过其总席位等级),或仅需选中“所有可用席位”选项以启用本许可的所有席位(其“用户计数”属性)
  • 漫游:选择“允许漫游”选项即可实现许可 “漫游”(当其主机PC未连接到网络时,漫游许可供Altium软件使用)。 通过最大漫游持续时间设置进行许可配置,从而在指定时间段之后禁用漫游席位。有关Altium许可漫游的更多信息,请参阅“按需许可”。
  • 通知:通知是指为响应特定事件而发送给用户的消息,例如当几乎所有已分配的许可席位均已租出时,将发出90%席位数量选项的通知。可选择“拒绝通知”选项和消息用户角色目标(可选),可为与所分配许可断开连接(已撤销席位)的用户启用警报消息。
在“许可”页面中选择“角色”选项卡,即可集中查看和编辑“角色许可”分配以及分配给每个角色的相关用户。

私有许可服务

根据许可角色分配和可用席位数量,Altium基础架构服务器的私有许可服务(PLS)通过网络将其托管许可提供给Altium软件工作站。请注意:AIS还可以为网络上现有的Altium服务器提供适当许可,例如位于不同部门的脱机服务器。

在大多数情况下,需要根据软件所属的AIS角色(用户群组)向网络上的多台PC提供软件许可。简而言之,根据注册的用户配置文件(Windows帐户名和计算机名)来识别工作站,并使其成为已被分配许可的角色的成员。

或者,如果为“所有用户”(而不是“群组角色”)设置了分配许可,则任何具有注册用户配置文件的工作站均可以访问该许可——可有效忽略角色不计。

PLS在服务器许可管理器部分的管理员»设置页面上提供了多种配置选项。

这些默认采用适当设置的选项包括:

  • 云许可证服务url——由AIS安装预设为正确的网址,以访问AltiumLive许可服务,该服务允许根据您的AltiumLive登录证书获取许可。可在管理员»设置下的常规– Altium Live证书页面中添加或编辑证书。
  • 自动用户创建——选中PLS后(默认和推荐设置),当Altium软件连接到AIS时,PLS将自动生成一个AIS用户帐户(设置为工作站的Windows帐户名)。在Altium Designer中,当启用设置专用许可服务器特性时,将触发上述情况。然后,已生成的AIS用户配置文件将用于角色成员,从而确定该Altium软件工作站的许可分配。如果未选中该选项,则不会创建任何用户帐户。
  • 席位返回超时间隔——指定客户端(已连接的工作站)在当前许可租用到期之前的无活动时间,并返回至可用的许可席位池。 PLS会定期通过网络查询客户端,并期望得到响应,如果在指定的小时数内未返回席位,将取消许可租用。当客户端软件以正常的“净化”方式(“退出”、“与PLS断开连接”等)断开许可连接时,已租用的许可席位将被自动返回。
  • 自动为“所有用户”群组创建分配——选中后,新获取的许可将被分配给“所有用户”群组。连接到AIS的所有工作站均可访问所提供的许可,无论工作站的用户配置文件属于哪个角色群组。请注意:如上所述,许可分配是可编辑的。取消选中该选项时,所获取的许可不会被分配给任何用户群组,因此无法通过网络来访问。

基础架构服务器PLS将基于角色为连接到服务器的工作站提供许可。在此处的示例中,如果ENGINEERING-2上的Altium Designer和Bruce Windows用户帐户通过其“私有许可服务器”接口连接到AIS,则分配给“工程角色”(Bruce是其成员)的许可将被Altium Designer租用。

请注意:此示例中,是在选择自动租用模式的情况下将Altium许可分配给“工程角色”——参阅上文。如果AIS许可分配中未启用该选项,则Altium Designer中的“许可管理”页面将列出“可用许可”下的许可,并要求您选择相关项,然后通过“使用”链接来租用(使用)许可。

通过以上自动/手动方法租用许可后,基础架构服务器上的许可页面将指示该许可的一个席位正在使用中。如果工作站Bruce/ENGINEERING-2与PLS断开连接或一旦用户关闭Altium Designer,则该许可将立即被释放。

►有关服务器“许可管理器”(PLS)使用的更多信息,请参阅“私有许可服务”。

使用网络安装服务

基础架构服务器的网络安装服务(NIS)提供了一种用于部署和管理公司范围内Altium软件安装的复杂脱机方法。该服务允许管理员通过本地网络自动安装和更新软件,并实现对软件可用性、配置及功能的集中控制。

实际上,基础架构服务器管理员可使用NIS功能从Altium获取软件产品文件,然后将其整合成可配置的软件部署包。然后,可将本地存储的部署包作为软件安装程序可执行文件(*.msi)部署到联网的工作站,或利用“Microsoft’s Active Directory Group Policy”直接安装。

►有关服务器NIS使用的更多信息,请参阅“网络安装服务”。

可从NIS控制台访问服务器的网络安装服务(“管理员»安装”)。打开NIS后,产品和扩展标签下的列表内将显示本公司可用的Altium产品和扩展。该列表来自Altium Cloud Vault,要求您已在基础架构服务器上注册AltiumLive证书(用户名和密码)——如未注册,请转到“管理员»设置”,然后在“常规-Altium Live证书”部分输入相关详细信息。

举例来说,以下有关获取、生成和部署Altium软件包的概述适用于旧版Altium Designer——16.1版。

获取产品和扩展

要获取组装到部署包中的产品,请首先在其各自列表中同时指定该产品和所需的扩展。从扩展后的子列表中选择产品/扩展版本,或仅指定产品(顶级复选框)以获取最新版本。

请注意:对于一个部署包只能选择一个产品版本,并且自动包含产品的默认扩展。

选择按钮以激活软件获取过程,该过程会将选定的产品和扩展下载到基础架构服务器自身的存储中,为部署包的组装做准备。或者,可将安装文件集(作为解压文件)直接下载到本地硬盘驱动器()——稍后可将该集合导入到NIS(已上载)或任何其他服务器的NIS中,待组装成软件部署包。

根据服务器负载和网络下载速度,下载文件需要花费一些时间。您可以在“任务”选项卡下监控获取(下载)状态,该选项卡会列出和记录NIS操作——您可能需要刷新页面(F5)或在两个选项卡之间切换以更新状态。

获取产品和扩展(下载状态完成)后,“服务器存储”选项卡列表中将显示存储在基础架构服务器中的文件。

生成安装包

在服务器存储页面上选择部署包所需的产品和扩展,然后单击按钮以启动部署包生成过程。此时将打开“部署包”对话框,用于配置待生成的部署包。

在上文显示的部署包配置示例中,“部署包”对话框中排列的项用于为Altium Designer 16.1创建安装程序,该安装程序将包括一个文件导入器(Altium PCB)和Draftsman扩展。将安装路径设置在目标硬盘上的典型位置,并利用AIS_admin证书访问基础架构服务器中的产品文件。安装后还将上传一个Altium Designer首选项文件,以自动配置Altium Designer。

“部署包”对话框中的选项字段概述如下:

  • 部署包名称——部署包的名称以及将要生成的安装文件。
  • 说明——与部署包相关的更多详细信息,以供参考。
  • 用户名和密码——登录证书,用于在安装过程中以静默方式访问服务器检索产品文件。
  • 显示进度——在安装程序上显示安装进度。取消选中该选项即可进行“静默”安装。
  • 安装路径——PC上的软件将安装的目录。
  • 文档路径——在用户计算机上创建的文档文件夹的路径。
  • 私有许可服务器(可选)——私有许可服务器的TCP/IP地址(与基础架构服务器不同时)。如果您希望从基础架构服务器的可访问许可中为已安装的部署软件自动获取许可,则本信息必选。
  • 许可激活码(可选)——产品安装的首选许可类型的激活码。
  • 首选项(可选)——指定用于本次安装的一组首选项。可将首选项文件(*.DXPPref)上载到服务器以供使用,也可上载从关联下拉列表中选择的服务器中现有的任何首选项。
  • 使用最新产品版本——强制安装程序使用最新产品版本及其扩展。
  • 产品——服务器已获取的所有产品的列表。启用将通过本部署包安装的产品(和版本)。
  • 安装功能——指定安装中包括的可用产品功能或扩展列表中的子功能。
  • 扩展——所有与指定产品兼容的已获取的扩展列表。在扩展的子列表中选择将通过本部署包安装的扩展或扩展版本。

在对话框中选择并生成新的部署包,该部署包随后将列于服务器“部署包”标签下。请注意:可编辑现有部署包,然后通过相关的项目按钮重新创建。

然后,生成的部署包可下载到本地硬盘()以及浏览器的默认下载位置,并进行相应的分发。在此处的示例中,所生成的安装程序包为AltiumDesigner16-1_incl-Draftsman.msi。

配置更新

基础架构服务器“更新”选项卡下提供手动或自动更新所获取的软件和扩展的功能。实际上,服务器会自动检测并列出可用于服务器本地存储中已添加产品/扩展的最新更新——例如服务器存储选项卡下列出的产品/扩展。

要在更新选项卡下手动更新列出的项,请选择关联按钮,或选中“自动更新”框,以允许服务器自动获取最新版本(若有)。自动更新检查和获取过程将按照管理员»设置页面上网络安装下指定的时间间隔进行。在此处的示例中,由于仅获取Altium Designer 16.1,因此更新列表上将显示Altium Designer的最新可用版本和最新兼容的Draftsman扩展版本。

在列出大量产品和扩展时(即服务器中获取并存储多个产品/扩展),更新选项卡所提供的附加功能将十分有用:

  • ——手动更新当前选定的项(通过与其名称关联的复选框)
  • ——启用所有选定项的自动更新。
  • ——禁用所有选定项的自动更新。

请注意:在更新所获取的软件之后,之前从软件文件中生成的所有部署包都将过时。可对部署包进行编辑以适应最新更新,但是最好创建新的有适当命名的部署包。

部署软件安装

基础架构服务器中的“网络安装服务”(NIS)支持使用安装程序包(*.msi)分发或使用Microsoft“活动目录”域中的批量“组策略安装”集中进行远程软件安装。无论采用哪种方法,基础架构服务器都是通过已部署的安装程序检索的安装文件的网络连接源。

要将软件直接部署到单个工作站,请通过网络共享为计算机分配已生成的部署包(如上所述),或将其直接复制到PC。然后运行安装程序即可。

按照在基础架构服务器中创建部署包时应用的配置设置(路径、软件版本等),将软件包安装在计算机上。安装文件通过网络从基础架构服务器的存储中获取——建议在安装程序包的“私有许可服务器”字段指定服务器的URL路径。

安装后,可从基础架构服务器的“私有许可服务”中对已部署的软件授予许可。或者,如果已将基础架构服务器获取的许可设置为自动租用并已分配至用户配置文件所属的角色,则新安装的软件将自动从AIS获得许可。请注意:相关的AIS用户配置文件是该用户在先前连接期间由Windows帐户名(及PC名)自动生成的配置文件,例如下文所示的ENGINEERING 4工作站上的Windows帐户用户2。

在此处的示例中,User2已成为“工程角色”的成员,该角色被分配了20个Altium Designer许可席位——当User2从Altium Designer连接到基础架构服务器时,其中一个席位将自动被租用。

必要时,可通过软件应用程序内部署的更新引擎安装软件更新,也可直接创建新的更新部署包(*.msi)进行分发,或利用“活动目录”域网络结构中的“组策略”配置“推送”更新功能。

要直接从基础架构服务器获取Altium Designer软件更新,请确保在软件“首选项”对话框的“系统–安装”页面上选择“本地安装”服务选项。

Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

联系我们

联系原厂或当地办公室

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: