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

Är det ett hot? Nej, iställer innebär det att kunden får kraft att själva få kunskap och vara innovativa och hitta nya lösningar. I slutändan tror jag att det för mig som konsult innebär ett återkommande engagemang, därför att kunden får kraft att förstå och se möjligheterna. När jag och mina kollegor blir anlitade är det för att det behövs för spetskompetens, inte för att vi skall göra varje liten föränding som kunden omöjligt kan göra själv för att det är för komplicerat när koden är stängd. Vår roll blir också att vara de som samlar kunskapen, vi kan ju inte lära oss varje kunds dagliga verksamhet i detalj, men med förändring och innovation hos kunden kan vi lära oss, och förmedla innovativa idéer. Det gagnar hela communityn av en öppen källkodsprodukt.

Detta är inte möjlig när produkterna är proprietära. Det beror på att licensregler där användarna hindras från att vara innovativa, men även på att det inte är möjligt att ta del av hur produkten fungerar i detalj. Naturligtvis hindrar inget att en kund går exempelvis en sharepoint-kurs, men för att helt förstå en produkt krävs tillgång till källkoden. Proprietära produkter är skapta för produktleverantören och dess partner skall trycka ut innovation till kunden, och att greppet om kunskapen kring produkten skall stanna dä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