Control version storage bloat with Javascript?

sarnold — Wed, 26 Oct 2011 03:15:01 GMT

Hi All,We are currently trailing Alfresco Community 4.0a with a view to using it in-house for document storage and management.Firstly, none of this would be needed except that so far as I can see there is no way in Alfresco to limit the number of document versions that can be created.So if I've miss

Re: Control version storage bloat with Javascript?

gyro_gearless — Wed, 26 Oct 2011 08:23:50 GMT

Hi,

just a few thought on this:

Not sure if this can be done in Javascript, but for sure using a Behaviour (in Java).

The identifiers you get are for sure internal Javascript references, you would perhaps use something like "document.getVersion("1.42")"

Creating a new document would surely work, but is rather unelegant: It would break for example all other associations to that document. Maybe you dont use that now, buts its an rather elegant Alfresco feature….

HTH
Gyro

Re: Control version storage bloat with Javascript?

sarnold — Thu, 27 Oct 2011 23:37:23 GMT

Hi Gyro,

Thanks for taking the time to reply!

Creating a new document would surely work, but is rather unelegant: It would break for example all other associations to that document. Maybe you dont use that now, buts its an rather elegant Alfresco feature….

I hear you! The elegant solution would be to delete older versions. But the Javascript API has no call for removal of a document version. At least not yet. There is a request for such a feature in JIRA https://issues.alfresco.com/jira/browse/ALFCOM-2839. But it looks to have been "archived" back in 2009 and so I'm not sure if this is still on anyones to-do list.

I also understand that it can be done in Java. Sadly I've not done any programming in Java before so this will be a bit of a learning curve.

I did try document.getVersion("1.3") in my script and that worked. At least the code line executes without error. But I'm at a complete loss as to how to use it. I thought it would be something like:

var oldver = document.getVersion("1.3");
oldver.copy(space); // <– This does not work!

To get an old copy of the document and make a copy of it into a new document in the current document space. But it doesn't work. The correct syntax eludes me.

What I have managed to cobble together is a small script that sends out a "Nag" e-mail to the person who updates a document which has many revisions and directs the same message to the IT support department. Just in case anyone is following along I'll include it below.

Thanks again for your input.

Cheers Steve.

// Alfresco Server Side Javascript
// Script to send "Nag" emails if a document gains an excessive number of revisions
// One e-mail to the user who updated the document and a copy to the IT Dept
// Script set to run on document updates

var textBuffer = ""

// Test to see if the document in question is versioned. If not then just bail out

if (document.isVersioned) {

   // Grab the total number of revisions held

   NbrOfRevs = document.versionHistory.length;
   
   // Test below triggers on only 3 revisions for testing purposes
   // Set this number to something sensible for your environment

   if (NbrOfRevs > 3) {

      // create mail action
      var mail = actions.create("mail");
      mail.parameters.to = person.properties.email;
      mail.parameters.subject = "Large number of document revisions detected.";
      mail.parameters.from = "alfresco@fake.email.local";
      
      // Uncomment line below if you want to build and use your own
      // template document for the e-mail. I have not played with this yet.
      // With no template e-mail it uses the mail.parameters.text
      // for the message body.

      //mail.parameters.template = root.childByNamePath("Company Home/Data Dictionary/Email Templates/excessive_revisions_email.ftl"); 

      // Get the document name and the name of the submitting user
      var DocuName = document.properties.name;
      var PersonName = person.properties.firstName;

      // Build a text buffer containing the email body message.
      // Then assign this buffer to mail.parameters.text
      // I did try adding text directly to mail.parameters.text with a series of
      // mail.parameters.text += but got very unpredictable results.

      textBuffer = "Dear " + PersonName + "\n\n";
      textBuffer += "Warning! A document you just updated called:- \n\n";
      textBuffer += DocuName + "\n\n";
      textBuffer += "has more than 3 revisions currently stored in the Alfresco system.\n\n";
      textBuffer += "Could you please contact the IT Department for some instructions\n";
      textBuffer += "on how to remove any non essential older revisions of this document.\n\n";
      textBuffer += "Our file storage space is not unlimited.\n\n";
      textBuffer += "Thankyou.\n";

      mail.parameters.text = textBuffer;

      // Execute action against a document
      // This sends an e-mail to the person who did the document update
      mail.execute(document);
      
      // There seems to be no support for Cc: or Bcc: e-mails
      // Nor could I work out how to specifiy multiple To: addresses on the one line.
      // So to send the same message to the IT dept as well
      // we reset the mail.parameters.to and then mail.execute again
   
      mail.parameters.to = "itadmin@fake.email.address"; // Change e-mail address to the address of your support group
      mail.execute(document);

   }

}
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Re: Control version storage bloat with Javascript?

sarnold — Fri, 28 Oct 2011 03:28:35 GMT

Not specifically related to Javascript but thought I'd mention that I have solved my problem of limiting the number of file revisions using an AMP add-on module written by Jared Ottley. You can get it here:-

http://jared.ottleys.net/alfresco/alfresco-max-version-policy

And "yes" it works correctly with Community 4.0.a

topic Re: Control version storage bloat with Javascript? in Alfresco Archive

Control version storage bloat with Javascript?

Re: Control version storage bloat with Javascript?

Re: Control version storage bloat with Javascript?

Re: Control version storage bloat with Javascript?