Funktionalitet

• All standardfunktionalitet i CKEditor.
• Anpassade konfigurationsfiler
• Infoga bildfiler direkt från Alfresco Share webbplats.

För formulär i Alfresco är det enkelt att skapa nya kontroller. I detta fall så anger du bara att du vill använda den nya kontrollen enligt

<appearance>
   <field id="cm:content">
      <control template="/org/alfresco/components/form/controls/ckeditor.ftl">
         <control-param name="forceEditor">true</control-param>
      </control>
   </field>
</appearance>

Själva kontrollen inklusive källkod ladda ner från Share Extras projektet. Mer om hur du konfigurerar formulär på Alfresco Wiki
För att installera, kopiera filen ckeditor-form-control-0.1.jar till tomcat/webapps/share/WEB-INF/lib. Sedan ändrar du dina formulärdefinitioner enligt ovan eller kopierar filen ckeditor-config-custom.xml (ta bort filändelsen sample) till tomcat/shared/classes/alfresco/web-extension och startar om.

Vill du använda en anpassad konfigurationsfil för att ange vilka knappar som visas och styra utseende så kan du ange vilken med

<control-param name="settingsfile">components/editors/ckeditor/my-config.js</control-param>

Sökvägen skall vara utan inledande / och sedan till den plats där du placerat filen. Om du skapar en bra config fil så inkluderar jag den gärna om du skickar den till mig. Kommer framöver lägga till några alternativa konfigurationsfiler.

För att bläddra efter bilder så klickar du bara ”bläddra på server” så listas miniatyrbilder. Jag baserade den på Image dashleten som finns i Share, så naturligtvis kan du klicka på bilden och få en full förhandsgrandskning. Välj en bild genom att klicka namnet.

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