This article is applicable for both Mobile WMS for Dynamics 365 Finance & Supply Chain, as well as the version for Dynamics AX 2012, though the example is shown as an extension, the change can be applied directly in AX 2012
In this aticle, we will explore an example on how to change the default value in the Delivery Date Field for the Receive Orders page in Mobile WMS
The content of each Header or filter pane on each Mobile WMS page is declared in our DocumentHandler classes, which is any class, that extends MobDocumentHandler. In a document handler class a filter or header can be declared as follows:
/// <summary>
/// The filter for the receive order page.
/// </summary>
/// <returns>An XML formatted string containing the filter fields.</returns>
[MobReferenceDataMethod]
public MobReferenceData ReceiveOrderFilters()
{
MobReferenceDataConfiguration refData = new MobReferenceDataConfiguration();
MobRegistrationCollectorList regCollectorList = new MobRegistrationCollectorList(5,MobConstants::Warehouse(),"@SYS6437","@SYS6437","@SYS6437");
MobRegistrationCollectorDate regCollectorDate = MobRegistrationCollector::collectorFromEDT(extendedtypestr(WMSDlvDate));
regCollectorList.parmDataTable(methodStr(MobGetReferenceData,WarehouseFilterList));
regCollectorList.parmDataKeyColumn(extendedtypestr(InventLocationId));
regCollectorList.parmDataDisplayColumn(extendedtypestr(Name));
refData.addCollector(regCollectorList);
regCollectorDate.parmName(MobConstants::DeliveryDate());
regCollectorDate.isHeader(true);
regCollectorDate.parmId(10);
regCollectorDate.parmLabel("@SYS16056");
refData.addCollector(regCollectorDate);
refData.parmUseDynaFilter(true);
return refData;
}
The above example is from the class MobDocReceiveOrder, which incidently is the class and method we will exten in this example.
Things to notice:
The method is augmented with the attribute MobReferenceDataMethod
This tells the Mobile WMS Core, that this method returns reference data, which is the category Header field traditionally has fallen under.
The method returns a MobReferenceDataConfiguration object
This object contains the Header Configuration for the page, thereby it has the fields for the header.
This is the object we need to modify to change the values and behaviour of the header fields.
Now to change the default value of the Date collector, the following extension class including method, can be made:
[ExtensionOf(classStr(MobDocReceiveOrder))]
final class MobDocReceiveOrderDate_extension
{
public MobReferenceData ReceiveOrderFilters()
{
MobReferenceDataConfiguration refData = next ReceiveOrderFilters();
SetEnumerator collectors = refData.getCollectors().getEnumerator();
MobRegistrationCollector collector;
MobRegistrationCollectorDate regCollectorDate;
date dateToSet = return DateTimeUtil::getToday(DateTimeUtil::getUserPreferredTimeZone()) + 200;
//Get the Date Collector, iterate through all the collectors
while (collectors.moveNext())
{
collector = collectors.current();
if (classidGet(collector) == classNum(MobRegistrationCollectorDate) && collector.parmName() == MobConstants::DeliveryDate())
{
//Found the right collector
regCollectorDate = collector;
//Modify default date to somewhere in the future
regCollectorDate.parmDefaultValue(date2str(dateToSet,123,2,DateSeparator::Hyphen,2,DateSeparator::Hyphen,4));
}
}
return refData;
}
}
In the above code, we take the MobReferenceDataConfiguration from the method we extend, we iterate over the collectors in the object, and when we find the right collector, we modify it with the new default value for the date.
All attributes for the registration collectors are available as parm-methods in the Registration Collector Objects, and can thereby be manipulated as well.