Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 3


Generic Order Service

As something new it is now possible to create an arbitrary number of services; one is no longer forced to choose from the predefined pick, receive, etc services but can e.g. create a pick_extra_validation service and enable extra validation for new employees.

Service Configuration

The following configuration example shows how to add a service called NewFeatureconvert the pick service and tasklets into using the new generic versions. It could just as well be an entirely new service type. The change has to be applied to the whole chain: service, filter, order list, order lines and registration tasklets.

To setup the service add the new ServiceManager service in app.config and move the NewFeature pick service configuration into the list of <services> provided by the manager.

Code Block
languagexml
titleService Manager
<add type="TaskletFactory.WMS.Services.ServiceManager, TaskletFactory.WMS.Services.Base"
           factory="TaskletFactory.WMS.Services.ServiceManagerFactory, TaskletFactory.WMS.Services.Base"
           startup="true">
  <configuration xmlns="http://schemas.taskletfactory.com/MDMF/MobileWMS/Services/2015/01/ServiceManagerConfiguration.xsd">
    <services>
      <add id="NewFeaturePick">

        <configuration xmlns="http://schemas.taskletfactory.com/MDMF/MobileWMS/Services/2009/01/ServiceConfiguration.xsd">
          <DatabaseName>AppDatabase</DatabaseName>
           <PostOrderRequestDocumentName>PostNewFeatureOrder<<PostOrderRequestDocumentName>PostPickOrder</PostOrderRequestDocumentName>
          <GetOrdersRequestDocumentName>GetNewFeatureOrders<<GetOrdersRequestDocumentName>GetPickOrders</GetOrdersRequestDocumentName>
          <GetFilteredOrdersRequestDocumentName>GetFilteredNewFeatureOrders<<GetFilteredOrdersRequestDocumentName>GetFilteredPickOrders</GetFilteredOrdersRequestDocumentName>
          <GetOrderLinesRequestDocumentName>GetNewFeatureOrderLines<<GetOrderLinesRequestDocumentName>GetPickOrderLines</GetOrderLinesRequestDocumentName>

          <GetBackendInfoRequestDocumentName>GetBackendInfo</GetBackendInfoRequestDocumentName>
          <LockOrderRequestDocumentName>LockOrder</LockOrderRequestDocumentName>
          <UnlockOrderRequestDocumentName>UnlockOrder</UnlockOrderRequestDocumentName>
          <UseOrderLocking>true</UseOrderLocking>
          <ScanBehaviourWhenRegisteringQuantity>SCAN_NEXT_ITEM</ScanBehaviourWhenRegisteringQuantity>
          <DataSource>ONLINE</DataSource>
          <ExpirationDateSeparator>,</ExpirationDateSeparator>
          <BarcodeSeparator>;</BarcodeSeparator>
          <AddOrderLineRequestDocumentName>AddOrderLine</AddOrderLineRequestDocumentName>
          <AutoPostWhenAllLinesComplete>true</AutoPostWhenAllLinesComplete>
           <ServiceType>NewFeature<<ServiceType>Pick</ServiceType>

        </configuration>
      </add>
    </services>
  </configuration>
</add>

To add a service simply use the <add id="serviceName"> syntax and the service is referenced through its id. Copy the <configuration> section from the existing pick service.

Finally remove the existing pick service configuration.

Tasklet Configuration

The next step is to convert the accompanying tasklets from using the specific PickFilterPickOrderList, etc. types to the GenericFilterGenericOrderList, etc. versions instead by modifying the UserRole.xml Add the following configuration file.

Code Block
languagexml
titleGeneric Pick Filter
<tasklet name="NewFeatureFilterPickFilter" text="NewFeaturePick filter"

         type="TaskletFactory.WMS.Tasklets.GenericFilter, TaskletFactory.WMS.Tasklets.Filter">
  <configuration>
    <appSettings>
      <add key="okMenuItem" value="filterMenuOk"/>
    </appSettings>

    <filterConfiguration>
      <service id="NewFeaturePick" />
    </filterConfiguration>

  </configuration>
  <actions>
    <open name="filterMenuOk" tasklet="NewFeatureListPickList" priority="110" text="OK_" context=""></open>

    <exitTasklet name="unplanRegMenuBack" text="Back" priority="1" icon="Arrow Left.bmp" context="The text on the softkey that goes back to the previous tasklet"></exitTasklet>
  </actions>
</tasklet>

...

Code Block
languagexml
titleGeneric Order List
<tasklet name="NewFeatureListPickList"  text="NewFeaturePick orders" icon="NewFeaturepick.bmp"
         type="TaskletFactory.WMS.Tasklets.GenericOrderList, TaskletFactory.WMS.Tasklets.OrderList">
  <configuration>
    <appSettings>
      ...
    </appSettings>
    <orderListConfiguration xmlns="http://schemas.taskletfactory.com/MDMF/MobileWMS/Tasklets/2013/08/OrderListConfigurationSection.xsd">

      <service id="NewFeaturePick" />

    </orderListConfiguration>
    <listConfiguration xmlns="http://Schemas.TaskletFactory.com/MDMF/Platform/Controls/2008/10/CustomizableList.xsd">
      ...
    </listConfiguration>
  </configuration>
  <actions>
    ...
  </actions>
</tasklet>

...

Code Block
languagexml
titleGeneric Order Lines
<tasklet name="NewFeatureOrderLinesPickOrderLines" text="NewFeaturePick order lines" icon="NewFeaturepick.bmp"

         type="TaskletFactory.WMS.Tasklets.GenericOrderLines, TaskletFactory.WMS.Tasklets.OrderLines">
  <configuration>
    <appSettings>
      ...
    </appSettings>
    <shortcut enabled="true">
      ...
    </shortcut>
    <orderLineConfiguration xmlns="http://Schemas.TaskletFactory.com/MDMF/Platform/Tasklets/2009/01/OrderLineConfiguration.xsd">

      <service id="NewFeaturePick" />
      ...
    </orderLineConfiguration>
    <listConfiguration xmlns="http://Schemas.TaskletFactory.com/MDMF/Platform/Controls/2008/10/CustomizableList.xsd">
      ...
    </listConfiguration>
  </configuration>
  <actions>
    ...
  </actions>
  <outputMappings>
    ...
  </outputMappings>
</tasklet>

...

Code Block
languagexml
titleGeneric Registration
<tasklet name="Registrations_NewFeaturePick" text="Registrations" icon="Notepad.bmp"

         type="TaskletFactory.WMS.Tasklets.GenericRegistration, TaskletFactory.WMS.Tasklets.RegistrationTasklet">
  <configuration>
    <appSettings>
      ...
    </appSettings>
    <registrationConfiguration xmlns="http://Schemas.TaskletFactory.com/MDMF/MobileWMS/Tasklets/2015/01/RegistrationConfiguration.xsd">

      <service id="NewFeaturePick"/>

    </registrationConfiguration>
    <listConfiguration xmlns="http://Schemas.TaskletFactory.com/MDMF/Platform/Controls/2008/10/CustomizableList.xsd">
      ...
    </listConfiguration>
  </configuration>
  <actions>
    ...
  </actions>
</tasklet>