nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

As we transition to the new Hyland Community, some post links may be temporarily disrupted as we finalize redirects. We apologize for the inconvenience and are working to resolve this as quickly as possible. Details.

Developing Task List - a multi-user todo list

turgayz

Hi,
On the wiki page http://www.alfresco.org/mediawiki/index.php/Contribution_Area , there are some suggestions of contributions to Alfresco. Among them, I think that implementing the "Task List" will be one of the easiest. So let's start it as a community effort. If you are interested, please write your ideas, suggestions, code… Any help will be appreciated. In the end, I hope we can have a "Task List" contribution to Alfresco.

To start with, I'll try to gather the use cases I can think of - how will the task list be used?

- As a space: A user can create a "Task List" space within his/her home space. And then he can enter lots of "Task"s in it. (So, "Task" looks like a good candidate for a custom type). Later, he will update tasks, mark some of them as completed, etc. We will be able to sort and filter tasks. There may also be department and company wide task lists.

- Tasks can be attached to other nodes: For example, we have a PDF document. A user will be able to attach a Task to the document. Like a manager attaching a task to a document, asking her assistant to modify some part of the document.

This is the functionality I can think of right now. For a start, please write any other use cases you think can be included in the functionality list.

Find more posts tagged with

Comments

turgayz

Gavin had posted some pointers on another thread, which I am copying here:

Thanks for the positive feedback.

Some pointers to get you started…

First of all you will need to create the appropriate types in the model, the following wiki page may help with this: http://www.alfresco.org/mediawiki/index.php/Data_Dictionary_Guide

Add an option into the advanced space wizard for creating a space of your type:
<config evaluator="string-compare" condition="Custom Folder Types">
   <folder-types>
      <type name="fm:forums" icon="/images/icons/forums_large.gif" descriptionMsgId="forums_desc" />
      <type name="your:type" icon="/images/icons/your_icon.gif" description="Description of your space type" />
   </folder-types>
</config>‍‍‍‍‍‍
You can now create spaces of your new type. To get a different "view" of your space when you click on it in the browse view you need to obviously create the JSP and then create some dispatching configuration for it.

In web-client-config.xml add the following (you can use the forums stuff as an example):
<config evaluator="node-type" condition="your:type">
   <navigation>
      <override from-view-id="/jsp/browse/browse.jsp" to-view-id="/jsp/your/page.jsp" />
      <override from-outcome="browse" to-view-id="/jsp/your/page.jsp" />
   </navigation>
</config>‍‍‍‍‍‍
With this config in place when you click on a space in the UI you should get re-directed to your custom page.

I'm working on a wiki page that will explain the dispatching mechanism and also the simple dialog framework we have now too (which is also used by the forums). I'll let you know when it goes live.

turgayz

Hi,
Trying to implement task list functionality, I have done the following:

1) Created a model (taskListModel.xml):

<model name="tl:taskListmodel" xmlns="http://www.alfresco.org/model/dictionary/1.0">

&nbsp;&nbsp; <description>Task List Model</description>
&nbsp;&nbsp; <author></author>
&nbsp;&nbsp; <version>1.0</version>

&nbsp;&nbsp; <!– Imports are required to allow references to definitions in other models –>&nbsp;&nbsp; 
&nbsp;&nbsp; <imports>
&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp; <!– Import Alfresco Dictionary Definitions –>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <import uri="http://www.alfresco.org/model/dictionary/1.0" prefix="d"/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <!– Import Alfresco Content Domain Model Definitions –>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <import uri="http://www.alfresco.org/model/content/1.0" prefix="cm"/>
&nbsp;&nbsp; </imports>

&nbsp;&nbsp; <namespaces>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <namespace uri="http://www.alfresco.org/model/taskList/1.0" prefix="tl"/>
&nbsp;&nbsp; </namespaces>
&nbsp;&nbsp; 
&nbsp;&nbsp; <types>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <type name="tl:taskList">
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <parent>cm:folder</parent>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </type>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <type name="tl:task">
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <parent>cm:folder</parent>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </type>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <type name="tl:comment">
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <parent>cm:content</parent>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </type>
&nbsp;&nbsp;&nbsp; </types>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp; <aspects>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <aspect name="tl:taskListAppendable">
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <associations>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <child-association name="tl:taskListOfContent">
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <source>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <mandatory>false</mandatory>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <many>false</many>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </source>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <target>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <class>tl:taskList</class>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <mandatory>true</mandatory>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <many>false</many>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </target>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <duplicate>false</duplicate>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </child-association>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </associations>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </aspect>
&nbsp;&nbsp; </aspects>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
</model>
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

2) Defined the model in repository/config/alfresco/extension/extension-context.xml:

<value>alfresco/extension/taskListModel.xml</value>
‍‍‍

3) created a class to hold the model definitions (TaskListModel.java):

public class TaskListModel {
&nbsp;&nbsp;&nbsp;//
&nbsp;&nbsp;&nbsp; // Task List Model Definitions
&nbsp;&nbsp;&nbsp; //
&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp; static final String TASKLIST_MODEL_URI = "http://www.alfresco.org/model/taskList/1.0";
&nbsp;&nbsp;&nbsp; static final String TASKLIST_MODEL_PREFIX = "tl";
&nbsp;&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp; static final QName TYPE_TASKLIST = QName.createQName(TASKLIST_MODEL_URI, "taskList");
&nbsp;&nbsp;&nbsp; static final QName TYPE_TASK = QName.createQName(TASKLIST_MODEL_URI, "task");
&nbsp;&nbsp;&nbsp; static final QName TYPE_COMMENT = QName.createQName(TASKLIST_MODEL_URI, "comment");

&nbsp;&nbsp;&nbsp; static final QName ASPECT_TASKLISTAPPENDABLE = QName.createQName(TASKLIST_MODEL_URI, "taskListAppendable");
&nbsp;&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp; static final QName ASSOC_TASKLIST = QName.createQName(TASKLIST_MODEL_URI, "taskListOfContent");
}
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

And then, written the following unit tests. First, creating a task list just under the company home:

public class TaskListTest extends TestCase {
&nbsp;&nbsp;&nbsp;TransactionService transactionService = null;

&nbsp;&nbsp;&nbsp;NodeService nodeService = null;

&nbsp;&nbsp;&nbsp;ContentService contentService = null;

&nbsp;&nbsp;&nbsp;AuthenticationService authenticationService = null;

&nbsp;&nbsp;&nbsp;@Override
&nbsp;&nbsp;&nbsp;protected void setUp() throws Exception {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// initialise app content
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ApplicationContext ctx = ApplicationContextHelper
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.getApplicationContext();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// get registry of services
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ServiceRegistry serviceRegistry = (ServiceRegistry) ctx
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.getBean(ServiceRegistry.SERVICE_REGISTRY);

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// get individual, required services
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;transactionService = serviceRegistry.getTransactionService();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;nodeService = serviceRegistry.getNodeService();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;contentService = serviceRegistry.getContentService();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;authenticationService = serviceRegistry.getAuthenticationService();

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;authenticationService.authenticate("admin", "admin".toCharArray());
&nbsp;&nbsp;&nbsp;}

&nbsp;&nbsp;&nbsp;public void testCanGetCompanyHome() {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NodeRef companyHome = getCompanyHome();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assertTrue(nodeService.exists(companyHome));

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.out.println(NodeStoreInspector.outputNode(0, nodeService,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;companyHome));
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assertEquals("The company root space", nodeService.getProperty(
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;companyHome, ContentModel.PROP_DESCRIPTION));
&nbsp;&nbsp;&nbsp;}

&nbsp;&nbsp;&nbsp;public void testCreateTaskListUnderCompanyHome() {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;TransactionWork<Object> exampleWork = new TransactionWork<Object>() {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;public Object doWork() throws Exception {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NodeRef companyHome = getCompanyHome();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;nodeService.addAspect(companyHome,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;TaskListModel.ASPECT_TASKLISTAPPENDABLE, null);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Map<QName, Serializable> nodeProperties = new HashMap<QName, Serializable>(
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;7);

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// add a sample task list to the company home
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;nodeProperties.clear();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;nodeProperties.put(ContentModel.PROP_NAME, "Sample Task List");
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ChildAssociationRef assocRef = nodeService.createNode(
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;companyHome, TaskListModel.ASSOC_TASKLIST, QName
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.createQName(TaskListModel.TASKLIST_MODEL_URI,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sampleTaskList"),
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;TaskListModel.TYPE_TASKLIST, nodeProperties);

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NodeRef taskListRef = assocRef.getChildRef();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assertEquals("Sample Task List", nodeService.getProperty(
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;taskListRef, ContentModel.PROP_NAME));
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.out.println(NodeStoreInspector.outputNode(0,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;nodeService, companyHome));
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return null;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;};
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;TransactionUtil.executeInUserTransaction(transactionService,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;exampleWork);

&nbsp;&nbsp;&nbsp;}

&nbsp;&nbsp;&nbsp;public void testDeleteTaskListCreatedUnderCompanyHome() {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;TransactionWork<Object> exampleWork = new TransactionWork<Object>() {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;public Object doWork() throws Exception {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NodeRef companyHome = getCompanyHome();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;List<ChildAssociationRef> childRefs = nodeService
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.getChildAssocs(companyHome,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;RegexQNamePattern.MATCH_ALL, QName.createQName(
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;TaskListModel.TASKLIST_MODEL_URI,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sampleTaskList"));

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;for (ChildAssociationRef ref : childRefs) {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NodeRef sampleTaskList = ref.getChildRef();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;nodeService.deleteNode(sampleTaskList);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.out.println("deleted 1 task list");
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.out.println(NodeStoreInspector.outputNode(0,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;nodeService, companyHome));
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return null;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;};
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;TransactionUtil.executeInUserTransaction(transactionService,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;exampleWork);
&nbsp;&nbsp;&nbsp;}

&nbsp;&nbsp;&nbsp;private NodeRef getCompanyHome() {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;StoreRef spacesStoreRef = new StoreRef(StoreRef.PROTOCOL_WORKSPACE,

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"SpacesStore");
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assertTrue(nodeService.exists(spacesStoreRef));

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NodeRef rootNodeRef = nodeService.getRootNode(spacesStoreRef);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;List<ChildAssociationRef> childRefs = nodeService.getChildAssocs(
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rootNodeRef, RegexQNamePattern.MATCH_ALL, QName.createQName(
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NamespaceService.APP_MODEL_1_0_URI, "company_home"));
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ChildAssociationRef companyHomeRef = childRefs.get(0);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NodeRef companyHome = companyHomeRef.getChildRef();
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return companyHome;
&nbsp;&nbsp;&nbsp;}

}
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

The tests run without error. First I can create a task list under company home, and then I can successfully find and delete it. These tests don't assert anything yet, I better test the functionality with asserts, not by writing the whole company home node to the console.

I hope I am doing everything right.

gavinc

The only suggestion I have is to take a look at some of the unit tests in the repository projects. Most of them extend the "org.alfresco.util.BaseAlfrescoSpringTest" class which provides the transaction handling you are doing manually in your tests.

Apart from that its looking good.

turgayz

Thanks, Gavin, the tests look simpler now, after extending BaseAlfrescoSpringTest.

But what will happen when I move this functionality out of the tests to the actual classes? Will I have to start a transaction and end it manually? Or will I use the TransactionUtil.executeInUserTransaction() then?

gavinc

No, you wouldn't use TransactionUtil.executeInUserTransaction() you would use a UserTransaction.

We use the following pattern in the client…

UserTransaction tx = null;
   
try
{
   tx = Repository.getUserTransaction(FacesContext.getCurrentInstance());
   tx.begin();
   ….
   your code
   ….
   tx.commit();
}
catch (Throwable e)
{
   // rollback the transaction
   try { if (tx != null) {tx.rollback();} } catch (Exception ex){}
}         
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Take a look at any of the wizard beans in org.alfresco.web.bean.wizard package. They are all examples of this usage.

turgayz

Hi,
I have posted the files for task lists functionality to JIRA. You can find it here:
http://www.alfresco.org/jira/browse/AWC-500

In the zip file, open the README.txt which describes the modified/added files, and where to put each of them.

The zip file also contains some screenshots.

There are some problems I need help for, I'll post another reply here for them.

Any questions/suggestions are welcome.

turgayz

Hi,
I have added 2 properties to my model:

<type name="tl:task">
         <parent>cm:folder</parent>
         <properties>
            <property name="tl:taskStatus">
               <title>Status</title>
               <type>d:text</type>
               <mandatory>true</mandatory>
            </property>
            <property name="tl:taskPercentCompleted">
               <title>Percent Completed</title>
               <type>d:int</type>
               <mandatory>true</mandatory>
            </property>
         </properties>
         <associations>
            <child-association name="tl:commentOfTask">
               <target>
                  <class>tl:comment</class>
                  <mandatory>false</mandatory>
                  <many>true</many>
               </target>
            </child-association>
         </associations>
      </type>
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

I want to show the properties taskStatus and taskPercentCompleted on the web client, and let the user update them. For this, I have added the following to task.jsp:

<div class="mainSubText"><h:outputText value="#{NavigationBean.nodeProperties.taskStatus}" id="msg5" /></div>
<div class="mainSubText"><h:outputText value="#{NavigationBean.nodeProperties.taskPercentCompleted}" id="msg7" /></div>
‍‍‍‍

There are resolvers for the properties in TaskListBean.java:

   public NodePropertyResolver resolverTaskStatus = new NodePropertyResolver() {
      public Object get(Node node) {
         System.out.println("inside NodePropertyResolver.resolverTaskStatus…");
         System.out.println(NodeStoreInspector.dumpNode(nodeService, node.getNodeRef()));
         QNameNodeMap props = (QNameNodeMap) node.getProperties();
         String taskStatus = (String) props.getRaw("tl:taskStatus");

         if (taskStatus == null || taskStatus.equals(""))
            taskStatus = "NOT STARTED";         

         return taskStatus;
      }
   };
   
   public NodePropertyResolver resolverPercentCompleted = new NodePropertyResolver() {
      public Object get(Node node) {
         System.out.println("inside NodePropertyResolver.resolverPercentCompleted…");
         System.out.println(NodeStoreInspector.dumpNode(nodeService, node.getNodeRef()));
         QNameNodeMap props = (QNameNodeMap) node.getProperties();
         Integer percentCompleted = (Integer) props.getRaw("tl:taskPercentCompleted");

         if (percentCompleted == null)
            percentCompleted = 0;         

         return percentCompleted;
      }
   };
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

The properties don't show up in the jsp page. I must be doing something wrong, what is it? :?

gavinc

The problem is that the task properties are defined in a different namespace.

Using the syntax #{NavigationBean.nodeProperties.taskStatus} makes the presumption that the taskStatus property is in the "cm:" namespace.

You can try the following syntax instead:

#{NavigationBean.nodeProperties["tl:taskStatus"]}‍

Let me know if that helps.

turgayz

Yes, it works perfectly, thank you

Now I need to let the user update those properties.

Updating a property as a text field should not be hard, I can find an example for that. Is there support for selecting a property value from a list box also? For example, I want to let selecting the Status property from a list box, having entries like NOT STARTED, IN PROGRESS, FINISHED, etc. Is there a pointer showing how to do this?

gavinc

It depends on the type you have used for the status property.

If you have used a category to represent the status then you could use the r:categorySelector component, however, currently this will allow you to select any category in the system i.e. you can't limit it to a particular category.

We will be working to improve this in the 1.3 timeframe as well as working on value constraints for properties which will include "list of available values" functionality.

If the status property is just a text field you can just use a normal drop down box represented by the standard JSF h:selectOneMenu component. An example of this is in /projects/web-client/source/web/jsp/wizard/new-rule/details.jsp. The component in this case calls getTypes() in NewRuleWizard to retrieve the values. This method has to return a List of SelectItem objects.

Hope this helps.

turgayz

Hi,
I have added some more functionality:
- The properties "TaskStatus" and "TaskPercentCompleted" are added to Task.
- In the GUI, the above mentioned properties can be updated by editing a task, or when entering a new comment.

New file added to JIRA, and also some screenshots are added.

Things to do:
- Get the list of "task status" definitions from a category definition. Currently, the list is
defined statically in the method NewCommentWizard.getTaskStatusDefinitions(), and also in
NewTaskWizard.getTaskStatusDefinitions().
- Put in some consistency checks for taskPercentCompleted. For example:
- TaskPercentCompleted cannot be changed to some value other than 0, if the TaskStatus is "NOT STARTED".
- TaskPercentCompleted should be 100 if the TaskStatus is changed as "FINISHED"
- Introduce a property "AssignedTo" to Task items.
- Create a page for a user to see "Tasks Assigned To Me". This page can list all the tasks assigned to the
current user which are not finished yet.
- (BUG) When the properties of a Task is updated, or a new comment is added, the "task.jsp" page does not get refreshed.
This causes for the task to show previous values for TaskStatus and TaskPercentCompleted. The change should update the
values for the task.jsp page.
- Make it possible to attach files to Tasks.

http://www.alfresco.org/jira/browse/AWC-500

jdfreier

Hello,
Has anyone updated the task list code to work with the latest code in svn?

Thanks,
Joshua

turgayz

Hello,
Has anyone updated the task list code to work with the latest code in svn?

Thanks,
Joshua

I am afraid I could not find the time to modify the code yet.

I guess that a "Task List Space" is being added to Alfresco for release 1.3. But I don't know about the latest status. There is not much info on JIRA: http://www.alfresco.org/jira/browse/AWC-56