README.md

Serenity.Extra

Name of the repo says that this is an EXTRA of my Beloved https://github.com/volkanceylan/Serenity platform

It is just some useful utilities and some extra functionality like

• Showing lookup text instead of id value in grid etc.
• Automatic width adjustment of grid columns.
• Adding export report button automatically in grid if a report service method in defined.
• Added funtionality to make a detail grid editable (inline)
• Added some useful function in q (Not Q).

How to use

1. Install NuGet Package Serenity.Extra
2. Include the following lines in _LayoutHead.cshtml

@Html.Stylesheet("~/Modules/_Ext/ExtStyles.css")
@Html.Script("~/Modules/_Ext/CustomSlickGridPlugin/slick.autocolumnsize.js")
@Html.Script("~/Modules/_Ext/Editors/SerenityInlineEditors.js") 

3. Change Base/Super classes of Dialog.ts and Grid.ts using following mappings
4. Please Build solution then Transform All T4 Templates and then Run to avoid errors

Serenity Default	_Ext
Serenity.EntityGrid	_Ext.GridBase
Serenity.EntityDialog	_Ext.DialogBase
Common.GridEditorBase	_Ext.GridEditorBase
Common.EditorDialogBase	_Ext.EditorDialogBase

4. Add following line in ScriptInitialization.ts Q.Config.rootNamespaces.push('_Ext');

Examples

Setting the field's width in a dialog

simply use [CssClass("width6")] on top of the property in Form.cs. here "width6" is similar to "col-xx-6" in bootstrap

To make a detail grid inline editable

add the following code to Grid.ts

protected getSlickOptions() {
  let opt = super.getSlickOptions();
  opt.editable = true;
  return opt;
}

To hide a field in a Dialog

use q.hideField(this.form.SomeField).

To access parent/master dialog from child/detail dialog

Initialize detail editor by using q.initDetailEditor(this, this.form.someDetailField) in dialog's constructor() OR onDialogOpen() overload

Then you should be able to access parent dialog like this.parentEditor.parentDialog

Make sure that you have declared form in parent/master dialog as public

Please explore the code to know more...