{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"atlassian-macro-output-type":{"value":"INLINE"}},"macroMetadata":{"macroId":{"value":"5d607897-843d-449c-a843-8af14acd5281"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"46870d06-6afa-434d-9af4-f945c4b6493a"},"content":[{"type":"paragraph","content":[{"text":"A line ","type":"text"},{"text":"step","type":"text","marks":[{"type":"link","attrs":{"href":"https://taskletfactory.atlassian.net/wiki/spaces/TFSK/pages/78942803"}}]},{"text":" can be Online or ","type":"text"},{"text":"Offline ","type":"text","marks":[{"type":"link","attrs":{"href":"https://taskletfactory.atlassian.net/wiki/spaces/TFSK/pages/78942333"}}]},{"text":"validated. This is opposed to on posting (header steps)","type":"text"}]}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"2"}},"macroMetadata":{"macroId":{"value":"f9e893e2-2527-4cd0-a741-415d78cdc1de"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"4489548a-727a-443c-aa40-cdc71909f9a7"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Use case","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tell the user instantly whether an input value is correct","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Return additional steps - based on the input","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Limitations","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You will limit the Offline capability because a request is made for each order lines registration","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Types of Online Validation","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Standard steps (steps in the standard ","type":"text"},{"text":"Workflows","type":"text","marks":[{"type":"link","attrs":{"href":"https://taskletfactory.atlassian.net/wiki/spaces/TFSK/pages/78944176"}}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom steps","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Standard Step Validation","type":"text"}]},{"type":"paragraph","content":[{"text":"Standard validation can be set up in the following steps from the \"standard\" workflow","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ToBin / FromBin","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lot number","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tote","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Serial number","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Quantity","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 1: Setup In the mobile configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the \"\" tag in the service section, to enable the validators needed. Each required element needs to be enabled and have a document type set.","type":"text"},{"type":"hardBreak"},{"text":"The \"includeCollectedValues\" attribute defines whether previously gathered steps should be added to the request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n <..>\n \n \n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"OnlineValidation Request","type":"text"}]},{"type":"paragraph","content":[{"text":"ItemNumber, lineNumber and orderBackendId are always included, followed by the step setup for validation, and previously gathered steps if setup to do so.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"XML Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n TF-003\n 20000\n RE000160\n 13-07-2022\n ScannedLotNumber\n \n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The online validation responses should look as follows.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"XML Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"If the status is returned as Completed, then the application will take that as a positive response. Another status will be interpreted as an error and will prevent the user from going forward.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Custom Step Validation","type":"text"}]},{"type":"paragraph","content":[{"text":"Generic step validation is a mechanism for validating any step in the workflow configuration, which does not have a specific validation element in the services section. This type of online validation still has the possibility to validate the current step and any previous step if set up to do so.","type":"text"},{"type":"hardBreak"},{"text":"Configuration is done inside the workflow and looks as follows.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n ...\n \n \n \n \n \n \n ...\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The request and response will look the same as the specific validation types.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Extended online validation functionality","type":"text"}]},{"type":"paragraph","content":[{"text":"Besides the capability to validate whether or not an entered value is accepted by the backend, several online validators also support returning additional information, and changing behavior.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step Updates from Custom Validation","type":"text"}]},{"type":"paragraph","content":[{"text":"Available from v. 1.9.1","type":"text"}]},{"type":"paragraph","content":[{"text":"Step updates lets the backend return values as a response to an online request. The individual element needs to contain a name and a value. The name is used to identify a step in the current registration collector workflow, and the value is applied to that step. Currently step updates will only be applied to steps past the validating step.","type":"text"}]},{"type":"paragraph","content":[{"text":"The response should look as follows, where step updates is the wrapper element containing any specific step update.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n // interactionPermission is only supported for the specific Quantity step/name.\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Response for Type and Quantity","type":"text"}]},{"type":"paragraph","content":[{"text":"The generic online validator does have an extra feature when it comes to the ","type":"text"},{"text":"Collector Step TypeAndQuantity","type":"text","marks":[{"type":"link","attrs":{"href":"https://taskletfactory.atlassian.net/wiki/spaces/TFSK/pages/78938415"}}]},{"text":" step , which allows the backend to return a new display name for the scanned value.","type":"text"},{"type":"hardBreak"},{"text":"So instead of e.g. displaying a serial number, the item number or a human-readable name can be displayed on the control.","type":"text"},{"type":"hardBreak"},{"text":"Notice that the display value (TypeDisplay) needs to contain all the information.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"XML Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n TF-002\n TF-002 - Intense Orange\n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Returning a quantity","type":"text"}]},{"type":"paragraph","content":[{"text":"When utilizing lot or serial number validation, a quantity can be returned, which will be used as the quantity going forward.","type":"text"},{"type":"hardBreak"},{"text":"Whether or not the user is allowed to edit the quantity can be set by the element.","type":"text"}]},{"type":"paragraph","content":[{"text":"ValueInteractionPermission can have three states.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AllowEdit ","type":"text","marks":[{"type":"strong"}]},{"text":"- Allows the user to edit the value in the quantity step. User still sees quantity step","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ApplyDirectly ","type":"text","marks":[{"type":"strong"}]},{"text":"- Hides the quantity step altogether","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VerifyOnly ","type":"text","marks":[{"type":"strong"}]},{"text":"- \"Disables\" the quantity step. User still sees quantity step, but cannot edit it","type":"text"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"XML Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n 5\n ApplyDirectly\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Returning registration collector steps","type":"text"}]},{"type":"paragraph","content":[{"text":"Available from v. 1.5.12","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"All standard online validators can return steps as part of the response to validation.","type":"text"}]},{"type":"paragraph","content":[{"text":"The response should look as follows:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"XML Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The registration collector configuration element can be combined with lot and serial number information elements, and should exist on the same xml node level.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Setting Serial Number Validation Level (optional)","type":"text"}]},{"type":"paragraph","content":[{"text":"When using Serial Number validation, you can also set the \"ValidationLevel\" for how restrictive to validating serial numbers.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The levels are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Item: The same serial number can only be registered once per item, but multiple times across items.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Line: A serial number can only be registered once per order line, but multiple times per order.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Order (default): A serial number can only be registered once per order","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"None: Does not check for serial number uniqueness.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Empty input validation","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Requirement: Tasklet Mobile WMS version 1.11.2","type":"text"}]}]},{"type":"paragraph","content":[{"text":"By default, the online validation does not handle empty input values. However, by adding the attribute ","type":"text"},{"text":"validateEmptyValue","type":"text","marks":[{"type":"code"}]},{"text":" to the ","type":"text"},{"text":"online","type":"text","marks":[{"type":"code"}]},{"text":" validator and set its corresponding step configuration in the workflow to ","type":"text"},{"text":"optional","type":"text","marks":[{"type":"code"}]},{"text":", the online validation will now work on empty input values as well. The following is an example on how this can be configured:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"XML Example","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n ...\n \n \n \n ...\n \n \n ...\n \n \n \n \n ...\n \n ...\n \n ...\n \n \n \n ...\n \n \n ...\n \n \n \n \n \n ...\n \n \n \n ...\n \n ...\n \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 2: Handle validation in backend","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"How-to: Online Validation for Line step","type":"text","marks":[{"type":"link","attrs":{"href":"https://taskletfactory.atlassian.net/wiki/spaces/TFSK/pages/78945060"}}]}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"contentbylabel","parameters":{"macroParams":{"showLabels":{"value":"false"},"showSpace":{"value":"false"},"title":{"value":"See also"},"excludeCurrent":{"value":"true"},"cql":{"value":"label = \"onlinevalidation\""}},"macroMetadata":{"macroId":{"value":"fc4d8d59-4894-41cc-aa21-a5ac00de44e1"},"schemaVersion":{"value":"4"},"title":"Filter by label (Content by label)"}},"localId":"ed5f084c-d942-4258-ad23-195cda4de48b"}},{"type":"paragraph"}],"version":1}

Browser not supported