how to use AlfDocumentList.js

[boneill]

Hi Guys,

I have been trying to get my head around the new share customisation framework using dojo modules.

Included in framework are a number of widgets for Document Library display.  I cannot find any documentation or examples on how to include a AlfDocumentList widget on a new page.  I have read all of david drapers blogs on the new framewok but there is nothing I can find on how to get this up and running.  Having read the js files and tried to add the widget to a page I am stuck.  If anyone has any idea on how to work with the document library widgets and perhaps an example that would be fantastic.  Thanks in advance.

my widget include so far:

model.jsonModel = {
   widgets: [
   {
         name: "alfresco/documentlibrary/AlfDocumentList",
         config:{label:"List", viewMap:[{name: "alfresco/documentlibrary/views/AlfSimpleView"}],
            widgets:[{name: "alfresco/documentlibrary/views/AlfSimpleView"}]
            }
   }

   ]
};
‍‍‍‍‍‍‍‍‍‍‍‍‍

Brian

[ddraper]

Hi,

There are a large number of widgets that have been added into the Alfresco Community source that are in varying stages of completion. The general rule of thumb should be that if they are used by default in 4.2 then they're "safe" to be used, but if not then they should be considered "beta" and as such functions, variable names, capabilities are subject to change and there is also no guarantee that the widgets are even completely functional. We were working on a new version of the Document Library for 4.2 but made a decision based around available time and resources required to achieve feature parity with the existing YUI2 based Document Library and decided that we would postpone the work for a future release. However, the widgets have been left in the source to give an indication of the direction in which we're heading. I would certainly not recommend using any of these widgets in production systems and I'm very deliberately *not* going to be answering specific questions on how you can use them (since there is a high probability that the information will become out-of-date almost immediately).

I will be demonstrating some of these widgets in action at Summit next month with a detailed explanation of what we're up to and what can be expected in the future. If you're not going to Summit then I'm reasonably confident that videos of the sessions will appear online at some point in the future (although I can't say when)

Regards,
Dave

[boneill]

Hi David,

I appreciate your response and candour.  At least I now know what to expect and what to avoid.  I have to say I like the direction the new framework is going and in an attempt to be more productive in front end development for Alfresco will try to persevere with creating custom widgets that match what I am trying to achieve.  One suggestion I would like to make is that you keep up the blog series on this.  An example of how to use each widget in context of its use case (working on a share page perhaps) would really help in getting everyone up and running.

Regards

Brian

[ddraper]

Hi Brian,

Thanks for the feedback - it's much appreciated. I would like to spend more time on the blog posts but I just don't have enough time unfortunately! Hopefully once Summit is out of the way I'll get some more time to write in detail on some of the specific things that we're doing and provide examples of how to use them.

Regards,
Dave