topic Re: Taggable aspect problem ... and labels definitions in Alfresco Archive

Taggable aspect problem ... and labels definitions

piski — Fri, 07 May 2010 08:29:56 GMT

Hi All,I've a problem to show standard aspect cm:taggable ( Categories are shown instead ?!? ).I've created a custom type within a custom model in which I put my properties (Publication's date, Document's ref …).I apply madatory aspects such as cm:taggable and cm:categories to automatically availabl

Re: Taggable aspect problem ... and labels definitions

mikeh — Fri, 07 May 2010 08:38:37 GMT

Have a look at the "out of the box" form config in share-form-config.xml to see you're missing a couple of settings:

<field id="cm:taggable">
   <control>
      <control-param name="compactMode">true</control-param>
      <control-param name="params">aspect=cm:taggable</control-param>
      <control-param name="createNewItemUri">/api/tag/workspace/SpacesStore</control-param>
      <control-param name="createNewItemIcon">tag</control-param>
   </control>
</field>‍‍‍‍‍‍‍‍

compactMode is optional, as are the createNewItemUri and createNewItemIcon parameters (the last two present the user with the ability to add new tags within the picker).

However, because tags are represented in the Data Dictionary as the same type as categories, the Forms code needs to be told to treat them differently. Therefore, we need to tell the control to query using the cm:taggable aspect.

Thanks,
Mike

Re: Taggable aspect problem ... and labels definitions

piski — Fri, 07 May 2010 09:11:02 GMT

Thank Mike, it works perfectly … I've missed this part !

… but I still have problems with groups labels traductions into Share. Could you please give some support or hints ?

Here is my files :
tomcat\shared\classes\alfresco\extension\MyModel-model-context.xml

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'>
 
<beans>
    <!– Registration of new models –>   
    <bean id="extension.dictionaryBootstrap" parent="dictionaryModelBootstrap" depends-on="dictionaryBootstrap">
        <property name="models">
            <list>
                <value>alfresco/extension/MyModel.xml</value>
            </list>
        </property>
        <property name="labels">
            <list>
                <value>alfresco/extension/MyModel</value>
            </list>
        </property>
    </bean>
</beans>‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

MyModel.properties and MyModel_fr_FR.properties (both are similar except the language) :

my_MyModel.type.my_MyType.title=Document Type
my_MyModel.type.my_MyType.description=Document Type

my_MyModel.property.my_refDoc.title=Référence du document
my_MyModel.property.my_refDoc.description=Permet de numéroter, codifier un document
my_MyModel.property.my_publicationDate.title=Date de publication
my_MyModel.property.my_publicationDate.description=Date de création originelle du document

grouptitre=Document
groupdetails=Détails
groupattributes=Attributs
groupcategories=Categories
grouptags=Mot-Clés‍‍‍‍‍‍‍‍‍‍‍‍‍

Parts within the custom content model are well displayed, but not the groups customisations (by using label-id) defined into share-config-custom.xml.

As I've said before, documentation isn't clear (for me ! for all ?) and I've tried many ways to get it works … without success !

Thanks Mike, your help is very appreciated !

Re: Taggable aspect problem ... and labels definitions

mikeh — Fri, 07 May 2010 09:50:15 GMT

You were correct adding the message bundle to the custom-slingshot-application-context.xml. Make sure the properties file is in the Share webapp's classpath, not the Alfresco one.

Thanks,
Mike

Re: Taggable aspect problem ... and labels definitions

piski — Fri, 07 May 2010 13:44:40 GMT

Thanks for your advices !

I think the mistake was to put my files (label-id for custom model & label-id for set groups défined into shared-config-custom.xml) into tomcat\shared\classes\alfresco\extension and also to modify tomcat\shared\classes\alfresco\web-extension\custom-slingshot-application-context.xml instead of tomcat\webapps\share\WEB-INF\classes\alfresco\web-extension\custom-slingshot-application-context.xml.

So this is the result (it works) :

I've created a file in tomcat\shared\classes\alfresco\extension\MyModel_fr_FR.properties (because I've declared it into my MyModel-model-context.xml) :

# Only elements defined within my custom model
my_MyModel.type.my_MyType.title=Document Type
my_MyModel.type.my_MyType.description=Document Type

my_MyModel.property.my_refDoc.title=Référence du document
my_MyModel.property.my_refDoc.description=Permet de numéroter, codifier un document
my_MyModel.property.my_publicationDate.title=Date de publication
my_MyModel.property.my_publicationDate.description=Date de création originelle du document‍‍‍‍‍‍‍‍

and these files : tomcat\webapps\share\WEB-INF\classes\alfresco\web-extension\custom-slingshot-application-context.xml

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'>

<beans>
   
   <!– Override WebScript Messages - add slingshot application messages –>
   <bean id="webscripts.resources" class="org.springframework.extensions.surf.util.ResourceBundleBootstrapComponent">
      <property name="resourceBundles">
         <list>
            <value>webscripts.messages.webscripts</value>
            <value>alfresco.messages.common</value>
            <value>alfresco.messages.slingshot</value>
            <value>alfresco.messages.dod5015</value>
            <value>alfresco.messages.MyModel</value>
         </list>
      </property>
   </bean>
   
   <bean id="dod5015.custom.config" class="org.springframework.extensions.config.ConfigBootstrap" init-method="register">
      <property name="configService" ref="web.config" />
      <property name="configs">
         <list>
            <value>classpath:alfresco/dod-5015-form-config.xml</value>
         </list>
      </property>
   </bean>
   
</beans>‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

… and tomcat\webapps\share\WEB-INF\classes\alfresco\messages\MyModel_fr_FR.properties

grouptitre=Document
groupdetails=Détails
groupattributes=Attributs
groupcategories=Catégories
grouptags=Mot-Clés‍‍‍‍‍

Is this the best practice to define resource bundles keys, like that ?

Thanks, I'll mark the subject as solved !

Re: Taggable aspect problem ... and labels definitions

mikeh — Fri, 07 May 2010 15:31:28 GMT

You should be able to move the Share extension files out into: tomcat/shared/classes/alfresco/web-extension/ - i.e. outside the webapps folder structure. Are you saying this mechanism isn't working for you?

Thanks,
Mike

Re: Taggable aspect problem ... and labels definitions

piski — Tue, 11 May 2010 15:02:14 GMT

I've made some tests :

In tomcat\shared\classes\alfresco\extension\MyModel-model-context.xml, I've declared the resource bundle to use :

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'>

<beans>
    <!– Registration of new models –>   
    <bean id="extension.dictionaryBootstrap" parent="dictionaryModelBootstrap" depends-on="dictionaryBootstrap">
        <property name="models">
            <list>
                <value>alfresco/extension/MyModel.xml</value>
            </list>
        </property>
        <property name="labels">
            <list>
                <value>alfresco/messages/MyModel</value>
            </list>
        </property>
    </bean>
</beans>‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

If the file MyModel.properties (and MyModel_fr_FR.properties for FR locale) isn't created at location tomcat\shared\classes\alfresco\extension\MyModel.properties, the model bootstrap fails -> NORMAL

I access to Share and when I take a look on Document Details, properties translations are well applied … but groups ("set" tags defined with "bordered-panel" style in share-config-custom.xml) aren't translated. Moreover, types in combo box "Change Type" action and custom aspect in "Add aspect" aren't translated.

If I create a file tomcat\shared\classes\alfresco\web-extension\custom-slingshot-application-context.xml :

   <!– Override WebScript Messages - add slingshot application messages –>
   <bean id="webscripts.resources" class="org.springframework.extensions.surf.util.ResourceBundleBootstrapComponent">
      <property name="resourceBundles">
         <list>
            <value>webscripts.messages.webscripts</value>
            <value>alfresco.messages.common</value>
            <value>alfresco.messages.slingshot</value>
            <value>alfresco.messages.dod5015</value>
            <value>alfresco.messages.lavdocModel</value>
         </list>
      </property>
   </bean>‍‍‍‍‍‍‍‍‍‍‍‍

and I put my file MyModel.properties (and FR file) into tomcat\shared\classes\alfresco\messages OR tomcat\webapps\share\WEB-INF\classes\alfresco\messages, it does'nt work.

… until I define, in WEBINF at location tomcat\webapps\share\WEB-INF\classes\alfresco\web-extension\custom-slingshot-application-context.xml

   <!– Override WebScript Messages - add slingshot application messages –>
   <bean id="webscripts.resources" class="org.springframework.extensions.surf.util.ResourceBundleBootstrapComponent">
      <property name="resourceBundles">
         <list>
            <value>webscripts.messages.webscripts</value>
            <value>alfresco.messages.common</value>
            <value>alfresco.messages.slingshot</value>
            <value>alfresco.messages.dod5015</value>
            <value>alfresco.messages.lavdocModel</value>
         </list>
      </property>
   </bean>‍‍‍‍‍‍‍‍‍‍‍‍

and I put my file MyModel.properties into tomcat\webapps\share\WEB-INF\classes\alfresco

type.my_MyType=Document Type
type.my_MyType2=Document Type 2
aspect.my_MyAspect=My Custom Aspect

grouptitre=Document
groupdetails=Détails
groupattributes=Attributs
groupcategories=Catégories
grouptags=Mot-Clés
groupcontrat=Contrat‍‍‍‍‍‍‍‍‍‍

It works fine except the translation for aspect.my_MyAspect … and I don't know why !

To summarize, I made it work this way :

1) MyModel-model-context.xml -> bean extension.dictionaryBootstrap -> property label -> give the relative path of your resource bundle file (located everywhere you want in tomcat\shared\classes\alfresco, in my case, in ../alfresco/messages)

2) Within file MyModel.xml, I don't define any <title> flags except for types and aspects.

3) In my resource bundle file, which is located into tomcat\shared\classes\alfresco\messages, I add properties respecting naming rules. I'm sure that my file is correct because I see descriptions properties when I edit metadata.

4) In share-config-custom.xml, I define my <set /> flags (and my fields to be grouped) with a label-id.

5) For type and groups translations, I must declared in tomcat\webapps\share\WEB-INF\classes\alfresco\web-extension\custom-slingshot-application-context.xml the relative path to resource bundle, in my case tomcat\webapps\share\WEB-INF\classes\alfresco\messages.

6) I have to put my resource bundle tomcat\webapps\share\WEB-INF\classes\alfresco\messages containing only types and groups translations (aspect translation isn't working because of my syntax, file location ?!?)

I think adding some definitions into WEBINF files is a bad practice, isn't it ? … but I only find this way to translate properly other things than fields properties.

Re: Taggable aspect problem ... and labels definitions

gavinc — Tue, 11 May 2010 15:45:32 GMT

Hi,

In 3.3 we added a Forms Development Kit (http://wiki.alfresco.com/wiki/Forms_Development_Kit) which actually demonstrates pretty much everything it appears you are trying to do, you could therefore use that to validate what you have done i.e. best practices.

Hope that helps!

Re: Taggable aspect problem ... and labels definitions

piski — Wed, 12 May 2010 07:02:16 GMT

Thanks ! I'll take a look on this tool !

Re: Taggable aspect problem ... and labels definitions

d_garry — Fri, 29 Apr 2011 09:27:49 GMT

[someone has deleted my post here.. what have i done wrong supplying my step-by-step solution with examples?]

Re: Taggable aspect problem ... and labels definitions

puccia — Sun, 20 Nov 2011 05:08:09 GMT

Thank you all for this very instructive discussion, and Mike especially for the pointer to the tool.