Override client side JS

As we transition to the new Hyland Community, some post links may be temporarily disrupted as we finalize redirects. We apologize for the inconvenience and are working to resolve this as quickly as possible. Details.

binary_101

How can I override e.g.

{share.war}/components/documentlibrary/documentlist-view-detailed.js‍‍

in SDK 3.0 (alfresco-share-jar-archetype)?

I tried:

1. putting my custom documentlist-view-detailed.js‍‍ into src/main/assembly/web/components/documentlibrary/ with the default file-mappings.properties (already maps /web=/)
2. put my custom documentlist-view-detailed.js‍‍ into src/main/resources/META-INF/resources/components/documentlibrary/

Nothing works ... it ends up in {custom.amp}/web/components/documentlibrary/ but running the maven project does not load it, alfresco ignores it.

afaust

You shouldn't actually try to override the file - Share supports loading multiple views and you could simply load a custom client side JavaScript file as a separate view mode using clean extension points, without overriding that file.

On the nature of "why this doesn't work with SDK 3.0" though I don't know - I neither use SDK 3.0 nor ever try to override any of the default files. One thing to note though is that when you are using the JAR archetype you should - by default - be producing a JAR artifact. JAR artifacts are not installed into the Share WAR like AMPs are - the file-mapping.properties does not have any effect for them. For JARs, the only way to "override" (not really an override, simply just a trickery played by (potentially unreliable) classpath load order precedence) is by packaging the resource inside the the JAR via src/main/resources. One potential issue I could imagine only affects production use cases, especially if you do not include a minified version of the file - in that case, the minified version of the original WAR would take precedence and your "override" would be ignored.