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

/**
 * Custom content types
 */
function getContentTypes()
{
   // TODO: Data webscript call to return list of available types
   var contentTypes = [
   {
      id: "cm:content",
      value: "cm_content"
   },
   {
      id: "my:customtype",
      value: "my_customtype"
   }
   ];

   return contentTypes;
}

model.contentTypes = getContentTypes();

TODO är Alfresco-utvecklarnas egen, så det kanske kommer ett konfigurationsalternativ senare, men nu är det så här du måste göra.
Du måste också lägga till properties i filen flash-upload.get.properties, och i detta fall även html-upload.get.properties. Har du språkpaket, lägg till även i de properties filerna.
Lägg till värdet för “value” i javascript-koden för var och en av dina anpassade dokumenttyper

my_customtype=Min egen typ

Det fungerar bra, och du får sätta dokumenttyp för varje fil individuellt. Har noterat en bugg, och det är att du får ange dokumenttyp även när du laddar upp ny version, men det ändrar trots det inte dokumenttyp.
Så här kan det se ut.

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: