How to Add New Field to Alfresco/Share Form?

Question

Okay, so we know that Alfresco has standard forms that it comes packaged with. For example, the default ad-hoc form is shown below:

enter image description here

Now, if I wanted to customize that form, say add a separate Items field, how exactly would I go about doing that? What I mean is, I want to have one field that displays only the current item. And another field that displays all the related items in that same space. I have the script to display all the items in a space into that singular items field, so I think I should be able to manipulate that, but I need the additional items field first in order to do so.

I've been trying to mess with some of the XML files, and I've managed to get an extra Items label to show up on the form, but not the actual box which can be populated with Add or depopulated with Remove All.

I did this by first modifying /opt/alfresco-4.0.d/tomcat/webapps/share/WEB-INF/classes/alfresco/form-config.xml:

The only real change here being the addition of .

Next, I went into /opt/alfresco-4.0.d/tomcat/webapps/share/WEB-INF/classes/alfresco/share-workflow-form-config.xml, and modified it like so:

And again, here the only real changes were the addition of after any instance of , the addition of after any instance of , and the addition of after any instance of .

But this is the result:

enter image description here

Now, I didn't think it would be THAT easy. However, I've tried some different pairings in the share-workflow-form-config.xml file, but this seems to be the only one that results in at least the visible showing of the extra label Items, albeit without the rest of the components. I was just wondering if anyone had any experience customizing these forms, and/or perhaps knew what I could be doing wrong here?

Teqnology · Accepted Answer

Could you just post some pictures of what are you trying to achieve, maybe with what have you achieved already? Just to make clear. I don't understand why would you add another field "Items" when you have already one there doing it's job. Anyway, the ad-hoc form is part of a workflow, do you want to change a workflow form, or some other thing, like the upload and change properties of a node? these are different things. In both cases, you should work with files like share-workflow-form-config.xml or share-config-custom.xml. Anyway, you can't just add a component like "singlePackageItem" without declaring it somewhere. The id packageItems and the set Items are calling a file named packageItems.ftl that exposes the form that you see. You can find that file in:

/alfresco/tomcat/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/components/form/controls/workflow

with all other ftl files that expose the forms that you see in a workflow. If you want to custom a form, and expose some custom properties or fields you should work with some (workflow) content modeling first, you can find a wiki here: Custom Share Workflow UI

If you can be more specific on what do you want to achieve, just ask, and I can see if I can help you.

Ok, maybe I've misunderstood, but this is my idea. You should have a controller js file with the script, and a template file ftl that exposes these documents in a field. editing* If you use the packageItems form field, you use the form that Alfresco offers as out-of-the-box. You should implement your own freemarker template file, that reads your script and exposes this list and this single file you need. You could start from looking at the code in the default form controls in Share: '/Alfresco/tomcat/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/components/form/controls/' then, you could recall your own ftl form control from the share-workflow-form-config.xml like this:

How to Add New Field to Alfresco/Share Form?

Answers (1)

Related Questions