Projectnet 管理自定义 Administration-Customizing.docx

管理自定义 Administration-Customizing从科技社区跳转到：导航，搜索内容隐藏 1 自定义和品牌战略 1.1 创建一个配置为您的安装 1.1.1 创建自定义配置 的说明 1.1.2 特定于站点的标记值 说明 1.1.3 配置疑难解答 1.2 自定义图像 1.2.1 必备 1.2.2 添加静态资源通过一个 Tomcat 上下文资源 说明 1.2.3 疑难解答 1.2.4 添加通过 Apache web 服务器的静态资源 说明 1.3 自定义页页眉 1.3.1 自定义页面标题链接 1.4 接口通过 CSS 自定义 1.5 替换登录屏幕 2 、更多帮助编辑自定义和品牌战略在开始之前，请确保您已经阅读了自定义 P 概述. 编辑创建一个配置为您的安装P 包含许多其设置在配置标记 ；这些标记存储在命名的配置集。例如，如果您希望您的公司名称和徽标出现在 P 登录页上，您将更改两个特定标记的值。虽然你可以改变的 P 默认配置设置，建议您创建的配置，只是为您的安装。P 将首先使用从您的配置的值。任何不在您的配置中设置的值将从系统默认的配置获得它们的值。使用一个单独的配置隔离您自定义的设置，使它们更加明显。更重要的是，每当 P 软件升级后，虽然失去了任何更改的默认配置保留的备用配置。注： P 可以有多个活动配置。为用户选择的配置是由确定的 URL 或 IP 地址使用他或她来访问 P 服务器。例如，用户访问服务器通过可能会看到结果的默认配置中，而那些使用自定义 可以看到自定义的备用配置网站。 注意： 有可能要转储中的一个脚本，它可以应用到另一个数据库中，这些令牌加载到第二个数据库形式的配置标记。若要提取令牌，修改和运行该脚本：/树干/核心/db/oracle/创建-脚本/工具/generate_update_system_properties_dml.sqlto。针对另一个 P 数据库，要在第二个数据库中设置这些令牌运行生成的脚本。 编辑创建自定义配置请按照以下步骤创建安装特定的配置编辑说明1. 从应用程序管理界面内选择管理 / 配置。2. 单击创建图标，以创建新的配置。3. 请输入：1. 名称-建议： 使用标准的生产配置或使用使用 siteHost 标记的值。2. 描述-建议： 包括 siteHost 值的说明的一部分。3. 缩写 这将用作令牌标识符的一部分。4. 选择的默认语言。请注意，你 _must_ 选择一个值。5. 通过按住 Control 键并单击所需的名称来选择多个支持的语言。你可以把这作为默认值。6. 支持主机名称 (CSV) 此字段中的值确定时将使用此配置集。请列出你想要关联的配置，用逗号分隔的 web 站点名称。如果你输入 ， 其中任何一个地址会导致值在此配置中设置为从默认配置值一起使用。4. 提交您的更改要创建配置集。编辑站点特定的标记值请按照以下步骤创建安装特定的配置编辑说明1. 从应用程序管理界面内选择了管理 / 配置. 2. 单击从列表中配置的自定义配置的名称。3. 从左边的菜单中选择标记。4. 从类别列表中选择基本的品牌。5. 单击筛选 6. 设置适当的值，下面的标记。7. 如果一个令牌未出现在列表中您可以在令牌名称中输入其名称： 搜索字段，然后单击筛选器按钮来找到它。prm.global.brand.defaulthost： 相同的默认配置标记为prm.global.brand.defaultjsprooturl: /prm.global.brand.defaulttimezoneprm.global.brand.defaultsitescheme: http:/prm.global.brand.legal-名称prm.global.login.channel.login.titleprm.global.brand.logo.login.href-用页标题中的图像的 URL .emailaddressprm.global.help.legal.emailaddressprm.global.help.sales.emailaddressprm.global.help.support.emailaddress8. 提交您的更改。直到再次登录，可能无法看到结果。编辑配置疑难解答一旦你建立了自定义配置第一件事，以验证是 P 使用该配置，而不是默认值。这里有一些提示： 自定义配置中将设置为备用配置类似的令牌ject.login.login_header_text-1 。这将可以容易地确定当正在使用此配置。如果你转到登录页面，它仍说会员登陆而不是备用配置然后自定义配置不是被使用。 请检查主机名值的自定义配置。请列出任何应触发此配置的主机名。你可能想要包括 localhost 或任何特定的端口。例如，，:8080，本地主机。 请确保默认配置为主机名为空。因为它是必填的字段必须输入 假 作为它的值。不包括本地主机或任何用于自定义配置的主机名。注意： 您不需要更改任何配置，如主机名中的值后，重新启动应用程序服务器。 编辑自定义图像在文件系统中，您可以替换到物理位置的大部分在 P 通过令牌的组合和使用 Tomcat 上下文，地图雄猫虚拟目录中使用的图像。备用或自定义的图片放在虚拟目录中，其标记改为提及此目录。P 在运行时将使用该虚拟目录，而不是其默认的图像目录中的图像。请注意，除非您计划修改 P JSP 源页，更换图像必须是原始文件的大小相同。在 P 中替换的常见图像 标记名称 说明 Size(pixels) pnet_logo2.gif在登录页上的 P 标志165 x 90pnet_home_button.gif在登录页上 P 首页图像113 17prm.global.header.banner.image页面页眉中的 P 图像103 x 50编辑必备组件1. 如果您没有创建一个创建 P 的配置将覆盖默认的配置。2. 选择保存您替换映像 （例如 C:pnetbrandimages，/opt/pnet/brand，等等） 的文件系统位置。它建议创建一个子目录的每个 P 配置或品牌，如果您有多个配置。3. 找出其中的图像你想要替换及它的大小，上面列出的常用替换图像的一小部分。 从浏览器内, 图像上单击鼠标右键，从弹出菜单中选择属性。从属性对话框中看看地址 (URL)：条目和注意的形象，出现在结尾的 URL 的名称。此外记录的图像，在维度字段中列出的大小。4. 创建替换图像相同的类型和大小作为原件 ；将它保存在上面选择的文件系统位置。5. 按照根据您的配置下面的其余说明。编辑添加静态资源通过一个 Tomcat 上下文资源如果您使用的 Tomcat 应用程序服务器可以替换静态资源，如通过 Tomcat 上下文的自定义图像。使用上下文使您可以自定义的图像代替项目.net 没有触及 P EAR 文件。编辑说明1. 下面的说明假定的备用图像被命名为mycompanyLogo.gif并存储在一个名为/选择/科技/品牌/目录中。替代的目录和文件名为适合您的系统。2. 内APACHE_HOME/conf/卡塔利娜/本地主机/创建下面的文件命名为科技-branding.xml 值为docBase是基目录，它将举行备用图像的路径。 使用正斜杠 (/) 作为目录分隔符中的路径名称。 对于 Windows 系统中，您可以包括驱动器标志符 （例如，c: / 或 d: /) 的路径开头。 上下文路径 =/ 科技品牌docBase =/ 选择/科技/品牌3. 重新启动 Tomcat。4. P 应用程序管理员的身份登录。5. 从应用程序管理界面内选择了管理 / 配置. 6. 单击从列表中配置的自定义配置的名称。7. 从左边的菜单中选择标记。8. 搜索表示您想要替换，示例ject.login.pnet_logo2是在登录页上的徽标标记的图像的标记。9. 更改它的值为 / 。在我们的示例中，它将是： /pnet-branding/mycompanyLogo.gif 此路径名应该开始与作为docBase中conf data.xml列出的最后一个目录. 10. 应用的设置。11. 注销的 P。您将看到您在登录页面的左上角的徽标。编辑故障排除 如果你仍然看到 P 徽标，机会是默认的配置目前仍未选定在你的备用。 徽标上单击鼠标右键并从弹出菜单中选择属性。 从属性对话框中看看地址 (URL)：条目。如果没有你定义 ject.login.pnet_logo2 令牌中，然后您的配置没有被选的图像文件。创建一个配置为您安装的故障排除部分，请参阅. 如果标志缺少 (即带有一个红色的 X 改为显示图标），再看看要见应显示什么图像的图像属性。检查中名称的拼写错误。 请注意，某些安装 Tomcat 不需要/pnet-branding指定为一个图像标记中的路径的一部分。如果不显示该图像和图像路径在图像属性对话框中的列出两次在路径中的/pnet-branding/pnet-branding然后删除/pnet-branding从图像标记的值。1. 如果名称和路径是否正确，剪切粘贴图像路径从图像属性并将其粘贴到浏览器中，浏览器中应显示的图像。如果浏览器说：找不到映像然后重新启动 Tomcat，重复此步骤。2. 请注意，Tomcat 只上下文目录启动时读取它。如果您将图像添加到此目录一旦运行 Tomcat 然后你必须重新启动 Tomcat 显示它们。3. 最后，仔细检查科技-branding.xml；不要忘记更改此文件后，重新启动 Tomcat。编辑添加通过 Apache web 服务器的静态资源如果你使用的是 Apache web 服务器可以替换静态资源通过服务器。编辑说明1. 修改 httpd.conf 文件 （大概 /etc/httpd/conf/httpd.conf） 和底部下面我们添加的其余部分添加以下行： /ext*一个位置的默认处理程序别名 /ext /home/weblogic/extResources订单允许、 拒绝允许从所有2. 创建目录 /home/weblogic/extResources （大写的 R 是非常重要的未能正确地做它会让你以后激怒了）3. 放置你想要送达此目录中的文件。4. 运行 httpd （大概 apache） 的用户将需要具有某些权限。它将需要有上导致的 extResources 目录的每个目录的执行权限。这是，(首页/首页/weblogic /home/weblogic/extResources)。它还需要在您想要显示的文件上读过。如果您想要创建子目录内 extResources，只是确保 apache 用户有x的权限。5. 重新启动您的服务器。查找 apachectl cmd (大概 /usr/sbin/apachectl） 并运行 /usr/sbin/apachectl 重新启动。6. 测试您的 web 浏览器 （例如/ext/images/topnav-banner-bg.gif的文件 ) 编辑自定义页面页眉您可以更改大小和头顶部的页面的内容。 若要更改大小，请创建下面的标记 prm.custom.topmenu.height 它应该是一个文本值与标头的高度 （以像素为单位） 若要设置自定义内容 创建文件 page.html 或 page.jsp 创建或更新的标记 prm.custom.topmenu.content 与文本值 html 或者 jsp 若要使用标准的头，删除prm.custom.topmenu.content ，或给它一个空值。编辑自定义页面标题链接页面页眉中的标志是，默认情况下它指向 的链接。若要在页面页眉中定义的链接的图像在非默认配置中设置prm.global.brand.logo.login.href 。常见的链接是：要链接到. 可以使用此 URL. 个人仪表板页https:/personal/Main.jsp个人的工作分配页https:/assignments/My?module=160&redirectedFromSpace=true组合页https:/portfolio/Project?module=160&portfolio=true编辑通过 CSS 自定义的接口您可以自定义任何 CSS 文件和动态值中任何现有的或新的配置令牌。例如，下面的静态 CSS 与一个固定的值为左：: 文件 /css/ourcss.css div#ourFrame, position: absolute; left: 10; 可以有其配置令牌prm.ourframe.left使用这种格式中包含的值 div#ourFrame, position: absolute; left: $prm.ourframe.left$; 在运行时，将替换的数据库值为令牌prm.ourframe.left $prm.ourframe.left$. 注意： 要使用此功能你必须添加过滤器映射为你的 css 文件到 web.xml 为您的应用程序服务器 (Tomcat) CSSDbValues /css/ourcss.css 该标记没有被添加到数据库中或没有值的情况下，还可以定义一个默认值。应添加默认值来筛选作为init 参数正确 web.xml 文件中的声明。 CSSDbValues ject.css.CSSDbValues prm.ourframe.left 1o 编辑更换登录屏幕1. Html （或 jsp） 为创建页自定义登录屏幕，并将其保存在 / 自定义。2. 现在，添加或编辑下面的标记 prm.custom.loginscreen.content 与文本值 html 或者 jsp 若要使用标准的登录屏幕，删除prm.custom.loginscreen.content ，或给它一个空值。登录屏幕的示例： Login: Pass: 编辑更多帮助 管理员手册-管理员手册内容 额外的帮助也是可用的P 用户论坛 Administration-CustomizingFrom Pnet-CommunityJump to: navigation, searchContentshide 1 Customization and Branding Strategies 1.1 Create a configuration for your installation 1.1.1 Create a custom configuration Instructions 1.1.2 Site-specific token values Instructions 1.1.3 Troubleshooting a configuration 1.2 Customizing images 1.2.1 Pre-requisites 1.2.2 Adding Static Resources via a Tomcat Context Resource Instructions 1.2.3 Troubleshooting 1.2.4 Adding Static Resources via an Apache Webserver Instructions 1.3 Customizing page header 1.3.1 Customizing page header link 1.4 Interface customization via CSS 1.5 Replacing the login screen 2 More Helpedit Customization and Branding Strategies Before beginning, make sure you have read the Overview of Customizing P. edit Create a configuration for your installation P contains many of its settings in configuration tokens; these tokens are stored in named configuration sets. For example, if you want your companys name and logo to appear on the P login page, you would change the values of two specific tokens. While you can alter the P default configuration set, it is recommended that you create a configuration just for your installation. P will first use the values from your configuration. Any values not set in your configuration will receive their values from the system default configuration. Using a separate configuration isolates your custom settings, making them more obvious. More importantly, alternate configurations are preserved whenever the P software is upgraded, while the default configuration loses any changes. Note: P can have more than one active configuration. Which configuration is selected for a user is determined by the URL or IP address he or she used to access the P server. For example, users accessing the server through may see the results of the default configuration, while those using could see a site customized by an alternate configuration. Note: It is possible to dump the configuration tokens in the form of a script that can be applied to another database, loading those tokens into the second database. To extract the tokens, modify and run the script: /trunk/core/db/oracle/create-scripts/tools/ generate_update_system_properties_dml.sqlto. Run the resulting script against another P database to set those tokens in the second database. edit Create a custom configuration Follow these steps to create a installation-specific configuration edit Instructions 1. From within the Application Administration interface, chose Manage / Configurations. 2. Click the Create icon to create a new configuration. 3. Enter: 1. Name - Suggestion: use Standard Production Configuration or use the value used for the siteHost token. 2. Description - Suggestion: include the siteHost value as part of the description. 3. Abbreviation This will be used as part of the token identifier. 4. Choose the Default Language. Note, you _must_ select a value. 5. Select multiple Supported Languages by holding down the Control key while clicking the desired names. You can leave this as the default value. 6. Supported Host Names (CSV) The values in this field determine when this configuration set will be used. List the web site names you want associated with configuration, separated by commas. If you enter , either address will cause the values in this configuration set to be used, in conjunction with the values from the default configuration. 4. Submit your changes to create the configuration set. edit Site-specific token values Follow these steps to create a installation-specific configuration edit Instructions 1. From within the Application Administration interface, chose Manage / Configurations. 2. Click on the name of the custom configuration from the list of configurations. 3. Choose Tokens from the menu on the left. 4. Select Basic Branding from the Category list. 5. Click Filter 6. Set the appropriate values for the tokens below. 7. If a token does not appear in the list you can enter its name in the Token Name: search field and click the Filter button to locate it. prm.global.brand.defaulthost: Same as the default configuration token prm.global.brand.defaultjsprooturl: / prm.global.brand.defaulttimezone prm.global.brand.defaultsitescheme: http:/ prm.global.brand.legal-name prm.global.login.channel.login.title prm.global.brand.logo.login.href - URL used by the image in the page header prm.global.default.site.href prm.global.footer.copyright.href prm.global.footer.poweredby.href prm.global.login.requestinformation.text prm.global.default.email.fromaddress prm.global.help.feedback.emailaddress .emailaddress prm.global.help.legal.emailaddress prm.global.help.sales.emailaddress prm.global.help.support.emailaddress 8. Submit your changes. You may not see the results until you login again. edit Troubleshooting a configuration Once you have established an custom configuration the first thing to verify is that P is using that configuration rather than the default. Here are some hints: In the custom configuration set the token ject.login.login_header_text-1 to something like Alternate Configuration. This will make it easy to determine when this configuration is being used. If you go to the login page and it still says Member Log in rather than Alternate Configuration then the custom configuration is not being used. Check the hostname values for the custom configuration. List any hostnames that should trigger this configuration. You may want to include localhost or any specific ports. For example, , :8080, localhost. Make sure the hostname for the default configuration is blank. Since it is a required field you may have to enter as its value. Do not include localhost or any of the hostnames used for the custom configuration. Note: You do not need to restart the application server after changing a value in any of the configurations, such as a hostname. edit Customizing images You can replace most of the images used in P through a combination of tokens and the use of a Tomcat Context, which maps a Tomcat virtual directory to a physical location in the file system. Alternate or customized images are placed in the virtual directory and their tokens changed to refer to this directory. At runtime P will use the images in the virtual directory, rather than its default image directory. Note, unless you plan to modify the P JSP source pages, the replacement images must be the same size as the originals. Common images replaced in P Token Name Description Size(pixels) pnet_logo2.gif The P logo on the login page 165 x 90 pnet_home_button.gif The P Home image on the login page 113 17 prm.global.header.banner.image The P image in the page header 103 x 50 edit Pre-requisites 1. If you have not created one, create a P configuration that will override the default configuration. 2. Choose a file system location to hold your replacement images (ex. C:pnetbrandimages, /opt/pnet/brand, etc). It is suggested to create a sub-directory for each P configuration or brand, if you have more than one configuration. 3. Figure out which image you want to replace and its size, a few of the commonly replaced images are listed above. From within a browser, right-click on the image, select Properties from the pop-up menu. From the properties dialog look at the Address (URL): entry and note the name of the image, which appears at the end of the URL. Also record the size of the image, listed in the Dimension field. 4. Create a replacement image the same type and size as the original; save it in the file system location chosen above. 5. Follow the remaining instructions based upon your configuration below. edit Adding Static Resources via a Tomcat Context Resource If you are using the Tomcat application server you can substitute static resources, such as a custom image, through a Tomcat context. The use of a context enables you to substitute customized images for Ps without touching the P EAR file. edit Instructions 1. The following instructions assume the alternate image is named mycompanyLogo.gif and is stored in a directory named /opt/pnet/branding/. Substitute the directory and filename as appropriate for your system. 2. Within APACHE_HOME/conf/Catalina/localhost/ create the the following file named pnet-branding.xml The value for docBase is the path to the base directory that will hold the alternate image. Use forward slashes (/) as directory separators in the path name. For Windows systems, you can include a drive designator (e.g. C:/ or D:/) at the beginning of the path. Context path=/pnet-branding docBase=/opt/pnet/branding 3. Restart Tomcat. 4. Login to P as an application administrator. 5. From within the Application Administration interface, chose Manage / Configurations. 6. Click on the name of your custom configuration from the list of configurations. 7. Choose Tokens from the menu on the left. 8. Search for the token representing the image you want to replace, for example ject.login.pnet_logo2 is the token for the logo on the login page. 9. Change its value to /. In our example, it would be: /pnet-branding/mycompanyLogo.gif This pathname should start with the last directory listed as docBase in conf-data.xml. 10. Apply the set