Movatterモバイル変換

[0]ホーム
URL:

In: content-servicesIn: All docs
Close
Alfresco Content Services

Admin Console Component Extension Point

Extension modules that needs some form of administration interface can be supported by a custom Admin Console Component.

Architecture Information:Platform Architecture

Description

TheRepo Admin Console provides a way of managing services integrated into Alfresco, or built on as extensions. Installed modules can have a custom Admin Console component, so that they can be managed from the well-known interface of the Admin Console. You will see how to create a custom Admin Console component that displays already available MBean data but in a different layout. Displaying custom MBean data will be done in the same way.

The finished result will look something like this:

dev-extensions-repo-admin-console-component-custom

Here you have added a new section calledCustom Stuff and as a sub-section we haveCustomized Admin Console - Tutorial. The custom page displays information already available in other sections, but is laid out differently.

A custom component is added by implementing aRepository web scripts. The descriptor is as follows:

<webscript>   <shortname>Customized Admin Console - Tutorial</shortname>   <description>Admin Console WebScript that displays a simple page.></description>   <url>/enterprise/admin/admin-tutorial</url>   <family>AdminConsole</family>   <format default="html">argument</format>   <authentication>admin</authentication>   <lifecycle>internal</lifecycle>   <transaction allow="readonly">required</transaction></webscript>

There are several important things here that control if this component is going to work correctly and be visible on the Admin Console page:

  • url - the Admin Console is available only in the Alfresco Enterprise edition, and as the name suggests, for administrators. So theurl should begin with/enterprise/admin
  • family - if the custom component is going to be visible at all, then it needs to belong to theAdminConsole web scriptsfamily
  • authentication - the Admin Console is for administrators only soauthentication should be set toadmin

You will be able to access this Admin Console component page directly via thehttp://localhost:8080/alfresco/service/enterprise/admin/admin-tutorial url, this can be useful when we just want to make sure the page (i.e. web scripts) works.

With this descriptor you have a component that will be added to the Admin Console page automatically, and by default located just under theSystem Summary section. To have the new component listed under a specific section you need to store the web scripts at a specific directory path. For example, to add your component to theConsoles section, you need to store the component web scripts in thealfresco/extension/templates/webscripts/org/alfresco/enterprise/repository/admin/consoles directory. If you wanted it located in theSupport Tools section you should store it in the.../admin/support-tools directory and so on. To have the new component located in a new section likeCustom Stuff you create a new directory that does not previously exist, such as.../admin/custom-stuff in our case.

You can then localize the section name by providing a resource file with the following property set:

admin-console.tool.group.custom-stuff=Custom Stuff

When the descriptor is finished and located in the appropriate directory you can continue with the web scripts controller:

<import resource="classpath:alfresco/enterprise/webscripts/org/alfresco/enterprise/repository/admin/admin-common.lib.js">Admin.initModel(   "Alfresco:Name=License",   ["Subject", "LicenseMode", "Issued", "RemainingDays"],   "admin-tutorial");

What you do here is let the Admin Console system know what MBean properties you want to use in our custom component. In this case it is the “Subject”, “LicenseModel”, “Issued”, and “RemainingDays” properties.

These properties are available in the MBean called “License”, you can see it by runningJConsole and connecting to Content Services:

dev-extensions-repo-admin-console-mbeans

After the controller you implement the web scripts template, which contains the page layout:

<#include "/org/alfresco/enterprise/repository/admin/admin-template.ftl" /><@page title=msg("tutorial.title")>      <div>      <@section label=msg("tutorial.column") />      <#-- tutorial - Retrieve keys - which are attribute names - use to index into attribute hash -->      <#list attributes?keys as a>         <@control attribute=attributes[a] />      </#list>   </div>      <div>      <@section label=msg("tutorial.leftcolumn") />      <#-- tutorial - Retrieve values - which are attributes -->      <#list attributes?values as a>         <@control attribute=a />      </#list>   </div>   <div>      <@section label=msg("tutorial.rightcolumn") />      <#-- tutorial - Retrieve values - which are attributes -->      <#list attributes?values as a>         <@control attribute=a />      </#list>   </div>   </@page>

Here you loop through the MBean properties (attributes), you can also obtain them directly like this:

<@control attribute=attributes["Subject"] />

The template uses a number of resource properties that are fetched with themsg function.

The web scripts i18n resource file need to have them specified as follows:

tutorial.title=Customized Admin Console Pagetutorial.column=Main Columntutorial.leftcolumn=Left Columntutorial.rightcolumn=Right Column

This is all there is to it. If you have your own services and module components exposing MBeans, then you can display and control them in a similar way, just change the controller to point to the MBean and the properties you want to display.

Deployment - App Server

  • tomcat/shared/classes/alfresco/extension/templates/webscripts/... see SDK project below for directory path - Descriptor, JavaScript controller, template, properties files (Untouched by re-deployments and upgrades)

Deployment All-in-One SDK project

  • aio/platform-jar/src/main/resources/alfresco/extension/templates/webscripts/org/alfresco/enterprise/repository/admin/[general|support-tools|consoles|email-services|repository-services|user-directories|virtual-file-systems|{custom section id}] - Descriptor, JavaScript controller, template, properties files
  • aio/platform-jar/src/main/resources/alfresco/module/platform-jar/messages/some-admin.console.properties - properties used in the web scripts template
  • aio/platform-jar/src/main/resources/alfresco/module/platform-jar/context/bootstrap-context.xml - i18n resource loading Spring Bean

More Information

Sample Code

Edit this page

Suggest an edit on GitHub
By clicking "Accept Cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts.View Cookie Policy.
[8]ページ先頭
©2009-2025 Movatter.jp