{"id":5025,"date":"2017-08-09T17:03:14","date_gmt":"2017-08-09T17:03:14","guid":{"rendered":"https:\/\/alt2.minisoft.com\/support\/?p=5025"},"modified":"2022-03-16T10:53:24","modified_gmt":"2022-03-16T17:53:24","slug":"manhattan-wmos-integration","status":"publish","type":"post","link":"https:\/\/c002.minisoft.com\/support\/manhattan-wmos-integration\/","title":{"rendered":"Manhattan WMOS Integration"},"content":{"rendered":"<div class=\"entry-content\">\n<p><a href=\"http:\/\/www.manh.com\/products\/warehouse-management\" target=\"_blank\" rel=\"noopener noreferrer\">Manhattan Associates&#8217; Warehouse Management for Open Systems (WMOS)<\/a> is a warehouse management solution for retailers which can output in a variety of formats, including PostScript (.PS) and Extensible Markup (.XML) via the Manhattan Integration Framework (MIF).<\/p>\n<p>eFORMz integrates with WMOS via Java Print Service (JPS). There are a variety of methods for handling the data as it&#8217;s printed out of Jasper or other Java Print Services. The eFORMzPrinter options are listed below.<\/p>\n<ul>\n<li>\u201cfile\u201d \u2013 This is local to the WMOS server. It can be on a shared or Network File System (NFS) volume.<\/li>\n<li>\u201cws\u201d \u2013 This is web service call from the WMOS side into eFORMz, usually to POST the data into the Director. For more on the eFORMz API: <a href=\"\/support\/index.php\/eformz-api-management-developer-resources\/\">eFORMz API Management (Developer Resources)<\/a><\/li>\n<li>\u201cjms\u201d \u2013 This is a Java Message Service call.<\/li>\n<li>\u201csocket\u201d \u2013 This a raw TCP\/IP socket sending of the data. For more information, consult the following post: <a href=\"\/support\/index.php\/netport-listener-input-source-in-eformz-director\/\">NetPort Listener input source in eFORMz Director<\/a><\/li>\n<\/ul>\n<p>A sample configuration is available here: <strong><a href=\"\/support\/wp-content\/uploads\/2020\/09\/config.zip\">Config<\/a><\/strong><\/p>\n<\/div>\n<h3>Enable Java Print Service (JPS)<\/h3>\n<p>To check if Java Print is on or off, run the following:<\/p>\n<pre>Select *\nFrom application_configuration\nWhere key = 'labelprinting.javaprintservice'<\/pre>\n<p>If Value = FALSE then Java Print is turned off and WMOS is using Unix printing. To turn on Java Print, run the following SQL statement and then restart the environment:<\/p>\n<pre>update application_configuration set value = 'TRUE' where key = 'labelprinting.javaprintservice' and value = 'FALSE'<\/pre>\n<div class=\"entry-content\">\n<h1>Best Practices<\/h1>\n<p>eFORMz works with any version of WMOS, but the integration methods can vary widely. Even within the same year there are platform and non-platform versions that require different approaches for integration. In pre-2010 versions or non-Platform versions, integration is done by reading the \u201cRPT_REQST_Q \u201c table for the print request and then reading other tables for additional required data. When integrating with WMOS version 2010 and newer, eFORMz&nbsp;intercepts the system print output by looking to the user as a normal printer. When the output is intercepted, it is processed by the eFORMz engine to produce the desired output as designed, and then it is outputted to its final destination.<\/p>\n<p>More specifically, for WMOS version 2010 and newer, the eFORMz Java Print Service Provider jar file (eFORMzPrinter.jar) is installed in WMOS Classpath. This doesn&#8217;t make any changes to WMOS code. Be sure to add the following in a Java command to whatever is calling the print service (e.g. WebSphere):<\/p>\n<pre>-DefzPrintServicesDefaultDirectory=&lt;config directory&gt;<\/pre>\n<p>The <code>&lt;config directory&gt;<\/code> refers to a directory created to contain the PrintServices.xml file. It is also the directory that will contain the folders for the intercepted output from WMOS. Typically we use <code>\/minisoft<\/code> or <code>\/opt\/minisoft<\/code>.<\/p>\n<p>PrintServices.xml is a part of the eFORMz installation and it holds configuration of eFORMz printers. The Director Toolkit (Configuration) is a&nbsp;Minisoft App to configure eFORMz printers. The eFORMz Java Print Service Provider translates Java drawing operations to Minisoft eFORMz Document (.efd) formatted output. The flow of this process is detailed in the diagram below.<\/p>\n<p><a href=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos.png\"><img decoding=\"async\" loading=\"lazy\" class=\"alignnone size-full wp-image-7573\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos.png\" alt=\"\" width=\"990\" height=\"765\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos.png 990w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos-300x232.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos-768x593.png 768w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos-150x116.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos-250x193.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos-550x425.png 550w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos-800x618.png 800w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos-233x180.png 233w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos-388x300.png 388w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/wmos-647x500.png 647w\" sizes=\"(max-width: 990px) 100vw, 990px\" \/><\/a><\/p>\n<\/div>\n<div class=\"entry-content\">\n<p>Consult the following post for additional details: <a href=\"\/support\/index.php\/process-w-director\/\">Process w\/Director<\/a><\/p>\n<p>Depending on the version of WMOS, it&#8217;s possible that some combination of the&nbsp;<a href=\"\/support\/index.php\/how-does-eformz-integrate\/\" target=\"_blank\" rel=\"noopener noreferrer\">four main integration options<\/a>&nbsp;for eFORMz could be used. Contact a <a href=\"mailto:support@minisoft.com\">Minisoft support representative<\/a> for specific integration options regarding your version of WMOS.<\/p>\n<h2>WebSphere Container<\/h2>\n<\/div>\n<nav class=\"post-navigation\" role=\"navigation\">\n<div class=\"nav-links clearfix\">The directory to install 3rd-party jar files is needed, so they get added to the classpath for the WebSphere container that runs WMOS. Likewise, the name and location of the script used to start the WebSphere container that runs WMOS is needed, to modify the Java options to add a system variable.<\/div>\n<\/nav>\n<div>\n<p>To manually install the .jar file, please perform the following:<\/p>\n<p>1.<strong> Copy<\/strong>&nbsp;the new jar to <code>$WMS_INSTALLATION_HOME\/distribution\/scope.ear\/lib<\/code><br \/>\n2.&nbsp;<strong>Extract<\/strong><code>$WMS_INSTALLATION_HOME\/distribution\/scope.ear\/scope.war\/META-INF\/MANIFEST.MF<\/code><br \/>\n3.&nbsp;<strong>Edit<\/strong>&nbsp;<code>MANIFEST.MF<\/code> and append new lib name (better to do this from a dev environment and move the scope.ear to production)<\/p>\n<p><a href=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/Websphere1.jpg\"><img decoding=\"async\" loading=\"lazy\" class=\"alignnone size-full wp-image-5144\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/Websphere1.jpg\" alt=\"\" width=\"969\" height=\"116\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/Websphere1.jpg 969w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/Websphere1-300x36.jpg 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/Websphere1-768x92.jpg 768w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/Websphere1-150x18.jpg 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/Websphere1-250x30.jpg 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/Websphere1-550x66.jpg 550w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2017\/08\/Websphere1-800x96.jpg 800w\" sizes=\"(max-width: 969px) 100vw, 969px\" \/><\/a><\/p>\n<p>4.&nbsp;<strong>Paste<\/strong>&nbsp;the updated <code>MANIFEST.MF<\/code> in <code>scope.ear\/scope.war\/META-INF\/MANIFEST.MF<\/code><br \/>\n5.&nbsp;<strong>Re-deploy<\/strong>&nbsp;WMS<br \/>\n6.&nbsp;<strong>Start<\/strong>&nbsp;WMS application<\/p>\n<\/div>\n<div><\/div>\n","protected":false},"excerpt":{"rendered":"<p>Manhattan Associates&#8217; Warehouse Management for Open Systems (WMOS) is a warehouse management solution for retailers which can output in a variety of formats, including PostScript (.PS) and Extensible Markup (.XML) via the Manhattan Integration Framework (MIF). eFORMz integrates with WMOS via Java Print Service (JPS). There are a variety of methods for handling the data [&hellip;]<\/p>\n","protected":false},"author":75,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[106],"tags":[584,107,772,216,217],"_links":{"self":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5025"}],"collection":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/users\/75"}],"replies":[{"embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/comments?post=5025"}],"version-history":[{"count":18,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5025\/revisions"}],"predecessor-version":[{"id":10090,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5025\/revisions\/10090"}],"wp:attachment":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/media?parent=5025"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/categories?post=5025"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/tags?post=5025"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}