js/requirement_spec.js

   1 /* Functions used for the requirement specs */
   2
   3 // -----------------------------------------------------------------------------
   4 // ------------------------------ basic settings -------------------------------
   5 // -----------------------------------------------------------------------------
   6
   7 function basic_settings_customer_changed(customer_ctrl, value_ctrl) {
   8   $.get(
   9     'controller.pl?action=Customer/get_hourly_rate',
  10     { id: $(customer_ctrl).val() },
  11     function(data) { if (data.hourly_rate_formatted) $(value_ctrl).val(data.hourly_rate_formatted); }
  12   );
  13 }
  14
  15 // -----------------------------------------------------------------------------
  16 // ------------------------------ the tree itself ------------------------------
  17 // -----------------------------------------------------------------------------
  18
  19 function requirement_spec_tree_check_move(data) {
  20   var dragged_type = data.o.data('type');
  21   var dropped_type = data.r.data('type');
  22
  23   // console.debug("dragged " + dragged_type + " dropped " + dropped_type + " dir " + data.p);
  24
  25   if ((dragged_type == "sections") || (dragged_type == "text-blocks-front") || (dragged_type == "text-blocks-back"))
  26     return false;
  27
  28   if (dragged_type == "text-block") {
  29     if ((dropped_type == "text-blocks-front") || (dropped_type == "text-blocks-back"))
  30       return (data.p == "inside") || (data.p == "last");
  31     if (dropped_type == "text-block")
  32       return (data.p == "before") || (data.p == "after");
  33
  34     return false;
  35   }
  36
  37   if (dragged_type == "section") {
  38     if (dropped_type == "sections")
  39       return (data.p == "inside") || (data.p == "last");
  40     if (dropped_type == "section")
  41       return (data.p == "before") || (data.p == "after");
  42
  43     return false;
  44   }
  45
  46   // dragged_type == (sub) function blocks
  47   if ((dropped_type == "text-block") || (dropped_type == "text-blocks-front") || (dropped_type == "text-blocks-back"))
  48     return false;
  49
  50   var dropped_depth = dropped_type == "sections" ? 0 : dropped_type == "section" ? 1 : data.r.parent().parent().data('type') != "function-block" ? 2 : 3;
  51   if ((data.p == "inside") || (data.p == "last"))
  52     dropped_depth++;
  53
  54   var dragged_depth = 1 + data.o.children('ul').size();
  55
  56   // console.debug("dropped_depth " + dropped_depth + " dragged_depth " + dragged_depth);
  57
  58   return (2 <= dropped_depth) && ((dragged_depth + dropped_depth) <= 4);
  59 }
  60
  61 function requirement_spec_tree_node_moved(event) {
  62   // console.debug("node moved");
  63   var move_obj   = $.jstree._reference('#tree')._get_move();
  64   var dragged    = move_obj.o;
  65   var dropped    = move_obj.r;
  66   var controller = dragged.data("type") == "text-block" ? "RequirementSpecTextBlock" : "RequirementSpecItem";
  67   var data       = {
  68     action:               controller + "/dragged_and_dropped",
  69     requirement_spec_id:  $('#requirement_spec_id').val(),
  70     id:                   dragged.data("id"),
  71     dropped_id:           dropped.data("id"),
  72     dropped_type:         dropped.data("type"),
  73     position:             move_obj.p,
  74     current_content_type: $('#current_content_type').val(),
  75     current_content_id:   $('#current_content_id').val()
  76   };
  77   // console.debug("controller: " + controller);
  78   // console.debug(data);
  79
  80   $.post("controller.pl", data, eval_json_result);
  81
  82   return true;
  83 }
  84
  85 function requirement_spec_tree_node_clicked(event) {
  86   var node = $.jstree._reference('#tree')._get_node(event.target);
  87   var type = node ? node.data('type') : undefined;
  88
  89   if (!type)
  90     return;
  91
  92   var url = 'controller.pl?action='
  93   $.get('controller.pl', {
  94     action:               (/^text-block/.test(type) ? 'RequirementSpecTextBlock' : 'RequirementSpecItem') + '/ajax_list.js',
  95     requirement_spec_id:  $('#requirement_spec_id').val(),
  96     current_content_type: $('#current_content_type').val(),
  97     current_content_id:   $('#current_content_id').val(),
  98     clicked_type:         type,
  99     clicked_id:           node.data('id')
 100   }, eval_json_result);
 101 }
 102
 103 // -------------------------------------------------------------------------
 104 // ------------------------------ text blocks ------------------------------
 105 // -------------------------------------------------------------------------
 106
 107 function find_text_block_id(clicked_elt) {
 108   // console.log("id: " + $(clicked_elt).attr('id'));
 109   var id = $(clicked_elt).attr('id');
 110   if (/^text-block-\d+$/.test(id)) {
 111     // console.log("find_text_block_id: case 1: " + id.substr(11));
 112     return id.substr(11) * 1;
 113   }
 114
 115   id = $(clicked_elt).closest("[id*=text-block-]").attr('id')
 116   if (/^text-block-\d+$/.test(id)) {
 117     // console.log("find_text_block_id: case 2: " + id.substr(11));
 118     return id.substr(11) * 1;
 119   }
 120
 121   id = $(clicked_elt).closest("[id*=tb-]").attr('id')
 122   if (/^tb-\d+$/.test(id)) {
 123     // console.log("find_text_block_id: case 3: " + id.substr(3));
 124     return id.substr(3) * 1;
 125   }
 126
 127   // console.log("find_text_block_id: case undef");
 128   return undefined;
 129 }
 130
 131 function find_text_block_output_position(clicked_elt) {
 132   var output_position = $(clicked_elt).closest('#text-block-list-container').find('#text_block_output_position').val();
 133   if (output_position)
 134     return output_position;
 135
 136   var type = $(clicked_elt).closest('#tb-back,#tb-front').data('type');
 137   if (/^text-blocks-(front|back)/.test(type))
 138     return type == "text-blocks-front" ? 0 : 1;
 139
 140   return undefined;
 141 }
 142
 143 function disable_edit_text_block_commands(key, opt) {
 144   return find_text_block_id(opt.$trigger) == undefined;
 145 }
 146
 147 function standard_text_block_ajax_call(key, opt, other_data) {
 148   var data = {
 149     action:               "RequirementSpecTextBlock/ajax_" + key,
 150     requirement_spec_id:  $('#requirement_spec_id').val(),
 151     id:                   find_text_block_id(opt.$trigger),
 152     output_position:      find_text_block_output_position(opt.$trigger),
 153     current_content_type: $('#current_content_type').val(),
 154     current_content_id:   $('#current_content_id').val()
 155   };
 156
 157   $.post("controller.pl", $.extend(data, other_data || {}), eval_json_result);
 158
 159   return true;
 160 }
 161
 162 function cancel_edit_text_block_form(id_base) {
 163   var id = $('#' + id_base + '_id').val();
 164   $('#' + id_base + '_form').remove();
 165   if (id)
 166     $('#text-block-' + id).show();
 167 }
 168
 169 function ask_delete_text_block(key, opt) {
 170   if (confirm(kivi.t8("Are you sure?")))
 171     standard_text_block_ajax_call(key, opt);
 172   return true;
 173 }
 174
 175 // --------------------------------------------------------------------------------
 176 // ------------------------------ sections and items ------------------------------
 177 // --------------------------------------------------------------------------------
 178
 179 function find_item_id(clicked_elt) {
 180   // console.log("clicked id: " + $(clicked_elt).attr('id'));
 181   var id     = $(clicked_elt).attr('id');
 182   var result = /^(function-block|function-block-content|sub-function-block|sub-function-block-content|section|section-header)-(\d+)$/.exec(id);
 183   if (result) {
 184     // console.log("find_item_id: case 1: " + result[2]);
 185     return result[2];
 186   }
 187
 188   id = $(clicked_elt).closest("[id*=fb-]").attr('id')
 189   if (/^fb-\d+$/.test(id)) {
 190     // console.log("find_item_id: case 2: " + id.substr(3));
 191     return id.substr(3) * 1;
 192   }
 193
 194   // console.log("find_item_id: case undef");
 195   return undefined;
 196 }
 197
 198 function standard_item_ajax_call(key, opt, other_data) {
 199   var data = {
 200     action:               "RequirementSpecItem/ajax_" + key,
 201     requirement_spec_id:  $('#requirement_spec_id').val(),
 202     id:                   find_item_id(opt.$trigger),
 203     current_content_type: $('#current_content_type').val(),
 204     current_content_id:   $('#current_content_id').val()
 205   };
 206
 207   // console.log("I would normally POST the following now:");
 208   // console.log(data);
 209   $.post("controller.pl", $.extend(data, other_data || {}), eval_json_result);
 210
 211   return true;
 212 }
 213
 214 function disable_edit_item_commands(key, opt) {
 215   return find_item_id(opt.$trigger) == undefined;
 216 }
 217
 218 function disable_add_function_block_command(key, opt) {
 219   if (find_item_id(opt.$trigger))
 220     return false;
 221   return opt.$trigger.attr('id') != "section-list-empty";
 222 }
 223
 224 function cancel_edit_item_form(form_id_base, options) {
 225   $('#' + form_id_base + '_form').remove();
 226   if (!options)
 227     return;
 228   if (options.to_show)
 229     $(options.to_show).show();
 230   if (options.to_hide_if_empty && (1 == $(options.to_hide_if_empty).children().size()))
 231     $(options.to_hide_if_empty).hide();
 232 }
 233
 234 function ask_delete_item(key, opt) {
 235   if (confirm(kivi.t8("Are you sure?")))
 236     standard_item_ajax_call(key, opt);
 237   return true;
 238 }
 239
 240 function handle_text_block_popup_menu_markings(opt, add) {
 241   var id = find_text_block_id(opt.$trigger);
 242   if (id)
 243     $('#text-block-' + id).toggleClass('selected', add);
 244   return true;
 245 }
 246
 247 function requirement_spec_text_block_popup_menu_shown(opt) {
 248   return handle_text_block_popup_menu_markings(opt, true);
 249 }
 250
 251 function requirement_spec_text_block_popup_menu_hidden(opt) {
 252   return handle_text_block_popup_menu_markings(opt, false);
 253 }
 254
 255
 256 function handle_item_popup_menu_markings(opt, add) {
 257   var id = find_item_id(opt.$trigger);
 258   if (id)
 259     $('#section-' + id + ',#function-block-' + id + ',#sub-function-block-' + id).toggleClass('selected', add);
 260   return true;
 261 }
 262
 263 function requirement_spec_item_popup_menu_shown(opt) {
 264   return handle_item_popup_menu_markings(opt, true);
 265 }
 266
 267 function requirement_spec_item_popup_menu_hidden(opt) {
 268   return handle_item_popup_menu_markings(opt, false);
 269 }
 270
 271 // -------------------------------------------------------------------------
 272 // -------------------------- time/cost estimate ---------------------------
 273 // -------------------------------------------------------------------------
 274
 275 function standard_time_cost_estimate_ajax_call(key, opt) {
 276   if ((key == 'cancel') && !confirm(kivi.t8('Do you really want to cancel?')))
 277     return true;
 278
 279   var data = "action=RequirementSpec/ajax_" + key + "_time_and_cost_estimate&";
 280
 281   if (key == 'save')
 282     data += $('#edit_time_cost_estimate_form').serialize()
 283          +  '&' + $('#current_content_type').serialize()
 284          +  '&' + $('#current_content_id').serialize();
 285   else
 286     data += 'id=' + encodeURIComponent($('#requirement_spec_id').val());
 287
 288   $.post("controller.pl", data, eval_json_result);
 289
 290   return true;
 291 }
 292
 293 // -------------------------------------------------------------------------
 294 // ---------------------------- general actions ----------------------------
 295 // -------------------------------------------------------------------------
 296
 297 function download_reqspec_pdf(key, opt) {
 298   var data = {
 299     action: "RequirementSpec/download_pdf",
 300     id:     $('#requirement_spec_id').val()
 301   };
 302   $.download("controller.pl", data);
 303 }
 304
 305 function copy_reqspec(key, opt) {
 306   window.location.href = "controller.pl?action=RequirementSpec/new&copy_source_id=" + encodeURIComponent($('#requirement_spec_id').val());
 307   return true;
 308 }
 309
 310 function delete_reqspec(key, opt) {
 311   if (confirm(kivi.t8("Are you sure?")))
 312     window.location.href = "controller.pl?action=RequirementSpec/destroy&id=" + encodeURIComponent($('#requirement_spec_id').val());
 313   return true;
 314 }
 315
 316 function disable_requirement_spec_commands(key, opt) {
 317   if (key === "create_version")
 318     return ($('#current_version_id').val() || '') == '' ? false : true;
 319   return false;
 320 }
 321
 322 // -------------------------------------------------------------------------
 323 // -------------------------------- versions -------------------------------
 324 // -------------------------------------------------------------------------
 325
 326 function create_requirement_spec_version() {
 327   open_jqm_window({ url:  'controller.pl',
 328                     data: { action:              'RequirementSpecVersion/new',
 329                             requirement_spec_id: $('#requirement_spec_id').val() },
 330                     id:   'new_requirement_spec_version_window' });
 331   return true;
 332 }
 333
 334 // -------------------------------------------------------------------------
 335 // ----------------------------- context menus -----------------------------
 336 // -------------------------------------------------------------------------
 337
 338 function create_requirement_spec_context_menus() {
 339   var general_actions = {
 340       sep98:           "---------"
 341     , general_actions: { name: kivi.t8('Requirement spec actions:') }
 342     , sep99:           "---------"
 343     , create_version:  { name: kivi.t8('Create new version'),      icon: "new",    callback: create_requirement_spec_version, disabled: disable_requirement_spec_commands }
 344     , copy_reqspec:    { name: kivi.t8('Copy requirement spec'),   icon: "copy",   callback: copy_reqspec   }
 345     , delete_reqspec:  { name: kivi.t8('Delete requirement spec'), icon: "delete", callback: delete_reqspec }
 346   };
 347
 348   $.contextMenu({
 349     selector: '#content',
 350     items:    general_actions
 351   });
 352
 353   var events = {
 354     show: requirement_spec_text_block_popup_menu_shown,
 355     hide: requirement_spec_text_block_popup_menu_hidden
 356   };
 357
 358   $.contextMenu({
 359     selector: '.text-block-context-menu',
 360     events:   {
 361         show: requirement_spec_text_block_popup_menu_shown
 362       , hide: requirement_spec_text_block_popup_menu_hidden
 363     },
 364     items:    $.extend({
 365         add:     { name: kivi.t8('Add text block'),        icon: "add",    callback: standard_text_block_ajax_call }
 366       , edit:    { name: kivi.t8('Edit text block'),       icon: "edit",   callback: standard_text_block_ajax_call, disabled: disable_edit_text_block_commands }
 367       , delete:  { name: kivi.t8('Delete text block'),     icon: "delete", callback: ask_delete_text_block,         disabled: disable_edit_text_block_commands }
 368       , sep1:    "---------"
 369       , flag:    { name: kivi.t8('Toggle marker'),         icon: "flag",   callback: standard_text_block_ajax_call, disabled: disable_edit_text_block_commands }
 370       , sep2:    "---------"
 371       , copy:    { name: kivi.t8('Copy'),                  icon: "copy",   callback: standard_text_block_ajax_call, disabled: disable_edit_text_block_commands }
 372       , paste:   { name: kivi.t8('Paste'),                 icon: "paste",  callback: standard_text_block_ajax_call  }
 373     }, general_actions)
 374   });
 375
 376   events = {
 377     show: requirement_spec_item_popup_menu_shown,
 378     hide: requirement_spec_item_popup_menu_hidden
 379   };
 380
 381   $.contextMenu({
 382     selector: '.section-context-menu',
 383     events:   events,
 384     items:    $.extend({
 385         add_section:        { name: kivi.t8('Add section'),        icon: "add",    callback: standard_item_ajax_call }
 386       , add_function_block: { name: kivi.t8('Add function block'), icon: "add",    callback: standard_item_ajax_call, disabled: disable_add_function_block_command }
 387       , sep1:               "---------"
 388       , edit:               { name: kivi.t8('Edit'),               icon: "edit",   callback: standard_item_ajax_call, disabled: disable_edit_item_commands }
 389       , delete:             { name: kivi.t8('Delete'),             icon: "delete", callback: ask_delete_item,         disabled: disable_edit_item_commands }
 390       , sep2:               "---------"
 391       , flag:               { name: kivi.t8('Toggle marker'),      icon: "flag",   callback: standard_item_ajax_call, disabled: disable_edit_item_commands }
 392       , sep3:               "---------"
 393       , copy:               { name: kivi.t8('Copy'),               icon: "copy",   callback: standard_item_ajax_call, disabled: disable_edit_item_commands }
 394       , paste:              { name: kivi.t8('Paste'),              icon: "paste",  callback: standard_item_ajax_call }
 395     }, general_actions)
 396   });
 397
 398   $.contextMenu({
 399     selector: '.function-block-context-menu,.sub-function-block-context-menu',
 400     events:   events,
 401     items:    $.extend({
 402         add_function_block:     { name: kivi.t8('Add function block'),     icon: "add",    callback: standard_item_ajax_call }
 403       , add_sub_function_block: { name: kivi.t8('Add sub function block'), icon: "add",    callback: standard_item_ajax_call }
 404       , sep1:                   "---------"
 405       , edit:                   { name: kivi.t8('Edit'),                   icon: "edit",   callback: standard_item_ajax_call, disabled: disable_edit_item_commands }
 406       , delete:                 { name: kivi.t8('Delete'),                 icon: "delete", callback: ask_delete_item,         disabled: disable_edit_item_commands }
 407       , sep2:                   "---------"
 408       , flag:                   { name: kivi.t8('Toggle marker'),          icon: "flag",   callback: standard_item_ajax_call, disabled: disable_edit_item_commands }
 409       , sep3:                   "---------"
 410       , copy:                   { name: kivi.t8('Copy'),                   icon: "copy",   callback: standard_item_ajax_call, disabled: disable_edit_item_commands }
 411       , paste:                  { name: kivi.t8('Paste'),                  icon: "paste",  callback: standard_item_ajax_call }
 412     }, general_actions)
 413   });
 414
 415   $.contextMenu({
 416     selector: '.time-cost-estimate-context-menu',
 417     events:   events,
 418     items:    $.extend({ edit: { name: kivi.t8('Edit'), icon: "edit", callback: standard_time_cost_estimate_ajax_call } }, general_actions)
 419   });
 420
 421   $.contextMenu({
 422     selector: '.edit-time-cost-estimate-context-menu',
 423     events:   events,
 424     items:    $.extend({
 425         save:   { name: kivi.t8('Save'),   icon: "save",  callback: standard_time_cost_estimate_ajax_call }
 426       , cancel: { name: kivi.t8('Cancel'), icon: "close", callback: standard_time_cost_estimate_ajax_call }
 427     }, general_actions)
 428   });
 429 }