{"id":2225,"date":"2020-07-22T11:43:00","date_gmt":"2020-07-22T08:43:00","guid":{"rendered":"https:\/\/guvensahin.com\/?p=2225"},"modified":"2020-07-29T23:49:44","modified_gmt":"2020-07-29T20:49:44","slug":"dynamics-365-fo-events","status":"publish","type":"post","link":"https:\/\/guvensahin.com\/tr\/dynamics-365-fo-events\/","title":{"rendered":"Dynamics 365 F&O – Events"},"content":{"rendered":"\n

Bu yaz\u0131da Dynamics 365 Finance and Operations da yeni tan\u0131\u015ft\u0131\u011f\u0131m\u0131z ve extensibility framework<\/a>‘\u00fcn bir par\u00e7as\u0131 olan event kavram\u0131ndan bahsece\u011fim. Hem tablo-form gibi \u00e7e\u015fitli objelerin \u00fczerinde g\u00f6rd\u00fc\u011f\u00fcm\u00fcz event<\/strong>‘lerden hem de methodlar i\u00e7in kullan\u0131lan pre-post event<\/strong>‘lere de\u011finece\u011fiz.<\/p>\n\n\n\n

1. Event Nedir ?<\/h2>\n\n\n\n

Ad\u0131ndan da anla\u015f\u0131labilece\u011fi gibi \u00e7e\u015fitli durumlarda tetiklenen yer tutuculard\u0131r. \u00d6rne\u011fin bir tabloya kay\u0131t eklendi\u011finde OnInserted<\/strong> event’i tetiklenir. Kay\u0131t silindi\u011finde OnDeleted<\/strong> \u00e7al\u0131\u015f\u0131r. Siz ihtiyac\u0131n\u0131za uygun olan\u0131 se\u00e7ip, kullanabilirsiniz. Neredeyse her event standartta var olan ve override ederek kulland\u0131\u011f\u0131m\u0131z sistem methodlar\u0131na kar\u015f\u0131l\u0131k gelir. \u00d6rne\u011fin insert methodunun super \u00f6ncesi i\u00e7in OnInserting, super sonras\u0131 i\u00e7in OnInserted event’i bulunur.<\/p>\n\n\n\n

Kullan\u0131m\u0131<\/h3>\n\n\n\n

D365 F&O i\u00e7inde tablo-form gibi \u00e7e\u015fitli objelerde Events<\/strong> isminde bir b\u00f6l\u00fcm oldu\u011funu g\u00f6rm\u00fc\u015fs\u00fcn\u00fczd\u00fcr. Bu b\u00f6l\u00fcm, o obje i\u00e7in kullanabilece\u011finiz event listesini i\u00e7erir. Her obje i\u00e7in bu liste farkl\u0131d\u0131r. Listede ilgili event \u00fczerine gelip sa\u011f t\u0131k > kopyala diyerek ald\u0131\u011f\u0131n\u0131z kodu, yeni olu\u015fturdu\u011funuz bir s\u0131n\u0131f\u0131n i\u00e7ine yap\u0131\u015ft\u0131rarak kullanabilirsiniz. Yap\u0131\u015ft\u0131rd\u0131\u011f\u0131n\u0131z method’un i\u00e7ini kendinize uygun \u015fekilde doldurduktan sonra de\u011fi\u015fikliklerin yans\u0131mas\u0131 i\u00e7in Visual Studio’yu build etmeniz yeterli.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

\u00d6rnekler<\/h3>\n\n\n\n

Event’lerde this<\/strong> yada element<\/strong> gibi \u00f6zel ifadeleri direkt kullanam\u0131yorsunuz. Bu sebeple a\u015fa\u011f\u0131da en \u00e7ok kullanaca\u011f\u0131n\u0131z objeler i\u00e7in \u00e7e\u015fitli \u00f6rnek kodlar ekledim.<\/p>\n\n\n\n

\u00d6zellikle form event’lerinin kullan\u0131m\u0131 ba\u015flarda kar\u0131\u015f\u0131k gelebilir. Form i\u00e7indeki di\u011fer objelere nas\u0131l eri\u015fece\u011finizi anlayabilmeniz i\u00e7in a\u015fa\u011f\u0131daki \u00f6rnek kodlar\u0131 inceleyebilirsiniz.<\/p>\n\n\n\n

Tablo \u00d6rnek 1 – Updating<\/h4>\n\n\n\n
[DataEventHandler(tableStr(TrvRequisitionTable), DataEventType::Updating)]\npublic static void TrvRequisitionTable_onUpdating(Common sender, DataEventArgs e)\n{\n\tTrvRequisitionTable trvRequisitionTable = sender;\n\n\tif (trvRequisitionTable.orig()\n\t\t&& trvRequisitionTable.orig().GvnField != trvRequisitionTable.GvnField)\n\t{\n\t\t\/\/ do something\n\t}\n}<\/code><\/pre>\n\n\n\n
Tablo \u00d6rnek 2 – ValidateWrite<\/h4>\n\n\n\n
[DataEventHandler(tableStr(TrvRequisitionTable), DataEventType::ValidatingWrite)]\npublic static void TrvRequisitionTable_onValidatingWrite(Common sender, DataEventArgs e)\n{\n\tValidateEventArgs   validateEventArgs   = e as ValidateEventArgs;\n\tboolean             ret                 = validateEventArgs.parmValidateResult();\n\tTrvRequisitionTable trvRequisitionTable = sender;\n\t\n\tif (ret\n\t\t&& !trvRequisitionTable.TravelPurpose)\n\t{\n\t\tret = checkFailed(strFmt(\"@GVN:TravelPurposeEmpty\"));\n\t}\n\n\tif (ret\n\t\t&& trvRequisitionTable.GvnEndDateTime\n\t\t&& trvRequisitionTable.GvnStartDateTime\n\t\t&& trvRequisitionTable.GvnEndDateTime < trvRequisitionTable.GvnStartDateTime)\n\t{\n\t\tret = checkFailed(\"@GVN:StartEndDateError\");\n\t}\n\n\tvalidateEventArgs.parmValidateResult(ret);\n}<\/code><\/pre>\n\n\n\n
Form – Initialized<\/h4>\n\n\n\n
[FormEventHandler(formStr(TrvExpenses), FormEventType::Initialized)]\npublic static void TrvExpenses_OnInitialized(xFormRun sender, FormEventArgs e)\n{\n\tFormDataSource  trvExpTableDs   = sender.dataSource(formDataSourceStr(TrvExpenses, TrvExpTable));\n\tTrvExpTable     trvExpTable     = trvExpTableDs.cursor();\n\tFormDataSource  trvExpTransDs   = sender.dataSource(formDataSourceStr(TrvExpenses, TrvExpTrans));\n\tFormDesign      design          = sender.design();\n\n\t\/\/ field gizlili\u011fi\n\ttrvExpTableDs.object(fieldNum(TrvExpTable, MyField)).visible(false);\n\n\t\/\/ buton gizlili\u011fi\n\tdesign.controlName(formControlStr(TrvExpenses, GvnDummyButton)).enabled(false);\n\n\t\/\/ dataSource\n\ttrvExpTransDs.allowCreate(false);\n\ttrvExpTransDs.allowDelete(false);\n\ttrvExpTransDs.allowEdit(false);\n}<\/code><\/pre>\n\n\n\n
FormDataSource – Activated<\/h4>\n\n\n\n
[FormDataSourceEventHandler(formDataSourceStr(TrvRequisition, TrvRequisitionTable), FormDataSourceEventType::Activated)]\npublic static void TrvRequisitionTable_OnActivated(FormDataSource sender, FormDataSourceEventArgs e)\n{\n\tsender.object(fieldNum(TrvRequisitionTable, GvnDummyField)).visible(trvRequisitionTable.CurrencyCode != \"\");\n}<\/code><\/pre>\n\n\n\n
FormDataSource Field – Modified<\/h4>\n\n\n\n
[FormDataFieldEventHandler(formDataFieldStr(TrvCashAdvances, TrvCashAdvance, GvnWorker), FormDataFieldEventType::Modified)]\npublic static void GvnWorker_OnModified(FormDataObject sender, FormDataFieldEventArgs e)\n{\n\tFormDataSource formDs = sender.datasource();\n\tTrvCashAdvance trvCashAdvance = formDs.cursor();\n\t\n\t\/\/ do something\n}<\/code><\/pre>\n\n\n\n
FormControl – Lookup<\/h4>\n\n\n\n
Lookup ile ilgili detayl\u0131 yaz\u0131ma buradan<\/a> bakabilirsiniz.<\/p>\n\n\n\n
[FormControlEventHandler(formControlStr(TrvCashAdvances, General_GvnWorker), FormControlEventType::Lookup)]\npublic static void General_GvnWorker_OnLookup(FormControl sender, FormControlEventArgs e)\n{\n\tTrvCashAdvance          trvCashAdvance = sender.formRun().dataSource(formdatasourcestr(TrvCashAdvances, TrvCashAdvance)).cursor();\n\tQuery                   query;\n\tQueryBuildDataSource    qbds;\n\tSysReferenceTableLookup sysTableLookup;\n\n\tquery = new Query();\n\tqbds = query.addDataSource(tableNum(HcmWorker));\n\n\n\tsysTableLookup = SysReferenceTableLookup::newParameters(tableNum(HcmWorker), sender);\n\tsysTableLookup.addLookupMethod(\"name\");\n\tsysTableLookup.addLookupfield(fieldNum(HcmWorker, PersonnelNumber));\n\n\tsysTableLookup.parmQuery(query);\n\tsysTableLookup.performFormLookup();\n\n\n\tFormControlCancelableSuperEventArgs event = e;\n\tevent.CancelSuperCall();\n}<\/code><\/pre>\n\n\n\n
2. Pre-Post Event Handler<\/h2>\n\n\n\n
D365 F&O objelerinde yer alan methodlar\u0131n \u00f6ncesine veya sonras\u0131na kod yazmak i\u00e7in kullan\u0131l\u0131rlar.<\/p>\n\n\n\n
Herhangi bir tabloda, s\u0131n\u0131fta yada formda (sadece form methodlar\u0131 i\u00e7in, datasource ve design daki methodlar i\u00e7in de\u011fil) bulunan method’a sa\u011f t\u0131klay\u0131p Copy event handler method > Pre \/ Post<\/strong> diyerek kopyalad\u0131\u011f\u0131n\u0131z kodu, bir s\u0131n\u0131f i\u00e7erisine yap\u0131\u015ft\u0131r\u0131p kullanabilirsiniz. \u00d6rnek kullan\u0131mlar a\u015fa\u011f\u0131daki gibidir.<\/p>\n\n\n\n
Pre<\/h4>\n\n\n\n
[PreHandlerFor(classStr(RetailTransactionServiceCustomer), staticMethodStr(RetailTransactionServiceCustomer, updateCustomer))]\npublic static void RetailTransactionServiceCustomer_Pre_updateCustomer(XppPrePostArgs args)\n{       \n\tRetailTransactionServiceCustomer serviceCustomer = args.getThis();\n\n\t\/\/ do something\n}<\/code><\/pre>\n\n\n\n
Post<\/h4>\n\n\n\n
[PostHandlerFor(formStr(TrvCashAdvances), formMethodStr(TrvCashAdvances, init))]\npublic static void TrvCashAdvances_Post_init(XppPrePostArgs args)\n{\n\tFormRun formRun = args.getThis();\n\tFormDataSource formDs = formRun.dataSource(formdatasourcestr(TrvCashAdvances, TrvCashAdvance));\n\t\n\tformDs.object(fieldNum(TrvCashAdvance, RequestingWorker)).visible(true);\n}<\/code><\/pre>\n\n\n\n
Bilinen K\u0131s\u0131tlamalar<\/h3>\n\n\n\n