Alfresco formulär för Share

Alfresco Share har nu stöd för att lägga till presentationen av anpassade metadata via en formulär motor. Och det har jag nu haft anledning att testa fullt ut i en kundimplementation. Här är några saker som jag noterat (exemplen förutsätter viss kännedom om Alfresco konfiguration sedan tidigare).

Börja med att läsa igenom Alfresco’s dokumentation för formulär. Där hittar du det mesta om hur du konfigurerar formulär, och länkar vidare till exempel på anpassningar. Mina anpassade formulär har jag lagt i share-config-custom.xml, som du sedan lägger i web-extension katalogen. En sak som inte framgår i Wiki-dokumentationen är hur du lägger in konfigurationen för aspects. Lägg till den i en egen aspect evaluator

<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: