]> CyberLeo.Net >> Repos - Github/sugarcrm.git/blob - modules/Emails/javascript/EmailUICompose.js
Release 6.2.3
[Github/sugarcrm.git] / modules / Emails / javascript / EmailUICompose.js
1 /*********************************************************************************
2  * SugarCRM Community Edition is a customer relationship management program developed by
3  * SugarCRM, Inc. Copyright (C) 2004-2011 SugarCRM Inc.
4  * 
5  * This program is free software; you can redistribute it and/or modify it under
6  * the terms of the GNU Affero General Public License version 3 as published by the
7  * Free Software Foundation with the addition of the following permission added
8  * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
9  * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
10  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
11  * 
12  * This program is distributed in the hope that it will be useful, but WITHOUT
13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14  * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
15  * details.
16  * 
17  * You should have received a copy of the GNU Affero General Public License along with
18  * this program; if not, see http://www.gnu.org/licenses or write to the Free
19  * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
20  * 02110-1301 USA.
21  * 
22  * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
23  * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
24  * 
25  * The interactive user interfaces in modified source and object code versions
26  * of this program must display Appropriate Legal Notices, as required under
27  * Section 5 of the GNU Affero General Public License version 3.
28  * 
29  * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
30  * these Appropriate Legal Notices must retain the display of the "Powered by
31  * SugarCRM" logo. If the display of the logo is not reasonably feasible for
32  * technical reasons, the Appropriate Legal Notices must display the words
33  * "Powered by SugarCRM".
34  ********************************************************************************/
35
36  (function() {
37         var sw = YAHOO.SUGAR,
38                 Event = YAHOO.util.Event,
39                 Connect = YAHOO.util.Connect,
40             Dom = YAHOO.util.Dom
41             SE = SUGAR.email2;
42
43 ///////////////////////////////////////////////////////////////////////////////
44 ////    ADDRESS BOOK
45 SE.addressBook = {
46     _contactCache : new Array(), // cache of contacts
47     _dd : new Array(), // filtered list, same format as _contactCache
48     _ddLists : new Array(), // list of Lists
49     _dd_mlUsed : new Array(), // contacts in mailing list edit view column1
50     _dd_mlAvailable : new Array(), // contacts in mailing list edit view column2
51     clickBubble : true, // hack to get around onclick event bubbling
52         relatedBeanId : '',
53         relatedBeanType : '',
54         idx : 0,
55
56     itemSpacing : 'white-space:nowrap; padding:2px;',
57     reGUID : SE.reGUID,
58
59
60
61     /**
62     *  YUI bug fix 2527707.  Causes nested datatable's in <tables> to cause 404 errors whens earching.
63     */
64     initFixForDatatableSort: function () {
65         //Workaround for YUI bug 2527707: http://yuilibrary.com/projects/yui2/ticket/913efafad48ce433199f3e72e4847b18, should be removed when YUI 2.8+ is used
66         YAHOO.widget.DataTable.prototype.getColumn = function(column) {
67             var oColumn = this._oColumnSet.getColumn(column);
68
69             if(!oColumn) {
70                 // Validate TD element
71                 var elCell = column.nodeName.toLowerCase() != "th" ? this.getTdEl(column) : false;
72                 if(elCell) {
73                     oColumn = this._oColumnSet.getColumn(elCell.cellIndex);
74                 }
75                 // Validate TH element
76                 else {
77                     elCell = this.getThEl(column);
78                     if(elCell) {
79                         // Find by TH el ID
80                         var allColumns = this._oColumnSet.flat;
81                         for(var i=0, len=allColumns.length; i<len; i++) {
82                             if(allColumns[i].getThEl().id === elCell.id) {
83                                 oColumn = allColumns[i];
84                             }
85                         }
86                     }
87                 }
88             }
89
90             return oColumn;
91         };
92     },
93
94     cancelEdit : function() {
95         if(this.editContactDialog)
96             this.editContactDialog.hide();
97         if(this.editMailingListDialog)
98             this.editMailingListDialog.hide();
99     },
100
101     /**
102      * Clears filter form
103      */
104     clear : function() {
105         var t = document.getElementById('contactsFilter');
106         t.value = '';
107         this.filter(t);
108     },
109
110     /**
111      * handle context-menu Compose-to call
112      * @param string type 'contacts' or 'lists'
113      */
114     composeTo : function(type, waited) {
115         var activePanel = SUGAR.email2.innerLayout.get("activeTab").get("id")
116         if (activePanel.substring(0, 10) != "composeTab") {
117             SE.composeLayout.c0_composeNewEmail();
118             setTimeout("SE.addressBook.composeTo('" + type + "', true);");
119                 SE.contextMenus.contactsContextMenu.hide();
120             return;
121         }
122         var idx = activePanel.substring(10);
123         var rows = [ ];
124         var id = '';
125         // determine if we have a selection to work with
126         if(type == 'contacts') {
127             var ids = SE.contactView.getSelectedRows();
128             for (var i in ids) {
129                 rows[i] = SE.contactView.getRecord(ids[i]);
130             }
131             removeHiddenNodes(rows, SE.contactView);
132         }
133                 else { return; }
134
135         if(rows.length > 0) {
136             SE.composeLayout.handleDrop(
137                 (type == 'contacts') ? SE.contactView : SE.emailListsView,
138                 null, rows, 'addressTO' + idx );
139         } else {
140             alert(app_strings.LBL_EMAIL_MENU_MAKE_SELECTION);
141         }
142     },
143
144     editContact : function() {
145         SE.contextMenus.contactsContextMenu.hide();
146         var element = SE.contactView.getSelectedNodes()[0];
147         var elementId = "";
148         if (element.className.indexOf('address-contact') > -1) {
149             elementId = element.id;
150         } else if (element.className.indexOf('address-exp-contact') > -1) {
151             elementId = element.id.substring(2);
152         }
153     },
154
155
156     /**
157      * Filters contact entries based on user input
158      */
159     filter : function(inputEl) {
160         var ret = new Object();
161         var re = new RegExp(inputEl.value, "gi");
162
163         for(var i in this._contactCache) {
164             if(this._contactCache[i].name.match(re)) {
165                 ret[i] = this._contactCache[i];
166             }
167         }
168
169         this.buildContactList(ret);
170     },
171
172     fullForm : function(id, module) {
173         document.location = "index.php?return_module=Emails&return_action=index&module=" + module + "&action=EditView&record=" + id;
174     },
175
176     /**
177      * returns a formatted email address from the addressBook cache
178      */
179     getFormattedAddress : function(id) {
180         var o = this._contactCache[id];
181         var primaryEmail = '';
182
183         for(var i=0; i<o.email.length; i++) {
184             var currentEmail = o.email[i].email_address;
185
186             if(o.email[i].primary_address == 1) {
187                 primaryEmail = o.email[i].email_address;
188             }
189         }
190
191         var finalEmail = (primaryEmail == "") ? currentEmail : primaryEmail;
192         var name = new String(o.name);
193         var finalName = name.replace(/(<([^>]+)>)/ig, "").replace(/&#039;/gi,'\'');
194         var ret = finalName + " <" + finalEmail.replace(/&#039;/gi,'\'') + ">";
195
196         return ret;
197     },
198
199     /**
200      * Sets up async call to query for matching contacts, users, etc.
201      */
202     searchContacts : function() {
203         var fn = document.getElementById('input_searchField').value;
204         var pe = document.getElementById('input_searchPerson').value;
205
206         var rb = document.getElementById('hasRelatedBean').checked;
207         if (rb) {
208                         var idx = this.idx;
209                 var relatedBeanId = document.getElementById('data_parent_id' + idx).value;
210                 var relatedBeanType = document.getElementById('data_parent_type' + idx).value;
211                 this.addressBookDataModel.params['related_bean_id'] = relatedBeanId;
212                 this.addressBookDataModel.params['related_bean_type'] = relatedBeanType;
213         } else {
214                 this.addressBookDataModel.params['related_bean_id'] = '';
215         }
216
217         this.addressBookDataModel.params['search_field'] = fn;
218         this.addressBookDataModel.params['person'] = pe;
219         this.addressBookDataModel.params['emailUIAction'] = 'getAddressSearchResults';
220         this.grid._oDataSource = this.addressBookDataModel;
221         this.grid.getDataSource().sendRequest(SUGAR.util.paramsToUrl(this.addressBookDataModel.params),  this.grid.onDataReturnInitializeTable, this.grid);
222     },
223
224     /**
225      * Clear Search Crieteria For Addressbook
226      */
227     clearAddressBookSearch : function() {
228         document.getElementById('input_searchField').value = "";
229         document.getElementById('input_searchPerson').selectedIndex = 0;
230     },
231
232     /**
233      * Opens modal select window to add contacts to addressbook
234      */
235     selectContactsDialogue : function(destId) {
236         if(!this.contactsDialogue) {
237                 var dlg = this.contactsDialogue = new YAHOO.widget.Dialog("contactsDialogue", {
238                 modal:true,
239                 visible:false,
240                 draggable: false,
241                 constraintoviewport: true,
242                 width   : 980,
243                 buttons : [{text: app_strings.LBL_EMAIL_ADDRESS_BOOK_ADD, isDefault: true, handler: this.populateEmailAddressFieldsFromResultTable},
244                            {text: app_strings.LBL_EMAIL_ADDRESS_BOOK_CLEAR, isDefault: true, handler: this.clearAllEmailAddressFieldsFromResultTable} ]
245             });
246                 dlg.setHeader(app_strings.LBL_EMAIL_ADDRESS_BOOK_SELECT_TITLE);
247
248                 var body = SUGAR.util.getAndRemove("contactsDialogueHTML");
249                 dlg.setBody(body.innerHTML);
250                 dlg.renderEvent.subscribe(function() {
251                 var iev = YAHOO.util.Dom.get("contactsDialogueBody");
252                 if (iev && !SUGAR.isIE) {
253                         this.body.style.width = "950px";
254                 }
255             }, dlg);
256
257
258                 dlg.beforeRenderEvent.subscribe(function() {
259                         var dd = new YAHOO.util.DDProxy(dlg.element);
260                         dd.setHandleElId(dlg.header);
261                         dd.on('endDragEvent', function() {
262                                 dlg.show();
263                         });
264                 }, dlg, true);
265                 dlg.render();
266
267                 var tp = new YAHOO.widget.TabView("contactsSearchTabs");
268
269                 var tabContent = SUGAR.util.getAndRemove("searchForm");
270                 tp.addTab(new YAHOO.widget.Tab({
271                                 label: app_strings.LBL_EMAIL_ADDRESS_BOOK_TITLE,
272                                 scroll : true,
273                                 content : tabContent.innerHTML,
274                                 id : "addressSearchTab",
275                                 active : true
276                         }));
277
278                 var addListenerFields = ['input_searchPerson','input_searchField' ]
279                 YAHOO.util.Event.addListener(addListenerFields,"keydown", function(e){
280                         if (e.keyCode == 13) {
281                                 YAHOO.util.Event.stopEvent(e);
282                                 SUGAR.email2.addressBook.searchContacts();
283                         }
284                 });
285
286                 this.contactsDialogue.render();
287                 dlg.center();
288         }
289         //Quick Compose does not have an innerLayout component and will always be referenced with ix 0.
290         if (typeof(SUGAR.email2.innerLayout) == 'undefined')
291             var idx = 0;
292         else
293         {
294             var activePanel = SUGAR.email2.innerLayout.get("activeTab").get("id");
295             var idx = activePanel.substring(10);
296         }
297         SE.addressBook.idx = idx;
298
299                 var relatedBeanId;
300         if ((hasRelatedBeanId = document.getElementById('data_parent_id' + idx).value) != '') {
301                 document.getElementById('relatedBeanColumn').style.display = '';
302                 var relatedBeanName = document.getElementById('data_parent_name' + idx).value;
303                         var relatedBeanType = document.getElementById('data_parent_type' + idx).value;
304                         relatedBeanId = document.getElementById('data_parent_id' + idx).value;
305                         document.getElementById('relatedBeanInfo').innerHTML = ' ' + relatedBeanType + ' <b>' + relatedBeanName + '</b>';
306                         SE.addressBook.relatedBeanType = relatedBeanType;
307             } else {
308                 document.getElementById('relatedBeanColumn').style.display = 'none';
309                 document.getElementById('hasRelatedBean').checked = false;
310             }
311
312             if (!SE.addressBook.grid)
313             {
314                 if (hasRelatedBeanId) {
315                         document.getElementById('hasRelatedBean').checked = true;
316                 }
317                 AddressSearchGridInit();
318                         SE.addressBook.relatedBeanId = relatedBeanId;
319             }
320             else
321             {
322                 if (typeof(relatedBeanId) != 'undefined' && relatedBeanId != SE.addressBook.relatedBeanId)
323                 {
324                         SE.addressBook.relatedBeanId = relatedBeanId;
325                         document.getElementById('hasRelatedBean').checked = true;
326                 }
327                 if (document.getElementById('hasRelatedBean').checked == true)
328                 {
329                         SE.addressBook.addressBookDataModel.params['related_bean_id'] = relatedBeanId;
330                         SE.addressBook.addressBookDataModel.params['related_bean_type'] = relatedBeanType;
331                 } else {
332                         SE.addressBook.addressBookDataModel.params['related_bean_id'] = '';
333                         SE.addressBook.addressBookDataModel.params['related_bean_type'] = '';
334                 }
335                 SE.addressBook.addressBookDataModel.params['search_field'] = document.getElementById('input_searchField').value;;
336                         SE.addressBook.addressBookDataModel.params['person'] = document.getElementById('input_searchPerson').value;
337                 SE.addressBook.grid.getDataSource().sendRequest(SUGAR.util.paramsToUrl(SE.addressBook.addressBookDataModel.params),  SE.addressBook.grid.onDataReturnInitializeTable, SE.addressBook.grid);
338             }
339
340             //Remove any lingering rows in the result set table if the module was closed.
341             SE.addressBook.gridResults.deleteRows(0, SUGAR.email2.addressBook.gridResults.getRecordSet().getLength());
342             //Repopulate
343             SE.addressBook.populateResulstTableEmailAddresses();
344
345         this.contactsDialogue.show();
346     },
347     /**
348     *  Clear all email addresses from result table.
349     *
350     */
351     clearAllEmailAddressFieldsFromResultTable: function () {
352         SUGAR.email2.addressBook.gridResults.deleteRows(0, SUGAR.email2.addressBook.gridResults.getRecordSet().getLength());
353         //Unhighlight any rows currently selected if the emails were cleared.
354         SUGAR.email2.addressBook.grid.toggleSelectAll(false);
355         SUGAR.email2.addressBook.grid.reSelectRowsOnRender();
356     },
357     /**
358     *  Take all email address listed in the compose tab To|Cc|Bcc fields and re-populates the
359     *  results table.  This function is called when the address book is displayed.
360     */
361     populateResulstTableEmailAddresses: function () {
362
363         var idx = SE.addressBook.idx;
364         var emailFields = ['to','cc','bcc'];
365
366         for(var k=0;k<emailFields.length;k++)
367         {
368             var elKey = 'address' + emailFields[k].toUpperCase() + idx;
369             var allEmails = document.getElementById(elKey).value;
370             if(allEmails == '')
371                 continue;
372
373             var formatedEmails = SE.composeLayout._getEmailArrayFromString(allEmails);
374
375                 for (var i=0; i<formatedEmails.length; i++)
376                 {
377                     var t_name = formatedEmails[i].name;
378                     var t_emailAddr = formatedEmails[i].email_address;
379                     var displayEmail = t_name + ' <' + t_emailAddr + '>';
380                     if(t_name == '')
381                         t_name = displayEmail = t_emailAddr;
382
383                     var addressType = SE.addressBook.translateAddresType(emailFields[k],true);
384                 SUGAR.email2.addressBook.gridResults.addRow({'type':addressType,'name':t_name,'email_address': t_emailAddr,
385                     'display_email_address': displayEmail,'bean_id': -1,'idx' : SE.addressBook.idx});
386                 }
387         }
388     },
389
390     /**
391     * Checks all entries in the result table against a particular email address, returning true
392     * if the email address is found, false otherwise.
393     */
394     doesEmailAdddressExistInResultTable: function(emailAddress)
395     {
396         if(trim(emailAddress) == '')
397             return false;
398
399         var emailAddressFound = false;
400         var contacts = SE.addressBook.gridResults.getRecordSet().getRecords();
401         for (var i=0; i < contacts.length; i++)
402         {
403             var data = SE.addressBook.gridResults.getRecord(contacts[i]).getData();
404             //If we are adding to cc or bcc fields, make them visible.
405             if(data.email_address == emailAddress)
406             {
407                 emailAddressFound = true;
408                 break;
409             }
410         }
411
412         return emailAddressFound;
413     },
414     /**
415     *  Takes all email addresses that the users wishes to add from the address book and populates the To
416     *  fields on the compose tab.
417     */
418     populateEmailAddressFieldsFromResultTable: function()
419     {
420         //Clear the fields first, all email addresses are stored in the address book
421         var idx = SE.addressBook.idx;
422         var emailFields = ['to','cc','bcc'];
423         for(var k=0;k<emailFields.length;k++)
424         {
425             var elKey = 'address' + emailFields[k].toUpperCase() + idx;
426             document.getElementById(elKey).value = "";
427         }
428
429         var contacts = SE.addressBook.gridResults.getRecordSet().getRecords();
430         for (var i=0; i < contacts.length; i++)
431         {
432             var data = SE.addressBook.gridResults.getRecord(contacts[i]).getData();
433
434             var addressTypeKey = SE.addressBook.translateAddresType(data.type,false);
435             //If we are adding to cc or bcc fields, make them visible.
436             if(addressTypeKey =='cc' || addressTypeKey =='bcc')
437                 SE.composeLayout.showHiddenAddress(addressTypeKey,data.idx);
438             //Construct the target id
439             var target_id = 'address' + addressTypeKey.toUpperCase() + data.idx
440
441             var target = document.getElementById(target_id);
442             target.value = SE.addressBook.smartAddEmailAddressToComposeField(target.value, data.display_email_address);
443         }
444
445         //Delete all rows from the result set table
446         SUGAR.email2.addressBook.gridResults.deleteRows(0, SUGAR.email2.addressBook.gridResults.getRecordSet().getLength());
447
448         //Hide the dialogue
449         SE.addressBook.contactsDialogue.hide()
450     },
451     /**
452     *  Insert contacts into the result table.
453     */
454     insertContactToResultTable : function(event,address_type) {
455
456         var contactsDialogue = SE.addressBook.contactsDialogue;
457         var contacts = SE.addressBook.grid.getSelectedRows();
458
459         var rows = SUGAR.email2.addressBook.grid.getRecordSet().getRecords();
460         for (var i = 0; i < rows.length; i++)
461         {
462                         if (typeof(rows[i]) != "undefined" && rows[i].getData().checked )
463                         {
464                             var recId = SE.addressBook.grid.getRecord(rows[i]).getId();
465                 SE.addressBook.insertContactRowToResultTable(recId,address_type);
466                 SUGAR.email2.addressBook.grid.selectRow(rows[i]);
467                 rows[i].setData("selected",true);
468                         }
469         }
470         var checkBoxes = SUGAR.email2.addressBook.grid.get("element").getElementsByTagName('input');
471         for (var i = 0; i < checkBoxes.length; i++) {
472             checkBoxes[i].checked = false;
473         }
474     },
475     /**
476     *
477     */
478     insertContactRowToResultTable : function(rowId, addressType) {
479         var data = SE.addressBook.grid.getRecord(rowId).getData();
480         if(SE.addressBook.doesGridResultsEntryExist(data.email) )
481                 return;
482         var name = data.name.replace(/&#039;/gi,'\'').replace(/&quot;/gi,'"');
483         var ea = name + ' <' + data.email.replace(/&#039;/gi,'\'') + '>';
484         if(addressType == null)
485             addressType = app_strings.LBL_EMAIL_ADDRESS_BOOK_ADD_TO.replace(/:$/,''); //Default to To when using the plus icon.
486         SUGAR.email2.addressBook.gridResults.addRow({'type':addressType,'name':name,'email_address': data.email,'display_email_address': ea,'bean_id': data.bean_id,'idx' : SE.addressBook.idx});
487     },
488     /**
489     * Remove a row from the gridsResult table.
490     */
491     removeRowFromGridResults : function(rowId,emailAddress)
492     {
493         var contacts = SE.addressBook.gridResults.getRecordSet().getRecords();
494         for (var i=0; i < contacts.length; i++)
495         {
496             var rec = SE.addressBook.gridResults.getRecord(contacts[i]);
497             var data = rec.getData();
498             if(data.email_address == emailAddress)
499             {
500                 SUGAR.email2.addressBook.gridResults.deleteRow(rec.getId());
501                 break;
502             }
503         }
504
505        SUGAR.email2.addressBook.toggleSearchRowIcon(rowId,true);
506     },
507     /**
508     * Translates between the addressType To|Cc|Bcc labels/keys.
509     */
510     translateAddresType: function(addressType,fromKey)
511     {
512         var displayTo = app_strings.LBL_EMAIL_ADDRESS_BOOK_ADD_TO.replace(/:$/,'');
513         var displayCc = app_strings.LBL_EMAIL_ADDRESS_BOOK_ADD_CC.replace(/:$/,'');
514         var displayBcc = app_strings.LBL_EMAIL_ADDRESS_BOOK_ADD_BCC.replace(/:$/,'');
515         var mappingObject = {};
516
517         if(fromKey)
518             mappingObject = {'to':displayTo, 'cc':displayCc, 'bcc':displayBcc};
519         else
520         {
521             mappingObject[displayTo] = 'to'; //Cant use object literal with variable variable.
522             mappingObject[displayCc] = 'cc';
523             mappingObject[displayBcc] = 'bcc';
524         }
525
526         return typeof(mappingObject[addressType]) != 'undefined' ? mappingObject[addressType] : '';
527
528     },
529     /**
530     *
531     */
532     toggleSearchRowIcon : function(rowId,show)
533     {
534         if(show)
535         {
536             var idToShow = rowId + '_add_img';
537             var idToHide = rowId + '_rm_img';
538         }
539         else
540         {
541             var idToShow = rowId + '_rm_img';
542             var idToHide = rowId + '_add_img';
543         }
544
545
546         Dom.addClass(idToHide, "yui-hidden");
547         Dom.removeClass(idToShow, "yui-hidden");
548     },
549     /**
550     * Determine if an entry has already been added to the grid results table to prevent duplicates.
551     */
552     doesGridResultsEntryExist: function(emailAddrs)
553     {
554
555         var contactExists = false;
556         var contacts = SE.addressBook.gridResults.getRecordSet().getRecords();
557         for (var i=0; i < contacts.length; i++)
558         {
559             var data = SE.addressBook.gridResults.getRecord(contacts[i]).getData();
560             if(data.email_address == emailAddrs)
561             {
562                 contactExists = true;
563                 break;
564             }
565         }
566         return contactExists;
567     },
568
569     /**
570      * adds an email address to a string, but first checks if it exists
571      * @param string concat The string we are appending email addresses to
572      * @param string addr Email address to add
573      * @return string
574      */
575     smartAddEmailAddressToComposeField : function(concat, addr) {
576         var re = new RegExp(addr);
577
578         if(!concat.match(re)) {
579             if(concat != "") {
580                 concat += "; " + addr;
581             } else {
582                 concat = addr;
583             }
584         }
585
586         return concat;
587     }
588 };
589 ////    END ADDRESS BOOK
590 ///////////////////////////////////////////////////////////////////////////////
591
592
593
594 ///////////////////////////////////////////////////////////////////////////////
595 ////    AUTOCOMPLETE
596 /**
597  * Auto-complete object
598  */
599 SE.autoComplete = {
600     config : {
601         delimChar : [";", ","],
602         useShadow :    false,
603         useIFrame : false,
604         typeAhead : true,
605         prehighlightClassName : "yui-ac-prehighlight",
606         queryDelay : 0
607     },
608     instances : new Array(),
609
610     /**
611      * Parses an addressBook entry looking for primary address.  If not found, it will return the last found address.
612      * @param object Contact from AddressBook
613      * @return string
614      */
615     getPrimaryAddress : function(contact) {
616         var address = app_strings.LBL_EMAIL_ADDRESS_BOOK_NOT_FOUND;
617
618         for(var eIndex in contact.email) {
619             address = contact.email[eIndex].email_address;
620             if(contact.email[eIndex].primary_address == 1) {
621                 return contact.email[eIndex].email_address;
622             }
623         }
624         return address;
625     },
626
627
628     /**
629      * initializes autocomplete widgets for a given compose view
630      * @param int idx
631      */
632     init : function(idx) {
633         var ds = new YAHOO.widget.DS_JSArray(this.returnDataSource(SE.addressBook._contactCache), {
634             "queryMatchContains" : false,
635             "queryMatchSubset" : true
636         });
637
638         this.instances[idx] = {
639             to : null,
640             cc : null,
641             bcc : null
642         };
643
644
645         // instantiate the autoComplete widgets
646         this.instances[idx]['to'] = new YAHOO.widget.AutoComplete('addressTO'+idx, "addressToAC"+idx, ds, this.config);
647         this.instances[idx]['cc'] = new YAHOO.widget.AutoComplete('addressCC'+idx, "addressCcAC"+idx, ds, this.config);
648         this.instances[idx]['bcc'] = new YAHOO.widget.AutoComplete('addressBCC'+idx, "addressBccAC"+idx, ds, this.config);
649
650         // enable hiding of interfering textareas
651         this.instances[idx]['to'].containerExpandEvent.subscribe(SE.autoComplete.toggleTextareaHide);
652         this.instances[idx]['cc'].containerExpandEvent.subscribe(SE.autoComplete.toggleTextareaHide);
653         this.instances[idx]['bcc'].containerExpandEvent.subscribe(SE.autoComplete.toggleTextareaHide);
654
655         // enable reshowing of hidden textareas
656         this.instances[idx]['to'].containerCollapseEvent.subscribe(SE.autoComplete.toggleTextareaShow);
657         this.instances[idx]['cc'].containerCollapseEvent.subscribe(SE.autoComplete.toggleTextareaShow);
658         this.instances[idx]['bcc'].containerCollapseEvent.subscribe(SE.autoComplete.toggleTextareaShow);
659
660         // enable refreshes of contact lists
661         this.instances[idx]['to'].textboxFocusEvent.subscribe(SE.autoComplete.refreshDataSource);
662         this.instances[idx]['cc'].textboxFocusEvent.subscribe(SE.autoComplete.refreshDataSource);
663         this.instances[idx]['bcc'].textboxFocusEvent.subscribe(SE.autoComplete.refreshDataSource);
664     },
665
666     refreshDataSource : function(sType, aArgs) {
667         var textBoxId = aArgs[0].getInputEl().id; // "addressTo0"
668         var idx;
669         var refresh = SE.autoComplete.returnDataSource(SE.addressBook._contactCache);
670
671         if(textBoxId.indexOf("addressTO") > -1 || textBoxId.indexOf("addressCC") > -1) {
672             idx = textBoxId.substr(9);
673         } else {
674             idx = textBoxId.substr(10);
675         }
676
677         SE.autoComplete.instances[idx]['to'].dataSource.data = refresh;
678         SE.autoComplete.instances[idx]['cc'].dataSource.data = refresh;
679         SE.autoComplete.instances[idx]['bcc'].dataSource.data = refresh;
680     },
681
682     /**
683      * Parses AddressBook entries to return an appropriate DataSource array for YUI.autoComplete
684      */
685     returnDataSource : function(contacts) {
686         var ret = new Array();
687         for(var id in contacts) {
688             if (contacts[id].name) {
689                     var primary = this.getPrimaryAddress(contacts[id]);
690
691                     ret[ret.length] = contacts[id].name.replace(/<[\/]*b>/gi, '') + " <" + primary + ">";
692                     //ret[ret.length] = contacts[id].name + " <" + primary + ">";
693
694                     for(var emailIndex in contacts[id].email) {
695                         ret[ret.length] = contacts[id].email[emailIndex].email_address;
696                     }
697             }
698         }
699
700         return ret;
701     },
702
703     /**
704      * Hides address textareas to prevent autocomplete dropdown from being obscured
705      */
706     toggleTextareaHide : function(sType, aArgs) {
707         var textBoxId = aArgs[0]._oTextbox.id; // "addressTo0"
708         var type = "";
709         var idx = -1;
710
711         if(textBoxId.indexOf("addressTO") > -1) {
712             type = "to";
713         } else if(textBoxId.indexOf("addressCC") > -1) {
714             type = "cc";
715         }
716         idx = textBoxId.substr(9);
717
718         // follow through if not BCC
719         if(type != "") {
720             var cc = document.getElementById("addressCC" + idx);
721             var bcc = document.getElementById("addressBCC" + idx);
722
723             switch(type) {
724                 case "to":
725                     cc.style.visibility = 'hidden';
726                 case "cc":
727                     bcc.style.visibility = 'hidden';
728                 break;
729             }
730         }
731     },
732
733     /**
734      * Redisplays the textareas after an address is commited
735      */
736     toggleTextareaShow : function(sType, aArgs) {
737         var textBoxId = aArgs[0]._oTextbox.id; // "addressTo0"
738         var type = "";
739         var idx = -1;
740
741         if(textBoxId.indexOf("addressTO") > -1) {
742             type = "to";
743         } else if(textBoxId.indexOf("addressCC") > -1) {
744             type = "cc";
745         }
746         idx = textBoxId.substr(9);
747
748         // follow through if not BCC
749         if(type != "") {
750             document.getElementById("addressCC" + idx).style.visibility = 'visible';
751             document.getElementById("addressBCC" + idx).style.visibility = 'visible';
752         }
753     }
754 };
755
756 ////    END AUTOCOMPLETE
757 ///////////////////////////////////////////////////////////////////////////////
758
759 ///////////////////////////////////////////////////////////////////////////////
760 ////    COMPOSE & SEND
761 /**
762  * expands the options sidebar
763  */
764 SE.composeLayout = {
765     currentInstanceId : 0,
766     ccHidden : true,
767     bccHidden : true,
768     outboundAccountErrors : null,
769     loadedTinyInstances : {}, //Tracks which tinyMCE editors have initalized with html content.
770
771     showAddressDetails : function(e) {
772         var linkElement = document.getElementById("More"+e.id);
773         var spanElement = document.getElementById("Detail"+e.id);
774         var emailAddressList = e.value;
775         if(e.value.length > 96)
776         {
777                 var resultArray = SE.composeLayout._getEmailArrayFromString(emailAddressList);
778             var displayArray = [];
779                 for (var i=0; i<resultArray.length; i++)
780                 {
781                     var t_name = resultArray[i].name;
782                     var t_emailAddr = resultArray[i].email_address;
783                     if(t_name == '')
784                        displayArray.push('<br/>&lt;' + t_emailAddr + '&gt;');
785                     else
786                        displayArray.push(t_name + '<br/>&lt;' + t_emailAddr + '&gt;');
787                 }
788
789             var result = displayArray.join('<br/>');
790                 // Display
791             linkElement.style.display = "inline";
792             linkElement.style.height="10px";
793             linkElement.style.overflow="visible";
794             spanElement.innerHTML = result;
795         }
796         else
797                 linkElement.style.display = "none";
798
799         },
800
801    /**
802     *  Given a string of email address, return an array containing the name portion (if available)
803     *  and email portion.
804     */
805     _getEmailArrayFromString : function (emailAddressList){
806
807         var reg = /@.*?;/g;
808         while ((results = reg.exec(emailAddressList)) != null)
809         {
810             orignial = results[0];
811             parsedResult = results[0].replace(';', ':::::');
812             emailAddressList = emailAddressList.replace (orignial, parsedResult);
813         }
814
815         reg = /@.*?,/g;
816         while ((results = reg.exec(emailAddressList)) != null)
817         {
818             orignial = results[0];
819             parsedResult = results[0].replace(',', ':::::');
820             emailAddressList = emailAddressList.replace (orignial, parsedResult);
821         }
822         //Administrator <johndoe@som.com>  ;1@somwhe.com;2@somwherecomplex.com,3@somwherecomplex.com;4@somwherecomplex.com,5@somwherecomplex.com,
823         var emailArr = emailAddressList.split(":::::");
824         var resultsArray = [];
825         var newArr = [];
826         for (var i=0; i<emailArr.length; i++)
827         {
828             var rposition = emailArr[i].indexOf('<');
829             var lposition = emailArr[i].indexOf('>');
830
831             if(trim(emailArr[i]) != '')
832             {
833                 if(rposition != -1 && lposition != -1)
834                 {
835                     var t_name = emailArr[i].substr(0, rposition-1);
836                     var t_emailAddr = emailArr[i].substr(rposition+1, (lposition-1 - rposition) );
837                     resultsArray.push({'name':t_name, 'email_address': t_emailAddr});
838                 }
839                 else
840                 {
841                     resultsArray.push({'name':'', 'email_address': emailArr[i]});
842                 }
843             }
844         }
845         return resultsArray;
846     },
847     ///////////////////////////////////////////////////////////////////////////
848     ////    COMPOSE FLOW
849     /**
850      * Prepare bucket DIV and yui-ext tab panels
851      */
852     _0_yui : function() {
853         var idx = this.currentInstanceId;
854
855         var composeTab = new YAHOO.SUGAR.ClosableTab({
856                         label: mod_strings.LNK_NEW_SEND_EMAIL,
857                                 scroll : true,
858                                 content : "<div id='htmleditordiv" + idx + "'/>",
859                                 id : "composeTab" + idx,
860                                 closeMsg: app_strings.LBL_EMAIL_CONFIRM_CLOSE,
861                                 active : true
862         }, SE.innerLayout);
863         SE.innerLayout.addTab(composeTab);
864
865         // get template engine with template
866         if (!SE.composeLayout.composeTemplate) {
867                 SE.composeLayout.composeTemplate = new YAHOO.SUGAR.Template(SE.templates['compose']);
868         }
869
870         // create Tab inner layout
871         var composePanel =  this.getComposeLayout();
872         composePanel.getUnitByPosition("right").collapse();
873         composePanel.autoSize();
874
875     },
876         /**
877      * Generate the quick compose layout
878          * @method getQuickComposeLayout
879          * @param {Pannel} parentPanel Parent pannel
880          * @param {Object} o Options
881          * @return {} none
882          **/
883     getQuickComposeLayout : function (parentPanel,o) {
884          var idx = SE.composeLayout.currentInstanceId;
885
886          //Before rendering the parent pannel we need to initalize the grid layout
887          parentPanel.beforeRenderEvent.subscribe(function() {
888
889                 YAHOO.util.Event.onAvailable('htmleditordiv' + idx, function() {
890                         SE.composeLayout._createComposeLayout(idx);
891                         SE.composeLayout[idx].set('height', 350);
892                         SE.composeLayout[idx].render();
893            });
894         });
895
896          //Wait until the Compose Layout has rendered, then add the
897          //options tab and perform the tiny initialization.
898          parentPanel.renderEvent.subscribe(function() {
899
900                 YAHOO.util.Event.onAvailable('htmleditordiv' + idx, function() {
901                 SE.composeLayout._initComposeOptionTabs(idx);
902                 SE.composeLayout[idx].getUnitByPosition("right").collapse();
903                 //Initialize tinyMCE
904             SE.composeLayout._1_tiny(false);
905             
906                 //Init templates and address book
907                 SE.composeLayout._2_final();
908
909             SE.composeLayout.quickCreateComposePackage(o);
910
911                 });
912          });
913
914             //Check if we have the div override for the shortcut bar
915         if(typeof o.menu_id != 'undefined') {
916                    parentPanel.render(o.menu_id);
917             } else {
918                    parentPanel.render(document.body);
919             }
920
921         return SE.composeLayout[idx];
922     },
923     /**
924      * Fill in all fields into the quick compose layout.
925          * @method quickCreateComposePackage
926          * @param {Object} o Options
927          * @return {} none
928          **/
929     quickCreateComposePackage: function(o)
930     {
931         //If we have a compose package fill in defaults.
932         if (typeof(o.composePackage) != 'undefined')
933         {
934             composePackage = o.composePackage; //Set the compose data object
935             //Hijack this method called by composePackage as it's not need for quick creates.
936             SE.composeLayout.c0_composeNewEmail = function(){};
937             SE.composeLayout.composePackage(); //Fill in defaults.
938         }
939     },
940     getComposeLayout : function() {
941         var idx = SE.composeLayout.currentInstanceId;
942
943         this._createComposeLayout(idx);
944         SE.composeLayout[idx].render();
945         this._initComposeOptionTabs(idx);
946
947         return SE.composeLayout[idx];
948         },
949
950         /**
951         *       Create the layout manager for the compose window.
952         */
953         _createComposeLayout : function(idx)
954         {
955                 SE.composeLayout[idx] = new YAHOO.widget.Layout('htmleditordiv' + idx, {
956                 parent: SE.complexLayout,
957                 border:true,
958             hideOnLayout: true,
959             height: 400,
960                         units: [{
961                                         position: "center",
962                         animate: false,
963                         scroll: false,
964                         split:true,
965                         body:
966                                 SE.composeLayout.composeTemplate.exec({
967                                 'app_strings':app_strings,
968                                 'mod_strings':mod_strings,
969                                 'theme': theme,
970                                 'linkbeans_options' : linkBeans,
971                                 'idx' : SE.composeLayout.currentInstanceId
972                                 })
973                     },{
974                         position: "right",
975                                     scroll:true,
976                                     collapse: true,
977                                     collapsed: true,
978                                     resize: true,
979                                     border:true,
980                                     animate: false,
981                                     width:'230',
982                                     body: "<div class='composeRightTabs' id='composeRightTabs" + idx + "'/>",
983                                     titlebar: true,
984                                     split: true,
985                                     header: app_strings.LBL_EMAIL_OPTIONS
986                     }]
987                 });
988         },
989
990         /**
991         *  Create compose tab which will populate the 'right' container in the compose window.
992         */
993         _initComposeOptionTabs : function(idx)
994         {
995                 var cTabs = new YAHOO.widget.TabView("composeRightTabs" + idx);
996                 var tab = new YAHOO.widget.Tab({
997                                 label: app_strings.LBL_EMAIL_ATTACHMENT,
998                                 scroll : true,
999                                 content : SUGAR.util.getAndRemove("divAttachments" + idx).innerHTML,
1000                                 id : "divAttachments" + idx,
1001                                 active : true
1002                         });
1003
1004                 tab.layout = SE.composeLayout[idx];
1005
1006            tab.on("activeChange", function(o){
1007                         if (o.newValue) {
1008                                 this.layout.getUnitByPosition("right").set("header", app_strings.LBL_EMAIL_ATTACHMENT);
1009                         }
1010                 });
1011
1012                 cTabs.addTab(tab);
1013
1014                 tab = new YAHOO.widget.Tab({
1015                                 label: app_strings.LBL_EMAIL_OPTIONS,
1016                                 scroll : true,
1017                                 content : SUGAR.util.getAndRemove("divOptions" + idx).innerHTML,
1018                                 id : "divOptions" + idx,
1019                                 active : false
1020                         });
1021
1022                 tab.layout = SE.composeLayout[idx];
1023                 tab.on("activeChange", function(o){
1024                         if (o.newValue) {
1025                                 this.layout.getUnitByPosition("right").set("header", app_strings.LBL_EMAIL_OPTIONS);
1026                         }
1027                 });
1028                 cTabs.addTab(tab);
1029
1030                 SE.composeLayout[idx].autoSize = function() {
1031                         var pEl = this.get("element").parentNode.parentNode.parentNode;
1032                         this.set("height", pEl.clientHeight-30);
1033                         this.render();
1034                 }
1035
1036                 SE.composeLayout[idx].rightTabs = cTabs;
1037     },
1038     isParentTypeValid : function(idx) {
1039                 var parentTypeValue = document.getElementById('data_parent_type' + idx).value;
1040                 var parentNameValue = document.getElementById('data_parent_name' + idx).value;
1041                 if (trim(parentTypeValue) == ""){
1042                         alert(mod_strings.LBL_ERROR_SELECT_MODULE);
1043                         return false;
1044                 } // if
1045                 return true;
1046     },
1047
1048     isParentTypeAndNameValid : function(idx) {
1049                 var parentTypeValue = document.getElementById('data_parent_type' + idx).value;
1050                 var parentNameValue = document.getElementById('data_parent_name' + idx).value;
1051                 var parentIdValue = document.getElementById('data_parent_id' + idx).value;
1052                 if ((trim(parentTypeValue) != "" && trim(parentNameValue) == "") ||
1053                         (trim(parentTypeValue) != "" && trim(parentNameValue) != "" && parentIdValue == "")){
1054                                 alert(mod_strings.LBL_ERROR_SELECT_MODULE_SELECT);
1055                         return false;
1056                 } // if
1057                 return true;
1058     },
1059
1060     callopenpopupForEmail2 : function(idx,options) {
1061
1062         var formName = 'emailCompose' + idx;
1063
1064         if(typeof(options) != 'undefined' && typeof(options.form_name) != 'undefined')
1065             formName = options.form_name;
1066
1067                 var parentTypeValue = document.getElementById('data_parent_type' + idx).value;
1068                 var parentNameValue = document.getElementById('data_parent_name' + idx).value;
1069                 if (!SE.composeLayout.isParentTypeValid(idx)) {
1070                         return;
1071                 } // if
1072                 open_popup(document.getElementById('data_parent_type' + idx).value,600,400,'&tree=ProductsProd',true,false,
1073                 {
1074                         call_back_function:"SE.composeLayout.popupAddEmail",
1075                         form_name:formName,
1076                         field_to_name_array:{
1077                                 id:'data_parent_id' + idx,
1078                                 name:'data_parent_name' + idx,
1079                                 email1:'email1'}
1080                 });
1081         },
1082
1083         popupAddEmail : function(o)
1084         {
1085                 var nameKey = "data_parent_name" + SE.composeLayout.currentInstanceId;
1086                 var data = o.name_to_value_array;
1087                 if (typeof (data[nameKey]) != "undefined" && data[nameKey] != ""
1088                         && typeof (data["email1"]) != "undefined" && data["email1"] != "" && data["email1"] != "undefined")
1089         {
1090                 var target = Dom.get("addressTO" + SE.composeLayout.currentInstanceId);
1091                 target.value = SE.addressBook.smartAddEmailAddressToComposeField(target.value, data[nameKey] + "<" + data.email1 + ">");
1092         }
1093                 set_return(o);
1094         },
1095     /**
1096      * Prepare TinyMCE
1097      */
1098     _1_tiny : function(isReplyForward) {
1099         var idx = SE.composeLayout.currentInstanceId;
1100         var elId = SE.tinyInstances.currentHtmleditor = 'htmleditor' + idx;
1101         SE.tinyInstances[elId] = { };
1102         SE.tinyInstances[elId].ready = false;
1103
1104         if (!SUGAR.util.isTouchScreen()) {
1105             var t = tinyMCE.getInstanceById(elId);
1106         }
1107         if(typeof(t) == 'undefined')  {
1108             if (!SUGAR.util.isTouchScreen()) {
1109                 tinyMCE.execCommand('mceAddControl', false, elId);
1110             }
1111             YAHOO.util.Event.onAvailable(elId + "_parent", function() {
1112                 SE.composeLayout.resizeEditorSetSignature(idx,!isReplyForward);
1113                 }, this);
1114         }
1115     },
1116
1117     resizeEditorSetSignature : function(idx,setSignature)
1118     {
1119         var instance = SE.util.getTiny(SE.tinyInstances.currentHtmleditor);
1120
1121         if(typeof(instance) == 'undefined' || (typeof(SE.composeLayout.loadedTinyInstances[idx]) != 'undefined' && SE.composeLayout.loadedTinyInstances[idx] == false)) {
1122             setTimeout("SE.composeLayout.resizeEditorSetSignature(" + idx + ",'"+isReplyForward+"');",500);
1123                     return;
1124                 }
1125
1126         SE.composeLayout.resizeEditor(idx);
1127         if(setSignature) {
1128             setTimeout("SUGAR.email2.composeLayout.setSignature("+idx+");",250);
1129         }
1130
1131     },
1132
1133     resizeEditor : function(idx)
1134     {
1135         var cof = Dom.get('composeOverFrame' + idx);
1136         var head = Dom.get('composeHeaderTable' + idx);
1137         var targetHeight = cof.clientHeight - head.clientHeight;
1138         var instance = SE.util.getTiny('htmleditor' + idx);
1139
1140         try {
1141         var parentEl = Dom.get(instance.editorId + '_parent');
1142         var toolbar = Dom.getElementsByClassName("mceFirst", "tr", parentEl)[0];
1143         var contentEl  = instance.contentAreaContainer;
1144         var iFrame = contentEl.firstChild;
1145         var tinMceToolbarOffset = 18;
1146         iFrame.style.height = (targetHeight - toolbar.offsetHeight - tinMceToolbarOffset)  + "px";
1147
1148         } catch(e) {
1149             setTimeout("SE.composeLayout.resizeEditor("+idx+");",1000);
1150         }
1151     },
1152
1153     /**
1154      * Initializes d&d, auto-complete, email templates
1155      */
1156     _2_final : function() {
1157         var idx = SE.composeLayout.currentInstanceId;
1158
1159         if(this.emailTemplates) {
1160             this.setComposeOptions(idx);
1161         } else {
1162             //populate email template cache
1163             AjaxObject.target = '';
1164             AjaxObject.startRequest(callbackComposeCache, urlStandard + "&emailUIAction=fillComposeCache");
1165         }
1166
1167         // handle drop targets for addressBook
1168        var to =  new YAHOO.util.DDTarget('addressTO' +idx, 'addressBookDD', {notifyDrop:this.handleDrop});
1169        var cc =  new YAHOO.util.DDTarget('addressCC' +idx, 'addressBookDD', {notifyDrop:this.handleDrop});
1170        var bcc = new YAHOO.util.DDTarget('addressBCC'+idx, 'addressBookDD', {notifyDrop:this.handleDrop});
1171        to.notifyDrop = cc.notifyDrop = bcc.notifyDrop = this.handleDrop;
1172
1173         // auto-complete setup
1174         SE.autoComplete.init(idx);
1175
1176         // set focus on to:
1177         document.getElementById("addressTO" + idx).focus();
1178     },
1179
1180         /**
1181      * hide tinyMCE tool bar if send email as plaintext is checked
1182      */
1183     renderTinyMCEToolBar : function (idx, hide) {
1184         if (hide) {
1185                 document.getElementById('htmleditor' + idx + '_toolbar1').style.display = 'none';
1186         } else {
1187                 document.getElementById('htmleditor' + idx + '_toolbar1').style.display = '';
1188         }
1189     },
1190
1191     c1_composeEmail : function(isReplyForward, retry) {
1192         if (!retry) {
1193             this._0_yui();
1194         }
1195         if  (!SUGAR.util.isTouchScreen() && (typeof(tinyMCE) == 'undefined' || typeof(tinyMCE.settings) == 'undefined')){
1196             setTimeout("SE.composeLayout.c1_composeEmail(" + isReplyForward + ", true);", 500);
1197         } else {
1198                 this._1_tiny(isReplyForward);
1199                 this._2_final();
1200
1201                 if(isReplyForward) {
1202                     this.replyForwardEmailStage2();
1203                 }
1204         }
1205     },
1206
1207     /**
1208      * takes draft info and prepopulates
1209      */
1210     c0_composeDraft : function() {
1211         this.getNewInstanceId();
1212         inCompose = true;
1213         document.getElementById('_blank').innerHTML = '';
1214         var idx = SE.composeLayout.currentInstanceId;
1215                 SE.composeLayout.draftObject = new Object();
1216                 SE.composeLayout.draftObject.id = idx;
1217                 SE.composeLayout.draftObject.isDraft = true;
1218         SE.composeLayout.currentInstanceId = idx;
1219         SE.tinyInstances.currentHtmleditor = 'htmleditor' + SE.composeLayout.currentInstanceId;
1220         SE.tinyInstances[SE.tinyInstances.currentHtmleditor] = new Object();
1221         SE.tinyInstances[SE.tinyInstances.currentHtmleditor].ready = false;
1222
1223         SE.composeLayout._0_yui();
1224         SE.composeLayout._1_tiny(true);
1225
1226         // final touches
1227         SE.composeLayout._2_final();
1228
1229         /* Draft-specific final processing. Need a delay to allow Tiny to render before calling setText() */
1230         setTimeout("AjaxObject.handleReplyForwardForDraft(SE.o);", 1000);
1231     },
1232
1233     /**
1234      * Strip & Prep editor hidden fields
1235      */
1236     c0_composeNewEmail : function() {
1237         this.getNewInstanceId();
1238         this.c1_composeEmail(false);
1239     },
1240
1241     /**
1242      * Sends async request to get the compose view.
1243      * Requests come from "reply" or "forwards"
1244      */
1245     c0_replyForwardEmail : function(ieId, uid, mbox, type) {
1246         SE.composeLayout.replyForwardObj = new Object();
1247         SE.composeLayout.replyForwardObj.ieId = ieId;
1248         SE.composeLayout.replyForwardObj.uid = uid;
1249         SE.composeLayout.replyForwardObj.mbox = mbox;
1250         SE.composeLayout.replyForwardObj.type = type;
1251
1252         if(mbox == 'sugar::Emails') {
1253             SE.composeLayout.replyForwardObj.sugarEmail = true;
1254         }
1255
1256         SE.composeLayout.getNewInstanceId();
1257         SE.composeLayout.c1_composeEmail(true);
1258     },
1259     ////    END COMPOSE FLOW
1260     ///////////////////////////////////////////////////////////////////////////
1261
1262     /**
1263      * Called when a contact, email, or mailinglist is dropped
1264      * into one of the compose fields.
1265      */
1266     handleDrop : function (source, event, data, target) {
1267         var nodes;
1268         if (!target) {
1269             target = event.getTarget();
1270             if (data.single) {
1271                 data.nodes = [data.nodes];
1272             }
1273             nodes = data.nodes;
1274         } else {
1275             target = document.getElementById(target);
1276             nodes = data;
1277         }
1278
1279         if (target.id.indexOf('address') > -1) {
1280             // dropped onto email to/cc/bcc field
1281             for(var i in nodes) {
1282                 var node = nodes[i].getData();
1283                 var email = "";
1284                 if (node[1].indexOf('contact') > -1) {
1285                     email = SE.addressBook.getFormattedAddress(node[0]);
1286                 } else if (node[1].indexOf('address-email') > -1){
1287                     email = node[3].replace(/&nbsp;/gi, '');
1288                     email = email.replace('&lt;', '<').replace('&gt;', '>');
1289                     var tr = source.getTrEl(nodes[i]);
1290                     while (tr && !Dom.hasClass(tr, "address-contact")) {
1291                         tr = source.getPreviousTrEl(tr);
1292                     }
1293                     var CID = source.getRecord(tr).getData()[0];
1294                     var o = SE.addressBook._contactCache[CID];
1295                     var name = new String(o.name);
1296                     var finalName = name.replace(/(<([^>]+)>)/ig, "");
1297                     email = finalName + email;
1298                 }
1299                 target.value = SE.addressBook.smartAddEmailAddressToComposeField(target.value, email);
1300             }
1301         }
1302     },
1303
1304
1305     /*/////////////////////////////////////////////////////////////////////////////
1306     ///    EMAIL TEMPLATE CODE
1307      */
1308     applyEmailTemplate : function (idx, id) {
1309
1310         //bug #20680
1311         var box_title = mod_strings.LBL_EMAILTEMPLATE_MESSAGE_SHOW_TITLE;
1312                 var box_msg = mod_strings.LBL_EMAILTEMPLATE_MESSAGE_SHOW_MSG;
1313                 var box_none_msg = mod_strings.LBL_EMAILTEMPLATE_MESSAGE_CLEAR_MSG;
1314                 
1315                 //bug #6224
1316                 var to_addr = document.getElementById('addressTO'+idx);
1317                 if (to_addr.value.search(/[^;,]{6,}[;,][^;,]{6,}/) != -1) 
1318                 {
1319                         box_title = mod_strings.LBL_EMAILTEMPLATE_MESSAGE_WARNING_TITLE;
1320                         box_msg = mod_strings.LBL_EMAILTEMPLATE_MESSAGE_MULTIPLE_RECIPIENTS + '<br /><br />' + box_msg;
1321                 }
1322                 
1323                 // id is selected index of email template drop-down
1324                 if(id == '' || id == "0") {
1325                         YAHOO.SUGAR.MessageBox.show({
1326                    title:box_title,
1327                    msg: box_none_msg,
1328                    type: 'confirm',
1329                    fn: function(btn){
1330                                 if(btn=='no'){return;};
1331                                 SUGAR.email2.composeLayout.processNoneResult(idx, id);},
1332                    modal:true,
1333                    scope:this
1334                });
1335                return;
1336                 }
1337
1338                 YAHOO.SUGAR.MessageBox.show({
1339            title:box_title,
1340            msg: box_msg,
1341            type: 'confirm',
1342            fn: function(btn){
1343                         if(btn=='no'){return;};
1344                         SUGAR.email2.composeLayout.processResult(idx, id);},
1345            modal:true,
1346            scope:this
1347        });
1348     },
1349
1350     processNoneResult : function(idx, id) {
1351         var tiny = SE.util.getTiny('htmleditor' + idx);
1352         var tinyHTML = tiny.getContent();
1353         var openTag = '<div><span><span>';
1354         var htmllow = tinyHTML.toLowerCase();
1355         var start = htmllow.indexOf(openTag);
1356                 if (start > -1) {
1357                 tinyHTML = tinyHTML.substr(start);
1358             tiny.setContent(tinyHTML);
1359                 } else { 
1360             tiny.setContent('');
1361                 }
1362     },
1363
1364         processResult : function(idx , id){
1365         call_json_method('EmailTemplates','retrieve','record='+id,'email_template_object', this.appendEmailTemplateJSON);
1366
1367         // get attachments if any
1368         AjaxObject.target = '';
1369         AjaxObject.startRequest(callbackLoadAttachments, urlStandard + "&emailUIAction=getTemplateAttachments&parent_id=" + id);
1370     },
1371
1372     appendEmailTemplateJSON : function() {
1373         var idx = SE.composeLayout.currentInstanceId; // post increment
1374
1375         // query based on template, contact_id0,related_to
1376         //jchi 09/10/2008 refix #7743
1377         if(json_objects['email_template_object']['fields']['subject'] != '' ) { // cn: bug 7743, don't stomp populated Subject Line
1378             document.getElementById('emailSubject' + idx).value = decodeURI(encodeURI(json_objects['email_template_object']['fields']['subject']));
1379         }
1380
1381         var text = decodeURI(encodeURI(json_objects['email_template_object']['fields']['body_html'])).replace(/<BR>/ig, '\n').replace(/<br>/gi, "\n").replace(/&amp;/gi,'&').replace(/&lt;/gi,'<').replace(/&gt;/gi,'>').replace(/&#039;/gi,'\'').replace(/&quot;/gi,'"');
1382
1383         // cn: bug 14361 - text-only templates don't fill compose screen
1384         if(text == '') {
1385             text = decodeURI(encodeURI(json_objects['email_template_object']['fields']['body'])).replace(/<BR>/ig, '\n').replace(/<br>/gi, "\n").replace(/&amp;/gi,'&').replace(/&lt;/gi,'<').replace(/&gt;/gi,'>').replace(/&#039;/gi,'\'').replace(/&quot;/gi,'"').replace(/\r\n/gi,"<br/>");
1386         }
1387
1388         var tiny = SE.util.getTiny('htmleditor' + idx);
1389         var tinyHTML = tiny.getContent();
1390         var openTag = '<div><span><span>';
1391         var closeTag = '</span></span></div>';
1392         var htmllow = tinyHTML.toLowerCase();
1393         var start = htmllow.indexOf(openTag);
1394                 if (start > -1) {
1395                 var htmlPart2 = tinyHTML.substr(start);
1396                 tinyHTML = text + htmlPart2;
1397                 tiny.setContent(tinyHTML);
1398                 } else {
1399                 tiny.setContent(text);
1400                 }
1401     },
1402
1403     /**
1404      * Writes out the signature in the email editor
1405      */
1406     setSignature : function(idx) {
1407         if (!tinyMCE)
1408             return false;
1409         var hide = document.getElementById('setEditor' + idx).checked;
1410         SE.composeLayout.renderTinyMCEToolBar(idx,hide);
1411         //wait for signatures to load before trying to set them
1412         if (!SE.composeLayout.signatures) {
1413             setTimeout("SE.composeLayout.setSignature(" + idx + ");", 1000);
1414                         return;
1415         }
1416
1417         if(idx) {
1418             var sel = document.getElementById('signatures' + idx);
1419         } else {
1420             var sel = document.getElementById('signature_id');
1421             idx = SE.tinyInstances.currentHtmleditor;
1422         }
1423
1424         //Ensure that the tinyMCE html has been rendered.
1425         if(typeof(SE.composeLayout.loadedTinyInstances[idx]) != 'undefined' && SE.composeLayout.loadedTinyInstances[idx] == false) {
1426             setTimeout("SE.composeLayout.setSignature(" + idx + ");",1000);
1427                     return;
1428                 }
1429
1430         var signature = '';
1431
1432         try {
1433             signature = sel.options[sel.selectedIndex].value;
1434         } catch(e) {
1435
1436         }
1437
1438         var openTag = '<div><span><span>';
1439         var closeTag = '</span></span></div>';
1440         var t = tinyMCE.getInstanceById('htmleditor' + idx);
1441         //IE 6 Hack
1442         if(typeof(t) != 'undefined')
1443         {
1444             t.contentDocument = t.contentWindow.document;
1445             var html = t.getContent();
1446         }
1447         else
1448         {
1449             var html = '';
1450         }
1451
1452         var htmllow = html.toLowerCase();
1453         var start = htmllow.indexOf(openTag);
1454         var end = htmllow.indexOf(closeTag) + closeTag.length;
1455
1456         // selected "none" - remove signature from email
1457         if(signature == '') {
1458             if (start > -1) {
1459                 var htmlPart1 = html.substr(0, start);
1460                 var htmlPart2 = html.substr(end, html.length);
1461
1462                 html = htmlPart1 + htmlPart2;
1463                 t.setContent(html);
1464             }
1465             SE.signatures.lastAttemptedLoad = '';
1466             return false;
1467         }
1468
1469         if(!SE.signatures.lastAttemptedLoad) // lazy load place holder
1470             SE.signatures.lastAttemptedLoad = '';
1471
1472         SE.signatures.lastAttemptedLoad = signature;
1473
1474         if(typeof(SE.signatures[signature]) == 'undefined') {
1475             //lazy load
1476             SE.signatures.lastAttemptedLoad = ''; // reset this flag for recursion
1477             SE.signatures.targetInstance = (idx) ? idx : "";
1478             AjaxObject.target = '';
1479             AjaxObject.startRequest(callbackLoadSignature, urlStandard + "&emailUIAction=getSignature&id="+signature);
1480         } else {
1481             var newSignature = this.prepareSignature(SE.signatures[signature]);
1482
1483             // clear out old signature
1484             if(SE.signatures.lastAttemptedLoad && start > -1) {
1485                 var htmlPart1 = html.substr(0, start);
1486                 var htmlPart2 = html.substr(end, html.length);
1487
1488                 html = htmlPart1 + htmlPart2;
1489             }
1490
1491             // [pre|ap]pend
1492                         start = html.indexOf('<div><hr></div>');
1493             if(SE.userPrefs.signatures.signature_prepend == 'true' && start > -1) {
1494                                 var htmlPart1 = html.substr(0, start);
1495                                 var htmlPart2 = html.substr(start, html.length);
1496                 var newHtml = htmlPart1 + openTag + newSignature + closeTag + htmlPart2;
1497             } else if(SUGAR.email2.userPrefs.signatures.signature_prepend == 'true') {
1498                 var newHtml = '<br/>' + openTag + newSignature + closeTag + html;
1499             } else {
1500                 var newHtml = html + openTag + newSignature + closeTag;
1501             }
1502             //tinyMCE.setContent(newHtml);
1503             t.setContent(newHtml);
1504         }
1505     },
1506
1507     prepareSignature : function(str) {
1508         var signature = new String(str);
1509
1510         signature = signature.replace(/&lt;/gi, '<');
1511         signature = signature.replace(/&gt;/gi, '>');
1512
1513         return signature;
1514     },
1515
1516
1517     showAttachmentPanel : function(idx) {
1518         var east = SE.composeLayout[idx].getUnitByPosition("right");
1519         var tabs = SE.composeLayout[idx].rightTabs;
1520         east.expand();
1521         tabs.set("activeTab", tabs.getTab(0));
1522     },
1523
1524     /**
1525      * expands sidebar and displays options panel
1526      */
1527     showOptionsPanel : function(idx) {
1528         var east = SE.composeLayout[idx].getUnitByPosition("right");
1529         var tabs = SE.composeLayout[idx].rightTabs;
1530         east.expand();
1531         tabs.set("activeTab", tabs.getTab(1));
1532     },
1533
1534     /**
1535      * Selects the Contacts tab
1536      */
1537     showContactsPanel : function() {
1538         SE.complexLayout.regions.west.showPanel("contactsTab");
1539     },
1540
1541     /**
1542      * Generates fields for Select Document
1543      */
1544     addDocumentField : function(idx) {
1545         var basket = document.getElementById('addedDocuments' + idx);
1546         if(basket) {
1547             var index = (basket.childNodes.length / 7) - 1;
1548             if(index < 0)
1549                 index = 0;
1550         } else {
1551             index = 0;
1552         }
1553
1554         var test = document.getElementById('documentId' + idx + index);
1555
1556         while(test != null) {
1557             index++;
1558             test = document.getElementById('documentId' + idx + index);
1559         }
1560
1561         var documentCup = document.createElement("div");
1562         documentCup.id = 'documentCup' + idx + index;
1563         documentCup.innerHTML = "<input type='hidden' name='document" + idx + index + "' id='document" + idx + index + "' />" +
1564                 // document id field
1565                 "<input type='hidden' name='documentId" + idx + index + "' id='documentId" + idx + index + "' />" +
1566                 // document name field
1567                 "<input value='' size='15' disabled='true' type='text' name='documentName" + idx + index + "' id='documentName" + idx + index + "' />" +
1568                 // select button
1569                 "<button class='button firstChild' type='button' name='documentSelect" + idx + index + "' id='documentSelect" + idx + index + "'" +
1570                     "onclick='SE.composeLayout.selectDocument(\"" + index + "\");' value='" + app_strings.LBL_EMAIL_SELECT + "'>" +
1571                 "<img src='index.php?entryPoint=getImage&themeName=" + SUGAR.themes.theme_name + "&imageName=id-ff-select.png' ></button>" +
1572                 // remove button
1573                 "<button class='button lastChild' type='button' name='documentRemove" + idx + index + "' id='documentRemove" + idx + index + "'" +
1574                     "onclick='SE.composeLayout.deleteDocumentField(\"documentCup" + idx + index + "\");' value='" + app_strings.LBL_EMAIL_REMOVE + "'>" +
1575                  "<img src='index.php?entryPoint=getImage&themeName=" + SUGAR.themes.theme_name + "&imageName=id-ff-clear.png' ></button>" +
1576                 "<br/>";
1577
1578         basket.appendChild(documentCup);
1579         //basket.innerHTML += out;
1580         return index;
1581     },
1582
1583     /**
1584      * Makes async call to save a draft of the email
1585      * @param int Instance index
1586      */
1587     saveDraft : function(tinyInstance) {
1588         this.sendEmail(tinyInstance, true);
1589     },
1590
1591     selectDocument : function(target) {
1592         URL="index.php?module=Emails&action=PopupDocuments&to_pdf=true&target=" + target;
1593         windowName = 'selectDocument';
1594         windowFeatures = 'width=800' + ',height=600' + ',resizable=1,scrollbars=1';
1595
1596         win = SUGAR.util.openWindow(URL, windowName, windowFeatures);
1597         if(window.focus) {
1598             // put the focus on the popup if the browser supports the focus() method
1599             win.focus();
1600         }
1601     },
1602
1603     /**
1604      * Modal popup for file attachment dialogue
1605      */
1606     addFileField : function() {
1607         if(!SE.addFileDialog){ // lazy initialize the dialog and only create it once
1608             SE.addFileDialog = new YAHOO.widget.Dialog("addFileDialog", {
1609                 modal:true,
1610                 visible:false,
1611                 fixedcenter:true,
1612                 constraintoviewport: true,
1613                 scroll: true,
1614                 keylisteners : new YAHOO.util.KeyListener(document, { keys:27 }, {
1615                         fn:function(){SE.addFileDialog.hide();}
1616                 })
1617             });
1618             SE.addFileDialog.setHeader(app_strings.LBL_EMAIL_ATTACHMENTS);
1619             SE.addFileDialog.render();
1620            // SE.addFileDialog.addKeyListener(27, , SE.addFileDialog);
1621         }
1622         Dom.removeClass("addFileDialog", "yui-hidden");
1623
1624         SE.addFileDialog.show();
1625     },
1626
1627     /**
1628      * Async upload of file to temp dir
1629      */
1630     uploadAttachment : function() {
1631         if(document.getElementById('email_attachment').value != "") {
1632             var formObject = document.getElementById('uploadAttachment');
1633             YAHOO.util.Connect.setForm(formObject, true, true);
1634             AjaxObject.target = '';
1635             AjaxObject.startRequest(callbackUploadAttachment, null);
1636         } else {
1637             alert(app_strings.LBL_EMAIL_ERROR_NO_FILE);
1638         }
1639     },
1640
1641     /**
1642      * Adds a SugarDocument to an outbound email.  Action occurs in a popup window displaying a ListView from the Documents module
1643      * @param string target in focus compose layout
1644      */
1645     setDocument : function(idx, target, documentId, documentName, docRevId) {
1646         // fields are named/id'd [fieldName][instanceId][index]
1647         var addedDocs = document.getElementById("addedDocuments" + idx);
1648         var docId = document.getElementById('documentId' + idx + target);
1649         var docName = document.getElementById('documentName' + idx + target);
1650         var docRevisionId = document.getElementById('document' + idx + target);
1651         docId.value = documentId;
1652         docName.value = documentName;
1653         docRevisionId.value = docRevId;
1654     },
1655
1656     /**
1657      * Removes the bucket div containing the document input fields
1658      */
1659     deleteDocumentField : function(documentCup) {
1660         var f0 = document.getElementById(documentCup);
1661         f0.parentNode.removeChild(f0);
1662     },
1663
1664     /**
1665      * Removes a Template Attachment field
1666      * @param int
1667      * @param int
1668      */
1669     deleteTemplateAttachmentField : function(idx, index) {
1670         // create not-in-array values for removal filtering
1671         var r = document.getElementById("templateAttachmentsRemove" + idx).value;
1672
1673         if(r != "") {
1674             r += "::";
1675         }
1676
1677         r += document.getElementById('templateAttachmentId' + idx + index).value;
1678         document.getElementById("templateAttachmentsRemove" + idx).value = r;
1679
1680         var target = 'templateAttachmentCup' + idx + index;
1681         d =  document.getElementById(target);
1682         d.parentNode.removeChild(d);
1683     },
1684
1685     /**
1686      * Async removal of uploaded temp file
1687      * @param string index Should be a concatenation of idx and index
1688      * @param string
1689      */
1690     deleteUploadAttachment : function(index, file) {
1691         var d = document.getElementById('email_attachment_bucket' + index);
1692         d.parentNode.removeChild(d);
1693
1694         // make async call to delete cached file
1695         AjaxObject.target = '';
1696         AjaxObject.startRequest('', urlStandard + "&emailUIAction=removeUploadedAttachment&file="+file);
1697     },
1698
1699     /**
1700      * Attaches files coming from Email Templates
1701      */
1702     addTemplateAttachmentField : function(idx) {
1703         // expose title
1704         document.getElementById('templateAttachmentsTitle' + idx).style.display = 'block';
1705
1706         var basket = document.getElementById('addedTemplateAttachments' + idx);
1707
1708         if(basket) {
1709             var index = basket.childNodes.length;
1710             if(index < 0)
1711                 index = 0;
1712         } else {
1713             index = 0;
1714         }
1715
1716         var out = "<div id='templateAttachmentCup" + idx + index + "'>" +
1717                                 // remove button
1718                                 "<img src='index.php?entryPoint=getImage&themeName=" + SUGAR.themes.theme_name + "&imageName=minus.gif' " +
1719                                         "style='cursor:pointer' align='absmiddle' onclick='SUGAR.email2.composeLayout.deleteTemplateAttachmentField(\"" +
1720                                         idx + "\",\"" + index + "\");'/>" +
1721                                 // file icon
1722                                 "<img src='index.php?entryPoint=getImage&themeName=" + SUGAR.themes.theme_name + "&imageName=attachment.gif' " + "align='absmiddle' />" +
1723                                 // templateAttachment field
1724                                 "<input type='hidden' value='" + "' name='templateAttachment" + idx + index + "' id='templateAttachment" + idx + index + "' />" +
1725                                 // docId field
1726                                 "<input type='hidden' value='" + "' name='templateAttachmentId" + idx + index + "' id='templateAttachmentId" + idx + index + "' />" +
1727                                 // file name
1728                                 "<span id='templateAttachmentName"  + idx + index + "'" + ">&nbsp;</span>" +
1729                                 "<br id='br" + index + "></br>" +
1730                                 "<br id='brdoc" + index + "></br>" +
1731                         "</div>";
1732                 basket.innerHTML = basket.innerHTML + out;
1733
1734         return index;
1735     },
1736
1737     /**
1738      * Sends one email via async call
1739      * @param int idx Editor instance ID
1740      * @param bool isDraft
1741      */
1742     sendEmail : function(idx, isDraft) {
1743
1744         //If the outbound account has an error message associate with it, alert the user and refuse to continue.
1745         var obAccountID = document.getElementById('addressFrom' + idx).value;
1746
1747         if( typeof(SUGAR.email2.composeLayout.outboundAccountErrors[obAccountID]) != 'undefined' )
1748         {
1749             overlay(app_strings.LBL_EMAIL_ERROR_DESC, SUGAR.email2.composeLayout.outboundAccountErrors[obAccountID], 'alert');
1750             return false;
1751         }
1752
1753
1754         var form = document.getElementById('emailCompose' + idx);
1755         var composeOptionsFormName = "composeOptionsForm" + idx;
1756
1757         
1758         var t = SE.util.getTiny(SE.tinyInstances.currentHtmleditor);
1759         if (t != null || typeof(t) != "undefined") {
1760             var html = t.getContent();
1761         } else {
1762             var html = "<p>" + document.getElementById('htmleditor' + idx).value + "</p>";
1763         }
1764
1765             var subj = document.getElementById('emailSubject' + idx).value;
1766         var to = trim(document.getElementById('addressTO' + idx).value);
1767         var cc = trim(document.getElementById('addressCC' + idx).value);
1768         var bcc = trim(document.getElementById('addressBCC' + idx).value);
1769         var email_id = document.getElementById('email_id' + idx).value;
1770         var composeType = document.getElementById('composeType').value;
1771         var parent_type = document.getElementById("parent_type").value;
1772         var parent_id = document.getElementById("parent_id").value;
1773
1774         var el_uid = document.getElementById("uid");
1775         var uid = (el_uid == null) ? '' : el_uid.value;
1776
1777         var el_ieId = document.getElementById("ieId");
1778         var ieId = (el_ieId == null) ? '' : el_ieId.value;
1779
1780         var el_mbox = document.getElementById("mbox");
1781         var mbox = (el_mbox == null) ? '' : el_mbox.value;
1782
1783         if (!isValidEmail(to) || !isValidEmail(cc) || !isValidEmail(bcc)) {
1784                         alert(app_strings.LBL_EMAIL_COMPOSE_INVALID_ADDRESS);
1785                 return false;
1786         }
1787
1788         if (!SE.composeLayout.isParentTypeAndNameValid(idx)) {
1789                 return;
1790         } // if
1791                 var parentTypeValue = document.getElementById('data_parent_type' + idx).value;
1792                 var parentIdValue = document.getElementById('data_parent_id' + idx).value;
1793         parent_id = parentIdValue;
1794         parent_type = parentTypeValue;
1795
1796         var in_draft = (document.getElementById('type' + idx).value == 'draft') ? true : false;
1797         // baseline viability check
1798
1799         if(to == "" && cc == '' && bcc == '' && !isDraft) {
1800             alert(app_strings.LBL_EMAIL_COMPOSE_ERR_NO_RECIPIENTS);
1801             return false;
1802         } else if(subj == '' && !isDraft) {
1803             if(!confirm(app_strings.LBL_EMAIL_COMPOSE_NO_SUBJECT)) {
1804                 return false;
1805             } else {
1806                 subj = app_strings.LBL_EMAIL_COMPOSE_NO_SUBJECT_LITERAL;
1807             }
1808         } else if(html == '' && !isDraft) {
1809             if(!confirm(app_strings.LBL_EMAIL_COMPOSE_NO_BODY)) {
1810                 return false;
1811             }
1812         }
1813
1814         SE.util.clearHiddenFieldValues('emailCompose' + idx);
1815                 document.getElementById('data_parent_id' + idx).value = parentIdValue;
1816                 var title = (isDraft) ? app_strings.LBL_EMAIL_SAVE_DRAFT : app_strings.LBL_EMAIL_SENDING_EMAIL;
1817         overlay(title, app_strings.LBL_EMAIL_ONE_MOMENT);
1818         html = html.replace(/&lt;/ig, "sugarLessThan");
1819         html = html.replace(/&gt;/ig, "sugarGreaterThan");
1820
1821         form.sendDescription.value = html;
1822         form.sendSubject.value = subj;
1823         form.sendTo.value = to;
1824         form.sendCc.value = cc;
1825         form.sendBcc.value = bcc;
1826         form.email_id.value = email_id;
1827         form.composeType.value = composeType;
1828         form.composeLayoutId.value = 'composeLayout' + idx;
1829         form.setEditor.value = (document.getElementById('setEditor' + idx).checked == false) ? 1 : 0;
1830         form.saveToSugar.value = 1;
1831         form.fromAccount.value = document.getElementById('addressFrom' + idx).value;
1832         form.parent_type.value = parent_type;
1833         form.parent_id.value = parent_id;
1834         form.uid.value = uid;
1835         form.ieId.value = ieId;
1836         form.mbox.value = mbox;
1837
1838         // email attachments
1839         var addedFiles = document.getElementById('addedFiles' + idx);
1840         if(addedFiles) {
1841             for(i=0; i<addedFiles.childNodes.length; i++) {
1842                 var bucket = addedFiles.childNodes[i];
1843
1844                 for(j=0; j<bucket.childNodes.length; j++) {
1845                     var node = bucket.childNodes[j];
1846                     var nName = new String(node.name);
1847
1848                     if(node.type == 'hidden' && nName.match(/email_attachment/)) {
1849                         if(form.attachments.value != '') {
1850                             form.attachments.value += "::";
1851                         }
1852                         form.attachments.value += node.value;
1853                     }
1854                 }
1855             }
1856         }
1857
1858         // sugar documents
1859         var addedDocs = document.getElementById('addedDocuments' + idx);
1860         if(addedDocs) {
1861             for(i=0; i<addedDocs.childNodes.length; i++) {
1862                 var cNode = addedDocs.childNodes[i];
1863                 for(j=0; j<cNode.childNodes.length; j++) {
1864                     var node = cNode.childNodes[j];
1865                     var nName = new String(node.name);
1866                     if(node.type == 'hidden' && nName.match(/documentId/)) {
1867                         if(form.documents.value != '') {
1868                             form.documents.value += "::";
1869                         }
1870                         form.documents.value += node.value;
1871                     }
1872                 }
1873             }
1874         }
1875
1876         // template attachments
1877         var addedTemplateAttachments = document.getElementById('addedTemplateAttachments' + idx);
1878         if(addedTemplateAttachments) {
1879             for(i=0; i<addedTemplateAttachments.childNodes.length; i++) {
1880                 var cNode = addedTemplateAttachments.childNodes[i];
1881                 for(j=0; j<cNode.childNodes.length; j++) {
1882                     var node = cNode.childNodes[j];
1883                     var nName = new String(node.name);
1884                     if(node.type == 'hidden' && nName.match(/templateAttachmentId/)) {
1885                         if(form.templateAttachments.value != "") {
1886                             form.templateAttachments.value += "::";
1887                         }
1888                         form.templateAttachments.value += node.value;
1889                     }
1890                 }
1891             }
1892         }
1893
1894         // remove attachments
1895         form.templateAttachmentsRemove.value = document.getElementById("templateAttachmentsRemove" + idx).value;
1896
1897         YAHOO.util.Connect.setForm(form);
1898
1899         AjaxObject.target = 'frameFlex';
1900
1901         // sending a draft email
1902         if(!isDraft && in_draft) {
1903             // remove row
1904             SE.listView.removeRowByUid(email_id);
1905         }
1906
1907         var sendCallback = (isDraft) ? AjaxObject.composeLayout.callback.saveDraft : callbackSendEmail;
1908         var emailUiAction = (isDraft) ? "&emailUIAction=sendEmail&saveDraft=true" : "&emailUIAction=sendEmail";
1909
1910         AjaxObject.startRequest(sendCallback, urlStandard + emailUiAction);
1911     },
1912
1913     /**
1914      * Handles clicking the email address link from a given view
1915      */
1916     composePackage : function() {
1917         if(composePackage != null) {
1918             SE.composeLayout.c0_composeNewEmail();
1919
1920
1921             if(composePackage.to_email_addrs) {
1922                 document.getElementById("addressTO" + SE.composeLayout.currentInstanceId).value = composePackage.to_email_addrs;
1923             } // if
1924             if (composePackage.subject != null && composePackage.subject.length > 0) {
1925                 document.getElementById("emailSubject" + SE.composeLayout.currentInstanceId).value = composePackage.subject;
1926             }
1927
1928             //If no parent fields are set in the composePackage, ensure they are cleared.
1929             var parentFields = ['parent_type','parent_name','parent_id'];
1930             for(var i=0;i<parentFields.length;i++)
1931             {
1932                 if ( typeof(composePackage[parentFields[i]]) == 'undefined' )
1933                     composePackage[parentFields[i]] = "";
1934             }
1935
1936             document.getElementById("parent_type").value = composePackage.parent_type;
1937             document.getElementById('data_parent_type' + SE.composeLayout.currentInstanceId).value = composePackage.parent_type;
1938             document.getElementById("parent_id").value = composePackage.parent_id;
1939             document.getElementById('data_parent_id' + SE.composeLayout.currentInstanceId).value = composePackage.parent_id;
1940             document.getElementById('data_parent_name' + SE.composeLayout.currentInstanceId).value = composePackage.parent_name;
1941
1942             if(composePackage.email_id != null && composePackage.email_id.length > 0) {
1943                 document.getElementById("email_id" + SE.composeLayout.currentInstanceId).value = composePackage.email_id;
1944             } // if
1945             if (composePackage.body != null && composePackage.body.length > 0) {
1946                         var tiny = SE.util.getTiny('htmleditor' + SE.composeLayout.currentInstanceId);
1947                         SE.composeLayout.loadedTinyInstances[SE.composeLayout.currentInstanceId] = false;
1948                         setTimeout("SE.composeLayout.setContentOnThisTiny();", 3000);
1949             } // if
1950             if (composePackage.attachments != null) {
1951                                 SE.composeLayout.loadAttachments(composePackage.attachments);
1952             } // if
1953
1954             if (composePackage.fromAccounts != null && composePackage.fromAccounts.status) {
1955                                 var addressFrom = document.getElementById('addressFrom' + SE.composeLayout.currentInstanceId);
1956                         SE.util.emptySelectOptions(addressFrom);
1957                         var fromAccountOpts = composePackage.fromAccounts.data;
1958                         for(i=0; i<fromAccountOpts.length; i++) {
1959                               var key = fromAccountOpts[i].value;
1960                               var display = fromAccountOpts[i].text;
1961                               var opt = new Option(display, key);
1962                               if (fromAccountOpts[i].selected) {
1963                                 opt.selected = true;
1964                               }
1965                               addressFrom.options.add(opt);
1966                         }
1967
1968             } // if
1969         } // if
1970     },
1971
1972     setContentOnThisTiny : function() {
1973         var tiny = SE.util.getTiny('htmleditor' + SE.composeLayout.currentInstanceId);
1974         var tinyHTML = tiny.getContent();
1975         composePackage.body = decodeURI(encodeURI(composePackage.body));
1976         // cn: bug 14361 - text-only templates don't fill compose screen
1977         if(composePackage.body == '') {
1978             composePackage.body = decodeURI(encodeURI(composePackage.body)).replace(/<BR>/ig, '\n').replace(/<br>/gi, "\n").replace(/&amp;/gi,'&').replace(/&lt;/gi,'<').replace(/&gt;/gi,'>').replace(/&#039;/gi,'\'').replace(/&quot;/gi,'"');
1979         } // if
1980         //Flag determines if we should clear the tiny contents or just append
1981         if (typeof(composePackage.clearBody) != 'undefined' && composePackage.clearBody)
1982             SE.composeLayout.tinyHTML = '';
1983         else
1984             SE.composeLayout.tinyHTML = tinyHTML + composePackage.body;
1985
1986          tiny.setContent(SE.composeLayout.tinyHTML);
1987          //Indicate that the contents has been loaded successfully.
1988          SE.composeLayout.loadedTinyInstances[SE.composeLayout.currentInstanceId] = true;
1989     },
1990     /**
1991      * Confirms closure of a compose screen if "x" is clicked
1992      */
1993     confirmClose : function(panel) {
1994         if(confirm(app_strings.LBL_EMAIL_CONFIRM_CLOSE)) {
1995             SE.composeLayout.closeCompose(panel.id);
1996             return true;
1997         } else {
1998             return false;
1999         }
2000     },
2001
2002     /**
2003      * forces close of a compose screen
2004      */
2005     forceCloseCompose : function(id) {
2006         SE.composeLayout.closeCompose(id);
2007
2008         // handle flow back to originating view
2009         if(composePackage) {
2010             // check if it's a module we need to return to
2011             if(composePackage.return_module && composePackage.return_action && composePackage.return_id) {
2012                 if(confirm(app_strings.LBL_EMAIL_RETURN_TO_VIEW)) {
2013                     var url = "index.php?module=" + composePackage.return_module + "&action=" + composePackage.return_action + "&record=" + composePackage.return_id;
2014                     window.location = url;
2015                 }
2016             }
2017         }
2018     },
2019
2020     /**
2021      * closes the editor that just sent email
2022      * @param string id ID of composeLayout tab
2023      */
2024     closeCompose : function(id) {
2025         // destroy tinyMCE instance
2026         var idx = id.substr(13, id.length);
2027         var instanceId = "htmleditor" + idx;
2028         tinyMCE.execCommand('mceRemoveControl', false, instanceId);
2029
2030         // nullify DOM and namespace values.
2031         inCompose = false;
2032         SE.composeLayout[idx] = null;
2033         SE.tinyInstances[instanceId] = null;
2034         var tabsArray = SE.innerLayout.get("tabs");
2035         for (i = 0 ; i < tabsArray.length ; i++) {
2036                 if (tabsArray[i].get("id") == ('composeTab' + idx)) {
2037                         tabsArray[i].close();
2038                         break;
2039                 }
2040         }
2041         //SE.innerLayout.getTab(idx).close();
2042     },
2043
2044     /**
2045     *  Enable the quick search for the compose relate field or search tab
2046     */
2047     enableQuickSearchRelate: function(idx,overides){
2048
2049         if(typeof overides != 'undefined')
2050         {
2051             var newModuleID = overides['moduleSelectField']; //data_parent_type_search
2052             var newModule = document.getElementById(newModuleID).value;
2053             var formName = overides['formName'];
2054             var fieldName = overides['fieldName'];
2055             var fieldId = overides['fieldId'];
2056             var fullName = formName + "_" + fieldName;
2057             var postBlurFunction = null;
2058         }
2059         else
2060         {
2061             var newModule = document.getElementById('data_parent_type'+idx).value;
2062             var formName = 'emailCompose'+idx;
2063             var fieldName = 'data_parent_name'+idx;
2064             var fieldId = 'data_parent_id'+idx;
2065             var fullName = formName + "_" + fieldName;
2066             var postBlurFunction = "SE.composeLayout.qsAddAddress";
2067         }
2068
2069         if(typeof sqs_objects == 'undefined')
2070             window['sqs_objects'] = new Array;
2071
2072         window['sqs_objects'][fullName] = {
2073             form:formName,
2074                         method:"query",
2075                         modules:[newModule],
2076                         group:"or",
2077             field_list:["name","id", "email1"],populate_list:[fieldName,fieldId],required_list:[fieldId],
2078             conditions:[{name:"name",op:"like_custom",end:"%",value:""}],
2079                         post_onblur_function: postBlurFunction,
2080             order:"name","limit":"30","no_match_text":"No Match"};
2081
2082
2083         if(typeof QSProcessedFieldsArray != 'undefined')
2084                 QSProcessedFieldsArray[fullName] = false;
2085         if (typeof(QSFieldsArray) != 'undefined' && typeof(QSFieldsArray[fullName]) != 'undefined') {
2086                 QSFieldsArray[fullName].destroy();
2087                 delete QSFieldsArray[fullName];
2088         }
2089         if (Dom.get(fullName + "_results")) {
2090                 Dom.get(fullName + "_results").parentNode.removeChild(Dom.get(fullName + "_results"));
2091         }
2092
2093         enableQS(false);
2094     },
2095
2096         qsAddAddress : function(o) {
2097         if (o.name != "" && o.email1 != "")
2098         {
2099                 var target = Dom.get("addressTO" + SE.composeLayout.currentInstanceId);
2100                 target.value = SE.addressBook.smartAddEmailAddressToComposeField(target.value, o.name + "<" + o.email1 + ">");
2101         }
2102     },
2103     /**
2104      * Returns a new instance ID, 0-index
2105      */
2106     getNewInstanceId : function() {
2107         this.currentInstanceId = this.currentInstanceId + 1;
2108         return this.currentInstanceId;
2109     },
2110
2111     /**
2112      * Takes an array of objects that contain the filename and GUID of a Note (attachment or Sugar Document) and applies the values to the compose screen.  Valid use-cases are applying an EmailTemplate or resuming a Draft Email.
2113      */
2114     loadAttachments : function(result) {
2115         var idx = SE.composeLayout.currentInstanceId;
2116
2117         if(typeof(result) == 'object') {
2118                 //jchi #20680. Clean the former template attachments;
2119                 var basket = document.getElementById('addedTemplateAttachments' + idx);
2120                         if(basket.innerHTML != ''){
2121                                 confirm(mod_strings.LBL_CHECK_ATTACHMENTS, mod_strings.LBL_HAS_ATTACHMENTS, function(btn){
2122                                         if (btn != 'yes'){
2123                                                 basket.innerHTML = '';
2124                                         }
2125                                 });
2126                         }
2127             for(i in result) {
2128                 if(typeof result[i] == 'object') {
2129                     var index = SE.composeLayout.addTemplateAttachmentField(idx);
2130                     var bean = result[i];
2131                     document.getElementById('templateAttachmentId' + idx + index).value = bean['id'];
2132                     document.getElementById('templateAttachmentName' + idx + index).innerHTML += bean['filename'];
2133                 }
2134             }
2135         }
2136     },
2137
2138     /**
2139      * fills drop-down values for email templates and signatures
2140      */
2141     setComposeOptions : function(idx) {
2142         // send from accounts
2143         var addressFrom = document.getElementById('addressFrom' + idx);
2144
2145         if (addressFrom.options.length <= 0) {
2146                 SE.util.emptySelectOptions(addressFrom);
2147                 var fromAccountOpts = SE.composeLayout.fromAccounts;
2148                 for (id = 0 ; id < fromAccountOpts.length ; id++) {
2149                       var key = fromAccountOpts[id].value;
2150                       var display = fromAccountOpts[id].text;
2151                       var is_default = false;
2152                       if(key == SUGAR.default_inbound_accnt_id)
2153                         is_default = true;
2154                       var opt = new Option(display, key);
2155                       addressFrom.options.add(opt);
2156                       addressFrom.options[id].selected = is_default; //Safari bug new Option(x,y,true) does not work.
2157                 }
2158         }
2159
2160         // email templates
2161         var et = document.getElementById('email_template' + idx);
2162         SE.util.emptySelectOptions(et);
2163
2164         for(var key in this.emailTemplates) { // iterate through assoc array
2165             var display = this.emailTemplates[key];
2166             var opt = new Option(display, key);
2167             et.options.add(opt);
2168         }
2169
2170         // signatures
2171         var sigs = document.getElementById('signatures' + idx);
2172         SE.util.emptySelectOptions(sigs);
2173
2174         for(var key in this.signatures) { // iterate through assoc array
2175             var display = this.signatures[key];
2176             var opt = new Option(display, key);
2177
2178             if(key == SE.userPrefs.signatures.signature_default) {
2179                 opt.selected = true;
2180             }
2181
2182             sigs.options.add(opt);
2183         }
2184
2185         // html/plain email?
2186         var htmlEmail = document.getElementById('setEditor' + idx);
2187         if(SE.userPrefs.emailSettings.sendPlainText == 1) {
2188             htmlEmail.checked = true;
2189         } else {
2190                 htmlEmail.checked = false;
2191         }
2192
2193         SE.tinyInstances[SE.tinyInstances.currentHtmleditor].ready = true;
2194     },
2195
2196     /**
2197      * After compose screen is rendered, async call to get email body from Sugar
2198      */
2199     replyForwardEmailStage2 : function() {
2200         SE.util.clearHiddenFieldValues('emailUIForm');
2201         overlay(app_strings.LBL_EMAIL_RETRIEVING_MESSAGE, app_strings.LBL_EMAIL_ONE_MOMENT);
2202
2203         var ieId = SE.composeLayout.replyForwardObj.ieId;
2204         var uid = SE.composeLayout.replyForwardObj.uid;
2205         var mbox = SE.composeLayout.replyForwardObj.mbox;
2206         var type = SE.composeLayout.replyForwardObj.type;
2207         var idx = SE.composeLayout.currentInstanceId;
2208
2209         var sugarEmail = (SE.composeLayout.replyForwardObj.sugarEmail) ? '&sugarEmail=true' : "";
2210
2211         document.getElementById('emailSubject' + idx).value = type;
2212         document.getElementById('emailUIAction').value = 'composeEmail';
2213         document.getElementById('composeType').value = type;
2214         document.getElementById('ieId').value = ieId;
2215         document.getElementById('uid').value = uid;
2216         document.getElementById('mbox').value = mbox;
2217                 document.getElementById('setEditor' + idx).checked = SE.userPrefs.emailSettings.sendPlainText == 1 ? true : false;
2218         var formObject = document.getElementById('emailUIForm');
2219         YAHOO.util.Connect.setForm(formObject);
2220
2221         var sendType = type;
2222         AjaxObject.startRequest(callbackReplyForward, urlStandard + "&composeType=" + type + sugarEmail);
2223     },
2224
2225     /**
2226     *  Show the hidden cc or bcc fields
2227     */
2228     showHiddenAddress: function(addrType,idx){
2229
2230         Dom.removeClass(addrType+"_tr"+idx, "yui-hidden");
2231         Dom.addClass(addrType+"_span"+idx, "yui-hidden");
2232                 Dom.addClass("bcc_cc_sep"+idx, "yui-hidden");
2233                 this[addrType+'Hidden'+idx] = false;
2234
2235                 //After bcc or cc is added, move options below last addr field
2236                 Dom.insertAfter("add_addr_options_tr"+idx, 'bcc_tr'+idx);
2237
2238                 //If both cc and bcc hidden, remove the empty row containing text.
2239                 if( ( typeof(this['ccHidden'+idx]) != 'undefined' && typeof(this['bccHidden'+idx]) != 'undefined')
2240                            && ( this['ccHidden'+idx]  == false && this['bccHidden'+idx] == false) )
2241                         Dom.addClass("add_addr_options_tr"+idx, "yui-hidden");
2242
2243                 // SE.composeLayout.resizeEditor(idx);
2244     },
2245     /**
2246     *  Hide the cc and bcc fields if they were shown.
2247     */
2248     hideHiddenAddresses: function(idx){
2249
2250         var addrTypes = ['cc','bcc'];
2251         for(var i = 0;i<addrTypes.length;i++)
2252         {
2253             Dom.addClass(addrTypes[i] + "_tr"+idx, "yui-hidden");
2254             Dom.removeClass(addrTypes[i] + "_span"+idx, "yui-hidden");
2255             this[addrTypes[i] + 'Hidden'+idx] = true
2256         }
2257
2258         Dom.removeClass("bcc_cc_sep"+idx, "yui-hidden");
2259         Dom.removeClass("add_addr_options_tr"+idx, "yui-hidden");
2260         Dom.insertBefore("add_addr_options_tr"+idx, 'bcc_tr'+idx);
2261     }
2262 };
2263
2264 ////    END SE.composeLayout
2265 ///////////////////////////////////////////////////////////////////////////////
2266 ///////////////////////////////////////////////////////////////////////////////
2267 ////    SE.util
2268 SE.util = {
2269     /**
2270      * Cleans serialized UID lists of duplicates
2271      * @param string
2272      * @return string
2273      */
2274     cleanUids : function(str) {
2275         var seen = new Object();
2276         var clean = "";
2277         var arr = new String(str).split(",");
2278
2279         for(var i=0; i<arr.length; i++) {
2280             if(seen[arr[i]]) {
2281                 continue;
2282             }
2283
2284             clean += (clean != "") ? "," : "";
2285             clean += arr[i];
2286             seen[arr[i]] = true;
2287         }
2288
2289         return clean;
2290     },
2291
2292     /**
2293      * Clears hidden field values
2294      * @param string id ID of form element to clear
2295      */
2296     clearHiddenFieldValues : function(id) {
2297         var form = document.getElementById(id);
2298
2299         for(i=0; i<form.elements.length; i++) {
2300             if(form.elements[i].type == 'hidden') {
2301                 var e = form.elements[i];
2302                 if(e.name != 'action' && e.name != 'module' && e.name != 'to_pdf') {
2303                     e.value = '';
2304                 }
2305             }
2306         }
2307     },
2308
2309     /**
2310      * Reduces a SELECT drop-down to 0 items to prepare for new ones
2311      */
2312     emptySelectOptions : function(el) {
2313         if(el) {
2314             for(i=el.childNodes.length - 1; i >= 0; i--) {
2315                 if(el.childNodes[i]) {
2316                     el.removeChild(el.childNodes[i]);
2317                 }
2318             }
2319         }
2320     },
2321
2322     /**
2323      * Returns the MBOX path in the manner php_imap expects:
2324      * ie: INBOX.DEBUG.test
2325      * @param string str Current serialized value, Home.personal.test.INBOX.DEBUG.test
2326      */
2327     generateMboxPath : function(str) {
2328         var ex = str.split("::");
2329
2330         /* we have a serialized MBOX path */
2331         if(ex.length > 1) {
2332             var start = false;
2333             var ret = '';
2334             for(var i=0; i<ex.length; i++) {
2335                 if(ex[i] == 'INBOX') {
2336                     start = true;
2337                 }
2338
2339                 if(start == true) {
2340                     if(ret != "") {
2341                         ret += ".";
2342                     }
2343                     ret += ex[i];
2344                 }
2345             }
2346         } else {
2347             /* we have a Sugar folder GUID - do nothing */
2348             return str;
2349         }
2350
2351         return ret;
2352     },
2353
2354     /**
2355      * returns a SUGAR GUID by navigating the DOM tree a few moves backwards
2356      * @param HTMLElement el
2357      * @return string GUID of found element or empty on failure
2358      */
2359     getGuidFromElement : function(el) {
2360         var GUID = '';
2361         var iterations = 4;
2362         var passedEl = el;
2363
2364         // upwards
2365         for(var i=0; i<iterations; i++) {
2366             if(el) {
2367                 if(el.id.match(SE.reGUID)) {
2368                     return el.id;
2369                 } else {
2370                     el = el.parentNode;
2371                 }
2372             }
2373         }
2374
2375         return GUID;
2376     },
2377
2378     /**
2379      * Returns the ID value for the current in-focus, active panel (in the innerLayout, not complexLayout)
2380      * @return string
2381      */
2382     getPanelId : function() {
2383         return SE.innerLayout.get("activeTab").id ? SE.innerLayout.get("activeTab").id : "Preview";
2384     },
2385
2386     /**
2387      * wrapper to handle weirdness with IE
2388      * @param string instanceId
2389      * @return tinyMCE Controller object
2390      */
2391     getTiny : function(instanceId) {
2392         if(instanceId == '') {
2393             return null;
2394         }
2395
2396         var t = tinyMCE.getInstanceById(instanceId);
2397
2398         if(this.isIe()) {
2399             this.sleep(200);
2400             YAHOO.util.Event.onContentReady(instanceId, function(t) { return t; });
2401         }
2402         return t;
2403     },
2404
2405     /**
2406      * Simple check for MSIE browser
2407      * @return bool
2408      */
2409     isIe : function() {
2410         var nav = new String(navigator.appVersion);
2411         if(nav.match(/MSIE/)) {
2412             return true;
2413         }
2414         return false;
2415     },
2416
2417     /**
2418      * Recursively removes an element from the DOM
2419      * @param HTMLElement
2420      */
2421     removeElementRecursive : function(el) {
2422         this.emptySelectOptions(el);
2423     },
2424
2425     /**
2426      * Fakes a sleep
2427      * @param int
2428      */
2429     sleep : function(secs) {
2430         setTimeout("void(0);", secs);
2431     },
2432
2433     /**
2434      * Converts a <select> element to an Ext.form.combobox
2435      */
2436      convertSelect : function(select) {
2437        alert('in convertSelect');
2438        if (typeof(select) == "string") {
2439            select = document.getElementById(select);
2440        }
2441      },
2442
2443      findChildNode : function (parent, property, value) {
2444          for (i in parent.children) {
2445                  var child = parent.children[i];
2446                  if (child.data[property] && child.data[property] == value || child[property] && child[property] == value)
2447                          return child;
2448                  var searchChild = SE.util.findChildNode(child, property, value);
2449                  if (searchChild)
2450                          return searchChild;
2451          }
2452          return false;
2453      },
2454
2455      cascadeNodes : function (parent, fn, scope, args) {
2456          for (i in parent.children) {
2457                  var child = parent.children[i];
2458                  var s = scope ? scope : child;
2459                  var a = args ? args : child;
2460                  fn.call(s, a);
2461                  SE.util.cascadeNodes(child, fn, scope, args);
2462          }
2463      }
2464 };
2465
2466
2467 ////    END UTIL
2468 ///////////////////////////////////////////////////////////////////////////////
2469
2470
2471 })();//End namespace