Posts tagged Alfresco
Customizing Simple Search
0Some time ago I made customized advanced search results view – no two boxes like in standard Alfresco, but three boxes – the third one for viewing special content type. Now I wanted to add this results screen as a default result of searching via the simple search box.
When I firstly saw r:simpleSearch component and no documentation, I wasn't happy. But after while I realized that it's very simple, thanks to actionListener parameter on that component:
<r:simpleSearch id="search" actionListener="#{BrowseSessionBean.search}" />
This component creates that very known search box
That action listener, search, is defined in BrowseBean, but I did my own (I copied and edited it
). All what this listener does is just setting Search Context and then redirects to results page – returns adequate outcome string to faces navigator.
public void search(ActionEvent event){
UISimpleSearch search = (UISimpleSearch)event.getComponent();
this.navigator.setSearchContext(search.getSearchContext());
FacesContext context = FacesContext.getCurrentInstance();
context.getApplication().getNavigationHandler().handleNavigation(context, null, "browseSearchResults");
}
Navigation rule in faces config navigates in this case from everywhere to my own search results page thanks to this rule:
<navigation-rule>
<from-view-id>/jsp/*</from-view-id>
<navigation-case>
<from-outcome>browseSearchResults</from-outcome>
<to-view-id>/jsp/archivace/view-search-results.jsp</to-view-id>
</navigation-case>
</navigation-rule>
That's all, view-search-results is up to you
Playing with titlebar and navigator II
0In last blogpost I wrote about titlebar and menu in it. Also I promised some navigator hacking, which is more complex (and crazy has many javascript code) and amazing, so I decided to write whole blogpost on it. Here we are go!
Navigator jsp is pretty simple, but it's not plus for us, because whole navigator is a component – r:navigator. That should not be a problem, but this component has no documentation and what is much worse, this component's aim is just to view that simple menu with Guest home, Alfresco home, My home and Company home. Nothing less, nothing more, no editings.So what to do with that crap? Let's do some hacking! You can see my result at following picture, I added one more link:
Navigator.jsp is in /jsp/sidebar/ and at start there is just that component:
<r:navigator id="navigator" activeArea="#{NavigationBean.toolbarLocation}" />
This component renders ahref links inside divs, like this:
<div id="navigator">
<div><a href="foo">bar</a></div>
<div><a href="bar">foo</a></div>
. . .
</div>
So I need to insert my own container with my link (both styled some way). ActionLink doesn't take 'class' attribute, so I need to inject that attribute with simple javascript:
<a:booleanEvaluator value="#{BrowseSessionBean.isArchivaceExist}">
<f:verbatim>
<div id="navigatorArchivaceBox" class="sidebarButton" style="background-image: url(/alfresco/images/parts/navigator_grey_gradient_bg.gif);">
</f:verbatim>
<a:actionLink id="navigatorArchivaceLink" value="Archivace" href="#{BrowseSessionBean.archivaceUrl}"/>
<f:verbatim>
<script type="text/javascript">
var link = document.getElementById("navigatorArchivaceLink");
link.setAttribute("class","sidebarButtonLink");
</script>
</div>
</f:verbatim>
</a:booleanEvaluator>
I personally hate that opening div inside verbatim tag and also that closing div, but what I can do else :-/. So this simple hack added my own link into navigator menu, it's clickable, it's styled, that link works, but that box is not selectable. After deploy this probably look like left picture a few rows higher. All that code is placed inside evaluator, because I need to have destination space accessible, to display this link in menu.
So next thing to do is to deselect all boxes and all links after 'my link' is clicked and also select my box and my link. Sounds simple, but it isn't thanks to 'My Alfresco' link. I'm doing all this stuff only when I'm at the right place (my Archivace space), so I need evaluator:
<a:booleanEvaluator value="#{BrowseSessionBean.isInsideArchivace}">
<f:verbatim>
Inside this evaluator I have simple javascript, which goes through elemnts under navigator container – links and divs – and for each set 'unselected' style:
<script type="text/javascript">
// disabling 'selected' style at all links
var links = document.getElementById("navigator").getElementsByTagName('a');
for(var i=0; i<links.length; i++){
links[i].setAttribute("class","sidebarButtonLink");
}// disabling 'selected' style at all boxes
var links = document.getElementById("navigator").getElementsByTagName('div');
for(var i=0; i<links.length; i++){
links[i].setAttribute("class","sidebarButton");
links[i].setAttribute("style","background-image: url(/alfresco/images/parts/navigator_grey_gradient_bg.gif)");
}
Now it's time to set 'selected' style just for my (selected) link. I know its ids, so I can access them directly through getElementById:
document.getElementById("navigatorArchivaceBox").setAttribute("style","background-image: url(/alfresco/images/parts/navigator_blue_gradient_bg.gif)");
document.getElementById("navigatorArchivaceLink").setAttribute("class","sidebarButtonSelectedLink");
And now all I have to do is 'just' to create evaluator – isInsideArchivace. That is not so hard – just getting current node and asking, if it has wanted aspect
.
public boolean getIsInsideArchivace(){
if(this.getCurrentLocation()==null)return false;
return this.navigator.getCurrentNode().hasAspect(cz.shmoula.ArchivaceModel.archSummary);
}
Now it's all doomed to work, like on first and second image
. BUT – 'My Alfresco' is not an ordinary space, it's some virtual space or something, so when I left my 'Archivace' space by clicking on 'My Alfresco', My Alfresco screen is opened, but selected option is still 'Archivace'. What to do? Look at breadcrumb, because when there is node, it's ordinary space. But when there's nothing, it's probably 'My Alfresco' space (if not, it doesn't matter, because it is not my 'Archivace' space) and it's neccessarynot to display 'Archivace' as selected node. Soall that is inside that getCurrentLocation, which fragments are stolen somewhere from Alfresco sources:
public String getCurrentLocation(){
List<IBreadcrumbHandler> location = this.navigator.getLocation();
String name = null;
if (location.size() != 0){
for (int i=0; i<location.size(); i++){
IBreadcrumbHandler element = location.get(i);
if (element instanceof IRepoBreadcrumbHandler){
NodeRef nodeRef = ((IRepoBreadcrumbHandler)element).getNodeRef();
name = Repository.getNameForNode(this.getNodeService(), nodeRef);
}
}
}
return name;
}
At this time it's all and it works! Ugly and hacky solution, but it works (FF3). Maybe it'll be better to write own component (eg. some tree browsing component), but now I wanted some simple and fast (and really ugly). Oh, I almost forget – this thread helped me a lot!
Playing with titlebar and navigator
0My next quest was to change content of titlebar and navigator box. Titlebar was really easy, but navigator box is 'hell itself', because it's r:navigator component and i didn't want to create another component just for adding one more line.
Titlebar editing is very easy. Final result is on following screenshot:
That topmenu is created by a styled a:modeList component with some listItems. ModeList has actionListener set and after listItem is clicked, its value is sent to that listener (which is a big switch). So my first task was to bridge that listener. Original code is placed in NavigationBean and that method is named toolbarLocationChanged. I wrote my own eventListener in 'someBean' this way:
public void toolbarLocationChanged(ActionEvent event){
UIModeList locationList = (UIModeList)event.getComponent();
String location = locationList.getValue().toString();
if(location.equals("archivace")){
. . .
}else this.navigator.processToolbarLocation(location, true);
In this piece of code is loaded 'location' – value of listItem (ie companyhome, userhome, archivace… see later) and is compared with identificator of my action.If equals, something happens (see next listing
), else original processToolbarLocation routine in NavigationBean is called.
That something piece of code, which happens in that case is creation of breadcrumb and some informations in NavigationBean are changed, follows here:
List<IBreadcrumbHandler> elements = new ArrayList<IBreadcrumbHandler>(1);
Node archivace = new Node(getArchivaceRef());
elements.add(new NavigationBreadcrumbHandler(archivace.getNodeRef(), archivace.getName()));
this.navigator.setLocation(elements);
this.navigator.setCurrentNodeId(archivace.getId());
But that is not all, you have to inform registered beans that the current area has changed:
UIContextService.getInstance(FacesContext.getCurrentInstance()).areaChanged();
And because the current node is not added to the dispatch context automaticaly, it's needed to add it programaticaly (this was very old bug of Alfresco and in some cases still lasts – forum, jira):
this.navigator.setupDispatchContext(this.navigator.getCurrentNode());
Last thing to do is to force a navigation to refresh the browse screen breadcrumb:
FacesContext context = FacesContext.getCurrentInstance();
context.getApplication().getNavigationHandler().handleNavigation(context, null, "browse");
That's all java coding. Now some jsp: you have to edit file titlebar.jsp in /jsp/parts/ and change actionListener in a:modeList and add another a:listItem as seen on next listing (simplified):
<a:modeList . . . actionListener="#{SomeBean.toolbarLocationChanged}">
<a:listItem value="archivace" label="Archivace" rendered="#{SomeBean.isArchivaceExist}"/>
</a:modeList>
Ah, I see there is evaluator – isArchivaceExist. It's just an evaluator, which returns true/false – if space I want to view exists, so that listItem is viewed just in case of that space exists.
As I can see, it'll be better to move navigator hacks to next blogpost.
Mimetype detection in upload component
0I posted short topic about my way to uploading files to Alfresco some time before. Now I turned all that code into my own component and added it to Tag Library and also added mimetype detection and some other amazing stuff. I'll try to describe some facts about my implementation in this blogpost, so be encouraged to keep reading
.
I'm not going to describe how to build own component, there are many tutorials on web (for example here or here) and it's much simplier than stuff I'm going to write about (many ughly javascript code). So let's begin.Firstly, thanks to component,jsp code is simplified. I compressed whole code into component (form inputs, labels, also js libraries includes), so my code lookslike this (note that javascript part is optional and is there just to disable OK button on page load; also mimetype selector is optional).
<%@ taglib uri="http://www.shmoula.cz/jsf/component/tags" prefix="shmoula" %>
<script type="text/javascript">
function pageLoaded(){
document.getElementById("dialog:finish-button").disabled = true;
}
window.onload = pageLoaded;
</script>. . .
<h:inputHidden id="fileId" value="#{SlowUpload.fileId}" />
<shmoula:upload label="soubor" />
<r:mimeTypeSelector id="mime-type" value="#{SlowUpload.mimeType}" />. . .
FileId parameter does still the same thing – it connects get data with post data – identificator is created and then AJAX call is made, in which goes this id and filename to servelt, which creates a new FileBean and also get mimetype from filename and send it back. You can see this snippet on following listing.
public void doGet(HttpServletRequest request,HttpServletResponse response)throws ServletException, IOException{
PrintWriter out = response.getWriter();
try{
// creating a new bean for fileinfo storing and also setting some info
this.fileUploadBean = new FileUploadBean();
this.uploadId = request.getParameter("uploadid");
String filename = request.getParameter("filename");// fetching mimetypeService from SlowUpload bean; more info follows
SlowUpload slowUpload = (SlowUpload)request.getSession().getAttribute("SlowUpload");
MimetypeService mimetypeService = slowUpload.getMimetypeService();
// guessing and returning mimetype
// if mimetype is not recognized, application/octet-stream is returned
out.print(mimetypeService.guessMimetype(filename));
}catch(Exception e){
out.print("FALSE");
}
}
MimetypeService must be injected into SlowUpload bean, so I need some Setters in my class for that and definition in Faces config:
<managed-bean>
<managed-bean-name>SlowUpload</managed-bean-name>
<managed-bean-class>cz.shmoula.SlowUpload</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
. . .
<managed-property>
<property-name>mimetypeService</property-name>
<value>#{MimetypeService}</value>
</managed-property>
. . .
</managed-bean>
Now onComplete function is called thanks to prototype library AJAX calling. In this function a right option in select box is selected just through a simple loop, as you can see:
function callbackFunction(originalRequest){
var vystup = new String(originalRequest.responseText);
if(vystup=="FALSE"){
rollback(1);
alert("Chyba pri uploadu");
}else{
var select = document.getElementById("dialog:dialog-body:mime-type");
for(i=0;i<select.length;i++){
var selectVal = new String(select.options[i].value);
if(selectVal.match(vystup)!=null){
select.options[i].selected = true;
select.selectedIndex = i;
break;
}
}
}
}
And after all this whole formular is sent to servlet via POST method. All this is described in previous post, so you can check it out there. But there is one change – servlet returns success of operation inside hidden input. So I changed servlet this way:
response.setContentType("text/html");
PrintWriter out = response.getWriter();
out.println(". . .<input type="hidden" id="iframe_status" value=""+this.fileUploadBean.getFileName()+"" />. . .");
On client side is after (un-)successfully file upload called handle_upload() function, which gets value from included iFrame and decides that operation was or was not successfull and call appropriate actions:
function handle_upload(){
var doc = getIframeDocument();
var filename = doc.getElementById("iframe_status").value;
if(filename != "FALSE"){
var fileNameInput = document.getElementById('dialog:dialog-body:fileName');
if(fileNameInput!=null)
fileNameInput.value = filename;
checkButtonState();
}else{
rollback(1);
alert("Chyba pri uploadu!");
}
}
CheckButtonState function does nothing else, than enable OK button for complete submit all those information (if some other conditions came true) and rollback function sets form target to original target – …/dialog/container.jsp.
That's all folks! Simplified procedure of my component activity. I wish I have not to write these hacks and all those things are accessible by developer in alfresco (they are there, but you can't use them outside specified containers or-how-to-name-that) some simple way. Maybe in future I hope!
Has properties webscript
0I did some other java based webscript. From portlet flash application I need to get information about some user's permissions on object specified by nodeRef. So firstly I tried to do this via JavaScript based webservice, but there are no tools to do this.
First thing is to create description xml for this service:
<webscript>
<shortname>hasRights</shortname>
<description>Returns some amazing info</description>
<url>/archivace/hasrights?u={userName}&s={nodeRef}&p={permissionName}</url>
<format default="xml"/>
<authentication>user</authentication>
<transaction>required</transaction>
</webscript>
As you can see, there are three parameters: u, which specifies userName of user, of which we want to get this information. Parameter s, which specifies nodeRef of node and finally p, which is optional and specifies one of permissions. If not set, WriteContent permission is used.
Space permissions:
- ReadProperties
- ReadChildren
- WriteProperties
- DeleteNode
- DeleteChildren
- CreateCildren
Content permissions:
- ReadContent
- WriteContent
- ReadProperties
- WriteProperties
- DeleteNode
- ExecuteContent
- SetOwner
You can find a complete list of all permisions in tomcat/webapps/alfresco/WEB-inf/classes/alfresco/model/permissionDefinitions.xml.
Now let's write some javacode: I created a class HasRights, which extends AbstractWebScript. Let's have a look into that code
public class HasRights extends AbstractWebScript{
private AuthenticationComponent authenticationComponent;
private PermissionService permissionService;public void execute(WebScriptRequest req, WebScriptResponse res)throws IOException {
try{
HttpServletRequest httpReq = ((WebScriptServletRequest)req).getHttpServletRequest();
String spaceRef = "workspace://SpacesStore/" +
(String)httpReq.getParameter("s");
String userName = (String)httpReq.getParameter("u");
String permission = (String)httpReq.getParameter("p");
if(permission==null)
permission = "WriteContent";
In case of this webScript is called method execute is the first to run (not exactly, setters of this class are called sooner – setAuthenticationComponent() and setPermissionService()) . In this method javax.servlet.http.HttpServletRequest is used for get parameters.
NodeRef nodeRef = new NodeRef(spaceRef);
Node noda = new Node(nodeRef);
this.authenticationComponent.setCurrentUser(userName);
In those steps Node and nodeRef objects are created and currently logged user is setted to wanted user.
res.setContentType("text/xml");
res.getWriter().write("<hasRightsResponse>");
res.getWriter().write("<nodeName>"+noda.getName()+"</nodeName>");
res.getWriter().write("<nodeRef>"+nodeRef.toString()+"</nodeRef>");
res.getWriter().write("<userName>"+this.authenticationComponent.getCurrentUserName()+"</userName>");
res.getWriter().write("<permissionName>"+permission+"</permissionName>");
res.getWriter().write("<hasPermission>"+this.permissionService.hasPermission(nodeRef, permission)+"</hasPermission>");
res.getWriter().write("</hasRightsResponse>");
After all that a response is printed out. Example of output is following:
<hasRightsResponse>
<nodeName>sezeni001.xml</nodeName>
<nodeRef>workspace://SpacesStore/da5ad5b0-3bc4-4d4c-88fe-4f9cf4f349f5</nodeRef>
<userName>pepik1</userName>
<permissionName>WriteContent</permissionName>
<hasPermission>DENIED</hasPermission>
</hasRightsResponse>
I forgot to mention the most importatn step – to define a bean with this webscript. So it looks like this (in web-scripts-application-context.xml):
<bean id="webscript.org.alfresco.archivace.hasrights.get" class="cz.shmoula.webscripts.HasRights" parent="webscript">
<property name="authenticationComponent" ref="AuthenticationComponent"/>
<property name="permissionService" ref="PermissionService"/>
</bean>
And that's it, pretty simple
.




Nejnovější komentáře