Activiti BPM modeller (Källa: http://activiti.org/)

Vi får nog vänta till slutet av året innan vi får se den första releasen av Alfresco med Activiti integrerad, för en Alfresco Enterprise release får vi nog räkna med att det dröjer upp till ett år. Det skall dock bli intressant att följa utvecklingen av Activiti, och det går redan nu att ladda ner och testa Activiti som en fristående produkt. Och är det så att du inte kör Alfresco, men utvecklar andra program och har behov av arbetsflödesstöd, så är tanken med Activiti att du skall kunna integrera och använda den som motor utan att behöva utveckla ditt eget arbetsflödesstöd.

Länkar
Alfresco Creates Activity – blogg av Tom Baeyens
Alfresco launches new Activiti Business Process Management Initiative – blogg av John Newton, CTO Alfresco

Så nu behöver vi bara skapar vår eget filter i switch delen i filter.lib.js så att vi får en url motsvarande documentlibrary?filter=customQuery. Men vi behöver också ett sätt att skicka med våra sökdata, och som tur är finns det redan en parameter färdig för det ändamålet, filterData, som skickas hela vägen av Share till filter.lib.js. Vår sökurl blir då /documentlibrary?filter=customQuery&filterData=/här kommer dina sökparametrar/.

Exempel på kod i att lägga till i filter.lib.js, delar av koden är återanvänd från andra delar av filter.lib.js. Du måste anpassa den här koden till att motsvara dina egna behov och metadata.

         case "customQuery":
             filterQuery = "+PATH:\"" + parsedArgs.rootNode.qnamePath + "//*\"";
             if(args.filterData.length>0)
             {
            	 var strData=decodeURI(args.filterData);
            	 logger.log(strData);
            	 var queryArray=strData.split("|");
            	 for(var i=0;i<queryArray.length;i++)
            	 {
            		var strQuery=queryArray[i];
            		var strQueryArray=strQuery.split("_");
            		logger.log(strQueryArray[0]);
            		logger.log(strQueryArray[1]);
            		switch (strQueryArray[0])
            		{
            		case "ftx":
             			var ftterm=strQueryArray[1];
            			var ftquery=" +(";

            		      var ftterms = ftterm.split(/\s/), i, j, t;

            		      for (i = 0, j = ftterms.length; i < j; i++)
            		      {
            		         t = ftterms[i];
            		         // remove quotes - TODO: add support for quoted terms later
            		         t = t.replace(/\"/g, "");
            		         if (t.length !== 0)
            		         {
            		            switch (t.toLowerCase())
            		            {
            		               case "and":
            		                  if (i < j - 1 && ftterms[i + 1].length !== 0)
            		                  {
            		                     ftquery += "AND ";
            		                  }
            		                  break;

            		               case "or":
            		                  break;

            		               case "not":
            		                  if (i < j - 1 && ftterms[i + 1].length !== 0)
            		                  {
            		                     ftquery += "NOT ";
            		                  }
            		                  break;

            		               default:
            		                  ftquery += "TEXT:\"" + t + "\"" + " ";
            		               		break;

            		            }
            		         }
            		      }
            		      filterQuery += ftquery+") ";

            			break;
            		case "docid":
            			filterQuery += " +@sys\\:node-dbid:"+strQueryArray[1];
            			break;
            		case "contractid":
            			filterQuery += " +@ltx\\:contractid:"+strQueryArray[1];
            			break;
            		case "doctype":
            			filterQuery += " +TYPE:\"{http://www.loftux.se/model}"+strQueryArray[1]+"\"";
            			break;
            		case "file":
            			//we need to search both with and without wildcards. Sometime there is a hit
            			//sometime not if we dont depending on search term. Makes results more predictable
            			filterQuery += " +(@cm\\:name:"+strQueryArray[1] + " OR @cm\\:name:*"+strQueryArray[1]+"*)" ;
            			break;
                    case "tag":
                    	filterQuery += " +PATH:\"/cm:taggable/cm:" + search.ISO9075Encode(strQueryArray[1].toLowerCase()) + "/member\"";
                        break;
                    case "sort":

                    	if(strQueryArray[1]=="editdesc")
                    	{
                    		filterParams.sort = [
                    		{
                    		column: "@{http://www.alfresco.org/model/content/1.0}modified",
                    		ascending: false
                    		}];
                    	}
                    	if(strQueryArray[1]=="editasc")
                    	{
                    		filterParams.sort = [
                    		{
                    		column: "@{http://www.alfresco.org/model/content/1.0}modified",
                    		ascending: true
                    		}];
                    	}

                    	break;
            		}
            	 }

             }
             filterParams.query = filterQuery + filterQueryDefaults;
             filterParams.query += " " + (Filters.TYPE_MAP["documents"]);

Vi kan nu alltså anropa vår sida med (exempel)
/documentlibrary?filter=customQuery&filterData=ftx_test|doctype_contract|sort_editdesc.
Det är alltså inte en generisk lösning, varje parameter motsvarar ett fält på ditt sökformulär. Sökningen ovan skulle söka på fulltext “test” och egna dokumenttypen contract samt sortera descending på senast redigerat datum.

För att det skall visas korrekt i Share Document Library, så måste vi även lägga till vår customQuery i Share. Leta reda på filen
site-webscripts/org/alfresco/components/documentlibrary/filter.get.config.xml och lägg till ett nytt filter.

<filters>
   <filter id="all" label="link.all" />
   <filter id="editingMe" label="link.editingMe" />
   <filter id="editingOthers" label="link.editingOthers" />
   <filter id="recentlyModified" label="link.recentlyModified" />
   <filter id="recentlyAdded" label="link.recentlyAdded" />
   <filter id="favouriteDocuments" label="link.favouriteDocuments" />
   <filter id="customQuery" label="link.customQuery" />
</filters>

Vårt filter skall ju anropas via en särskild söksida, så det skall inte dyka upp som en klickbar länk. Det kan vi enkelt göra genom att göra label ovan blank i filen filter.get.properties (i samma katalog som filen ovan)
link.customQuery=
Även i filen toolbar.get.properties får vi lägga till för att resultatlistan skall se bra ut.
description.customQuery=Custom Search
description.customQuery.more=
Om du har lagt på svenska eller annat språk, lägg till även i properties filerna för de språken.

Nu har du bara kvar att skapa sökformuläret. Det kan du göra i en Dashlet, eller med en egen anpassad sida. Jag kommer inte beskriva hur i detta inlägg, kommer eventullt i en uppföljning.

Notera också att Alfresco håller på med motsvarande funktionalitet för Share i version 3.3. Det kommer bli för snabbsök, där du kan skicka med parametrar för att söka specifika metadata genom att i snabbsök skriva till exempel description:important och som skapar en url /share/page/search?t=description:important. Men vad jag förstår kommer det bara vara via snabbsök och därmed bara för avancerade användare. Ett alternativ kan vara att invänta den funktionaliteten, och sedan skriva din egna avancerade söksida som anropar den nya url:en.

<config evaluator="aspect" condition="my:customaspect">
	<forms>
		<form>
			<appearance>
				<field id="my:customtextfield" set="mycustomset" mandatory="true">
					<control template="/org/alfresco/components/form/controls/autocomplete.ftl">
						<control-param name="ds">/share/service/ds/autocomplete/alfrescoperson />
					</control>
				</field>
			</appearance>
		</form>
	</forms>
</config>

Nu har du utseendet fastslaget, så då behöver du bara i din forms definition lägga till

>
<config evaluator="node-type" condition="my:customtype">
	<forms>
		<form>
			<field-visibility>
				<show id="sys:node-dbid" />
				<show id="my:customaspect" />
				...

så kommer din aspect att visas om och när den är tillagd till din dokumenttyp. Du skall alltså inte lägga till appearence i node-type evaluator, det skall du däremot göra för properties som är specifika för dokumenttypen. Som ni kan se så tillhör även aspect-en ovan ett custom set (mycustomset). Tilldelningen gör du under aspect-evaluatorn. Det du måste göra för varje dokumenttyp är att skapa ett appearance som motsvara det appearance du tilldelat.

<set id="mycustomset" appearance="bordered-panel" label="Company Inc. - My Custom Type" />

Utnyttja label till att tydligt visa vilket dokumenttyp ditt dokument är (My Custom Type i detta fall).
Som du kan se ovan så har jag lagt till sys:node-dbid, det är det interna löpnumret som Alfresco tilldelar ett dokument, och som fungerar utmärkt som ett dokument-id. Det som behövs är en bättre label en default. Det kan du få genom att lägga till för node-type evaluatorn för din anpassade dokumenttyp

<appearance>
       <field id="sys:node-dbid" read-only="true" set="mycustomset" label="Dokumentnummer" />

Formulärmotorn använder sig av datamodellens message resource bundle för att veta vilka etiketter den skall sätta på respektive metadata. Var nogrann med att skapa den tillsammans med din modellfil om du vill använda flera språk. Det skall även gå att skapa Resource bundles for själva formulärmotorn så att du inte behöver hårdkoda till exempel “Dokumentnummer” som jag gjort ovan. Jag har dock inte lyckats list ut var den skall ligga än, så får återkomma till det.
Slutresultatet kan se ut så här:

Jag lägger gärna upp fler, lämna dina tips som en kommentar

Ta del av inbjudan här

För Alfresco version 3.0 hittar du information på
http://wiki.alfresco.com/wiki/Category:3.0
Alla designdokument och kravdokument
http://www.slideshare.net/tag/alfresco
Sammanställning på hur gränssnittet kan komma att se ut.
http://issues.alfresco.com/browse/SLNG
Issue tracker som även används för att registrera krav på funktioner

Det du kan se är ett exempel på hur Microsoft bygger ut och förändrar standarder för eget ändamål utan att publicera dessa förändringar. Visst kan Microsoft var i sin fulla rätt att skapa program som bara fungerar med en WebDAV implementation i deras egen produkt Sharepoint. Se här vad Alfresco kom fram till när de undersökte Microsoft Sharepoint WebDAV implementation. Men med den marknadsdominansen som Microsoft har är det rimligt att ställa kravet att följa standards, eller att åtminstonde publicera de förändringar/tillägg som de gör till existerande standards. Detta för att undvika inlåsning. Jag väntar med spänning på vad Microsofts nya grepp kring interopabilitet och att publicera dokumention innebär, tag gärna del av kommentarerna på Groklaw. Det skall tilläggas att övriga Microsoft Office applikationer fungerar med Alfresco WebDAV.

Läst hela disskussionstråden från Alfrescos forum här:
Prototype: Alfresco Web Scripts + extjs ajax lib