Histórico da Página
| HTML |
|---|
<div id="main-content" class="wiki-content group"> <p>The process form validation in ECM is performed through the customization of card index and process events using scripts in the JavaScript language. Events can be implemented in ECM itself or sent by Protheus as parameter of the functions used in the previous examples.</p> <p> To validate the fields provided by the user, use the process <strong>beforeTaskSave</strong> event that runs on the confirmation of each task to be sent to the next step in the workflow. </p> <p> To access the value of a form field, use the <strong>hAPI.</strong><strong> </strong><strong>getCardValue</strong>(<nomeCampo>) workflow API and, to handle exceptions, use the <strong>throw</strong> <message> command, which will present the message to the user preventing them from proceeding until they correct the information typed. </p> <h1 id="id-2.3Validaçãodoformulário-ScriptdoeventonoECM">Event script in ECM</h1> <p>Simple validations can be performed in the event script to avoid unnecessary communication with Protheus immediately returning a message to the user.</p> <p> </p> <blockquote> <p>function beforeTaskSave(colleagueId,nextSequenceId,userList){</p> <p>var A1_COD = hAPI.getCardValue("A1_COD");</p> <p> </p> <p>if (A1_COD == ""){</p> <p>   throw "The Code field is mandatory"</p> <p>}</p> <p>}</p> </blockquote> <h1 id="id-2.3Validaçãodoformulário-Protheus">Protheus</h1> <p> Validation in the event scripts using external applications is performed via <a href="http://tdn.totvs.com/display/tec/Web+Services+com+o+ERP+Microsiga+Protheus">WebServices </a> that should be registered as service in ECM in the <em>Control Panel > Services > Add</em> option. When any WebService definition is changed or added, you will need to update ECM in <em>Control Panel > Services > Edit > Refresh</em> option. </p> <p> The WebService can be registered through the ECM Control Panel or Protheus using the <strong>FWWFPutService function, as in the example below</strong>. </p> <blockquote> <p>#include "totvs.ch"</p> <p> </p> <p>User Function WSCliente()</p> <p>Local cName := "WSCLIENTE"</p> <p> Local cURL := "<a href="http://hostname:8080/ws/exemplo.apw?wsdl" class="external-link" rel="nofollow">http://hostname:8080/ws/exemplo.apw?wsdl</a>" </p> <p>Local cDescription := "Service to be validated and updated in customer file"</p> <p> </p> <p> If <strong>FWWFPutService(cName,cUrl,cDescription)</strong> </p> <p>   MsgInfo("Service successfully registered")</p> <p>EndIf</p> <p>Return</p> </blockquote> <h1 id="id-2.3Validaçãodoformulário-WebService">WebService</h1> <p> For more information on how to develop Web Services with Microsiga Protheus, see the link: <a href="http://tdn.totvs.com/display/tec/Web+Services+com+o+ERP+Microsiga+Protheus">Web Services with ERP Microsiga Protheus</a>. </p> <p>Protheus WebService Example:</p> <p> </p> <blockquote> <p>#include "totvs.ch"</p> <p>#include "apwebsrv.ch"</p> <p> </p> <p>WSSERVICE WSCLIENTE DESCRIPTION "Customer file example"</p> <p>WSDATA A1_COD AS STRING</p> <p>WSDATA A1_LOJA AS STRING</p> <p>WSDATA XML AS Base64Binary</p> <p>WSDATA RETEXISTCOD AS BOOLEAN</p> <p>WSDATA RETINCLUIR AS BOOLEAN</p> <p>WSMETHOD ExistCod DESCRIPTION "Checks if customer code already exists"</p> <p>WSMETHOD Incluir DESCRIPTION "Adds customer"</p> <p>ENDWSSERVICE</p> <p> </p> <p>WSMETHOD ExistCod WSRECEIVE A1_COD,A1_LOJA WSSEND RETEXISTCOD WSSERVICE WSCLIENTE  </p> <p> </p> <p>Private INCLUI := .T.</p> <p> </p> <p>::RETEXISTCOD := existchav("SA1",::A1_COD+::A1_LOJA)</p> <p>Return .T.</p> <p> </p> <p>WSMETHOD Incluir WSRECEIVE XML WSSEND RETINCLUIR WSSERVICE WSCLIENTE</p> <p>Local oXML := tXMLManager():New()</p> <p>Local lRet := .T.</p> <p>Local aDadosCli := {}</p> <p> </p> <p>If oXML:Parse(::XML)</p> <p>   aAdd( aDadosCli, { "A1_COD"     , oXML:XPathGetNodeValue("/SA1/A1_COD")   , NIL } )</p> <p>   aAdd( aDadosCli, { "A1_LOJA"    , oXML:XPathGetNodeValue("/SA1/A1_LOJA")  , NIL } )</p> <p>   aAdd( aDadosCli, { "A1_TIPO"    , oXML:XPathGetNodeValue("/SA1/A1_TIPO")  , NIL } )</p> <p>   aAdd( aDadosCli, { "A1_PESSOA"  , oXML:XPathGetNodeValue("/SA1/A1_PESSOA"), NIL } )</p> <p>   aAdd( aDadosCli, { "A1_NOME"    , oXML:XPathGetNodeValue("/SA1/A1_NOME")  , NIL } )</p> <p>   aAdd( aDadosCli, { "A1_NREDUZ"  , oXML:XPathGetNodeValue("/SA1/A1_NREDUZ"), NIL } )</p> <p>   aAdd( aDadosCli, { "A1_END"     , oXML:XPathGetNodeValue("/SA1/A1_END")   , NIL } )</p> <p>   aAdd( aDadosCli, { "A1_MUN"     , oXML:XPathGetNodeValue("/SA1/A1_MUN")   , NIL } )</p> <p>   aAdd( aDadosCli, { "A1_EST"     , oXML:XPathGetNodeValue("/SA1/A1_EST")   , NIL } )</p> <p> </p> <p>   lMsErroAuto := .F.</p> <p>   MSExecAuto( { | x, y | MATA030( x, y ) } , aDadosCli, 3 )</p> <p>      </p> <p>   If lMsErroAuto</p> <p>      If __lSX8</p> <p>         RollBackSX8()</p> <p>      EndIf</p> <p>      ::RETINCLUIR := .F.        </p> <p>   Else</p> <p>      If __lSX8</p> <p>         ConFirmSX8()</p> <p>      EndIf</p> <p>      ::RETINCLUIR := .T.</p> <p>   EndIf</p> <p>Else</p> <p>   SetSoapFault("WSCLIENTE:INCLUIR",oXML:LastError())</p> <p>   lRet := .F.</p> <p>EndIf   </p> <p>Return lRet</p> <p> </p> </blockquote> <p> Validation on the <strong>beforeTaskSave</strong> event script: </p> <ol> <li>Call the service load with the <strong>ServiceManager.getService</strong> method </li> <li>Use the <strong>getBean</strong> method to return the utility for access to the service classes through the instantiate method by sending as a parameter the <em>Locator</em> class that is described in ECM in <em>Control Panel > Services</em>, select the service and click <em>View</em></li> <li>Call the method to instantiate the service (in this example <strong>getWSCLIENTESOAP</strong>) that is also described in the <em>Control Panel > Services > View</em> option </li> <li>Call the service method (in the example <strong>ExistCod</strong>) </li> </ol> <p> </p> <blockquote> <p>function beforeTaskSave(colleagueId,nextSequenceId,userList){</p> <p>var A1_COD = hAPI.getCardValue("A1_COD");</p> <p> </p> <p>if (A1_COD == ""){</p> <p>   throw "The Code field is mandatory"</p> <p>}</p> <p> </p> <p> var wsService = <strong>ServiceManager.getService("WSCLIENTE")</strong>; </p> <p> var serviceHelper = wsService.<strong>getBean()</strong>; </p> <p> var serviceLocator = serviceHelper.<strong>instantiate("localhost.WSCLIENTELocator")</strong>; </p> <p> var service = serviceLocator.<strong>getWSCLIENTESOAP()</strong>; </p> <p>var ret = false;</p> <p> </p> <p>try {</p> <p>    ret = service.<strong>EXISTCOD(A1_COD</strong>); </p> <p>}</p> <p>catch(erro){</p> <p>   throw erro.message</p> <p>}</p> <p> </p> <p>if (!ret) {</p> <p>   throw "Customer already exists";</p> <p>}</p> <p>}</p> </blockquote> <h1 id="id-2.3Validaçãodoformulário-MVC">MVC</h1> <p> The validation process of a MVC routine is performed using the <strong>FWWSMODEL</strong> WebService (<a href="http://hostexemplo:8080/ws/fwwsmodel.apw?wsdl" class="external-link" rel="nofollow">http://hostexemplo:8080/ws/fwwsmodel.apw?wsdl</a>) with the invocation of the <strong>GETXMLDATADETAIL</strong> method that returns the XML of the model to populate the data and the <strong>VLDXMLDATA</strong> method that will validate the XML. </p> <p> </p> <blockquote> <p>#include "totvs.ch"</p> <p>User Function WSMVC()</p> <p>Local cName := "TOTVS_FWMVC"</p> <p> Local cURL := "<a href="http://hostname:8080/ws/fwwsmodel.apw?wsdl" class="external-link" rel="nofollow">http://hostname:8080/ws/fwwsmodel.apw?wsdl</a> " </p> <p>Local cDescription := "TOTVS MVC Service for integrating routines/programs with ECM"</p> <p>Local aService := FWWFGetService(cName)</p> <p> </p> <p> If Empty(aService) .and. <strong>FWWFPutService(cName,cUrl,cDescription)</strong> </p> <p>   MsgInfo("Service successfully registered")</p> <p>EndIf</p> <p>Return</p> </blockquote> <p> </p> <p> Validation on the <strong>beforeTaskSave</strong> event script: </p> <p> </p> <blockquote> <p> function <strong>beforeTaskSave</strong>(colleagueId,nextSequenceId,userList){ </p> <p>var wsService = ServiceManager.getService("TOTVS_FWMVC");</p> <p>var serviceHelper = wsService.getBean();</p> <p>var serviceLocator = serviceHelper.instantiate("br.com.totvs.webservices.fwwsmodel_apw.FWWSMODELLocator");</p> <p>var service = serviceLocator.getFWWSMODELSOAP();</p> <p> var err = {message:"", <a href="http://emptytrue" class="external-link" rel="nofollow">empty:true</a>}; </p> <p>var ret, xml;</p> <p> </p> <p>try {</p> <p>    ret = service.<strong>GETXMLDATADETAIL</strong>([],"MATA030_MVC"); </p> <p>   xml = new XML(new String(new java.lang.String(ret)).replace(/<\?.*\?>/g,""));</p> <p>}</p> <p>catch(erro){</p> <p>   throw erro.message;</p> <p>   return;</p> <p>}</p> <p> </p> <p>updateXMLFields(xml,err);</p> <p> </p> <p>if (err.message.length > 0){</p> <p>   throw err.message;</p> <p>}</p> <p>else if (err.empty){</p> <p>   throw "Fill out form";</p> <p>}</p> <p>else{</p> <p>   eval("xml.@Operation = 3");</p> <p>   try{</p> <p>       service.<strong>VLDXMLDATA</strong>([],"MATA030_MVC",new java.lang.String(xml.toXMLString()).getBytes()); </p> <p>   } catch(e){</p> <p>      throw e.message;</p> <p>   }</p> <p>}</p> <p>}</p> <p> </p> <p>function updateXMLFields(node,err){</p> <p>var list = node.children();</p> <p>var name,value;</p> <p> </p> <p>for (var i=0;i<list.length();i++){</p> <p>   switch (Trim(eval("list[i][email protected]()"))){</p> <p>      case "FIELDS":</p> <p>         updateXMLFields(list[i],err);</p> <p>         break;</p> <p>      default:</p> <p>         name = list[i].name().localName;</p> <p>         value = hAPI.getCardValue(name);</p> <p>         if (value != null)</p> <p>            list[i].value = convertValue(name,list[i],value,err);</p> <p>         break;</p> <p>   }</p> <p>   if (err.message.length > 0)</p> <p>      break;</p> <p>}</p> <p>}</p> <p> </p> <p>function convertValue(name,struct,value,err){</p> <p>var y,m,d,n,len,str,reg</p> <p>var setYear = new Date().getFullYear().toString().substring(0,2);</p> <p>var setDate = "dd/mm/yyyy";</p> <p>var yCount = setDate.match(/yyyy/) ? 4 : 2;</p> <p>var hasErr = false;</p> <p> </p> <p>value = value.trim();</p> <p> </p> <p>switch (eval("[email protected]()")){</p> <p>case "D":</p> <p>   if (value.replace("/","").trim() != ""){</p> <p>      len = value.length();</p> <p>      d = setDate.indexOf("d");</p> <p>      m = setDate.indexOf("m");</p> <p>      y = setDate.indexOf("y");</p> <p> </p> <p>      if (d + 2 > len || m + 2 > len || y + yCount > len){</p> <p>         hasErr = true;</p> <p>      }</p> <p>      else{</p> <p>         str = value.substr(m,2) + value.substr(d,2);</p> <p>         if (yCount == 4)</p> <p>            str = value.substr(y,4) + str;</p> <p>         else</p> <p>            str = setYear + value.substr(y,2) + str;</p> <p> </p> <p align="left">         if (str.match(/((((19|20)(([02468][048])|([13579][26]))0229))|((19|20)[0-9][0-9])((((0[1-9])|(1[0-2]))((0[1-9])|(1\d)|(2[0-8])))|((((0[13578])|(1[02]))31)|(((0[1,3-9])|(1[0-2]))(29|30)))))/g))</p> <p>            value = new java.lang.String(str);</p> <p>         else</p> <p>            hasErr = true;</p> <p>      }</p> <p> </p> <p>      if (hasErr)</p> <p>         err.message = "The field "+eval("struct.@info")+" ("+name+") has an invalid date";</p> <p>      else</p> <p>         err.empty = false;</p> <p>   }</p> <p>   break;</p> <p>case "N":</p> <p>   len = eval("[email protected]().split(',')");</p> <p>   if (len[1] == "0"){</p> <p>      reg = new RegExp("^[0-9]{1,"+len[0]+"}$");</p> <p>      str = value.replace(",","");</p> <p>      if(!reg.test(str)){</p> <p>         str = value.replace(".","");</p> <p>         if(!reg.test(str)){</p> <p>            err.message = "The field "+eval("struct.@info")+" ("+name+") has an invalid number (value or size)"</p> <p>            hasErr = true;</p> <p>            break;</p> <p>         }</p> <p>      }</p> <p> </p> <p>      if (!hasErr){</p> <p>         n = parseInt(str);</p> <p>         if (!isNaN(n)){</p> <p>            value = new java.lang.String(str);</p> <p>            if (n > 0)</p> <p>               err.empty = false;</p> <p>         }</p> <p>      }</p> <p>   }</p> <p>   else{</p> <p>      reg = new RegExp("^0$|^0\.[0-9]{1,"+len[1]+"}$|^[0-9]{0,"+len[0]+"}(\.[0-9]{1,"+len[1]+"})?$");</p> <p>      str = value.replace(".","").replace(",",".");</p> <p>      if(!reg.test(str)){</p> <p>         str = value.replace(",","");</p> <p>         if(!reg.test(str)){</p> <p>            err.message = "The field "+eval("struct.@info")+" ("+name+") has an invalid number (value or size)"</p> <p>            hasErr = true;</p> <p>            break;</p> <p>         }</p> <p>      }</p> <p>            </p> <p>      if (!hasErr){</p> <p>         n = parseFloat(str);</p> <p>         if (!isNaN(n)){</p> <p>            value = new java.lang.String(str);</p> <p>            if (n > 0)</p> <p>               err.empty = false;</p> <p>         }</p> <p>      }</p> <p>   }</p> <p>   break;</p> <p>default:</p> <p>   if (value != "")</p> <p>      err.empty = false;</p> <p>   break;</p> <p>}</p> <p>return value;</p> <p>}</p> <p>function Trim(str){return str.replace(/^\s+|\s+$/g,"");}</p> </blockquote> </div> |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas