Alfresco

Contents supported for onlineEdit

2012-01-29T22:40:00.000-08:00

application/msword	"Word.Document"
	application/vnd.ms-excel	"Excel.Sheet"
	application/vnd.ms-powerpoint	"PowerPoint.Slide"
	application/vnd.openxmlformats-officedocument.presentationml.presentation	"PowerPoint.Slide"
	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	"Excel.Sheet"
	application/vnd.openxmlformats-officedocument.wordprocessingml.document We can get this value from the code /** * Configure the Online Edit URL if enabled for this mimetype */ if (scope.doclistMetadata.onlineEditing && (record.mimetype in scope.onlineEditMimetypes)) { from the file documentlist.js in Alfresco3.4.5

Thumbnail

2012-01-27T00:35:00.000-08:00

http://ecmarchitect.com/archives/2009/03/03/913

The above link talks about the Thumbanil generation from the image

Problem in Thumbnail generation and JVM settings

2012-01-25T01:12:00.000-08:00

JAVA_OPTS configuration can be seen in /opt/alfresco/tomcat/scripts
Inside this we will have the file name by name ctl.sh.
To make the thumbnails to work we should add -Djava.awt.headless=true in ctl.sh file

#!/bin/sh

CATALINA_HOME=/opt/alfresco/tomcat
TOMCAT_BINDIR=/opt/alfresco/tomcat/bin
JRE_HOME=/opt/alfresco/java
CATALINA_PID=/opt/alfresco/tomcat/temp/catalina.pid
export CATALINA_PID
TOMCAT_STATUS=""
ERROR=0
PID=""

start_tomcat() {
is_tomcat_running
RUNNING=$?
if [ $RUNNING -eq 1 ]; then
echo "$0 $ARG: tomcat (pid $PID) already running"
else
rm -f $CATALINA_PID
export JAVA_OPTS="-Xms512m -Xmx1024m -Xss1024k -XX:MaxPermSize=256m -XX:NewSize=256m -XX:+UseConcMarkSweepGC -Dalfresco.home=/opt/alfresco -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.ssl=false -Djava.awt.headless=true"
export JAVA_HOME=$JRE_HOME
$TOMCAT_BINDIR/startup.sh
if [ $? -eq 0 ]; then
echo "$0 $ARG: tomcat started"
else
echo "$0 $ARG: tomcat could not be started"
ERROR=1
fi
fi
}

daemon_tomcat() {
export JAVA_OPTS="-Xms512m -Xmx1024m -Xss1024k -XX:MaxPermSize=256m -XX:NewSize=256m -XX:+UseConcMarkSweepGC -Dalfresco.home=/opt/alfresco -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.ssl=false -Djava.awt.headless=true"
export JAVA_HOME=$JRE_HOME
$TOMCAT_BINDIR/catalina.sh run
}

stop_tomcat() {
$TOMCAT_BINDIR/shutdown.sh 300 -force
if [ $? -eq 0 ]; then
echo "$0 $ARG: tomcat stopped"
if [ -f $CATALINA_PID ] ; then
rm $CATALINA_PID
fi
sleep 3
else
echo "$0 $ARG: tomcat could not be stopped"
ERROR=2
fi
}

get_pid() {
PID=""
PIDFILE=$1
# check for pidfile
if [ -f $PIDFILE ] ; then
PID=`cat $PIDFILE`
fi
}

get_tomcat_pid() {
get_pid $CATALINA_PID
if [ ! $PID ]; then
return
fi
}

is_service_running() {
PID=$1
if [ "x$PID" != "x" ] && kill -0 $PID 2>/dev/null ; then
RUNNING=1
else
RUNNING=0
fi
return $RUNNING
}

is_tomcat_running() {
get_tomcat_pid
is_service_running $PID
RUNNING=$?
if [ $RUNNING -eq 0 ]; then
TOMCAT_STATUS="tomcat not running"
else
TOMCAT_STATUS="tomcat already running"
fi
return $RUNNING
}

if [ "x$1" = "xstart" ]; then
start_tomcat
sleep 2
elif [ "x$1" = "xdaemon" ]; then
daemon_tomcat
elif [ "x$1" = "xstop" ]; then
stop_tomcat
sleep 2
elif [ "x$1" = "xstatus" ]; then
is_tomcat_running
echo $TOMCAT_STATUS
fi

exit $ERROR

JVM Details

2012-01-24T22:17:00.000-08:00

http://www.unidata.ucar.edu/projects/THREDDS/tech/tds4.2/reference/JavaOptsSummary.html

TDS Reference: Summary of JAVA_OPTS

Note: This page focuses on Tomcat running on a Unix/Linux OS but much of it is appropriate for other servlet containers and other OSs. How and where the various options are configured will depend on the servlet container and OS you are using.

You can set JAVA_OPTS in the ${TOMCAT_HOME}/bin/setenv.sh file. The options discussed below are the ones we set on our production server.

Memory Available to the Java JVM

Increasing the memory available to the Java JVM can help TDS performance (see more on TDS performance here). Try to give your server as much memory as you can. The following are reasonable numbers to start with but if you have more memory increase these numbers. [Note: 32-bit JVMs max out around 1500m.)

JAVA_OPTS="-Xmx1024m -Xms256m" export JAVA_OPT

What the options mean:

-Xmx sets the maximum amount of memory that can be allocated to the JVM heap; here it is being set to 1024 megabytes.
-Xms sets the initial amount of memory allocated to the JVM heap; here it is being set to 256 megabytes.

Run Java JVM in Server Mode

The Java JVM can optimize a number of things for server environments. [Since Java 5, the launcher tries to detect whether it is running on a "server-class" machine and set this for you (more on this here). But ...] You can explicitly select the Java HotSpot Server VM with the -server option.

JAVA_OPTS="-Xmx1024m -Xms256m -server" export JAVA_OPT

What the option means:

-server instructs the launcher to use the Java HotSpot Server VM.

PermGen Memory

If you start getting java.lang.OutOfMemoryError: PermGen space error messages. You may want to include a "-XX:MaxPermSize" option in your JAVA_OPTS. See the PermGen FAQ entry for more information on this problem.

JAVA_OPTS="-Xmx1024m -Xms256m -server -XX:MaxPermSize=128m" export JAVA_OPT

What the option means:

-XX:MaxPermSize set the maximum amount of memory that can be used for PermGen.

If Using WMS, Tell Graphics Engine There is No Console

An obscure bug concerning X servers and graphics rendering code can cause WMS requests to fail or, in certain situations, cause Tomcat to crash. You may see error messages like the following:

"java.lang.NoClassDefFoundError: Could not initialize class sun.awt.X11GraphicsEnvironment"

To avoid this situation, the graphics code needs to be told that there is no graphics console available. This can be done by setting the java.awt.headless system property to true which can be done using JAVA_OPTS:

JAVA_OPTS="-Xmx1024m -Xms256m -server -Djava.awt.headless=true" export JAVA_OPT

What the option means:

-Djava.awt.headless=true sets the value of the java.awt.headless system property to true. Setting this system property to true prevent graphics rendering code from assuming that a graphics console exists.

More on using the headless mode in Java SE here.

If Using WMS, Setup Writable Directory for System java.util.prefs.

Some libraries that WMS depends on use the java.util.prefs package and there are some known issues that can crop up with storing system preferences. This problem can be avoided by setting the java.util.prefs.systemRoot system property to point to a directory in which the TDS can write. The given directory must exist and must contain a directory named ".systemPrefs" which must be writable by the user under which Tomcat is run.

JAVA_OPTS="-Xmx1024m -Xms256m -server -Djava.util.prefs.systemRoot=$CATALINA_HOME/content/thredds/javaUtilPrefs" export JAVA_OPT

What the option means:

-Djava.util.prefs.systemRoot= sets the value of the java.util.prefs.systemRoot system property to the given directory. The java.util.prefs code will use the given directory to persist the system (as opposed to user) preferences.

More information on the issue can be found on the TDS FAQ page.

Our production setenv.sh file looks like:

#!/bin/sh # ulimit -n 2048  CATALINA_HOME="/opt/tomcat" export CATALINA_HOME  JAVA_HOME="/opt/jdk" export JAVA_HOME  # Some commonly used JAVA_OPTS settings: # NORMAL="-d64 -Xmx4090m -Xms512m -server" MAX_PERM_GEN="-XX:MaxPermSize=256m" HEADLESS="-Djava.awt.headless=true" JAVA_PREFS_SYSTEM_ROOT="-Djava.util.prefs.systemRoot=$CATALINA_HOME/content/thredds/javaUtilPrefs"  # Standard setup. # JAVA_OPTS="$NORMAL $MAX_PERM_GEN $HEADLESS $JAVA_PREFS_SYSTEM_ROOT" export JAVA_OPTS

Server Performance

Hardware

Throw more $$ at this problem, hardware is cheap, compared to people.

It would be highly unusual for the TDS not to be I/O bound, so buying a high-performance disk subsystem is much better than buying fast CPUs. Slower, more energy efficient multicore processors are optimized for web server loads.

Typically disk access is faster on a local drive than on an NFS mounted drive. High performance disk subsystems like RAID or SANs can also significantly improve TDS throughput.

Operating System Configuration

Use a 64-bit OS

'nuff said

Use a high-performance file system

If you have system admin resources, examine the possible file systems available for your OS, eg on Linux or Solaris. We are using the ZFS file system on Solaris-X86 and it is very fast. We use ZFS software RAID, which replaces hardware RAID.

Resources:

Setting the number of file handles

The OS typically limits the number of open file handles per process. To check this value on Unix, use:

 ulimit -n

If you are using the default TDS configuration values, this value should be 1024 or greater. Otherwise you can tune this number based on your own settings. For example, to set this value to 2048 in the tomcat startup.sh script:

 ulimit -n 2048

This affects the number of files to keep in the NetcdfFile Object Cache.

Java Virtual Machine

Use a 64-bit JVM with -server

You may have to examine the docs for your JVM on how to do this. Below are the options we use for Sun Solaris 1.6 JVM, which requires -d64 to run the 64 bit version
You should run with the Java HotSpot Server VM, by using the -server option.
You should give the JVM as much memory as possible. Here we give it 4 Gbytes. The maximum you can use for 32-bit JVMs seems to be around 1500 Mbytes

-d64 -Xmx4081m -Xms512m -server -XX:MaxPermSize=256m -XX:+HeapDumpOnOutOfMemoryError -Djava.awt.headless=true

-XX:+HeapDumpOnOutOfMemoryError triggers a heap dump when you run out of memory. We recommend the Memory Analyser from Eclipse to explore heap dumps.
-Djava.awt.headless=true tells the system that there is not a graphics console being used, which avaois some arcane errors from third party libraries.

We recommend the latest version of JDK 1.6, which has typically a 20% performance improvement or more over 1.5, especially with the -server option. We have not yet had a chance to compare performance of 32-bit vs 64-bit JVMs. However, 64-bit JVMs allow the use of much larger memory heaps, which will help for highly loaded systems.

Resources

Java Performance Tuning website with tuning tips
Java Tuning White Paper whitepaper from Sun (2005)
Java performance tuning, Jack Shirazi (O'Reilly, 2003), classic book, a bit dated.

Tomcat

Version

We recommend the latest stable version of Tomcat 6, which has better stability and performance than Tomcat 5.x. This requires JDK 1.5 or above.

Compression

Tomcat can be configured to automatically compress the responses, whenever the client allows that. Compression is usually a big win, especially for bandwidth-limited sites. Deciding when and what to compress depends on a lot of factors, however. We use the following settings in server.xml:

    
  compression="1000"
             compressableMimeType="text/html,text/xml,text/plain,application/octet-stream" />

This says to compress (gzip or deflate) when the number of bytes is >= 1000, for the named mime-types. See Tomcat HTTP Connector reference page for more details.

Automatic Startup

In a production environment, Tomcat should be automatically restarted when the machine starts. How to do this depends on what OS you are running. This FAQ has a bit of info.

Miscellaneous

Once thredds.war is expanded, manually copy everything in ${tomcat_home}/webapps/thredds/initialContent/root/ to ${tomcat_home}/webapps/ROOT/ .

This sets up a robots.txt file to keep crawlers from wasting bandwidth.
The favicon.ico file is mostly a convenience to keep browsers from constantly asking for it (substitute your own icon if you like!).

Resources

Tomcat Performance FAQ
Tomcat Performance paper by Peter Lin
Tomcat Performance Tuning paper at Apache Con 2003
Servlet Container Benchmarking (2004)
Tomcat Tuning free online chapter in Tomcat: The Definitive Guide (2007). Check out the timings between Tomcat and Apache.

Thredds Data Server

File Handles and Caching

The TDS caches file handles to minimize OS overhead. Currently this defaults to allow 200 - 400 open files for OPeNDAP and WCS, and 25 - 40 for HTTP file serving. This means that your OS must allow at least that many file handles per process, otherwise you can get a "out of file handles" message, and the server can freeze up.

These numbers limit performance, but not functionality. For example, the number of files in an aggregation is not limited by these file handle limits.

You can change these settings in the threddsConfig.xml file.

Each NetcdfFile object encapsolates a file. NcML aggregations are careful not to keep component files open. When number of cache files > maxElementsInMemory, a cleanup thread starts after 100 msecs. So the number of cached files can get larger than maxElementsInMemory in the interim, but unless you are really hammering the OS by opening many files per scond, it shouldnt get too much bigger. But leave some cushion, depending on your expected rate of opening files.

Consolidate cache / temporary directories

The TDS writes temporary files and caches files. By default these are stored under ${tomcat_home}/content/thredds/cache. These directories can get large. You might want to relocate them to another place, for example if ${tomcat_home} has limited space. Also, theres no need to backup the cache directories, so they can be placed on a disk that is not backed up. The easiest thing to do is to create a symbolic link from ${tomcat_home}/content/thredds/cache to wherever you want thes files to live.

OPeNDAP Memory Use

The OPeNDAP-Java layer of the server currently has to read the entire data request into memory before sending it to the client (we hope to get a streaming I/O solution working eventually). Generally clients only request subsets of large files, but if you need to support large data requests, make sure that the -Xmx parameter above is set accordingly.

Pre-indexing GRIB files

If you are serving GRIB files through any of the subsetting services (OPENDAP, WCS, etc), the CDM must write an index the first time it tries to read it. This can take several minutes for very large GRIB files. By indexing GRIB files before they are accessed, users get much faster response time.

JVM settings recommendation from Sun
http://java.sun.com/performance/reference/whitepapers/tuning.html

Kaleo workflow

2012-01-24T18:45:00.000-08:00

More details you can find here

http://l154k.blogspot.com/2011/11/10-things-programmer-should-know-about.html

Debugging with eclipse in server

2012-01-03T02:08:00.000-08:00

if [ -z "$LOGGING_MANAGER" ]; then
JAVA_OPTS="$JAVA_OPTS -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Xdebug -Xrunjdwp:transport=dt_socket,address=7777,server=y,suspend=n"
else
JAVA_OPTS="$JAVA_OPTS $LOGGING_MANAGER -Xdebug -Xrunjdwp:transport=dt_socket,address=7777,server=y,suspend=n"
fi

Add above line in catalina.sh present in /opt /alfresco/tomcat/bin

Logging webscripts in alfresco

2011-12-30T06:22:00.000-08:00

Logging API

A root level object 'logger' is provided that provides functions to aid debugging of scripts.

boolean isLoggingEnabled(): Return true if console logging is enabled. To enable console logging the Log4J category of log4j.logger.org.alfresco.repo.jscript should be set to DEBUG. This can be applied in the log4j.properties file (Tomcat) or log4j.xml file (JBoss) on the Alfresco server.

void log(string): Log a string message to the console.

vi /tomcat/webapps/alfresco/WEB-INF/classes/log4j.properties
 
log4j.logger.org.alfresco.repo.jscript=debug

Alfresco Ephesoft

2011-12-26T03:55:00.000-08:00

http://tpeelen.wordpress.com/2010/12/23/alfresco-and-ephesoft-overview/

Solr Tutorial

2011-12-26T03:39:00.000-08:00

http://wiki.apache.org/solr/Solrj#Directly_adding_POJOs_to_Solr

Coding practices to be followed in share

2011-12-22T18:25:00.000-08:00

http://wiki.alfresco.com/wiki/3.0_Component_Standards

SSO Authentication filter, passing our custom header

2011-12-13T18:59:00.000-08:00

/**
*
*/
package com.patil.web.site.servlet;

import java.io.IOException;

import javax.servlet.FilterChain;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.http.HttpServletRequest;

import org.alfresco.web.site.servlet.SSOAuthenticationFilter;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.extensions.surf.site.AuthenticationUtil;

/**
* @author basanagowda.patil
*
*/
public class Patil extends SSOAuthenticationFilter {

private static Log LOGGER = LogFactory.getLog(Patil.class);

@Override
public void doFilter(ServletRequest sreq, ServletResponse sresp,
FilterChain chain) throws IOException, ServletException {

// Get the HTTP request/response/session
HttpServletRequest req = (HttpServletRequest) sreq;
String ctuser = req.getHeader("CTUSER");
String alfrescoSystemuser = req.getHeader("X-Alfresco-Remote-User");
if(LOGGER.isDebugEnabled()){
LOGGER.debug("Getting users CTUSER " + ctuser
+ " X-Alfresco-Remote-User " + alfrescoSystemuser);

}
String user = (ctuser == null || "".equals(ctuser)) ? alfrescoSystemuser : ctuser;
if (user != null) {
AuthenticationUtil.login(req, user);
}

super.doFilter(sreq, sresp, chain);
}

}

In the web.xml you should have the entry for the custom filter

Alfresco Project Slingshot

Alfresco Project Slingshot application

org.jboss.jbossfaces.WAR_BUNDLES_JSF_IMPL

true

Spring config file location

contextConfigLocation

/WEB-INF/classes/web-application-config.xml

Set HTTP cache Expires header 30 days forward for a mapping.

CacheExpiresFilter

org.alfresco.web.scripts.servlet.StaticAssetCacheFilter

Add an Expires Header 30 days forward

expires

MT authentication support - NOTE: does not support portlets

MTAuthentationFilter

org.alfresco.web.site.servlet.MTAuthenticationFilter

Redirects view and service URLs to the dispatcher servlet.

UrlRewriteFilter

org.tuckey.web.filters.urlrewrite.UrlRewriteFilter

Share SSO authentication support filter.

Authentication Filter

com.patil.web.site.servlet.Patil

endpoint

alfresco

CacheExpiresFilter

*.jpg

CacheExpiresFilter

*.png

CacheExpiresFilter

*.gif

CacheExpiresFilter

*.css

CacheExpiresFilter

*.js

Authentication Filter

/page/*

Authentication Filter

/p/*

Authentication Filter

/proxy/*

UrlRewriteFilter

/proxy/*

Authentication Filter

/service/*

UrlRewriteFilter

/service/*

UrlRewriteFilter

/feedservice/*

UrlRewriteFilter

/res/*

UrlRewriteFilter

/system/*

MTAuthentationFilter

/page/*

MTAuthentationFilter

/p/*

org.springframework.web.context.ContextLoaderListener

Spring Surf Dispatcher Servlet

org.springframework.web.servlet.DispatcherServlet

contextAttribute

org.springframework.web.context.WebApplicationContext.ROOT

Spring Surf Dispatcher Servlet

/page/*

Spring Surf Dispatcher Servlet

/p/*

index.jsp

500

/error500.jsp

SCAN tool

2011-12-11T19:58:00.000-08:00

1. SCAN can browse files from network file system
2. SCAN will store the indexes in the location
C:\Documents and Settings\basanagowda.patil\.scan\repository
You can get this location from

To remove the SCAN data, delete the directory where it is located. You can find the actual path of this directory
in the Repository path field of SCAN configuration dialog (Tools→Configure...).

Cloud Alfresco

2011-11-17T07:00:00.001-08:00

We can host apps in the url

http://jelastic.com/

JMX Dump

2011-11-09T11:59:00.000-08:00

We can get jmx dump using below url

http://localhost:8080/alfresco/faces/jsp/admin/jmx-dumper.jsp

Conditionally hiding header in Alfresco share

2011-11-08T12:55:00.000-08:00

We can conditionally show or hide the headers in Share.
Share accepts the ftl expression and based on that it decides whether to show or hide the link.

{userdashboardpage}
{myhomeHersheys}
Alfresco.module.Sites
/people-finder
condition="user.properties['email']?ends_with('@patil.com')" >/repository

SSO to share

2011-11-08T11:39:00.000-08:00

All the people feel that alfresco share is not easy.

Follow the below steps

1. From your web server set the REMOTE_USER
Make sure you are getting remoteuser by getting that value in the jsp

2, In the tomcat disable the tomcat authentication so that you will get
req.getRemoteUser()

tomcatauthentication="false">

3. No need to change the X-Alfresco-RemoteUSer
as it will check for remoteuser i it does not exist then only it will check for the X-Alfresco-Remote User

Setting REMOTE_USER

2011-11-07T05:59:00.000-08:00

One way to do this is to put an apache front-end with a ajp1.3 connector with basic auth, i.e.:

a) create a /usr/local/apache2/conf/workers.properties file with:

-------------------------
worker.list=alexwk,jkstatus
worker.alexwk.host=127.0.0.1
worker.alexwk.port=8009
worker.alexwk.type=ajp13
worker.alexwk.lbfactor=100
-------------------------

b) in apache httpd.conf:

-------------------------
JkworkersFile "/usr/local/apache2/conf/workers.properties"

ServerName alfjk2.foo
JkLogFile "/usr/local/apache2/logs/mod_jk_2.log"
JkMount /alfresco alexwk
JkMount /alfresco/* alexwk
JkMount /share alexwk
JkMount /share/* alexwk
JkLogLevel info

AuthType Basic
AuthName "Test Basic Auth"
AuthUserFile /usr/local/apache2/passtest.txt
Require valid-user

-------------------------

4) In tomcat server.xml, define an ajp13 connector turning off tomcat authentication:

5) generate a password file with admin/admin:
/usr/local/apache2/bin/htpasswd -c /usr/local/apache2/passtest.txt admin

6) check the cgi variable setup putting in a new file
'tomcat/webapps/alfresco/test.jsp':

-------------------------
getRemoteUser() is set to:
<% out.print (request.getRemoteUser()); %>
-------------------------
and go to:

http://alfjk2.foo/alfresco/test.jsp

You should see the name of the HTTP user.

This is been taken from
https://issues.alfresco.com/jira/browse/ALF-4230

Updataing the jar file with the existing class

2011-11-03T08:23:00.000-07:00

update="true" duplicate="preserve" >

Here we need to put duplicate="preserve" so that only one file will be considered.

Liferay and Alfresco Doclib integration

2011-10-28T22:41:00.000-07:00

Alfresco uses org.springframework.extensions.webscripts.connector.HttpConnector to talk with
Alfresco. This has the hardcoded value
headers.put("X-Alfresco-Remote-User", user);

Since it is hardcoded,if we change the value of th eheader then the authentication will not be respected.

So change the code to fir the your custom external key CTUSER defined in your external file.

alfresco-noauth
Alfresco - unauthenticated access
Access to Alfresco Repository WebScripts that do not require authentication

alfresco

http://localhost:8080/alfresco/s

none

alfresco-feed
Alfresco Feed
Alfresco Feed - supports basic HTTP authentication

http

http://localhost:8080/alfresco/s

true

user

alfrescoCookie
Alfresco Connector
Connects to an Alfresco instance using cookie-based authentication
org.springframework.extensions.webscripts.connector.AlfrescoConnector

alfresco
Alfresco - user access
Access to Alfresco Repository WebScripts that require user authentication

alfrescoCookie

http://localhost:8080/alfresco/wcs

user

true

Finding the pid of the server running in alfresco

2011-10-27T09:26:00.000-07:00

halfwd01:#cd /opt/alfresco/
halfwd01:#find . -name '*.pid'
./tomcat/temp/catalina.pid
halfwd01:#cat ./tomcat/temp/catalina.pid
16789
halfd01:#ps -elf|grep java
0 S patil 14735 14413 0 77 0 - 15296 - 12:24 pts/3 00:00:00 grep java
0 S alfresco 16789 1 5 84 0 - 522368 futex_ Oct26 ? 01:15:21 /opt/alfresco/java/bin/java -Djava.util.logging.config.file=/opt/alfresco/tomcat/conf/logging.properties -Xms512m -Xmx1024m -Xss1024k -XX:MaxPermSize=256m -XX:NewSize=256m -XX:+UseConcMarkSweepGC -Dalfresco.home=/opt/alfresco -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.ssl=false -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djava.endorsed.dirs=/opt/alfresco/tomcat/endorsed -classpath /opt/alfresco/tomcat/bin/bootstrap.jar -Dcatalina.base=/opt/alfresco/tomcat -Dcatalina.home=/opt/alfresco/tomcat -Djava.io.tmpdir=/opt/alfresco/tomcat/temp org.apache.catalina.startup.Bootstrap start
halfd01:#

ldap sync in Alfresco

2011-10-20T07:57:00.001-07:00

org.alfresco.repo.security.sync.UserRegistrySynchronizerJob

${synchronization.synchronizeChangesOnly}

${synchronization.import.cron}

From here it calls

ChainingUserRegistrySynchronizer.java has a method by name

syncWithPlugin

private void syncWithPlugin(final String zone, UserRegistry userRegistry, boolean forceUpdate,
boolean allowDeletions, boolean splitTxns, final Set visitedZoneIds, final Set allZoneIds)

It has

final BatchProcessor personProcessor = new BatchProcessor(zone
+ " User Creation and Association", this.transactionService.getRetryingTransactionHelper(),
userRegistry.getPersons(lastModified), this.workerThreads, 10, this.applicationEventPublisher,

userRegistry.getPersons(lastModified)

It calls LDAPUSerRegistry

/*
* (non-Javadoc)
* @see org.alfresco.repo.security.sync.UserRegistry#getPersons(java.util.Date)
*/
public Collection getPersons(Date modifiedSince)
{
return new PersonCollection(modifiedSince);
}

which in turn calls PersonCollection. The PersonCollection has the constructor to initialize the query

PersonIterator has the next to get the users from the system

private NodeDescription fetchNext() throws NamingException
{
boolean readyForNextPage;
do
{
readyForNextPage = this.searchResults == null;
while (!readyForNextPage && this.searchResults.hasMore())
{
SearchResult result = this.searchResults.next();
Attributes attributes = result.getAttributes();
Attribute uidAttribute = attributes.get(LDAPUserRegistry.this.userIdAttributeName);
if (uidAttribute == null)
{
if (LDAPUserRegistry.this.errorOnMissingUID)
{
throw new AlfrescoRuntimeException(
"User returned by user search does not have mandatory user id attribute "
+ attributes);
}
else
{
LDAPUserRegistry.logger
.warn("User returned by user search does not have mandatory user id attribute "
+ attributes);
continue;
}
}
String uid = (String) uidAttribute.get(0);

if (this.uids.contains(uid))
{
LDAPUserRegistry.logger
.warn("Duplicate uid found - there will be more than one person object for this user - "
+ uid);
}

this.uids.add(uid);

if (LDAPUserRegistry.logger.isDebugEnabled())
{
LDAPUserRegistry.logger.debug("Adding user for " + uid);
}

// Apply the mapped properties to the node description
return mapToNode(LDAPUserRegistry.this.personAttributeMapping,
LDAPUserRegistry.this.personAttributeDefaults, result);
}

// Examine the paged results control response for an indication that another page is available
if (!readyForNextPage)
{
readyForNextPage = LDAPUserRegistry.this.ldapInitialContextFactory.hasNextPage(this.ctx,
LDAPUserRegistry.this.queryBatchSize);
}

// Fetch the next page if there is one
if (readyForNextPage)
{
this.searchResults = this.ctx.search(LDAPUserRegistry.this.userSearchBase,
PersonCollection.this.query, this.userSearchCtls);
}
}
while (readyForNextPage);
this.searchResults.close();
this.searchResults = null;
this.ctx.close();
this.ctx = null;
return null;
}

Link for CKEditor config

2011-10-18T18:47:00.001-07:00

http://blog.tommed.co.uk/?p=31

Open Office Trouble shooting

2011-10-17T12:58:00.001-07:00

http://wiki.knowledgetree.org/Troubleshooting_OpenOffice.org_Service

testing the service

ps -aux | grep soffice

Cron jobs

2011-10-11T07:22:00.000-07:00

30 1 * * * --- every day 1:30

http://www.quartz-scheduler.org/docs/tutorials/crontrigger.html

http://www.abunchofutils.com/utils/developer/cron-expression-helper/
http://www.cronmaker.com/

0 0 23 1/1 * ? * --- Every day night 11'o clock

WebServices for Alfresco

2011-10-06T05:45:00.001-07:00

http://wiki.alfresco.com/wiki/IngresTutorial_Alfresco_Web_Service_API_for_Java

org.alfresco.webservice.test.ContentServiceSystemTest

It has more explainations on the content upload through stream

Converting InputStream to byte for ByteArrayPartSource

2011-10-05T17:55:00.001-07:00

InputStream is = null;
int len;
int size = 1024;
byte[] buf = null;

if (is instanceof ByteArrayInputStream) {
size = is.available();
buf = new byte[size];
len = is.read(buf, 0, size);
}

new FilePart(filename, new ByteArrayPartSource("filename.txt", buf));

How to upload file to Alfresco share using java code

2011-10-05T17:03:00.000-07:00

Here the siteid is :testFolders
location to upload is : "/aaa/bbbb

It will upload the file from the local disk to the alfresco site testfolders/documentlibrary/aaa/bbb

Here I have passed the ticket to authenticate with the system

/**
*
*/
package com;

import java.io.File;
import java.io.IOException;

import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.methods.PostMethod;
import org.apache.commons.httpclient.methods.multipart.FilePart;
import org.apache.commons.httpclient.methods.multipart.MultipartRequestEntity;
import org.apache.commons.httpclient.methods.multipart.Part;
import org.apache.commons.httpclient.methods.multipart.StringPart;

import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.HttpException;
import org.apache.commons.httpclient.HttpStatus;
import org.apache.commons.httpclient.methods.GetMethod;

/**
* @author basanagowda.patil
*
*/
public class FileUpload {

public static void uploadDocument(String authTicket, File fileobj, String filename, String filetype, String description, String destination)
{
try
{
String urlString = "http://localhost:8080/alfresco/service/api/upload?alf_ticket="+authTicket;
System.out.println("The upload url:::"+urlString);
HttpClient client = new HttpClient();
PostMethod mPost = new PostMethod(urlString);
//File f1 =fileobj;
Part[] parts = {
new FilePart("filedata",filename,fileobj,filetype,null),
new StringPart("filename", filename),
new StringPart("description", description),
// new StringPart("destination", destination)
new StringPart("description", description),
new StringPart("siteid", "testFolders"),
new StringPart("containerid", "documentLibrary"),
new StringPart("uploaddirectory", "/aaa/bbbb")

};
mPost.setRequestEntity(
new MultipartRequestEntity(parts, mPost.getParams())
);
int statusCode1 = client.executeMethod(mPost);
System.out.println("statusLine>>>" +statusCode1+"......"+ mPost.getStatusLine()+mPost.getResponseBodyAsString());
mPost.releaseConnection();

}
catch (Exception e)
{
System.out.println(e);
}
}
public static void main(String args[])throws IOException
{
// SimpleUpload aw=new SimpleUpload();
//String Ticket=aw.login();
//String ticket="TICKET_3e61ccfa8a11690b10e1a2fb0eeee2c5583b0043";

String alfrescoTiccketURL = "http://localhost:8080/alfresco"+"/service/api/login?u="+"admin"+"&pw="+"admin";

String ticketURLResponse = invokeWebScriptgetRequest(alfrescoTiccketURL);

//ticketURLResponse =
int startindex= ticketURLResponse.indexOf("")+8;
int endindex = ticketURLResponse.indexOf("");

ticketURLResponse = ticketURLResponse.substring(startindex, endindex);

File f=new File("D:/Testupload/Alfresco_Enterprise_3_4_4_Administrator.pdf");

//FileInputStream is=new FileInputStream(f);
uploadDocument(ticketURLResponse, f,"Alfresco_Enterprise_3_4_4_Administrator.pdf","application/pdf","description",null);

//uploadDocument("TICKET_3ef085c4e24f4e2c53a3fa72b3111e55ee6f0543", f,"47.bmp","image file","application/jpg","workspace://SpacesStore/65a06f8c-0b35-4dae-9835-e38414a99bc1");
}

public static String invokeWebScriptgetRequest(String url){

// Create an instance of HttpClient.
HttpClient client = new HttpClient();

// Create a method instance.
GetMethod method = new GetMethod(url);
/* // Provide custom retry handler is necessary
method.getParams().setParameter(HttpMethodParams.RETRY_HANDLER,
new DefaultHttpMethodRetryHandler(3, false));*/
String response = null;
try {
// Execute the method.
int statusCode = client.executeMethod(method);

if (statusCode != HttpStatus.SC_OK) {
System.err.println("Method failed: " + method.getStatusLine());
}

// Read the response body.
byte[] responseBody = method.getResponseBody();

// Deal with the response.
// Use caution: ensure correct character encoding and is not binary data
response = new String(responseBody);
System.out.println(response);

} catch (HttpException e) {
System.err.println("Fatal protocol violation: " + e.getMessage());
e.printStackTrace();
} catch (IOException e) {
System.err.println("Fatal transport error: " + e.getMessage());
e.printStackTrace();
} finally {
// Release the connection.
method.releaseConnection();
}
return response;

}

}

Grails Features

2011-10-04T12:22:00.000-07:00

We can have the services declared in the services folder
These services can be used by Contoller by declaring the variable, automatically this service will be
autowired and we can easily access them.

Sending the message to MQ is simple simply put the send command and send the object string.
If you have map it can be converted to json string or xml.
There is a way to get back the object from json by typecasting. Once we are done we can place that message on the MQ.

While putting in the MQ we can use the payloader and pass that payloader object as string.

We can use the groovy variables interchangable with alfresco variables.

We can use any front end. To the front end we can pass the Model and View object. The model can be accessed in the front end.

In the front end we can use JSTL

http://grails.org/doc/latest/

http://grails.org/doc/latest/guide/6.%20The%20Web%20Layer.html

<http://grails.org/doc/latest/guide/6.%20The%20Web%20Layer.html#6.7 Ajax>

JMS Plugin Documentation: http://gpc.github.com/grails-jms/docs/manual/index.html

Grails

2011-09-27T14:05:00.001-07:00

Spring Source tools eclipse is used foe Grails Development.

Now will tell some steps

1. By default in the controller index method will be called
2. In the views folder name of the controller (login) folder will be created if you create loginController

3. In the controller we can instantiate Java classes and call them

4. In the contoller we will have the enclosures.

if you have the enclosure by name search inside LoginController
then it will look for
views --> login-->search.gsp

def search= {
render "abccc.gsp";
}

5. to define variables use def, semicolons are not mandatory

6. USes Gstrings similar to Velocity.

Sample

package com.hersheys.groovy.quickr

import com.hersheys.quickr.migration.TestClass

class LoginController {

/* def index = {

//can be double or string
def i = 4;

System.out.print("Inside the LoginController");

if(i < 0.5){
render "Hellvsgvdso World";
}else{
// brackets are not mandtory
render ("asfasgfasg");
}

//grroovy typeless, no return type , No semicolons , Gstring we have extrac com pared to Java

// Now calling Java

TestClass testClass = new TestClass();
def name = testClass.getNickName("john");

render name;
}
*/

def index = {

//We can configure the gsp to be used as below
//render "abccc.gsp";

// if you leave this method emptry then the index.gsp will be take n from the login folder of views
}

// url --- We can access closure similar to Dispatch Action
//http://localhost:8080/QuickrAlfresco/login/index
//login -- Controller
//index-- closure

def update = {
//render "updatehit"
System.out.print("Inside the update Closure. If we dont return anything then it will look for update.gsp inside song folder in views");
}

def search ={

def x = params.item;
//render x;
request.message = x;
}

}

We can explictly specify the name of the file where to go also

Link to get the Remote object

2011-09-27T11:51:00.001-07:00

https://forums.alfresco.com/en/viewtopic.php?t=17587

Getting all the users present in Liferay

2011-09-25T08:21:00.001-07:00

final Set users = authorityService.getAllAuthorities(AuthorityType.USER);

Policy and Behaviour

2011-09-24T21:14:00.000-07:00

We can trigger same policy for 2 contents in 2 different classes

EX:
public class UsageQuotaProtector implements NodeServicePolicies.OnUpdatePropertiesPolicy

public void init()
{
if (contentUsageService.getEnabled())
{
// Register interest in the onUpdateProperties policy
policyComponent.bindClassBehaviour(
QName.createQName(NamespaceService.ALFRESCO_URI, "onUpdateProperties"),
ContentModel.TYPE_PERSON,
new JavaBehaviour(this, "onUpdateProperties"));
}
}

Similarly we can have
public class RepositoryAuthenticationDao implements MutableAuthenticationDao, InitializingBean, OnUpdatePropertiesPolicy, BeforeDeleteNodePolicy

*/
public void afterPropertiesSet() throws Exception
{
this.policyComponent.bindClassBehaviour(
OnUpdatePropertiesPolicy.QNAME,
ContentModel.TYPE_PERSON,
new JavaBehaviour(this, "onUpdateProperties"));

Alfresco Liferay doclib

2011-09-23T13:01:00.001-07:00

http://pypeline.net

In this site you have the demo for alfreso and liferay doclib integration

Commands to copy file

2011-09-23T10:42:00.000-07:00

sudo su -liferay

cp /home/hbasa/share-config-custom.xml /opt/liferay-portal-6.0-ee/tomcat-6.0.29/shared/classes/alfresco/web-extension/

file operations
vim filename
to open the file

press i to write the content

once you are done with file operation do this to save and quit
esc:q! --- To Quit the file

escape+:+w+q
To write and quit the file

We can generate the classes from the below command

2011-09-21T06:00:00.000-07:00

http://axis.apache.org/axis2/java/core/docs/jaxws-guide.html

We can generate the classes from the below command
wsimport -keep -verbose wsdl_URL


 This is how we generate files

wsimport -p com.patil.jax -keep file.wsdl

Alfresco Doc lib portlets working

2011-09-18T18:34:00.000-07:00

When we start Liferay server after putting share war we see the below line info

23:52:27,703 INFO [site.servlet.SSOAuthenticationFilter] NTLMAuthenticationFil
ter initialised.

So this is the one which makes sso possible.
In the web.xml of share we have the following filter

Share SSO authentication support filter.

Authentication Filter

org.alfresco.web.site.servlet.SSOAuthenticationFilter

endpoint

alfresco

So this filter is looking for endpoint alfresco present in share-config-custom.xml

alfresco
Alfresco - user access
Access to Alfresco Repository WebScripts that require user authentication

alfrescoCookie

http://localhost:8080/alfresco/wcs

user

true

Here to make the external users to allow , we have external-auth true.

Now /wcs is mapped to following filter in alfresco's web.xml

WebScript Authentication Filter

/wcs/*

which points to the class

WebScript Authentication Filter

Authentication filter mapped to web script URLs. Mainly for SSO support

org.alfresco.repo.web.filter.beans.BeanProxyFilter

beanName

WebscriptAuthenticationFilter

And here again WebscriptAuthenticationFilter
maps to

${ntlm.authentication.sso.enabled}

CKEditor

2011-09-14T18:45:00.001-07:00

http://localhost:9090/html/js/editor/ckeditor/editor/filemanager/browser/liferay/browser.html?Connector=%2fc%2fportal%2ffckeditor%3fp_l_id%3d10141%26p_p_id%3d15%26doAsUserId%3dYhlw4Jlrv4M%253d%26doAsGroupId%3d18&CKEditor=CKEditor1&CKEditorFuncNum=1&langCode=en

This call will get converted as below

From the File Browser following url will be called

http://localhost:9090/c/portal/fckeditor?p_l_id=10141&p_p_id=15&doAsUserId=Yhlw4Jlrv4M%3d&doAsGroupId=18&Command=GetFoldersAndFiles&
Type=Image&CurrentFolder=%2F&uuid=1316050672680

In the structs-config.xml we have the maping for

Here the ConnectorAction based on the parameters is going to call the corresponding
command method
ex: GetFoldersAndFilesCommand
This is going to return the xml
and the returned xml will be parsed.

Place to change the FCKEditor

2011-09-13T19:54:00.000-07:00

You can extend the FCKEditor using hook

E:\Dumps\Liferay\liferay-portal-src-6.0.5\liferay-portal-src-6.0.5\portal-web\docroot\html\js\editor\fckeditor_diffs

from the above mentioned location.

SingleSigon For Share

2011-09-13T19:11:00.000-07:00

Lets do single sign on step by step
1. alfresco-global.properties

ntlm.authentication.sso.enabled=true

authentication.chain=alfrescoNtlm1:alfrescoNtlm,external1:external

2. share-config.custom.xml
Here we should enable connector with the name alfrescoCookie and with the endpoint
alfresco as below

false

production

false

-1

http://localhost:8080/alfresco

false

application/msword
application/vnd.ms-excel
application/vnd.ms-powerpoint

true

alfresco://company/home

false

500

secret

ALFRESCO.ORG

HTTP/repository.server.com@ALFRESCO.ORG

ShareHTTP

alfresco/web-extension/alfresco-system.p12
pkcs12
alfresco-system

alfrescoCookie
Alfresco Connector
Connects to an Alfresco instance using cookie-based authentication
org.springframework.extensions.webscripts.connector.AlfrescoConnector

alfresco
Alfresco - user access
Access to Alfresco Repository WebScripts that require user authentication

alfrescoCookie

http://localhost:8080/alfresco/wcs

user

true

alfresco-noauth
Alfresco - unauthenticated access
Access to Alfresco Repository WebScripts that do not require authentication

alfresco

http://localhost:8080/alfresco/s

none

alfresco-feed
Alfresco Feed
Alfresco Feed - supports basic HTTP authentication via the EndPointProxyServlet

http

http://localhost:8080/alfresco/s

true

user

setting up the memory(Perm Gen)

2011-09-13T17:37:00.000-07:00

In the startup.bat file put the below lines(C:\Alfresco3.4.3\tomcat\bin)
set JAVA_OPTS=-Xms512m -Xmx1024m -Xss1024k -XX:MaxPermSize=256m

By setting the above parameter we can start the server from startup.bat file.

@echo off
rem Licensed to the Apache Software Foundation (ASF) under one or more
rem contributor license agreements. See the NOTICE file distributed with
rem this work for additional information regarding copyright ownership.
rem The ASF licenses this file to You under the Apache License, Version 2.0
rem (the "License"); you may not use this file except in compliance with
rem the License. You may obtain a copy of the License at
rem
rem http://www.apache.org/licenses/LICENSE-2.0
rem
rem Unless required by applicable law or agreed to in writing, software
rem distributed under the License is distributed on an "AS IS" BASIS,
rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rem See the License for the specific language governing permissions and
rem limitations under the License.

if "%OS%" == "Windows_NT" setlocal
rem ---------------------------------------------------------------------------
rem Start script for the CATALINA Server
rem
rem $Id: startup.bat 908749 2010-02-10 23:26:42Z markt $
rem ---------------------------------------------------------------------------

rem Guess CATALINA_HOME if not defined
set JAVA_OPTS=-Xms512m -Xmx1024m -Xss1024k -XX:MaxPermSize=256m -XX:NewSize=256m
set "CURRENT_DIR=%cd%"
if not "%CATALINA_HOME%" == "" goto gotHome
set "CATALINA_HOME=%CURRENT_DIR%"
if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome
cd ..
set "CATALINA_HOME=%cd%"
cd "%CURRENT_DIR%"
:gotHome
if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome
echo The CATALINA_HOME environment variable is not defined correctly
echo This environment variable is needed to run this program
goto end
:okHome

set "EXECUTABLE=%CATALINA_HOME%\bin\catalina.bat"

rem Check that target executable exists
if exist "%EXECUTABLE%" goto okExec
echo Cannot find "%EXECUTABLE%"
echo This file is needed to run this program
goto end
:okExec

rem Get remaining unshifted command line arguments and save them in the
set CMD_LINE_ARGS=
:setArgs
if ""%1""=="""" goto doneSetArgs
set CMD_LINE_ARGS=%CMD_LINE_ARGS% %1
shift
goto setArgs
:doneSetArgs

call "%EXECUTABLE%" start %CMD_LINE_ARGS%

:end

Liferay CMIS hook to connect to Alfresco

2011-09-13T05:41:00.000-07:00

Install and make Alfresco up and running with the version Alfresco 3.4.1
Install Liferay and make it up. liferay-portal-tomcat-6.0-ee-sp1

In the portal-ext.properties put following properties and restart server

dl.hook.impl=com.liferay.documentlibrary.util.CMISHook

cmis.credentials.username=admin

cmis.credentials.password=admin

cmis.repository.url=http://localhost:8080/alfresco/service/api/cmis

cmis.repository.version=1.0

cmis.system.root.dir=Liferay Home

Restart Liferay and create content in the Document Library, the created content should go and sit in Alfresco.

But here the disadvantage is , it is storing the files in binary in Alfresco.

Hope that in the future releases we will have the actual content inside Alfresco

You can find more info in the blog
https://www.liferay.com/web/jonas.yuan/blog/-/blogs/integrating-alfresco-through-cmis-in-liferay

Content Storage and Lifecycle

2011-09-05T10:00:00.000-07:00

http://wiki.alfresco.com/wiki/Content_Store_Configuration

In Alfresco, the content binaries are stored separately from the metadata, which is always found in the database. The primary metadata that acts as a reference to the binaries takes the form contentUrl=store://.........|mimetype=...(etc). The abstraction that takes care of mapping the store://... part of the reference to a physical location is the ContentStore interface.

Content Binaries and Transactions

Because binaries are not modified, it means that writes to the filesystem do not become visible until the metadata has been committed to the database. In the event of transaction failure or rollback, the metadata will be left in the pre-transaction state i.e. referencing the older binary; the newer content binary will be left in an orphaned state for later cleanup.

Deleting Files

When a file node (or anything containing a reference to raw content) is permanently deleted, there is just one less reference to the raw content. When there are no more references to some raw content, it is called orphaned. Were nothing further done, the content stores would just irreversibly fill up with content.

Cleaning up Orphaned Content (Purge)

Once all references to a content binary have been removed from the metadata, the content is said to be orphaned. Orphaned content can be deleted or purged from the content store while the system is running. Identifying and either sequestering or deleting the orphaned content is the job of the contentStoreCleaner.

In the default configuration, the contentStoreCleanerTrigger fires the contentStoreCleaner bean.

        ...               14

protectDays

Use this property to dictate the minimum time that content binaries should be kept in the contentStore. In the above example, if a file is created and immediately deleted, it will not be cleaned from the contentStore for at least 14 days. The value should be adjusted to account for backup strategies, average content size and available disk space. Setting this value to zero will result in a system warning as it breaks the transaction model and it is possible to lose content if the orphaned content cleaner runs whilst content is being loaded into the system. If the system backup strategy is just to make regular copies, then this value should also be greater than the number of days between successive backup runs.

store

This is a list of ContentStore beans to scour for orphaned content.

listeners

When orphaned content is located, these listeners are notified. In this example, the deletedContentBackupListener copies the orphaned content to a separate deletedContentStore.

Note that this configuration will not actually remove the files from the file system but rather moves them to the designated deletedContentStore, usually contentstore.deleted. The files can be removed from the deletedContentStore via script or cron job once an appropriate backup has been performed.

Code for Purging the content

2011-09-05T09:48:00.001-07:00

delete

/images/icons/delete.gif
dialog:deleteItem

#{DialogManager.setupParameters}

#{actionContext.id}

Exposing objects in Alfresco share

2011-09-04T19:54:00.000-07:00

The way we use to expose the objects in the DM, similar way we can expose the objects in Alfresco share as surf objects.

This is done by extending ScriptBase object

org.springframework.extensions.webscripts.ScriptUser ---> exposes user object

Root scoped objects in Alfresco share

2011-09-04T18:49:00.000-07:00

Refer to below link
http://wiki.alfresco.com/wiki/Surf_Platform_-_Freemarker_Template_and_JavaScript_API

Root-scoped Objects

Create a Meeting Workspace

2011-09-04T11:07:00.001-07:00

Create a Meeting Workspace

You can create a Meeting Workspace in Share at the time you create a meeting request. The existing Share users that you add as meeting attendees automatically become members of the Meeting Workspace. The user who creates the Meeting Workspace automatically becomes the site manager.

To create a Meeting Workspace from Outlook:

Open Outlook and create a meeting request in the Calendar view with the following details:
To
usera@alfrescodemo.org; userb@alfrescodemo.org
Subject
Project Planning
Location
Conference Room
Start time
any date in the future, 10:00
End time
same day as start date, 12:00
Message
Please use the link provided to review the agenda and associated material for this meeting.
Click Meeting Workspace on the Meeting tab.
The Meeting Workspace task pane opens on the right side of the dialog box.
Click Change settings and configure the workspace as follows:
1. Specify http://localhost:7070/alfresco as the workspace location.
2. Select Create a new workspace.
3. Select Alfresco Meeting Workspace as the template type.
  If prompted, log in as the administrator (admin, admin).
  Click Create.
  If prompted, log in as the administrator (admin, admin).
  
  Outlook creates the Meeting Workspace (Share site), adds to this the meeting being scheduled, and inserts a link into the body of the meeting request. This link provides attendees with easy access to the workspace.
Click Go to workspace at the top of the task pane to access the Meeting Workspace. Again, log in as the administrator.
Use this link to create an agenda and upload meeting materials to the site before sending the meeting request. These tasks are not required as part of the tutorial.
The new Meeting Workspace opens with the calendar component displayed. The meeting request Subject line becomes both the meeting title and the workspace name (non-alphanumeric characters, including spaces, are converted to underscores for the workspace name). When you create a Meeting Workspace from Outlook, the site includes only the Document Library and Calendar components. To include additional page components—Wiki, Blog, Links, Discussions, or Data Lists—refer to the Share user help.
Log out of Share and close the browser.
In the meeting request in Outlook, click Send.
Outlook sends the meeting request. In Share, the meeting attendees are added to the Meeting Workspace as site members. By default, they are given the role Collaborator.

2011-09-04T11:07:00.000-07:00

Create a Meeting Workspace

To create a Meeting Workspace from Outlook:

Open Outlook and create a meeting request in the Calendar view with the following details:
To
usera@alfrescodemo.org; userb@alfrescodemo.org
Subject
Project Planning
Location
Conference Room
Start time
any date in the future, 10:00
End time
same day as start date, 12:00
Message
Please use the link provided to review the agenda and associated material for this meeting.
Click Meeting Workspace on the Meeting tab.
The Meeting Workspace task pane opens on the right side of the dialog box.
Click Change settings and configure the workspace as follows:
1. Specify http://localhost:7070/alfresco as the workspace location.
2. Select Create a new workspace.
3. Select Alfresco Meeting Workspace as the template type.
  If prompted, log in as the administrator (admin, admin).
  Click Create.
  If prompted, log in as the administrator (admin, admin).
  
  Outlook creates the Meeting Workspace (Share site), adds to this the meeting being scheduled, and inserts a link into the body of the meeting request. This link provides attendees with easy access to the workspace.
Click Go to workspace at the top of the task pane to access the Meeting Workspace. Again, log in as the administrator.
Use this link to create an agenda and upload meeting materials to the site before sending the meeting request. These tasks are not required as part of the tutorial.
The new Meeting Workspace opens with the calendar component displayed. The meeting request Subject line becomes both the meeting title and the workspace name (non-alphanumeric characters, including spaces, are converted to underscores for the workspace name). When you create a Meeting Workspace from Outlook, the site includes only the Document Library and Calendar components. To include additional page components—Wiki, Blog, Links, Discussions, or Data Lists—refer to the Share user help.
Log out of Share and close the browser.
In the meeting request in Outlook, click Send.
Outlook sends the meeting request. In Share, the meeting attendees are added to the Meeting Workspace as site members. By default, they are given the role Collaborator.

Command to change tomcat server settings in tomcat

2011-09-04T09:36:00.001-07:00

Open the path till bin and execute the command //ES//alfrescoTomcatnum2
C:\Alfresco3.4.3\tomcat\bin>tomcat6w.exe //ES//alfrescoTomcatnum2

Here alfrescoTomcatnum2 is the name of the service. You can change this name based in your service name.
Now set the required memory settings in the Java tab

Initail Memory pool 256 MB
Maximum memory pool 512mb
Thread stack size 64

If memory is not set then alfresco service may not start

DB Creation scripts for Alfresco with mysql

2011-09-04T09:23:00.000-07:00

Database creation scripts for mysql

create database alfresco default character set utf8 collate utf8_bin;
grant all on alfresco.* to 'alfresco'@'localhost' identified by 'alfresco' with grant option;
grant all on alfresco.* to 'alfresco'@'localhost.localdomain' identified by 'alfresco' with grant option;

Database deletion scripts for mysql
create database alfresco default character set utf8 collate utf8_bin;
grant all on alfresco.* to 'alfresco'@'localhost' identified by 'alfresco' with grant option;
grant all on alfresco.* to 'alfresco'@'localhost.localdomain' identified by 'alfresco' with grant option;

Configuring Alfresco to this database is done by below lines

### database connection properties ###
db.driver=org.gjt.mm.mysql.Driver
db.username=alfresco
db.password=alfresco
db.name=alfresco
db.url=jdbc:mysql://localhost:3306/alfresco

How documentlibrary folder gets created when we create site in Alfresco

2011-09-04T08:06:00.000-07:00

The pages will be defined here

calendar

wiki-page?title=Main_Page

documentlibrary

discussions-topiclist

blog-postlist

links

tasks

knowledgebase

The corresponding page definition will be available in the folder.

C:\Alfresco3.4.1\tomcat\webapps\share\WEB-INF\classes\alfresco\site-data\pages

discussions-topiclist

discussions-topiclist

Discussions

page.discussionsTopicList.title

Displays the forum topics

page.discussionsTopicList.description

discussions-topiclist

user

For the documentlibrary we will hava the below page definition.

Document Library

page.documentLibrary.title

Document library with Tree view

page.documentLibrary.description

documentlibrary

user

If you see the page It has Template-instance, so it will look for template-instance. The template-instance are located at C:\Alfresco3.4.1\tomcat\webapps\share\WEB-INF\classes\alfresco\site-data\template-instances\documentlibrary.xml

The template-instance is made up of the components. Components will have the region-id as below.

org/alfresco/documentlibrary

documentlibrary

documentLibrary

title

/components/title/collaboration-title

portlet-title

/components/title/portlet-collaboration-title

navigation

/components/navigation/collaboration-navigation

actions-common

/components/documentlibrary/actions-common

toolbar

/components/documentlibrary/toolbar

documentlist

/components/documentlibrary/documentlist

true

filter

/components/documentlibrary/filter

tree

/components/documentlibrary/tree

Finding the port listening command

2011-08-31T07:05:00.001-07:00

Finding the port listening command

From a Windows console, type:

netstat -an|find "61616"

From a Unix command shell, type:

netstat -an|grep 61616

Comparison between WCM and DM nodeRepresentation

2011-08-15T22:47:00.000-07:00

In the DM represenation noderef will be a numerical as below. I am trying to access
space_templates folder present in the DataDictionary
Node Identifier
Primary Path: /{http://www.alfresco.org/model/application/1.0}company_home/{http://www.alfresco.org/model/application/1.0}dictionary/{http://www.alfresco.org/model/application/1.0}space_templates
Reference: workspace://SpacesStore/08116618-8978-4917-88a1-9547e6128002
Type: {http://www.alfresco.org/model/content/1.0}folder
Parent: workspace://SpacesStore/460a0e42-dc18-4d7e-ad4a-2a8415a69846

In WCM noderef is comma seperated value with the complete store name

Primary Path: /{http://www.alfresco.org/model/content/1.0}www/{http://www.alfresco.org/model/content/1.0}avm_webapps/{http://www.alfresco.org/model/content/1.0}ROOT/{http://www.alfresco.org/model/content/1.0}statementinput.jsp.txt
Reference: avm://testdns--admin/-1;www;avm_webapps;ROOT;statementinput.jsp.txt
Type: {http://www.alfresco.org/model/wcmmodel/1.0}avmplaincontent
Parent: avm://testdns--admin/-1;www;avm_webapps;ROOT

Sample path will be as below
testdns--admin--preview:/www/avm_webapps/ROOT/statementinput.jsp.txt

If you replace ; with / of nodeReference we will get the path.

Alfresco WebContent Deployment

2011-08-15T04:08:00.000-07:00

Alfresco WCM projects involves Authoring environment and Staging environment.
Authoring environment is the plcae where we create the content.
From the Staging environment we pull content to external site. In this blog I am discussing about how to deploy the content to staging environment.

The staging environment can be classified as below
1. WCM to DM deployment
2. WCM to another alfresco instance deployment(ASR)
3. WCM to deployment Engine
4. WCM to file system

Tested with Alfresco3.4.1
1. WCM to DM deployment
While configuring use the below entries
Transport Name: default
Host: 127.0.0.1
Port: 50500
URL: --
Type: Live Server
Username: admin

Source Path: --
Excludes: --
Target Name: alfresco
Include In Auto Deploy: Yes

If the target name is alfresco then the content will be deployed to WebDeployed folder of Alfresco.

2. WCM to another alfresco instance deployment(ASR)

Transport Name: default
Host: 127.0.0.1
Port: 50500
URL: --
Type: Live Server
Username: admin

Source Path: --
Excludes: --
Target Name: avm
Include In Auto Deploy: No

Here the target name is avm, hence it acts as ASR. For the staging sandbox-live will be appeneded.

3. WCM to deployment Engine
Before doing this install and start the deployment engine.
In this case configure the port to 44100
Target Name: default

We can change the target name to other than default by making changes in
alfresco-global.properties

Exposing the Java variables to Velocity Templates

2011-08-08T23:48:00.000-07:00

We can make some java variables available in the velocity templates(used in theme)

In the

ServicePreAction  we set the variables and these variables will

 be accessed from the templates.



servlet.service.events.pre=com.liferay.portal.events.ServicePreAction,your.custom

.EXTServicePreAction

Getting the Tasks from WorkflowInstance

2011-08-04T00:20:00.000-07:00

WorkflowTaskQuery tasksQuery = new WorkflowTaskQuery();
tasksQuery.setTaskState(null);
tasksQuery.setActive(null);
tasksQuery.setProcessId(workflowInstance.id);
List tasks = workflowService.queryTasks(tasksQuery);

From the WorkflowTask get the id and make the query to get all the tasks.

JBPM api terminologies with Alfresco

2011-08-02T01:32:00.000-07:00

TASK : From here we can get the complete info related to the workflow

For the each new workflow we start on any content we will have the WorkflowInstance.

Each task assigned is considered to be WorkflowTask.

Workflowdefinition has the details about the complete workflow version of it.

WorkflowTaskDefinition it will have the details about the paerticular task assigned to user
at this point of time

The task Id is::::jbpm$20
Workflow Instance id is:::jbpm$7
Task: WorkflowTask[id=jbpm$20,title=Review,state=IN_PROGRESS,props=18,def=WorkflowTaskDefinition[id=wf:reviewTask,metadata=ClassDef[name={http://www.alfresco.org/model/workflow/1.0}reviewTask]],path=WorkflowPath[id=jbpm$7-@review.0,instance=WorkflowInstance[id=jbpm$7,active=true,def=WorkflowDefinition[id=jbpm$4,name=jbpm$wf:parallelreview,version=1,title=Parallel Review & Approve,startTask=WorkflowTaskDefinition[id=wf:submitParallelReviewTask,metadata=ClassDef[name={http://www.alfresco.org/model/workflow/1.0}submitParallelReviewTask]]]],active=true,node=WorkflowNode[title=review,type=TaskNode,transitions={'WorkflowTransition[id=approve,title=Approve]','WorkflowTransition[id=reject,title=Reject]'}]]]

Technologies used in Alfresco

2011-07-05T19:53:00.000-07:00

1. Java
2. JSF
3. Spring IOC and AOP
4. Spring Surf
5.WebServices
6.Hibernate/iBatis
7.DOJO Javascript
8.YUI Scripting
9.XSLT
10.XML and XSD

We need not have depth knowledge about the above mentioned technologies. To make the changes in out of the box functionalities ,we need to make configuration changes in xml files.
But if you are familiar with these technologies custom development becomes faster.

Alfresco share Development

2011-06-26T22:58:00.000-07:00

The below log url is having a lot of information related to the Alfresco share development

http://blogs.alfresco.com/wp/kevinr/2010/04/07/developer-tips-for-alfresco-share-33/

Debugging with Alfresco

2011-06-15T00:09:00.000-07:00

Do the following settings

1) 1. Open Catalina.bat [C:\Alfresco\tomcat\bin], find “DEBUG_OPTS=” and add following line..

set DEBUG_OPTS=

-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8888

2. Put the same port as the debug port in eclipse.

CIFS Alfresco

2011-05-30T07:18:00.000-07:00

The logic behind the implementation of CIFS as written below

/*
* Copyright (C) 2005-2010 Alfresco Software Limited.
*
* This file is part of Alfresco
*
* Alfresco is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Alfresco is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Alfresco. If not, see . */
/**
*
*/
package org.alfresco.filesys.util;

import java.util.HashMap;
import java.util.Map;

import org.alfresco.jlan.util.Platform;
import org.alfresco.util.exec.RuntimeExec;
import org.alfresco.util.exec.RuntimeExec.ExecutionResult;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

/**
* CIFS Mounter Class
*
*

Mount/map a network drive taking care of platform differences.
*
* @author gkspencer
*/
public class CifsMounter {

// Debug logging

private static final Log logger = LogFactory.getLog( CifsMounter.class);

// Protocol type constants

public static final int Default = 0;
public static final int NetBIOS = 1;
public static final int NativeSMB = 2;
public static final int Win32NetBIOS = 3;

// Windows mount/unmount commands

private static final String WindowsMountCmd = "net use ${drive} \\\\${srvname}\\${sharename} ${password} /USER:${username}";
private static final String WindowsUnMountCmd = "net use ${drive} /d";

// Linux mount/unmount commands

private static final String LinuxMountSmbfsCmd = "mount -t smbfs //${srvname}/${sharename} ${mountpoint} -o username=${username},password=${password}";
private static final String LinuxMountCifsCmd = "mount -t cifs //${srvname}/${sharename} ${mountpoint} -o username=${username},password=${password}";
private static final String LinuxMountCifsNBCmd = "mount.cifs //${srvname}/${sharename} ${mountpoint} -o servern=${srvname},port=139,username=${username},password=${password}";
private static final String LinuxUnMountCmd = "umount ${mountpoint}";

// Mac OS X mount/unmount commands

private static final String MacOSXMountCmd = "mount_smbfs -U ${username} //${password}@${srvname}/${sharename} ${mountpoint}";
private static final String MacOSXUnMountCmd = "umount ${mountpoint}";

// Server name and share name

private String m_srvName;
private String m_shareName;

// Server address

private String m_srvAddr;

// Access details for remote share

private String m_userName;
private String m_password;

// Protocol to use for connection (non Windows platforms)

private int m_protocolType = Default;

// Port to connect on (non Windows platforms)

private int m_port;

/**
* Default constructor
*/
public CifsMounter()
{
}

/**
* Class constructor
*
* @param srvName String
* @param shareName String
* @param userName String
* @param password String
*/
public CifsMounter(String srvName, String shareName, String userName, String password)
{
setServerName( srvName);
setShareName( shareName);

setUserName( userName);
setPassword( password);
}

/**
* Mount a remote CIFS shared filesystem
*
* @param driveLetter String
* @param mountPoint String
* @exception CifsMountException
*/
public void mountFilesystem( String driveLetter, String mountPoint)
throws CifsMountException
{
// Create the command line launcher

RuntimeExec exec = new RuntimeExec();

// Create the command map and properties

Map commandMap = new HashMap( 1);
Map defProperties = new HashMap( 10);

// Determine the platform type and build the appropriate command line string

Platform.Type platform = Platform.isPlatformType();

switch ( platform)
{
// Windows

case WINDOWS:
commandMap.put( "Windows.*", WindowsMountCmd);
break;

// Linux

case LINUX:

// Check the protocol type of the CIFS server

if ( isProtocolType() == NativeSMB || isProtocolType() == Default)
{
// Use the CIFS VFS mounter to connect using native SMB

StringBuilder cmd = new StringBuilder( LinuxMountCifsCmd);
if ( getProtocolPort() != 0)
{
cmd.append( ",port=");
cmd.append( getProtocolPort());
}

// Set the command line

commandMap.put( "Linux", cmd.toString());
}
else
{
// Set the command line to use the CIFS VFS mounter to connect using NetBIOS

StringBuilder cmd = new StringBuilder( LinuxMountCifsNBCmd);

if ( getServerAddress() != null)
{
cmd.append( ",ip=");
cmd.append( getServerAddress());
}

// Set the command line

commandMap.put( "Linux", cmd.toString());
}
break;

// Mac OS X

case MACOSX:
commandMap.put( "Mac OS X", MacOSXMountCmd);
break;
}

// Set the command map

exec.setCommandMap( commandMap);

// Build the command line properties list

defProperties.put( "drive", driveLetter);
defProperties.put( "srvname", getServerName());
defProperties.put( "sharename", getShareName());
defProperties.put( "username", getUserName());
defProperties.put( "password", getPassword());
defProperties.put( "mountpoint", mountPoint);

exec.setDefaultProperties(defProperties);

// Get the command to be used on this platform

if ( logger.isDebugEnabled())
logger.debug( "Mount CIFS share, cmdLine=" + exec.getCommand());

// Run the command

ExecutionResult execRes = exec.execute();

if ( logger.isDebugEnabled())
logger.debug( "Mount result=" + execRes);

// Check if the command was successful

if ( execRes.getSuccess() == false)
throw new CifsMountException( execRes.getExitValue(), execRes.getStdOut(), execRes.getStdErr());
}

/**
* Unmount a remote CIFS shared filesystem
*
* @param driveLetter String
* @param mountPoint String
* @exception CifsMountException
*/
public void unmountFilesystem( String driveLetter, String mountPoint)
throws CifsMountException
{
// Create the command line launcher

RuntimeExec exec = new RuntimeExec();

// Create the command map and properties

Map commandMap = new HashMap( 1);
Map defProperties = new HashMap( 10);

// Determine the platform type and build the appropriate command line string

Platform.Type platform = Platform.isPlatformType();

switch ( platform)
{
// Windows

case WINDOWS:
commandMap.put( "Windows.*", WindowsUnMountCmd);
break;

// Linux

case LINUX:
commandMap.put( "Linux", LinuxUnMountCmd);
break;

// Mac OS X

case MACOSX:
commandMap.put( "Mac OS X", MacOSXUnMountCmd);
break;
}

// Set the command map

exec.setCommandMap( commandMap);

// Build the command line properties list

defProperties.put( "drive", driveLetter);
defProperties.put( "mountpoint", mountPoint);

exec.setDefaultProperties(defProperties);

// Get the command to be used on this platform

if ( logger.isDebugEnabled())
logger.debug( "UnMount CIFS share, cmdLine=" + exec.getCommand());

// Run the command

ExecutionResult execRes = exec.execute();

if ( logger.isDebugEnabled())
logger.debug( "UnMount result=" + execRes);

// Check if the command was successful

if ( execRes.getSuccess() == false)
throw new CifsMountException( execRes.getExitValue(), execRes.getStdOut(), execRes.getStdErr());
}

/**
* Return the server name
*
* @return String
*/
public final String getServerName()
{
return m_srvName;
}

/**
* Return hte server address
*
* @return String
*/
public final String getServerAddress()
{
return m_srvAddr;
}

/**
* Return the share name
*
* @return String
*/
public final String getShareName()
{
return m_shareName;
}

/**
* Return the user name
*
* @return String
*/
public final String getUserName()
{
return m_userName;
}

/**
* Return the password
*
* @return String
*/
public final String getPassword()
{
return m_password;
}

/**
* Return the protocol type
*
* @return int
*/
public final int isProtocolType()
{
return m_protocolType;
}

/**
* Return the protocol port
*
* @return int
*/
public final int getProtocolPort()
{
return m_port;
}

/**
* Set the server name
*
* @param name String
*/
public final void setServerName(String name)
{
m_srvName = name;
}

/**
* Set the server address
*
* @param srvAddr String
*/
public final void setServerAddress(String srvAddr)
{
m_srvAddr = srvAddr;
}

/**
* Set the share name
*
* @param name String
*/
public final void setShareName(String name)
{
m_shareName = name;
}

/**
* Set the user name
*
* @param user String
*/
public final void setUserName(String user)
{
m_userName = user;
}

/**
* Set the password
*
* @param password String
*/
public final void setPassword(String password)
{
m_password = password;
}

/**
* Set the protocol type to use
*
* @param proto int
*/
public final void setProtocolType(int proto)
{
m_protocolType = proto;
}

/**
* Set the port to use for the connection
*
* @param port int
*/
public final void setProtocolPort(int port)
{
m_port = port;
}

/**
* Return the CIFS mounter as a string
*
* @return String
*/
public String toString()
{
StringBuilder str = new StringBuilder();

str.append( "[\\\\");
str.append( getServerName());
str.append( "\\");
str.append( getShareName());
str.append( ",");
str.append( getUserName());
str.append( ",");
str.append( getPassword());

if ( isProtocolType() != Default)
{
str.append( " (");
if ( isProtocolType() == NetBIOS)
str.append ( "NetBIOS");
else if ( isProtocolType() == NativeSMB)
str.append( "NativeSMB");
else if ( isProtocolType() == Win32NetBIOS)
str.append( "Win32NetBIOS");

if ( getProtocolPort() != 0)
{
str.append( ",");
str.append( getProtocolPort());
}
str.append( ")");
}
str.append( "]");

return str.toString();
}
}

Axis2 in Liferay portlet

2011-05-27T10:25:00.000-07:00

Even though Liferay is coming up with the Axis1 jars we can have the system that works in the
portlet with Axis2.

The importan thing is along with the library depedndency jars we need to add the below jars
activation-1.1
antlr-2.7.7
axiom-api-1.2.10
axiom-dom-1.2.10
axiom-impl-1.2.10
axis2-adb-1.5.4
axis2-adb-codegen-1.5.4
axis2-ant-plugin-1.5.4
axis2-clustering-1.5.4
axis2-codegen-1.5.4
axis2-corba-1.5.4
axis2-fastinfoset-1.5.4
axis2-java2wsdl-1.5.4
axis2-jaxbri-1.5.4
axis2-jaxws-1.5.4
axis2-jibx-1.5.4
axis2-json-1.5.4
axis2-kernel-1.5.4
axis2-metadata-1.5.4
axis2-mtompolicy-1.5.4
axis2-saaj-1.5.4
axis2-soapmonitor-servlet-1.5.4
axis2-spring-1.5.4
axis2-transport-http-1.5.4
axis2-transport-local-1.5.4
axis2-xmlbeans-1.5.4
commons-codec-1.3
commons-fileupload-1.2
commons-httpclient-3.1
commons-io-1.4
commons-logging-1.1.1
geronimo-stax-api_1.0_spec-1.0.1
httpcore-4.0
log4j-1.2.15
mail-1.4
neethi-2.0.4
woden-api-1.0M8
woden-impl-dom-1.0M8
wsdl4j-1.6.2
wstx-asl-3.2.9
xmlbeans-2.3.0
XmlSchema-1.4.3

The class will be as below

package com.test;

import java.io.IOException;

import javax.portlet.GenericPortlet;
import javax.portlet.PortletException;
import javax.portlet.PortletRequestDispatcher;
import javax.portlet.RenderRequest;
import javax.portlet.RenderResponse;

import sample.axisversion.ExceptionException;
import sample.axisversion.VersionStub;
import sample.axisversion.VersionStub.GetVersionResponse;

import com.liferay.portal.kernel.log.Log;
import com.liferay.portal.kernel.log.LogFactoryUtil;

/**
* Portlet implementation class NewPortlet
*/
public class NewPortlet extends GenericPortlet {

public void init() {
viewJSP = getInitParameter("view-jsp");
}

public void doView(
RenderRequest renderRequest, RenderResponse renderResponse)
throws IOException, PortletException {

System.out.println("**********View method of NewPortlet ******************8");

VersionStub versionStub = new VersionStub();

GetVersionResponse response;
try {
response = versionStub.getVersion();
System.out.println("**************Return::::"+response.get_return());

} catch (ExceptionException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}

include(viewJSP, renderRequest, renderResponse);
}

protected void include(
String path, RenderRequest renderRequest,
RenderResponse renderResponse)
throws IOException, PortletException {

PortletRequestDispatcher portletRequestDispatcher =
getPortletContext().getRequestDispatcher(path);

if (portletRequestDispatcher == null) {
_log.error(path + " is not a valid include");
}
else {
portletRequestDispatcher.include(renderRequest, renderResponse);
}
}

protected String viewJSP;

private static Log _log = LogFactoryUtil.getLog(NewPortlet.class);

}

Steps to use the WebService client in your Liferay portlet

2011-05-26T07:51:00.000-07:00

1. Use the seperate tomcat instance to generate the stub classes from the
url
2. Create the portlet in your sdk
3. The lib folder of the portlet should have below jars
axis.jar
commons-discovery-0.2.jar
jaxrpc.jar
saaj.jar
wsdl4j-1.5.1.jar
4. Inside your portlet class we can write the logic to consume the service

package com.cignex;

import com.liferay.portal.kernel.log.Log;
import com.liferay.portal.kernel.log.LogFactoryUtil;
import com.liferay.portal.model.UserSoap;
import com.liferay.portal.service.http.UserServiceSoap;
import com.liferay.portal.service.http.UserServiceSoapServiceLocator;

import java.io.IOException;
import java.net.URL;

import javax.portlet.GenericPortlet;
import javax.portlet.PortletException;
import javax.portlet.PortletRequestDispatcher;
import javax.portlet.RenderRequest;
import javax.portlet.RenderResponse;

/**
* Portlet implementation class WebServiceConsumePortlet
*/
public class WebServiceConsumePortlet extends GenericPortlet {

public void init() {
editJSP = getInitParameter("edit-jsp");
helpJSP = getInitParameter("help-jsp");
viewJSP = getInitParameter("view-jsp");
}

public void doEdit(
RenderRequest renderRequest, RenderResponse renderResponse)
throws IOException, PortletException {

include(editJSP, renderRequest, renderResponse);
}

public void doHelp(
RenderRequest renderRequest, RenderResponse renderResponse)
throws IOException, PortletException {

include(helpJSP, renderRequest, renderResponse);
}

public void doView(
RenderRequest renderRequest, RenderResponse renderResponse)
throws IOException, PortletException {

System.out.println("Inside the doView mode************ service");

try {

System.out.println("service locator*************8");
UserServiceSoapServiceLocator locatorUser = new UserServiceSoapServiceLocator();
UserServiceSoap soapUser = locatorUser.getPortal_UserService(new URL("http://test:test@127.0.0.1:8080/tunnel-web/secure/axis/Portal_UserService"));

//http://abc:abc@127.0.0.1:8080/tunnel-web/secure/axis/Portal_UserService
System.out.println("Calling from portlet");
if(null!=soapUser){
System.out.println("Inside soapUser not null*********");
UserSoap soapUserModel = soapUser.getUserById(10134);
System.out.println(" getEmailAddress:" + soapUserModel.getEmailAddress());

}

} catch (Exception e) {
e.printStackTrace();
}

include(viewJSP, renderRequest, renderResponse);
}

protected void include(
String path, RenderRequest renderRequest,
RenderResponse renderResponse)
throws IOException, PortletException {

PortletRequestDispatcher portletRequestDispatcher =
getPortletContext().getRequestDispatcher(path);

if (portletRequestDispatcher == null) {
_log.error(path + " is not a valid include");
}
else {
portletRequestDispatcher.include(renderRequest, renderResponse);
}
}

protected String editJSP;
protected String helpJSP;
protected String viewJSP;

private static Log _log = LogFactoryUtil.getLog(WebServiceConsumePortlet.class);

}

Using Liferay WebServices

2011-05-24T05:31:00.000-07:00

The wsdl url we can get it from
http://127.0.0.1:8080/tunnel-web/secure/axis/Portal_UserService?wsdl

by using the above url we can generate the skeleton classes in the eclipse.

The client code to access the url is as below

/**
*
*/
package com.cignex.test;

import java.net.URL;

import com.liferay.portal.model.UserSoap;
import com.liferay.portal.service.http.UserServiceSoap;
import com.liferay.portal.service.http.UserServiceSoapServiceLocator;

/**
* @author basanagowda.patil
*
*/
public class LiferayUserServiceClient {

/**
* @param args
*/
public static void main(String[] args) {
try {
UserServiceSoapServiceLocator locatorUser = new UserServiceSoapServiceLocator();
UserServiceSoap soapUser = locatorUser.getPortal_UserService(new URL("http://test:test@127.0.0.1:8080/tunnel-web/secure/axis/Portal_UserService"));

//http://abc:abc@127.0.0.1:8080/tunnel-web/secure/axis/Portal_UserService

if(null!=soapUser){
System.out.println("Inside soapUser not null*********");
UserSoap soapUserModel = soapUser.getUserById(10134);
System.out.println(" getEmailAddress:" + soapUserModel.getEmailAddress());

}

} catch (Exception e) {
e.printStackTrace();
}
}

}

Adding servlet in Liferay portlet

2011-05-23T03:48:00.000-07:00

In the Web.xml you should have the below code mapping

servlettest-portlet

index.html

index.htm

index.jsp

default.html

default.htm

default.jsp

testServlet

com.liferay.portal.kernel.servlet.PortalDelegateServlet

servlet-class

com.aonehewit.servlet.TestServlet

sub-context

testServlet

/testServlet/*

http://java.sun.com/portlet_2_0

/WEB-INF/tld/liferay-portlet.tld

In the class you should have the below code

/**
*
*/
package com.aonehewit.servlet;

import com.liferay.portal.kernel.servlet.PortalDelegatorServlet;
import com.liferay.portal.kernel.util.JavaConstants;
import com.liferay.portal.kernel.util.WebKeys;

import java.io.IOException;

import javax.portlet.PortletRequest;
import javax.portlet.PortletResponse;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
* @author basanagowda.patil
*
*/
public class TestServlet extends HttpServlet {

@Override
public void init() throws ServletException {
// TODO Auto-generated method stub
super.init();
System.out.println("Inside the init() method****************8 of TestServlet");
}

@Override
protected void service(HttpServletRequest arg0, HttpServletResponse arg1)
throws ServletException, IOException {
System.out.println("Inside the service******************TestServlet");
super.service(arg0, arg1);
}

@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
System.out.println("Inside the doGet method**********************888");
super.doGet(req, resp);
}

@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
// TODO Auto-generated method stub
super.doPost(req, resp);

System.out.println("Inside the Do post me thod:::::::::::::::::::");
}

}

The url to access the servlet will be as below

http://localhost:8080/delegate/testServlet

Note : delegate is not a portlet it is another servlet which is used to invoke our servlet.

Run Action flow in Alfresco

2011-05-05T01:11:00.000-07:00

1. Run actionwizard
2. actions.jsp
3. When we click on setvalues and add then the seperate page
will be opened.
4. From the page it will register the value to the corresonding executer
class.
5. On the click of finish in The RunActionwizard ,finishImpl
will find the corresponding bean handler and its executeIpl()
will be called. that will be responsible for performing the
operations

WebLogic Server Terminologies

2011-04-16T00:26:00.001-07:00

What is domain?
The logically related group of WebLogic server instances managed from single set of configuration artifacts. DOmian will have the servers and the clusters.

What is server?
It is the configured instance to host applications and resources. Server can be managed server or administraton server.

What is admin server?
One domain will have one administration server. It will have the administration console. From the administration console we can start and stop the servers.

What is Managed Server?
Each managed server is independent of other managed servers. There can be multiple managed servers in a domain. Managed servers are managed by the administration server. Each managed server will have the local copy of the configuration. Managed server and the administration server will be in sync. If you make any changes to the managed server from the administartation server then that configuration will be moved to the Managed server.

What is Cluster?
The group of managed servers running simultaneously in a domain is called as Cluster. There can be multiple clusters in a single domain. All the servers within the cluster have to be at the same Maintenance pack level. The clustered servers can be in the same or different machines.

What is Node Manager?
It is not associated with any domain. It is the utility running on the server which enables to start ,stop and restart the server. It is required for the server Migration

What is Machine?
Machine is piece of hardware. In a machine we can have the multiple managed servers

Administration tools
1. Configuration Wizard. : For creating the domains
2. Administration console : Complete administatration of the server is involved here.We can monitor dmains,deploy the applications and control the servers.The operation that can be performed on the admin console can be performed in the WLST i,e WebLogic Scripting Tool
Along with these we can use the command line tools for the deployment.
Weblogic.Deployer.

Conclusion

The best practice is to have the each manged server in its own physical server.Each application will have its own domain. Even the admin server have to be in its own phusical server.

Developing a portlet with multiple actions

2011-04-11T00:41:00.000-07:00

In our portlet class we need not implement our functionalities using processAction(),
We can write our own method actions.The name of the method can be whatever you want since you will be
referring to it when creating the URL

public class MyGreetingPortlet extends MVCPortlet {
public void setGreeting(
ActionRequest actionRequest, ActionResponse actionResponse)
throws IOException, PortletException {
PortletPreferences prefs = actionRequest.getPreferences();
String greeting = actionRequest.getParameter("greeting");
if (greeting != null) {
try {
prefs.setValue("greeting", greeting);
prefs.store();
}
catch(Exception e) {
SessionErrors.add(actionRequest, "error");
}
}
SessionMessages.add(actionRequest, "success");
}
public void sendEmail(
ActionRequest actionRequest, ActionResponse actionResponse)
throws IOException, PortletException {
// Add code here to send an email
}
}

The jsp element to call this is as below

Passing information from the action phase to the render phase

2011-04-10T23:39:00.000-07:00

Information can be passed from action phase to the render phase in 2 ways
1. By setting the setRenderParameter in the processAction method
2. Using the session

1. BY setRenderParameter
Within the implementaiton in the
processAction method you can invoke the setRenderParameter to add a new parameter
to the request that the render phase will be able to read:
actionResponse.setRenderParameter("parameter-name", "value");
From the render phase (in our case, the JSP), this value can be read using the
regular parameter reading method:
renderRequest.getParameter("parameter-name");

It is important to be aware that when invoking an action URL, the parameters
specified in the URL will only be readable from the action phase (that is the
processAction method). In order to pass parameter values to the render phase you
must read them from the actionRequest and then invoke the setRenderParameter
method for each parameter needed.

2. By using SessionMessages

SessionMessages.add(actionRequest, "success");

This is displayed in the jsp with the below tag

Understanding the two phases of portlet execution: action and render

2011-04-10T22:45:00.000-07:00

Action phase: The action phase can only be invoked for one portlet at a
time and is usually the result of an user interaction with the portlet. In
this phase the portlet can change its status, for instance changing the
user preferences of the portlet. It is also recommended that any inserts
and modifications in the database or operations that should not be
repeated are performed in this phase.

• Render phase: The render phase is always invoked for all portlets in
the page after the action phase (which may or not exist). This includes
the portlet that also had executed its action phase. It's important to
note that the order in which the render phase of the portlets in a page
gets executedis not guaranteed by the portlet specification. Liferay has
an extension to the specification through the element render-weight in
liferay-portlet.xml. Portlets with a higher render weight will be
rendered before those with a lower value.

renderURL: this is the type of URL that we have used so far. It invokes a
portlet using only its render phase.

• actionURL: this type of URL tells the portlet that it should execute its
action phase before rendering all the portlets in the page.

Exploring tlds

2011-04-10T03:51:00.000-07:00

Liferay exposes some of the default objects this is been done from the tag

and the corresponding class is com.liferay.taglib.theme.DefineObjectsTag

it exposes the objects like themeDisplay , layouts ,layout ,user ,theme etc

There is one more tag

It exposes the class
com.liferay.taglib.portlet.DefineObjectsTag

It exposes the objects like portletConfig , portletName , portletPreferences , portletPreferencesValues , portletSession , portletSessionScope and conditionally
actionResponse, eventResponse, renderResponse, resourceResponse based on the phase.

That is the reason we include these imports in all the pages.

Exploring Liferay Login Portlet

2011-04-10T01:27:00.000-07:00

From this example we will know how to submit the portlet, how to read the parameters from the page. We will know some of the default objects of the Liferay and how the values will be populated.

ConfigurationActionImpl is responsible for the struts actions

The Liferay Portlet configuration is as below

/html/icons/login.png

com.liferay.portlet.login.action.ConfigurationActionImpl

false

/html/portlet/login/css/main.jsp

portlet-login

true

The LoginAction will explain the basic concept of handling the parameters

Alfresco installation in Weblogic server

2011-03-31T23:40:00.000-07:00

1. Download the .ear file and put it in c:\Alfresco and execute below commands for extraction
mkdir alfresco
cd alfresco
jar xvf ../alfresco-enterprise-3.4.0.ear
move alfresco.war alfresco.war.tmp
move share.war share.war.tmp
mkdir alfresco.war
mkdir share.war
cd alfresco.war
jar xvf ../alfresco.war.tmp
cd ../share.war
jar xvf ../share.war.tmp

WebLogic administration

2011-03-31T03:57:00.001-07:00

System administration of WebLogic Server includes a wide range of tasks: creating WebLogic Server domains; deploying applications; migrating domains from development environments to production environments; monitoring and managing the performance of the run-time system; and diagnosing and troubleshooting problems. (A WebLogic Server domain is a collection of WebLogic Server services designed for a specific purpose. For example, you might create one domain to provide an employee portal and another domain to provide business services to your customers.)

WebLogic Server provides several ways to start and stop server instances. The method that you choose depends on whether you prefer using a graphical or command-line interface, and on whether you are using the Node Manager to manage a server's life cycle.
You can start a server instance on any computer on which WebLogic Server has been installed. The server's configuration information always resides in the domain's config.xml file, which is located on the computer that hosts the Administration Server. The first server instance you start in a domain assumes the role of Administration Server. Additional server instances assume the role of Managed Server.

No matter how you start a server, the end result passes a set of configuration options to initialize a Java Virtual Machine (JVM). The server instance runs within the JVM, and the JVM can host only one server instance.

Liferay Tags

2011-03-29T00:16:00.000-07:00

Liferay portal tags are JavaServer Pages Standard Tag Library (JSTL) tags. Using Liferay tags has the following two benefits.

You get a complicated feature with only one tag.
Liferay UI tags have been tested. They do not introduce bugs. This saves testing time.

They can be classified as below

Alloy (AUI) tags
Liferay portlet tags
Liferay liferay-portlet tags
Liferay security tags
Liferay theme tags
Liferay UI tags
Liferay utility tags

Liferay portlet tags

com.liferay.taglib.portlet.DefineObjectsTag class is responsible for its interpretation. The result is that the following objects, among others, are set in
the pageContext:
renderRequest
renderResponse
portletPreferences
In this way we can directly use these objects in our portlet JSP file coding

portlet:actionURL

We can use the actionURL tag to dynamically generate a URL in our JSP file and
use it, say, as an action URL for a form.

This tag is interpreted by the com.liferay.taglib.portlet.ActionURLTag class. It generates an action URL string with page layout ID, portlet ID, portlet mode, window state, and layout information. It will also include a parameter name of struts_action with a value of /journal/edit_article. This URL is set as value for an editArticleActionURL variable. Eventually this variable is used as the
action URL for a form as follows:

localization of Web Content in Liferay

2011-03-28T09:54:00.001-07:00

Liferay has built-in support for localization of web contents in some of the out-of-box portlets such as Web Content portlet.
A user needs to create a new article with contents in the default language first and save it. The user can then edit the article, select a different language in the Language drop down, and then add the localized content by using the WYSIWYG online editor.

Status command of mysql

2011-03-28T09:22:00.000-07:00

mysql> create database lportal character set utf8 collate utf8_bin;
mysql> use lportal;
mysql> status;

The status comman will display the below details.
mysql Ver 14.14 Distrib 5.1.44, for Win32 (ia32)
Connection id: 3
Current database: lportal
Current user: root@localhost
SSL: Not in use
Using delimiter: ;
Server version: 5.1.44-community MySQL Community Server (GPL)
Protocol version: 10
Connection: localhost via TCP/IP
Styling Pages
[ 100 ]
Server characterset: utf8
Db characterset: utf8
Client characterset: utf8
Conn. characterset: utf8
TCP port: 3306
Uptime: 45 min 51 sec
Threads: 1 Questions: 12 Slow queries: 0 Opens: 15 Flush tables: 1 Open tables: 0 Queries per
second avg: 0.4
--------------
mysql>

Getting CMISObject from nodeRef of Alfresco

2011-03-28T06:09:00.001-07:00

/**
*
*/
package com.packtpub.a3ws.samples.chemistry;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.apache.chemistry.opencmis.client.api.Folder;
import org.apache.chemistry.opencmis.client.api.ObjectId;
import org.apache.chemistry.opencmis.client.api.Repository;
import org.apache.chemistry.opencmis.client.api.Session;
import org.apache.chemistry.opencmis.client.api.SessionFactory;
import org.apache.chemistry.opencmis.client.runtime.SessionFactoryImpl;
import org.apache.chemistry.opencmis.commons.SessionParameter;
import org.apache.chemistry.opencmis.commons.enums.BindingType;

/**
* @author basanagowda.patil
*
*
*/
public class GettingFolders {

private static Session getSession(String serverUrl, String username, String password) {
SessionFactory sessionFactory = SessionFactoryImpl.newInstance();
Map params = new HashMap();
params.put(SessionParameter.USER, username);
params.put(SessionParameter.PASSWORD, password);
params.put(SessionParameter.ATOMPUB_URL, serverUrl);
params.put(SessionParameter.BINDING_TYPE, BindingType.ATOMPUB.value());
List repos = sessionFactory.getRepositories(params);
if (repos.isEmpty()) {
throw new RuntimeException("Server has no repositories!");
}
return repos.get(0).createSession();
}

/**
* @param args
*/

public static void main(String[] args) {
String serverUrl = "http://localhost:8080/alfresco/service/cmis";
String username = "admin";
String password = "admin";
Session session = getSession(serverUrl, username, password);
Folder root = session.getRootFolder();

System.out.println("The root folder is :::"+ root.getId());

//Create the folder(Wiki, inside Wiki images) under CompanyHome

Folder wikiImagesFolder = (Folder) session.getObjectByPath("/Wiki/images");

System.out.println("Illustrating how to construct the CMISObject from the noderef");
System.out.println("The folder ref of the image created is::"+ wikiImagesFolder.getId());
ObjectId parentId = session.createObjectId(wikiImagesFolder.getId());
Folder wikiImagesFolder1 = (Folder) session.getObject(parentId);

System.out.println("Reconstructed the CMisobject from the nodeRef:::"+ wikiImagesFolder1.getId());

}

}

Alfresco CMIS support for Custom types

2011-03-28T06:01:00.000-07:00

As of noe CMIS 1.0 spec does not support the custom content types used in alfresco.

refer to the below link
http://forums.alfresco.com/en/viewtopic.php?f=45&t=37645

Re: Defining custom metadata types through CMIS.

Postby fmui » 08 Mar 2011, 11:16
Hi,

There are two answers:

1) Creating new custom types through CMIS is not possible at this time because it is not part of the CMIS 1.0 standard.
This going to change with CMIS 1.1. The next revision of the standard will define type creation, modification and deletion.
The CMIS 1.1 specification will hopefully be completed in late summer and Alfresco will have an implementation shortly aft that.

2) You can set up a dynamic model through CMIS: http://wiki.alfresco.com/wiki/Dynamic_Models
Create the model document with type "cm:dictionaryModel" and set the property "cm:modelActive" to true.
This, of course, is Alfresco specific and will not work with other repositories.

- Florian

Loading of files in Liferay

2011-03-23T09:57:00.000-07:00

Initially the servlet init method will get called,
Refer to MainServlet used by Main Servlet.
It is going to read the files from the classpath.
It will load the themes and layouts related files from both the core and the ext environment.

The following methods will be called
initThemes()
readPluginPackage();
initPortlets(pluginPackage);
initLayoutTemplates(pluginPackage, portlets);
initThemes(pluginPackage, portlets);
initSocialEquityLogScheduler();

SCJP Naming convention and First Java Program

2011-03-20T00:52:00.000-07:00

/**
*
*/
package com.patil.chapter1;

/**
* @author basanagowda.patil
*
*/
public class NamingConvention {

private static int $1;
private static Integer integr2;
private static double dou1ble;
private static Double $dou1$ble2;
private static float floatValue;
private static Float floatValue$;
private static boolean boolean1;
private static Boolean _boolean$;

public static void main(String[] args) {

System.out.println("static method can access only static variable or the static method");
System.out.println("Naming Convention and default value is:::"+ $1);
System.out.println("default value of double is:::"+ dou1ble);
System.out.println("default value of Integer is:::"+ integr2);
System.out.println("default value of double is:::"+ dou1ble);
System.out.println("default value of Double is:::"+ $dou1$ble2);
System.out.println("default value of float is:::"+ floatValue);
System.out.println("default value of Float is:::"+ floatValue$);
System.out.println("default value of boolean is:::"+ boolean1);
System.out.println("default value of Boolean is:::"+ _boolean$);

}

static{
System.out.println("Starting with the static block");
System.out.println("variable can be started with the number or characters,only $ is allowed as the special character");
$1 = 100;
}

NamingConvention(){
System.out.println("Inside the Constructor");
System.out.println("Constructor is not called since we have not instantiated");
}

public void nonstaticMethod(){
System.out.println("Inside nonstaticMethod");
}

public void $methodWithNumber1AndSpecial$Character(){
System.out.println("Inside nonstaticMethod");
System.out.println("Method can start only with the special character $, other characters are not allowed");
System.out.println("Method cannot start with the Number,but inbetween it can have the number");
}

public void _methodWithUnderScore1AndSpecial$Character(){
System.out.println("Method Name can be started with the underscore, and even the character can start with the underscore");

}

}

WebServices of Alfresco

2011-03-13T22:23:00.000-07:00

End point to access the Authority WebService

http://localhost:8080/alfresco/wsdl/authoring-service.wsdl

The bean which has the declaration of the beans are in the location
D:\Alfresco3.3.4\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\web-services-application-context

All these services are implemented in JAX-RPC protocol(Validate this once)

package org.alfresco.repo.webservice.administration;

public interface AdministrationServiceSoapPort extends java.rmi.Remote {

/**
* Gets the details of the requested users.
*/
public org.alfresco.repo.webservice.administration.UserQueryResults queryUsers(org.alfresco.repo.webservice.administration.UserFilter filter) throws java.rmi.RemoteException, org.alfresco.repo.webservice.administration.AdministrationFault;

/**
* Fetch the next bathc of users from an existing user query.
*/
public org.alfresco.repo.webservice.administration.UserQueryResults fetchMoreUsers(java.lang.String querySession) throws java.rmi.RemoteException, org.alfresco.repo.webservice.administration.AdministrationFault;

/**
* Get the details of a specified user.
*/
public org.alfresco.repo.webservice.administration.UserDetails getUser(java.lang.String userName) throws java.rmi.RemoteException, org.alfresco.repo.webservice.administration.AdministrationFault;

/**
* Create new users with the details provided.
*/
public org.alfresco.repo.webservice.administration.UserDetails[] createUsers(org.alfresco.repo.webservice.administration.NewUserDetails[] newUsers) throws java.rmi.RemoteException, org.alfresco.repo.webservice.administration.AdministrationFault;

/**
* Updates the details of the specified users.
*/
public org.alfresco.repo.webservice.administration.UserDetails[] updateUsers(org.alfresco.repo.webservice.administration.UserDetails[] users) throws java.rmi.RemoteException, org.alfresco.repo.webservice.administration.AdministrationFault;

/**
* Changes the password of the specified user.
*/
public void changePassword(java.lang.String userName, java.lang.String oldPassword, java.lang.String newPassword) throws java.rmi.RemoteException, org.alfresco.repo.webservice.administration.AdministrationFault;

/**
* Delete the specified users.
*/
public void deleteUsers(java.lang.String[] userNames) throws java.rmi.RemoteException, org.alfresco.repo.webservice.administration.AdministrationFault;
}

A pattern called "WSDL First" is generally considered the best approach for developing interoperable web services. We have defined the schemas for all the types we'll use in the web services and are in the process of defining the WSDL for each of the services.

Once the WSDL is defined we use Axis's WSDL2Java tool to generate the classes required to support the service. We then write a class implementing the generated interface for the service and add setters for all the services that need to be injected by Spring. This class is then referenced in web-services-application-context.xml so that it can be referenced by server-config.wsdd using the Axis/Spring integration.

One of the class implementation is given below
/*
* Copyright (C) 2005-2010 Alfresco Software Limited.
*
* This file is part of Alfresco
*
* Alfresco is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Alfresco is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Alfresco. If not, see .
*/
package org.alfresco.repo.webservice.administration;

import java.io.Serializable;
import java.rmi.RemoteException;
import java.text.MessageFormat;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;

import org.alfresco.error.AlfrescoRuntimeException;
import org.alfresco.model.ContentModel;
import org.alfresco.repo.transaction.RetryingTransactionHelper.RetryingTransactionCallback;
import org.alfresco.repo.webservice.AbstractWebService;
import org.alfresco.repo.webservice.Utils;
import org.alfresco.repo.webservice.action.ActionFault;
import org.alfresco.repo.webservice.repository.RepositoryFault;
import org.alfresco.repo.webservice.types.NamedValue;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.repository.NodeService;
import org.alfresco.service.cmr.repository.datatype.DefaultTypeConverter;
import org.alfresco.service.cmr.security.AuthorityService;
import org.alfresco.service.cmr.security.MutableAuthenticationService;
import org.alfresco.service.cmr.security.PersonService;
import org.alfresco.service.namespace.QName;
import org.alfresco.service.transaction.TransactionService;
import org.apache.axis.MessageContext;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

/**
* @author Roy Wetherall
*/
public class AdministrationWebService extends AbstractWebService implements
AdministrationServiceSoapPort
{
/** Log */
private static Log logger = LogFactory.getLog(AdministrationWebService.class);

/** The person service */
private PersonService personService = null;

/**
* Indicates whether the user administration methods should manage the authentication
* details, or just the person details.
*
* Set this to true if an 3rd party authentication implementation has been pluged into
* the repository that manages authentication details.
*/
private boolean manageAuthenticationDetails = true;

/** The authentication service */
private MutableAuthenticationService authenticationService = null;

private AuthorityService authorityService;

/** The transaction service */
private TransactionService transactionService = null;

/** A set of ignored properties */
private static Set ignoredProperties = new HashSet(3);

/**
* Constructor
*/
public AdministrationWebService()
{
// Set properties to ignore
AdministrationWebService.ignoredProperties.add(ContentModel.PROP_STORE_PROTOCOL);
AdministrationWebService.ignoredProperties.add(ContentModel.PROP_STORE_IDENTIFIER);
AdministrationWebService.ignoredProperties.add(ContentModel.PROP_NODE_UUID);
}

/**
* Set the flag that indicates whether this service should manage user authentication details as
* well as person details.
*
* @param manageAuthenticationDetails true if authentication details are managed, false otherwise
*/
public void setManageAuthenticationDetails(boolean manageAuthenticationDetails)
{
this.manageAuthenticationDetails = manageAuthenticationDetails;
}

/**
* Set the transaction service
*
* @param transactionService the transaction service
*/
public void setTransactionService(TransactionService transactionService)
{
this.transactionService = transactionService;
}

/**
* Set the person service
*
* @param personService sets the person service
*/
public void setPersonService(PersonService personService)
{
this.personService = personService;
}

/**
* Set the authentication service
*
* @param authenticationService the authentication service
*/
public void setAuthenticationService(MutableAuthenticationService authenticationService)
{
this.authenticationService = authenticationService;
}

/**
* Set the authority service used to determine admin rights.
*
* @param authorityService the service implementation
*/
public void setAuthorityService(AuthorityService authorityService)
{
this.authorityService = authorityService;
}

/**
* @see org.alfresco.repo.webservice.administration.AdministrationServiceSoapPort#queryUsers(org.alfresco.repo.webservice.administration.UserFilter)
*/
public UserQueryResults queryUsers(final UserFilter filter)
throws RemoteException, AdministrationFault
{
try
{
RetryingTransactionCallback callback = new RetryingTransactionCallback()
{
public UserQueryResults execute() throws Exception
{
return queryUsersImpl(filter);
}
};
return transactionService.getRetryingTransactionHelper().doInTransaction(callback);
}
catch (Throwable exception)
{
if (logger.isDebugEnabled())
{
logger.error("Unexpected error occurred", exception);
}

throw new ActionFault(0, exception.getMessage());
}
}

/**
* Query users, batch by set size
*
* @param filter used to filter results
* @return user query results, optionally batched
*/
private UserQueryResults queryUsersImpl(UserFilter filter)
{
MessageContext msgContext = MessageContext.getCurrentContext();

// Create the query
UserQuery query = new UserQuery(filter);

// Create a user query session
UserQuerySession userQuerySession = new UserQuerySession(Long.MAX_VALUE, Utils.getBatchSize(msgContext), query);

// Get the next batch of results
UserQueryResults userQueryResults = userQuerySession.getNextResults(serviceRegistry);

String querySessionId = userQuerySession.getId();
// add the session to the cache if there are more results to come
boolean haveMoreResults = userQuerySession.haveMoreResults();
if (haveMoreResults)
{
querySessionCache.put(querySessionId, userQuerySession);
}

// Construct the return value
// TODO: http://issues.alfresco.com/browse/AR-1689
// This looks odd, but I've chosen to be specific about when the ID is set on the return
// results and when it isn't.
UserQueryResults result = new UserQueryResults(
haveMoreResults ? querySessionId : null,
userQueryResults.getUserDetails());

// Done
return result;
}

/**
* @see org.alfresco.repo.webservice.administration.AdministrationServiceSoapPort#fetchMoreUsers(java.lang.String)
*/
public UserQueryResults fetchMoreUsers(final String querySession)
throws RemoteException, AdministrationFault
{
try
{
RetryingTransactionCallback callback = new RetryingTransactionCallback()
{
public UserQueryResults execute() throws Exception
{
return fetchMoreUsersImpl(querySession);
}
};
return transactionService.getRetryingTransactionHelper().doInTransaction(callback);
}
catch (Throwable exception)
{
if (logger.isDebugEnabled())
{
logger.error("Unexpected error occurred", exception);
}

throw new ActionFault(0, exception.getMessage());
}
}

/**
*
* @param querySessionId
* @return
*/
private UserQueryResults fetchMoreUsersImpl(String querySessionId) throws RepositoryFault
{
UserQuerySession session = null;
try
{
session = (UserQuerySession) querySessionCache.get(querySessionId);
}
catch (ClassCastException e)
{
if (logger.isDebugEnabled())
{
logger.debug("Query session was not generated by the AdministrationWebService: " + querySessionId);
}
throw new RepositoryFault(
4,
"querySession with id '" + querySessionId + "' is invalid");
}

UserQueryResults queryResult = null;
if (session != null)
{
queryResult = session.getNextResults(serviceRegistry);
if (!session.haveMoreResults())
{
this.querySessionCache.remove(querySessionId);
}
else
{
// Update the cache instance so that it can trigger replication as required
querySessionCache.put(querySessionId, session);
}
}

return queryResult;
}

/**
* @see org.alfresco.repo.webservice.administration.AdministrationServiceSoapPort#getUser(java.lang.String)
*/
public UserDetails getUser(final String userName) throws RemoteException, AdministrationFault
{
try
{
RetryingTransactionCallback callback = new RetryingTransactionCallback()
{
public UserDetails execute() throws Exception
{
return getUserImpl(userName);
}
};
return transactionService.getRetryingTransactionHelper().doInTransaction(callback);
}
catch (Throwable exception)
{
if (logger.isDebugEnabled())
{
logger.error("Unexpected error occurred", exception);
}

throw new ActionFault(0, exception.getMessage());
}
}

/**
* Get the user details
*
* @param userName the user name
* @return the user details object
* @throws RemoteException
* @throws AdministrationFault
*/
private UserDetails getUserImpl(String userName)
{
NodeService nodeService = serviceRegistry.getNodeService();
UserDetails userDetails = null;

if (this.personService.personExists(userName) == true)
{
NodeRef nodeRef = this.personService.getPerson(userName);
userDetails = createUserDetails(nodeService, userName, nodeRef);
}
else
{
// Throw an exception to indicate that the user does not exist
throw new AlfrescoRuntimeException(MessageFormat.format("The user with name {0} does not exist.", new Object[]{userName}));
}

return userDetails;
}

/**
* Given a valid person node reference will create a user details object
*
* @param nodeRef the node reference
* @return the user details object populated with the appropriate property values
*/
/* package */ static UserDetails createUserDetails(NodeService nodeService, String userName, NodeRef nodeRef)
{
// Create the user details object
UserDetails userDetails = new UserDetails();

// Set the user name
userDetails.setUserName(userName);

// Set the various property values
Map properties = nodeService.getProperties(nodeRef);
List namedValues = new ArrayList(properties.size());
for (Map.Entry entry : properties.entrySet())
{
if (AdministrationWebService.ignoredProperties.contains(entry.getKey()) == false)
{
String value = null;
try
{
value = DefaultTypeConverter.INSTANCE.convert(String.class, entry.getValue());
}
catch (Throwable exception)
{
value = entry.getValue().toString();
}
NamedValue namedValue = new NamedValue();
namedValue.setName(entry.getKey().toString());
namedValue.setIsMultiValue(false);
namedValue.setValue(value);
namedValues.add(namedValue);
}
}
userDetails.setProperties((NamedValue[])namedValues.toArray(new NamedValue[namedValues.size()]));

return userDetails;
}

/**
* @see org.alfresco.repo.webservice.administration.AdministrationServiceSoapPort#createUsers(org.alfresco.repo.webservice.administration.NewUserDetails[])
*/
public UserDetails[] createUsers(final NewUserDetails[] newUsers) throws RemoteException, AdministrationFault
{
try
{
RetryingTransactionCallback callback = new RetryingTransactionCallback()
{
public UserDetails[] execute() throws Exception
{
return createUsersImpl(newUsers);
}
};
return transactionService.getRetryingTransactionHelper().doInTransaction(callback);
}
catch (Throwable exception)
{
if (logger.isDebugEnabled())
{
logger.error("Unexpected error occurred", exception);
}

throw new ActionFault(0, exception.getMessage());
}
}

/**
* Create the new users
*
* @param newUsers the new users detail
* @return the details of the created users
* @throws RemoteException
* @throws AdministrationFault
*/
private UserDetails[] createUsersImpl(NewUserDetails[] newUsers)
{
NodeService nodeService = serviceRegistry.getNodeService();
UserDetails[] userDetails = new UserDetails[newUsers.length];

int index = 0;
for (NewUserDetails newUser : newUsers)
{
if (this.manageAuthenticationDetails == true)
{
// Create a new authentication
this.authenticationService.createAuthentication(newUser.getUserName(), newUser.getPassword().toCharArray());
}

// Create a new person
Map properties = new HashMap(7);
properties.put(ContentModel.PROP_USERNAME, newUser.getUserName());
for (NamedValue namedValue : newUser.getProperties())
{
properties.put(QName.createQName(namedValue.getName()), namedValue.getValue());
}
NodeRef personNodeRef = this.personService.createPerson(properties);

// Add the details to the result
userDetails[index] = createUserDetails(nodeService, newUser.getUserName(), personNodeRef);
index++;
}

return userDetails;
}

/**
* @see org.alfresco.repo.webservice.administration.AdministrationServiceSoapPort#updateUsers(org.alfresco.repo.webservice.administration.UserDetails[])
*/
public UserDetails[] updateUsers(final UserDetails[] users) throws RemoteException, AdministrationFault
{
try
{
RetryingTransactionCallback callback = new RetryingTransactionCallback()
{
public UserDetails[] execute() throws Exception
{
return updateUsersImpl(users);
}
};
return transactionService.getRetryingTransactionHelper().doInTransaction(callback);
}
catch (Throwable exception)
{
if (logger.isDebugEnabled())
{
logger.error("Unexpected error occurred", exception);
}

throw new ActionFault(0, exception.getMessage());
}
}

/**
* Update the users details
*
* @param users the user details to update
* @return the updated user details
*/
private UserDetails[] updateUsersImpl(UserDetails[] users)
{
NodeService nodeService = serviceRegistry.getNodeService();
UserDetails[] userDetails = new UserDetails[users.length];

int index = 0;
for (UserDetails user : users)
{
// Build the property map
Map properties = new HashMap(7);
properties.put(ContentModel.PROP_USERNAME, user.getUserName());
for (NamedValue namedValue : user.getProperties())
{
properties.put(QName.createQName(namedValue.getName()), namedValue.getValue());
}

// Update the properties of the person
this.personService.setPersonProperties(user.getUserName(), properties);

// Add the details to the result
NodeRef nodeRef = this.personService.getPerson(user.getUserName());
userDetails[index] = createUserDetails(nodeService, user.getUserName(), nodeRef);
index++;
}

return userDetails;
}

/**
* @see org.alfresco.repo.webservice.administration.AdministrationServiceSoapPort#changePassword(java.lang.String, java.lang.String, java.lang.String)
*/
public void changePassword(final String userName, final String oldPassword, final String newPassword) throws RemoteException, AdministrationFault
{
try
{
RetryingTransactionCallback callback = new RetryingTransactionCallback()
{
public Object execute() throws Exception
{
changePasswordImpl(userName, oldPassword, newPassword);
return null;
}
};
transactionService.getRetryingTransactionHelper().doInTransaction(callback);
}
catch (Throwable exception)
{
if (logger.isDebugEnabled())
{
logger.error("Unexpected error occurred", exception);
}

throw new ActionFault(0, exception.getMessage());
}
}

/**
* Change the current password of the user
*
* @param userName the user name
* @param oldPassword the old (current) password
* @param newPassword the new password
*/
private void changePasswordImpl(String userName, String oldPassword, String newPassword)
{
if (this.manageAuthenticationDetails == true)
{
// Update the authentication details
if (this.authorityService.hasAdminAuthority() == true)
{
this.authenticationService.setAuthentication(userName, newPassword.toCharArray());
}
else
{
this.authenticationService.updateAuthentication(userName, oldPassword.toCharArray(), newPassword.toCharArray());
}
}
else
{
throw new RuntimeException("Web service has been configured so that user authenticaiton details are not managed.");
}
}

/**
* @see org.alfresco.repo.webservice.administration.AdministrationServiceSoapPort#deleteUsers(java.lang.String[])
*/
public void deleteUsers(final String[] userNames) throws RemoteException,
AdministrationFault
{
try
{
RetryingTransactionCallback callback = new RetryingTransactionCallback()
{
public Object execute() throws Exception
{
deleteUsersImpl(userNames);
return null;
}
};
transactionService.getRetryingTransactionHelper().doInTransaction(callback);
}
catch (Throwable exception)
{
if (logger.isDebugEnabled())
{
logger.error("Unexpected error occurred", exception);
}

throw new ActionFault(0, exception.getMessage());
}
}

/**
* Delete users
*
* @param userNames the names of the users to delete
*/
private void deleteUsersImpl(String[] userNames)
{
for (String userName : userNames)
{
this.personService.deletePerson(userName);
}
}
}

Integration with CXF

2011-03-13T19:59:00.001-07:00

CXFServlet

org.apache.cxf.transport.servlet.CXFServlet

The above servlet config is responsible for CXF WebServices integration in alfresco.

The beans are loaded from the configuration as below

contextConfigLocation

/WEB-INF/web-application-context.xml

Spring config file location

org.springframework.web.context.ContextLoaderListener

Configuring Log4j in alfresco

2011-03-13T19:50:00.000-07:00

Below command is responsible for loading the log4j configuration.

org.springframework.web.util.Log4jConfigListener

The above line has to be declared in the web.xml file

# Set root logger level to error
log4j.rootLogger=error, Console, File
//2 appenders been defined
1. Console
2. FIle

###### Console appender definition #######

# All outputs currently set to be a ConsoleAppender.
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout

# use log4j NDC to replace %x with tenant domain / username
log4j.appender.Console.layout.ConversionPattern=%d{ABSOLUTE} %x %-5p [%c{3}] %m%n
#log4j.appender.Console.layout.ConversionPattern=%d{ABSOLUTE} %-5p [%c] %m%n

How Javascript integrated with Java

2011-02-24T22:10:00.001-08:00

Alfresco JavaScript Debugger

The Alfresco Server provides a built-in server-side JavaScript debugger which allows line by line step through, variable inspection and arbitrary script execution.

Note:

* The debugger executes in the Java VM of the Alfresco Server. It must be executed on the same machine as the Alfresco Server - remote debugging is not supported.
* The debugger does not function correctly on early SunJDK1.6 series JVMs - enabling it will crash the entire JVM.

To enable and disable the JavaScript debugger use the following URL (you must be logged in as an administrator):

http://:/alfresco/service/api/javascript/debugger

This URL displays the current status of the debugger and allows you toggle between enabled and disabled.

When enabled, the JavaScript Debugger window is displayed. Upon execution of any server-side JavaScript, the debugger will intercept and stop execution at the first JavaScript statement. You can then step through, view variables etc or resume execution. When disabled, server-side JavaScript is executed without interruption.

How is Scripting integrated into Alfresco?

The Script Service is a typical Alfresco repository service accessed via a Spring managed bean with the name of ScriptService.

Only developers will be interested in accessing the ScriptService directly, those more interested in simply writing scripts themselves should skip this section and jump to Scripting API.

The available scripting engines can be configured in the Alfresco Spring config file script-services-context.xml. You should download the Alfresco SDK to examine the structure of this file.

As of Alfresco 2.1 a mechanism for adding additional scripting engines has been available. It is possible to completely replace or augment the existing JavaScript implemenation with others such as PHP or Ruby. The correct script engine implementation will be automatically selected by the ScriptService when executing a script based on the file extension of the script being executed. If it cannot resolve the engine to use, then the developer can specify it explicitly when calling the ScriptService.

Further engines can be added by developers. Examining the script-services-context.xml for configuration examples. The engine must implement org.alfresco.service.cmr.repository.ScriptProcessor interface and it is recommend to extend the org.alfresco.repo.processor.BaseProcessor abstract class and override the various execute() methods.

A Java based PHP engine has been integrated and is a good example of this, it is available as an AMP download for addition into an existing Alfresco installation.

Adding Custom Script APIs

It is possible to create and add custom script API's implemented in Java and accessible as root objects in JavaScript. This provides an integration point for Alfresco extensions to provide custom API's where appropriate.

In order to implement a custom JavaScript API it is recommended that you develop a POJO (Plain Old Java Object) that extends the base class org.alfresco.repo.processor.BaseProcessorExtension. The public methods of your class will be those that will be accessable from JavaScript. (For example see org.alfresco.repo.jscript.ScriptLogger).

Once complete, you must then configure your bean in Spring. Make use of the baseJavaScriptExtension parent bean definition in order to ensure your object is automatically registered with the ScriptService framework. The name of the object as it will appear to script writers must also be specified in the bean definition.

The following example shows the bean definition for the ScriptLogger custom API.

logger

Since this is a standard Spring bean definition any additional services that are required can be injected as properties into the bean definition in the usual way.

Once this bean have been loaded the custom API object will be accessible directly in JavaScript by calling the public methods on the named object. For example the following shows how the log method can be called on the logger API we have defined above.

...
logger.log("This is a log message.");
...

Native Java API Access

In some cases you may find that you're unable to satisfy a requirement using the Javascript API, but that a Java API (perhaps the Alfresco Foundation Services API or AVMService for our WCM module) contains facilities that would allow you to do so.

Using the method described in Adding Custom Script APIs, it is possible to add additional root scope objects to Javascript. In the case of the Alfresco Foundation Services API the only object that needs to be injected is the ServiceRegistry (or a proxy of it) - an example implementation of this may be found at Configuring the ServiceRegistry as a Javascript Root Object.

As of Alfresco 2.1.3, Javascript scripts stored in the classpath (e.g. in the file system at the extension directory) can also leverage the Rhino Javascript interpreter's native Java integration facilities (see the Rhino documentation for more details).

However, for security reasons these mechanisms are completely disabled for Javascript scripts that are stored in the repository. This means that the Javascript file has to be stored in the filesystem to be able to access the Native Java API.

Note that there are some important things to keep in mind when calling native Java APIs from Javascript:

* Mixing the standard JavaScript APIs and Alfresco Java APIs is not recommended - the JavaScript API caches some values which may not be reflected when using Java APIs and vice-versa.
* Extreme care must be taken when using certain Alfresco APIs, for example the transaction APIs. This is because in many cases the Alfresco scripting framework includes logic that handles some of these "plumbing" concerns automatically - for example the Javascript script for a Web Script is automatically executed within an Alfresco transaction - programmatic transaction handling within the Javascript is not required and may interfere with the default behaviour.
* Native Java collections (Arrays, Maps, Lists etc.) do not get translated into their Javascript equivalents, so you cannot use Javascript idioms when accessing them. For example, instead of accessing a java.util.Map using code such as:

var value1 = javaMap["key1"]
var value2 = javaMap.key2

You must call the underlying Java methods instead:

var value1 = javaMap.get("key1")
var value2 = javaMap.get("key2")

Please note that these techniques are solely intended for developers who wish to take advantage of the productivity benefits of a scripted language while still having access to the full power of native Java APIs. They should not be used for end user scripting scenarios (eg. end user developed custom actions uploaded to the repository, workflow scripts, etc.).

Config for datasource configuration alfresco

2011-02-22T19:17:00.000-08:00

java:comp/env/jdbc/dataSource

Getting and using the config service

2011-02-22T19:00:00.000-08:00

/**
* Retrieves the list of configured dialog container pages
*
* @param context FacesContext
* @return The container pages
*/
protected List getDialogContainers(FacesContext context)
{
if ((this.dialogContainers == null) || (Application.isDynamicConfig(FacesContext.getCurrentInstance())))
{
this.dialogContainers = new ArrayList(2);

ConfigService configSvc = Application.getConfigService(context);
Config globalConfig = configSvc.getGlobalConfig();

if (globalConfig != null)
{
this.dialogContainers.add(globalConfig.getConfigElement("dialog-container").getValue());
this.dialogContainers.add(globalConfig.getConfigElement("plain-dialog-container").getValue());
}
}

return this.dialogContainers;
}

Accessing the components of Alfresco as portlet config

2011-02-22T18:47:00.000-08:00

This config is available in the file
C:\Alfresco3.3.3\tomcat\webapps\alfresco\WEB-INF\portlet.xml

The class is haveing portletRuntime implementation as well.

Integration between spring and jsf

2011-02-22T18:38:00.000-08:00

The spring beans can be used in the JSF and the JSF beans in Spring this is possible because of the below configuration

"http://java.sun.com/dtd/web-facesconfig_1_1.dtd">

org.alfresco.web.app.AlfrescoNavigationHandler

org.alfresco.web.app.AlfrescoVariableResolver

This file is available in the location
C:\Alfresco3.3.3\tomcat\webapps\alfresco\WEB-INF\faces-config-app.xml

Mail Issues

2011-02-14T08:57:00.001-08:00

For any issues related to mail see MailActionExecuter,
it has ther code for sending mail to group as well as to user

protected void executeImpl(
final Action ruleAction,
final NodeRef actionedUponNodeRef)
{
// Create the mime mail message
MimeMessagePreparator mailPreparer = new MimeMessagePreparator()
{
@SuppressWarnings("unchecked")
public void prepare(MimeMessage mimeMessage) throws MessagingException
{
if (logger.isDebugEnabled())
{
logger.debug(ruleAction.getParameterValues());
}

MimeMessageHelper message = new MimeMessageHelper(mimeMessage);

// set header encoding if one has been supplied
if (headerEncoding != null && headerEncoding.length() != 0)
{
mimeMessage.setHeader("Content-Transfer-Encoding", headerEncoding);
}

// set recipient
String to = (String)ruleAction.getParameterValue(PARAM_TO);
if (to != null && to.length() != 0)
{
message.setTo(to);
}
else
{
// see if multiple recipients have been supplied - as a list of authorities
Serializable authoritiesValue = ruleAction.getParameterValue(PARAM_TO_MANY);
List authorities = null;
if (authoritiesValue != null)
{
if (authoritiesValue instanceof String)
{
authorities = new ArrayList(1);
authorities.add((String)authoritiesValue);
}
else
{
authorities = (List)authoritiesValue;
}
}

if (authorities != null && authorities.size() != 0)
{
List recipients = new ArrayList(authorities.size());
for (String authority : authorities)
{
AuthorityType authType = AuthorityType.getAuthorityType(authority);
if (authType.equals(AuthorityType.USER))
{
if (personService.personExists(authority) == true)
{
NodeRef person = personService.getPerson(authority);
String address = (String)nodeService.getProperty(person, ContentModel.PROP_EMAIL);
if (address != null && address.length() != 0 && validateAddress(address))
{
recipients.add(address);
}
}
}
else if (authType.equals(AuthorityType.GROUP))
{
// else notify all members of the group
Set users = authorityService.getContainedAuthorities(AuthorityType.USER, authority, false);
for (String userAuth : users)
{
if (personService.personExists(userAuth) == true)
{
NodeRef person = personService.getPerson(userAuth);
String address = (String)nodeService.getProperty(person, ContentModel.PROP_EMAIL);
if (address != null && address.length() != 0)
{
recipients.add(address);
}
}
}
}
}

message.setTo(recipients.toArray(new String[recipients.size()]));
}
else
{
// No recipiants have been specified
logger.error("No recipiant has been specified for the mail action");
}
}

// set subject line
message.setSubject((String)ruleAction.getParameterValue(PARAM_SUBJECT));

// See if an email template has been specified
String text = null;
NodeRef templateRef = (NodeRef)ruleAction.getParameterValue(PARAM_TEMPLATE);
if (templateRef != null)
{
// build the email template model
Map model = createEmailTemplateModel(actionedUponNodeRef);

// process the template against the model
text = templateService.processTemplate("freemarker", templateRef.toString(), model);
}

// set the text body of the message
if (text == null)
{
text = (String)ruleAction.getParameterValue(PARAM_TEXT);
}
message.setText(text);

// set the from address
NodeRef person = personService.getPerson(authService.getCurrentUserName());

String fromActualUser = null;
if (person != null)
{
fromActualUser = (String) nodeService.getProperty(person, ContentModel.PROP_EMAIL);
}
if( fromActualUser != null && fromActualUser.length() != 0)
{
message.setFrom(fromActualUser);
}
else
{
String from = (String)ruleAction.getParameterValue(PARAM_FROM);
if (from == null || from.length() == 0)
{
message.setFrom(fromAddress);
}
else
{
message.setFrom(from);
}
}
}
};

try
{
// Send the message unless we are in "testMode"
if(!testMode)
{
javaMailSender.send(mailPreparer);
}
else
{
try {
MimeMessage mimeMessage = javaMailSender.createMimeMessage();
mailPreparer.prepare(mimeMessage);
lastTestMessage = mimeMessage;
} catch(Exception e) {
System.err.println(e);
}
}
}
catch (MailException e)
{
String to = (String)ruleAction.getParameterValue(PARAM_TO);
if (to == null)
{
Object obj = ruleAction.getParameterValue(PARAM_TO_MANY);
if (obj != null)
{
to = obj.toString();
}
}

logger.error("Failed to send email to " + to, e);

throw new AlfrescoRuntimeException("Failed to send email to:" + to, e);
}
}

Refreshing the richlist

2011-02-04T21:09:00.000-08:00

If I want to reset the data then use the binding parameter.
In the startworkflowwizard,you can see one component by name packageRichnamelist,which is getting nullified.
Since its been binded to the richlist,whenever you make the value of this
component null then that portion will get refreshed.

Ex:

JSP code :
binding="#{WizardManager.bean.packageItemsRichList}"
styleClass="recordSet" headerStyleClass="recordSetHeader" rowStyleClass="recordSetRow"
altRowStyleClass="recordSetRowAlt" width="100%" pageSize="10"
initialSortColumn="name" initialSortDescending="true">

Java code :

// reset the rich list so it re-renders
this.packageItemsRichList.setValue(null);

Refer to the class StartWorkflowWizard

2011-02-03T07:36:00.000-08:00

refer to the class for checking how the groups will be created in alfresco.

${ldap.synchronization.active}

${ldap.synchronization.queryBatchSize}

${ldap.synchronization.attributeBatchSize}

${ldap.synchronization.groupQuery}

Toolbars ---> Check Alfresco

IF it is not available then do the below step

Go to Help --> About MicrosoftWindows -->DisabledItemss --> Enable Alfresco

import org.springframework.extensions.surf.util.Base64; encding

2011-01-31T10:48:00.000-08:00

import org.springframework.extensions.surf.util.Base64;

It is the encoding used

2011-01-31T10:42:00.000-08:00

LoginController present in package

org.springframework.extensions.surf.mvc

is the entry point for setting the user related data.
Using this we can do anything.
public ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response) throws Exception
{
request.setCharacterEncoding("UTF-8");

String username = (String) request.getParameter("username");
String password = (String) request.getParameter("password");
String successPage = (String) request.getParameter("success");
String failurePage = (String) request.getParameter("failure");

boolean success = false;
try
{
// check whether there is already a user logged in
HttpSession session = request.getSession(false);
if (session != null)
{
// destroy old session and log out the current user
AuthenticationUtil.logout(request, response);
}

UserFactory userFactory = FrameworkUtil.getServiceRegistry().getUserFactory();

// see if we can authenticate the user
boolean authenticated = userFactory.authenticate(request, username, password);
if (authenticated)
{
// this will fully reset all connector sessions
RequestContext context = FrameworkUtil.getCurrentRequestContext();
AuthenticationUtil.login(request, response, username, false);

// mark the fact that we succeeded
success = true;
}
}
catch (Throwable err)
{
throw new ServletException(err);
}

// If they succeeded in logging in, redirect to the success page
// Otherwise, redirect to the failure page
if (success)
{
if (successPage != null)
{
response.sendRedirect(successPage);
}
else
{
response.sendRedirect(request.getContextPath());
}
}
else
{
// inval

_______________________________________

AuthenticationUtil in the org.springframework.extensions.surf.site has the code for handling the user and cookies, which will be used for the future calls

Initializing share framework

2011-01-31T10:23:00.000-08:00

AlfrescoUserFactory present in org.springframework.extensions.surf.support
is responsible for giving all the data related to Alfresco user in share.
LoginController tells about how to authenticate the user and initialize the framework

Storing the complex type in the content model

2011-01-27T22:54:00.000-08:00

In the alfresco content model property you can store List, HashMap,Set etc

For this do the below

In your model define the property

d:any

To store the value use the below code

//storing all the selected regions
final HashMap regionMap = new HashMap();
for(String region : selectedRegions){
regionMap.put(region, region);
}
_map.put(PowerGridContentModel.PROP_REGIONS, (Serializable)regionMap);

To retrieve use the below code, I am considering example of getting property from executionContext

HashMap regionsMap = (HashMap) executionContext.getContextInstance().getVariables().get("pcm_regions");
if(regionsMap != null){

for (Map.Entry pair : regionsMap.entrySet()) {

System.out.println("Region name::"+pair.getKey() + " = " + pair.getValue());

}

Hope it helps.

Run Action

2011-01-27T21:59:00.000-08:00

Refer to classes

ScriptActionExecuter class finishImpl() to find the code to
execute the script.

refer to the ActionExecuter class implemented classes to find out the implementation of each method.

Code for creating the links in alfresco

2011-01-27T07:18:00.001-08:00

/**
* It links the source noderef to the destination noderef.
* Code needs to be tested
* Refer to WorkspaceClipboardItem.
* @param sourceNodeRef the noderef which is to be linked
* @param destNodeRef where the new link to be put
*/
private void establishLinkages(NodeRef sourceNodeRef , NodeRef destNodeRef){
boolean operationComplete = false;
// TODO: Should we be using primary parent here?
// We are assuming that the item exists in only a single parent and that the source for
// the clipboard operation (e.g. the source folder) is specifically that parent node.
// So does not allow for more than one possible parent node - or for linked objects!
// This code should be refactored to use a parent ID when appropriate.

// ChildAssociationRef assocRef = nodeService.getPrimaryParent(getNodeRef());
ChildAssociationRef assocRef = this.getServiceRegistry().getNodeService().getPrimaryParent(sourceNodeRef);
String name = getName(sourceNodeRef);
String linkTo ="Link to";
name = linkTo + ' ' + name;

//Now perform linking

// LINK operation

LOGGER.debug("Attempting to link node ID: " + sourceNodeRef + " into node: " + destNodeRef.toString());

// we create a special Link Object node that has a property to reference the original
// create the node using the nodeService (can only use FileFolderService for content)
String LINK_NODE_EXTENSION = ".url";
if (checkExists(name + LINK_NODE_EXTENSION, destNodeRef) == false)
{
Map props = new HashMap(2, 1.0f);
String newName = name + LINK_NODE_EXTENSION;
props.put(ContentModel.PROP_NAME, newName);
props.put(ContentModel.PROP_LINK_DESTINATION, sourceNodeRef);
DictionaryService dd = getServiceRegistry().getDictionaryService();
if (dd.isSubClass(getType(sourceNodeRef), ContentModel.TYPE_CONTENT))
{
// create File Link node
ChildAssociationRef childRef = this.getServiceRegistry().getNodeService().createNode(
destNodeRef,
ContentModel.ASSOC_CONTAINS,
QName.createQName(assocRef.getQName().getNamespaceURI(), newName),
ApplicationModel.TYPE_FILELINK,
props);

// apply the titled aspect - title and description
Map titledProps = new HashMap(2, 1.0f);
titledProps.put(ContentModel.PROP_TITLE, name);
titledProps.put(ContentModel.PROP_DESCRIPTION, name);
this.getServiceRegistry().getNodeService().addAspect(childRef.getChildRef(), ContentModel.ASPECT_TITLED, titledProps);
}
else
{
// create Folder link node
ChildAssociationRef childRef = this.getServiceRegistry().getNodeService().createNode(
destNodeRef,
ContentModel.ASSOC_CONTAINS,
assocRef.getQName(),
ApplicationModel.TYPE_FOLDERLINK,
props);

// apply the uifacets aspect - icon, title and description props
Map uiFacetsProps = new HashMap(4, 1.0f);
uiFacetsProps.put(ApplicationModel.PROP_ICON, "space-icon-link");
uiFacetsProps.put(ContentModel.PROP_TITLE, name);
uiFacetsProps.put(ContentModel.PROP_DESCRIPTION, name);
this.getServiceRegistry().getNodeService().addAspect(childRef.getChildRef(), ApplicationModel.ASPECT_UIFACETS, uiFacetsProps);
}

// if we get here without an exception, the clipboard link operation was successful
operationComplete = true;
}

LOGGER.debug("Is Linkage operation complete????"+ operationComplete);

}

public String getName(NodeRef sourceNodeRef)
{

String name = (String)getServiceRegistry().getNodeService().getProperty(
sourceNodeRef, ContentModel.PROP_NAME);

return name;
}

protected boolean checkExists(String name, NodeRef parent)
{
/** Shallow search for nodes with a name pattern */
String XPATH_QUERY_NODE_MATCH = "./*[like(@cm:name, $cm:name, false)]";
QueryParameterDefinition[] params = new QueryParameterDefinition[1];
params[0] = new QueryParameterDefImpl(
ContentModel.PROP_NAME,
getServiceRegistry().getDictionaryService().getDataType(
DataTypeDefinition.TEXT),
true,
name);

// execute the query
List nodeRefs = getServiceRegistry().getSearchService().selectNodes(
parent,
XPATH_QUERY_NODE_MATCH,
params,
getServiceRegistry().getNamespaceService(),
false);

return (nodeRefs.size() != 0);
}

public QName getType(NodeRef nodeRef)
{

QName type = getServiceRegistry().getNodeService().getType(nodeRef);

return type;
}

Mapping of javascript and Java

2011-01-27T03:21:00.000-08:00

sitedata object of Alfresco share(Surf) is availbale through
the class ScriptSiteData class present in the spring-surf-1.0.0.CI-SNAPSHOT.jar
Explore this to get the newPreset method.

Hiding Guest Home, UserHomes , DataDictionary in Alfresco share

2011-01-26T05:43:00.000-08:00

Follow the below steps

1. Hide in the tree.
Basically share will make the call to alfresco get all the nodeRef so we need to change the corresponding javascript.
Script responsible for the tree population of Repository is treenode.get.js present in the location

D:\Alfresco3.3\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\templates\webscripts\org\alfresco\slingshot\documentlibrary\treenode.get.js

/**
* Document List Component: treenode
*/
model.treenode = getTreeNode();

/* Create collection of folders in the given space */
function getTreeNode()
{
try
{
var items = new Array(),
hasSubfolders = true,
ignoredTypes =
{
"{http://www.alfresco.org/model/forum/1.0}forum": true,
"{http://www.alfresco.org/model/forum/1.0}topic": true,
"{http://www.alfresco.org/model/content/1.0}systemfolder": true
},
evalChildFolders = args["children"] !== "false",
resultsTrimmed = false,
argMax = parseInt(args["max"], 10),
maxItems = isNaN(argMax) ? -1 : argMax;

// Use helper function to get the arguments
var parsedArgs = ParseArgs.getParsedArgs();
if (parsedArgs === null)
{
return;
}

// Look for folders in the pathNode
for each (item in parsedArgs.pathNode.children)
{ //added by patil to check folders
if (item.isSubType("cm:folder") && !(item.type in ignoredTypes) && !( (item.properties.name =="Data Dictionary") || (item.properties.name =="Guest Home")|| (item.properties.name =="User Homes")|| (item.properties.name =="Imap Home")))
{
if (evalChildFolders)
{
hasSubfolders = item.childFileFolders(false, true, "fm:forum").length > 0;
}

items.push(
{
node: item,
hasSubfolders: hasSubfolders
});
}

if (maxItems !== -1 && items.length > maxItems)
{
items.pop();
resultsTrimmed = true;
break;
}
}

items.sort(sortByName);

return (
{
parent: parsedArgs.pathNode,
resultsTrimmed: resultsTrimmed,
items: items
});
}
catch(e)
{
status.setCode(status.STATUS_INTERNAL_SERVER_ERROR, e.toString());
return;
}
}

/* Sort the results by case-insensitive name */
function sortByName(a, b)
{
return (b.node.name.toLowerCase() > a.node.name.toLowerCase() ? -1 : 1);
}

Similarly in the body part the listing will happen from the script doclist.get.js

/**
* Main entry point: Create collection of documents and folders in the given space
*
* @method getDoclist
*/
function getDoclist()
{
// Use helper function to get the arguments
var parsedArgs = ParseArgs.getParsedArgs();
if (parsedArgs === null)
{
return;
}

var filter = args.filter,
items = [];

// Try to find a filter query based on the passed-in arguments
var allNodes = [],
favourites = Common.getFavourites(),
filterParams = Filters.getFilterParams(filter, parsedArgs,
{
favourites: favourites
}),
query = filterParams.query;

// Query the nodes - passing in sort and result limit parameters
if (query !== "")
{
allNodes = search.query(
{
query: query,
language: filterParams.language,
page:
{
maxItems: (filterParams.limitResults ? parseInt(filterParams.limitResults, 10) : 0)
},
sort: filterParams.sort,
templates: filterParams.templates,
namespace: (filterParams.namespace ? filterParams.namespace : null)
});
}

// Ensure folders and folderlinks appear at the top of the list
var folderNodes = [],
documentNodes = [];

for each (node in allNodes)
{
try
{
if (node.isContainer || node.typeShort == "app:folderlink")
{
//added by patil to filter
if(!( (node.properties.name =="Data Dictionary") || (node.properties.name =="Guest Home")|| (node.properties.name =="User Homes")|| (node.properties.name =="Imap Home"))){
folderNodes.push(node);
}

}
else
{
documentNodes.push(node);
}
}
catch (e)
{
// Possibly an old indexed node - ignore it
}
}

// Node type counts
var folderNodesCount = folderNodes.length,
documentNodesCount = documentNodes.length,
nodes, totalRecords;

if (parsedArgs.type === "documents")
{
nodes = documentNodes;
}
else
{
nodes = folderNodes.concat(documentNodes);
}
totalRecords = nodes.length;

// Pagination
var pageSize = args.size || nodes.length,
pagePos = args.pos || "1",
startIndex = (pagePos - 1) * pageSize;

// Trim the nodes array down to the page size
nodes = nodes.slice(startIndex, pagePos * pageSize);

// Common or variable parent container?
var parent = null;

if (!filterParams.variablePath)
{
// Parent node permissions (and Site role if applicable)
parent =
{
node: parsedArgs.pathNode,
userAccess: Evaluator.run(parsedArgs.pathNode, true).actionPermissions
};
}

var isThumbnailNameRegistered = thumbnailService.isThumbnailNameRegistered(THUMBNAIL_NAME),
thumbnail = null,
locationNode,
item;

// Loop through and evaluate each node in this result set
for each (node in nodes)
{
// Get evaluated properties.
item = Evaluator.run(node);
item.isFavourite = (favourites[item.node.nodeRef] === true);

// Does this collection of nodes have potentially differering paths?
if (filterParams.variablePath || item.isLink)
{
locationNode = (item.isLink && item.type == "document") ? item.linkNode : item.node;
location = Common.getLocation(locationNode);
}
else
{
location =
{
site: parsedArgs.location.site,
siteTitle: parsedArgs.location.siteTitle,
container: parsedArgs.location.container,
path: parsedArgs.location.path,
file: node.name
};
}

// Resolved location
item.location = location;

// Is our thumbnail type registered?
if (isThumbnailNameRegistered)
{
// Make sure we have a thumbnail.
thumbnail = item.node.getThumbnail(THUMBNAIL_NAME);
if (thumbnail === null)
{
// No thumbnail, so queue creation
item.node.createThumbnail(THUMBNAIL_NAME, true);
}
}

items.push(item);
}

return (
{
luceneQuery: query,
paging:
{
totalRecords: totalRecords,
startIndex: startIndex
},
parent: parent,
onlineEditing: utils.moduleInstalled("org.alfresco.module.vti"),
itemCount:
{
folders: folderNodesCount,
documents: documentNodesCount
},
items: items
});
}

/**
* Document List Component: doclist
*/
model.doclist = getDoclist();