1. INTRODUÇÃO WSF3M - REQUES ITOS WSF3M - ARQUITECTURA WSF3M MÉTODOS DO WEBS ERVICE WSF3M S EGURANÇA...

Transcrição

1

2 1. INTRODUÇÃO PRÉ REQUIS ITOS COMPATIBILIDADES REQUISITOS DE INSTALAÇÃO DO SERVIDOR REQUISITOS DE INSTALAÇÃO DOS POSTOS REQUISITOS DE DEFINIÇÕES REGIONAIS DOS POSTOS PROCESSO DE INSTALAÇÃO INSTALAÇÃO DO SERVIDOR INSTALAÇÃO POSTO PROCESSO DE UPGRADE UPGRADE DO SERVIDOR UPGRADE DO POSTO PROCESSO DE ATUALIZAÇÃO ATUALIZAÇÃO DO SERVIDOR ATUALIZAÇÃO DO POSTO PRIMEIRA EXECUÇÃO DA APLICAÇÃO IDENTIFICAÇÃO DO SERVIDOR DE DADOS OBTER LICENÇA DA APLICAÇÃO NO PORTAL LICENCIAMENTO DA APLICAÇÃO SISTEMAS 64 BITS UPGRADE DE VERSÕES ANTERIORES À PRIME CONVERSÃO DE DADOS DE ACCESS PARA SQL SERVER PARAMETRIZAÇÃO DE LIGAÇÕES ENTRE APLICAÇÕES ATUALIZAÇÃO DE MAPAS PERSONALIZADOS TRANSAÇÕES DIS TRIBUÍDAS CONFIGURAÇÃO DO AMBIENTE DO MECANISMO CONFIGURAÇÃO DO SERVIÇO RPC CONFIGURAÇÃO DO SERVIÇO MSDTC CONFIGURAÇÃO DA FIREWALL DO WINDOWS VALIDAÇÃO DE CONFIGURAÇÃO CONFIGURAÇÃO MANUAL DO AMBIENTE DO MECANISMO TRANSAÇÕES DISTRIBUÍDAS WSF3M - INTRODUÇÃO WSF3M - REQUES ITOS WSF3M - ARQUITECTURA WSF3M MÉTODOS DO WEBS ERVICE WSF3M S EGURANÇA WSF3M DETALHE DOS MÉTODOS WSF3M SCRIPTS DE EXTRACÇÃO DE MÉTODO BROWS EDATA CONSULTAR PONTOS E DADOS DE UTENTES WSF3M ERROS DEVOLVIDOS PELO MÉTODO BROWS EDATA... 59

3 17. WSF3M ETAPAS PARA INSTALAÇÃO DE WEBS ERVICE... 60

4 Este dcument dispnibiliza a infrmaçã necessária a uma crrecta instalaçã das aplicações da linha Os prduts desta linha nã sã cmpatíveis cm prduts de linhas anterires. Deste md nã há ligações cm aplicações de linhas anterires. Neste mment é pssível a cexistência, na mesma máquina, de aplicações desta linha e de linhas anterires, nã estand garantida essa cexistência em futurs Upgrades. O prcessadr tem que ser cmpatível cm Pentium III a 600 MHz u superir. Os sistemas perativs suprtads sã s seguintes: Windws 10 Prfessinal u Enterprise (32-bit r 64-bit editins). Windws 8 Prfessinal u Enterprise (32-bit r 64-bit editins). Windws 7 Prfessinal, Enterprise u Ultimate (32-bit r 64-bit editins). Windws Server Windws Server 2008 R2. Windws Server 2008 (32-bit r 64-bit editins). Micrsft.NET Framewrk 4 (Necessária para Axis e aplicações que fazem leitura d cartã de cidadã) Para as aplicações que utilizem a leitura d cartã de cidadã, antes de prceder à instalaçã da aplicaçã deve ser instalada a aplicaçã d cartã de cidadã (versã 1.61) Sistema de gestã de bases de dads SQL Server 2005 (versã Express u superir) SQL Server 2008 SQL Server 2008 R2 SQL Server 2012 SQL Server 2014 Tem que ter um mínim de 4 GB de RAM. Tem que ter um mínim de 350 MB de espaç livre n disc rígid para SQL Server e 250 Mbytes pr aplicaçã (valr médi). Tem que ter um mnitr Super VGA cm uma resluçã de 1024x768 u superir. Tem que ter um rat u um dispsitiv equivalente. Tem que ter uma impressra instalada. Mais infrmaçã encntram em:

5 Os sistemas perativs suprtads sã s seguintes: Windws 10 Prfessinal u Enterprise (32-bit r 64-bit editins). Windws 8 Prfessinal u Enterprise (32-bit r 64-bit editins). Windws 7 Prfessinal, Enterprise u Ultimate (32-bit r 64-bit editins). Windws Server Windws Server 2008 R2. Windws Server 2008 (32-bit r 64-bit editins). Micrsft.NET Framewrk 4 (Necessária para Axis e aplicações que fazem leitura d cartã de cidadã) Para as aplicações que utilizem a leitura d cartã de cidadã, antes de prceder à instalaçã da aplicaçã deve ser instalada a aplicaçã d cartã de cidadã (versã 1.61) Prcessadr Intel Pentium III 340Mhz u superir 2 GB de RAM Espaç livre em disc de 250 Mbytes pr aplicaçã (valr médi) Unidade CD-ROM u acess à Internet Tem que ter um mnitr Super VGA cm uma resluçã de 1024x768 u superir. Tem que ter um rat u um dispsitiv equivalente. Tem que ter uma impressra instalada. Outrs cmpnentes necessáris a diversas funcinalidades das aplicações Exprtaçã para Office e impressã em série: Micrsft excel 97, 2000, 2003, 2010, 2013 (32-bit) Micrsft wrd 2000, 2003, 2010, 2013 (32-bit) Envi de listagens pr Micrsft Outlk (32-bit) WinCTB criaçã da declaraçã anual: Micrsft excel 97, 2000, 2003, 2010, 2013 (32-bit) WinUTE - criaçã ds mdel 1,2 e 3 Micrsft excel 97, 2000, 2003, 2010, 2013 (32-bit) Internet explrer 9, 10, 11 Para usufruir das funcinalidades que utilizam Micrsft Office (ex: , exprtaçã para ffice, mail merge, etc) deverá ser uma versã Office 32bits As aplicações F3M nã sã cmpatíveis cm a versã starter d Office. Para um crret funcinament das aplicações tds s psts terã que ter a seguinte definiçã em terms de frmats de datas e valres numérics n sistema perativ: Frmat de datas dd-mm-aaaa Este frmat respeita as seguintes regras:

6 Separadr: hífen (-); Sequência rdenada pr dia, mês e an; Frmat de Númer e Meda (as definições têm que ser iguais) Frmats válids para as aplicações: , ,00, ,00 e 00, ; Estes frmats respeitam as seguintes regras: Separadr decimal: pnt (.) u vírgula (,); Símbl de agrupament de dígits: espaç ( ), pnt (.) u vírgula (,); O separadr decimal nã pde ser igual a símbl de agrupament de dígits; Separadr Hra: dis pnts (:). O prcess de instalaçã é realizad cm base ns seguintes ficheirs: <NmeAplicaçã>SQL.exe - um ficheir de instalaçã pr cada aplicaçã para executar na instalaçã da máquina Servidr; PstSQL.exe ficheir cmum a tdas as aplicações que será utilizad na instalaçã das máquinas Pst; SQL.exe ficheir cmum a tdas as aplicações e que será utilizad para instalar servidr de SQL. Para realizar a instalaçã cm recurs as ficheirs apre sentad deverá seguir s passs de instalaçã apresentads de seguida. Para que perações sbre as bases de dads (cm criaçã de cópias de segurança, criaçã de instituições u ans, n cas de CTB e GSL) crram nrmalmente, é necessári que a lcalizaçã a partir da qual estã a ser executadas as perações seja válida na rede, particularmente, que essa lcalizaçã seja válida para servidr de SQL. Para tal é acnselhável a utilizaçã de caminhs universais na rede (exempl \\servidr\f3m\wingsosql). Na máquina Servidr, executar ficheir pretenda instalar. Este ficheir de setup irá: para cada aplicaçã que Instalar s ficheirs necessáris a servidr para a aplicaçã; Preparar a instalaçã pst a executar em passs seguintes; Verificar a existência de uma instância d SQL Server 2005 cm nme F3M2005. Cas nã encntre essa instância pergunta se é pretendida a instalaçã e, em cas de respsta afirmativa, instala na máquina a instância SQL2005 para Micrsft SQl Server 2005 Express Editin ( nme da instância criada é

7 e a chave d utilizadr SA é (Chave Anterir - N cas de existência de uma firewall deverã ser criadas as excepções para SQL Server (sqlbrwser.exe e sqlsevr.exe) para que s psts se pssam ligar as dads. Para máquinas que tenham instalad um servidr de dads SQL Server 64 Bits a instalaçã da instância acima referida cm nme é brigatória. Executar a Instalaçã Pst. Para a 1ª execuçã da aplicaçã ver a secçã 6. Primeira Execuçã da Aplicaçã. O prcess de instalaçã d n servidr é realizad cm base ns seguintes passs: De frma a dar inici a prcess de instalaçã, deverá na máquina Servidr, executar ficheir O requer a instalaçã d Micrsft.Net Framewrk 4.0, n cas de mesm nã estar instalad na máquina pass seguinte passará pr instalar mesm, cm é demnstrad na imagem seguinte.

8 Depis de instalad Micrsft.Net Framewrk 4.0, pass seguinte será instalar n servidr.

9 Nesta fase da instalaçã deverá selecinar pnt Servidr de frma que prgrama seja instalad cm servidr, terá igualmente que selecinar qual a pasta de destin da aplicaçã, usand btã Prcurar. Pr exempl, se as aplicações da linha WINIPSS estã na pasta C:\prgramas\f3m\winadSQL a pasta a selecinar deve ser C:\prgramas, pis a restante estrutura será tratada pel instaladr, criand a pasta F3M e a pasta Axis se estas nã existirem. Neste pass terá que selecinar qual nme d servidr de base de dads, e preencher s camps Identificadr de Administradr e palavra passe de administradr.

10 Nesta fase assistente está prnt para iniciar a instalaçã, devend para iss clicar em Instalar de frma a dar inici à mesma.

11 Finalizada a instalaçã pel assistente deverá clicar em Cncluir de frma a terminar prcess de instalaçã. Na máquina Pst, executar ficheir para prceder à instalaçã ds cmpnentes necessáris à execuçã das aplicações (apenas será necessária uma execuçã independentemente d númer de aplicações da linha a utilizar n

12 Pst). Para a aplicaçã é necessári que ficheir atrás referid esteja na versã u superir, cas cntrári este terá de ser executad pel mens uma vez na máquina Pst. Após execuçã d pnt anterir, a instalaçã só ficará cncluída executand pela primeira vez a aplicaçã a partir da lcalizaçã send criads s atalhs para as execuções seguintes, à excepçã da aplicaçã WinGCS que terá de ser Utilizadr a criar s atalhs para s ficheirs: O prcess de instalaçã d num pst é realizad cm base ns seguintes passs: De frma a dar inici a prcess de instalaçã, deverá na máquina Pst, executar ficheir O requer a instalaçã d Micrsft.Net Framewrk 4.0, n cas de mesm nã estar instalad na máquina pass seguinte passará pr instalar mesm, cm é demnstrad na imagem seguinte.

13 Depis de instalad Micrsft.Net Framewrk 4.0, pass seguinte será instalar n pst. Nesta fase da instalaçã deverá selecinar pnt Pst de frma que prgrama seja instalad cm pst, terá igualmente que selecinar qual a Pasta d executável d (Axis.exe), usand btã Prcurar.

14 Nesta fase assistente está prnt para iniciar a instalaçã, devend para iss clicar em Instalar de frma a dar inici à mesma.

15 Finalizada a instalaçã pel assistente deverá clicar em Cncluir de frma a terminar prcess de instalaçã. O prcess de upgrade permite realizar upgrade para a para as aplicações já instaladas da u, através da execuçã d setup de actualizaçã de cada uma das aplicações. upgrade de versões anterires à definid na secçã 3. Prcess de instalaçã. terá que ser realizad segund prcess Os cas nã tenha cnfigurad a aplicaçã para realizar dwnlad a

16 partir da aplicaçã, deverã bter d crrespndente à aplicaçã que pretende actualizar., na zna Simply, ficheir de Upgrade Os upgrade. deverã utilizar s ficheirs de upgrade enviad pela F3M para realizar De seguida sã apresentads s prcediments para actualizar servidr e s psts. Para realizar upgrade d servidr deverá executar, n servidr, setup de upgrade, indicar a pasta nde está instalada a aplicaçã e cnfirmar a realizaçã d upgrade. A recrre a prcess de para execuçã de Descargas de dads e Desmarcações de dcuments entre as aplicações da linha. Para tal, quand exista a cnfiguraçã de Descargas entre aplicações, é brigatória a cnfiguraçã d mecanism de Transações. Para evitar que utilizadr da aplicaçã instale as nvas versões ds prduts sem a cnfiguraçã crrecta deste mecanism necessárias a funcinament da aplicaçã fi intrduzida a validaçã d mesm n utilitári de Actualizaçã da aplicaçã.

17 A executar btã Verificar além das validações já existentes prgrama de actualizaçã irá verificar se mecanism de Transações Distribuídas é necessári e está cnfigurad para crrect funcinament da aplicaçã em actualizaçã. Cas mecanism seja necessári e nã esteja cnfigurad a prgrama de Actualizaçã lançará mensagem a utilizadr: A partir deste mment deverã seguir as instruções definidas na deste manual. As validações realizadas sã: Aplicaçã Ligaçã Ligaçã Ligaçã Desmarcar Dcuments WinCTB WinGTE WinSEC Origem WinCTB X WinGCS X X X WinGSL X X WinGSO X X WinGTE X X X WinIMB X WinSEC X X X WinUTE X X X Para s prduts e é validada a cnfiguraçã a partir d an 2009 inclusive. A validaçã é efetuada sbre tdas as instituições registadas na aplicaçã desde que tenham parametrizad Servidr e Utilizadr da base de dads destin. Cas seja necessári cnfigurar Transacções Distribuídas deve: Cnfirmar se a parametrizaçã da descarga ns parâmetrs da Instituiçã está crrectamente cnfigurada. Cas nã esteja deverá ser crrectamente cnfigurad servidr da aplicaçã destin.

18 Pderá cnfirmar executand btã seguinte mensagem: e cas a cnfiguraçã esteja crrecta surgirá a Cnfigurar ambiente d mecanism Transacções Distribuídas. N mment das descargas ds váris prduts para as aplicações Destin, e é alimentada tabela cm a Origem de Dads da Descarga. Esta tabela é lida aquand da remçã de um dcument na aplicaçã destin para que pssa ser desmarcad dcument de rigem para pssível psterir descarga. Cas prcess de instalaçã nã cnsiga cmunicar cm determinad servidr su rgirá a seguinte mensagem:

19 a) Se servidr de dads se encntra mmentaneamente desligad deverá interrmper prcess de Instalaçã pressinand [Nã] e ligar servidr de dads indicad. b) Se servidr de dads indicad já nã existe, devid a uma alteraçã da estrutura de rede, deverá pressinar btã [Sim] para prceder à indicaçã d nv servidr da aplicaçã d rigem ds dads. Após indicar nv servidr pressine [Gravar]. A instalaçã prsseguirá cm as restantes validações. Na cnfiguraçã d ambiente d mecanism tems de cntemplar dis cenáris distints, nmeadamente: Cenári de um servidr físic cm múltiplas instâncias de Micrsft SQL Server : Neste cenári é brigatóri garantir a activaçã d serviç MSDTC (Pnt 1.a. da secçã 8.3. Cnfiguraçã d serviç MSDTC ) Cenári de váris servidres de dads fisicamente distints: Neste cenári cnfigurar s diverss servidres envlvid s, através da realizaçã das perações: Cnfiguraçã d serviç RPC. Cnfiguraçã d serviç MSDTC. Cnfiguraçã da Firewall d Windws. Validaçã de cnfiguraçã. As instruções para a cnfiguraçã d mecanism estã inscritas na secçã 8. Transações Distribuídas deste manual.

20 N pst nã será necessári executar qualquer setup de upgrade. Após atualizaçã d servidr, a aplicaçã atualizará cada pst na primeira execuçã desse pst. O prcess de atualizaçã permite a atualizaçã das aplicações já instaladas, através da execuçã d setup de actualizaçã de cada uma das aplicações. Cas nã tenha cnfigurad a aplicaçã para realizar dwnlad a partir da aplicaçã, deverá bter d, na zna SAPER, ficheir de Atualizaçã crrespndente à aplicaçã e versã que pretende actualizar. De seguida sã apresentads s prcediments para atualizar servidr e s psts. Após efetuar Dwnlad, deverá executar, n servidr, setup de actualizaçã, indicar a pasta nde está instalada a aplicaçã e cnfirmar a actualizaçã. Ver n que se refere a mecanism de Transações distribuídas. N pst nã será necessári executar qualquer setup de actualizaçã. Após actualizaçã d servidr, a aplicaçã actualizará cada pst na primeira execuçã desse pst. A executar pela 1ª vez a aplicaçã é apresentada a janela para identificar servidr de SQL e a passwrd d utilizadr SA. Após indicar esta infrmaçã deverá pressinar btã ( : Esta peraçã deverá ser executada n servidr, ist é, n lcal nde está instalad a a aplicaçã.) Cas tenha um servidr SQL Server de 64 Bits nde deseja instalar s dads deverá cnsultar a Cas tenha instalad SQL Server a partir da instalaçã da aplicaçã, servidr SQL Server a indicar será e a chave d utilizadr (Chave Anterir -

21 Após a sua execuçã, estará em cndições de adicinar uma nva instituiçã através d menu Arquiv/Instituições. Para bter a licença da aplicaçã que lhe permitirá crrect licenciament das aplicações, deverá seguir s passs: Aceder n prtal da F3M ( à área reservada Inserir s seus dads de acess a prtal Utilizadr e Passwrd (n cas de nã s pssuir, deve cntactar s serviçs da F3M). Ir a menu Sftware, e submenu Os Meus Prgramas

22 Na grelha cm as aplicações, deve seleccinar a pçã Dwnlad da Licença e guardar n seu cmputadr Para cncluir licenciament da aplicaçã deverá seguir as indicações da secçã seguinte. Após instalaçã da aplicaçã, antes de efectuar licenciament, surgirá a seguinte mensagem (exempl para a aplicaçã WinCTB): Deverá aceder as utilitáris e Licenciar a aplicaçã n menu frmulári: cnfrme

23 Pderá executar um ds seguintes passs para preenchiment ds dads: Intrduza s dads cnstantes da enviada pels Serviçs da e/u dispnível n Prtal da (área reservada) em Sftware\Os meus prgramas, Opçã Ver Licença. Seleccine e indique ficheir de licenciament da aplicaçã guardad anterirmente n seu cmputadr (ver secçã 6.2 para bter a licença). Autmaticamente sã preenchids s dads cnstantes da Após preenchiment ds dads seleccine A surgir a seguinte mensagem a aplicaçã fi licenciada cm sucess. Deverá antes de prsseguir cm a execuçã de aplicaçã instalar servidr intermédi para que as aplicações funcinem crrectamente. Instale setup dispnível n pacte de distribuiçã. Este setup instalará servidr intermédi e Instância d SQL Server 2005 e utilizadr SA cm chave d utilizadr (Chave Anterir - ).

24 A existência de uma instância denminada cm servidr intermédi da aplicaçã n servidr SQL Server 2005 instalad é brigatória para sistemas 64 Bits. Na primeira execuçã da aplicaçã será pedida a indicaçã d servidr de dads cnfrme secçã 6.1 deste dcument. Se desejar que s dads sejam guardads na instância de 64 Bits já anterirmente instalada deverá indicar essa instância d servidr de dads. Após a indicaçã d servidr de dads e de instalada a Instância d SQL Server 2005 será pedida a indicaçã da chave d utilizadr SA (Chave Anterir - ) Antes iniciar cnversã de dads de Access para SQL deverá prceder à reparaçã e cmpactaçã das bases de dads em Access. Para tal, na versã anterir à Prime, a entrar na aplicaçã aceda a Utilitáris e n menu Manutençã de Bases de dads execute as pções Cmpactar bases de dads e Reparar bases de dads para tdas as instituições que pretende cnverter para SQL. A lcalizaçã ds dads Access terá que ser válida para servidr de SQL, u seja, as bases de dads Access terã que estar dispníveis numa lcalizaçã d servidr de dads SQL u numa lcalizaçã de rede acessível a servidr de SQL.

25 Para fazer a migraçã de dads deverá aceder a menu seguinte janela será mstrada: A Nesta janela deverá cmeçar pr indicar a Base de Dads Geral Access da aplicaçã em através d btã de prcura u inserind manualmente caminh para a Base de Dads. Nta: cas haja alguma dúvida em relaçã a nme da Base de Dads Geral (ficheir que deverá ser seleccinad), este aparece já na janela de prcura: Depis de seleccinar a BD aparece uma lista cm as instituições existentes:

26 Tems entã que seleccinar as Instituições que desejams cnverter (marcand cm vist a linha crrespndente na cluna ) e/u e carregar n btã. Se já existir alguma das instituições seleccinadas aparece uma janela a perguntar se deseja cntinuar cm a cnversã das utras instituições u parar (a cnversã de uma instituiçã será realizada apenas se a instituiçã nã existir na versã Prime): Durante a migraçã é criad um ficheir que detalha a cnversã efectuada, permitind depis identificar se crreu alguma cisa mal e que fi que crreu mal. Este ficheir pde ser enviad através de u impress para ecrã clicand n btã u,

27 respectivamente, quand a cnversã terminar. Quand termina a cnversã de uma instituiçã aparece um avis a indicar que a cnversã fi bem sucedida, u cas haja algum err, que a cnversã nã fi efetuada e passa à cnversã das seguintes cas hajam mais instituições selecinadas. Após cnversã de dads de Access para SQL será necessári redefinir as ligações entre aplicações, indicand servidr de dads SQL e utilizadr. Para realizar a parametrizaçã da ligaçã entre aplicações deverá aceder a menu Utilitáris pçã Parâmetrs da Instituiçã e preencher s camps Servidr e Utilizadr. Na imagem seguinte é apresentad um exempl de parametrizaçã da descarga de para. As restantes ligações serã semelhantes. N camp deverá ser indicad nme da instância de SQL a utilizar. N exempl abaix a máquina nde está instalad SQL tem nme servidr e a instância de SQL é F3M2005, lg a infrmaçã a clcar é SERVIDOR\F3M2005. N camp deverá preencher cm F3MGCI. Nem tds s mapas persnalizads têm de ser actualizads, apenas mapas que utilizam infrmaçã prveniente da base de dads da instituiçã sã alv desta peraçã. A utilizar um mapa persnalizad que necessita de passar pel prcess de actualizaçã antes da realizaçã desse prcess prvcará a apresentaçã uma mensagem em tud idêntica à ilustraçã que se segue:

28 Para prceder à atualizaçã d mapa persnalizad deverá aceder a menu A seguinte janela será mstrada: Nesta janela deverá cmeçar pr seleccinar mapa persnalizad que pretende actualizar e através d btã entrar n md de alteraçã d referid mapa, cuj aspect será semelhante à seguinte ilustraçã:

29 Nesta janela deverá aceder à pçã d menu de cntext acessível através d clicar cm btã direit sbre mapa. A seguinte janela será mstrada: Deverá cnsiderar tabela abaix, devend indicar as bases de dads descritas, assciads a prdut a tratar:

30 Base Dads de Prdut Instância WinUTE WGuInst WinSEC WSECInst WinMLC WMLCInst WinIMB WIMBInst WinGVT WGVTInst WinGTE WGTEInst WinGSO WGSOInst WinGSL GP0000 WinGRH WInstGRH WinGES WESCInst WinCTB WInstCTB WinADO WInstAn Nesta janela deverá expandir nd mstrada: A seguinte janela será Nesta janela deverá seleccinar DSN referente à base de dads da instituiçã e clicar n btã. A seguinte janela será mstrada:

31 Nesta janela deverá clicar n btã. A janela fica nvamente activa, nde deverá seleccinar nd crrespndente à cnexã a DSN criada ns passs anterires e clicar n btã. A janela ficará cm um aspect idêntic à seguinte ilustraçã: Nesta janela deverá clicar n btã A janela de alteraçã d mapa parametrizad fica nvamente activa, na qual deverá utilizar btã para armazenar as alterações realizadas a mapa parametrizad e encerrar a janela.

32 Cncluíd este prcess mapa persnalizad está prnt a ser utilizad. Estes prcediments devem ser repetids para tds s mapas persnalizads que prduzem a mensagem apresentada n iníci desta secçã. Este dcument dispnibiliza a infrmaçã necessária a uma crrecta cnfiguraçã das transacções distribuídas necessária à transmissã de dads entre as aplicações da linha na cmpnente de descargas de dads, a transferência de dads entre e a, n cas de ter a aplicaçã sincrnizada n é necessári garantir que servidr da cnsiga cmunicar cm s restantes servidres da Na cnfiguraçã d ambiente d mecanism tems de cntemplar dis cenári s distints, nmeadamente: Cenári de um servidr físic cm múltiplas instâncias de Micrsft SQL Server : Neste cenári é brigatóri garantir a activaçã d serviç MSDTC (Pnt 1.a. da secçã 8.3. Cnfiguraçã d serviç MSDTC ) Cenári de váris servidres de dads fisicamente distints: Este cenári cnfigurar s diverss servidres envlvids, através da realizaçã das perações: Cnfiguraçã d serviç RPC. Cnfiguraçã d serviç MSDTC. Cnfiguraçã da Firewall d Windws. Validaçã de cnfiguraçã. Na Máquina Servidr da aplicaçã instalada encntrará a pasta que cntêm ficheirs que executads farã a cnfiguraçã d mecanism. Para a deverá cnsiderar a pasta Cada uma destas perações é apresentada em prmenr nas secções que se seguem. É imprtante referir que: As tarefas de cnfiguraçã têm de ser realizadas directamente sbre cada um ds servidres de Micrsft SQL Server envlvids, nã de td acnselhável a cnfiguraçã remta das mesmas.

33 Algumas das perações de seguida apresentadas implicam manuseament d registry. Após a cnfiguraçã d mecanism deverá reiniciar as máquinas ds servidres envlvids. Para que serviç esteja activ e cnfigurad crrectamente tem-se de: 1. N Servidr BD A : a. Cnfigurar crrectamente serviç RPC n servidr: 1. Executar n servidr ficheir Bat TransaccesDistribuidasRPC.bat que se encntra na pasta b. Cnfigurar crrectamente serviç RPC n registry d servidr: 1. Executar n servidr ficheir de cnfiguraçã d registry TransaccesDistribuidasRPC.reg que se encntra na pasta 2. N Servidr BD B : a. Repetir prcess especificad para Servidr BD A mas n âmbit d Servidr BD B. Para que serviç esteja activ e cnfigurad crrectamente tem-se de: 1. N Servidr BD A : a. Cnfigurar crrectamente serviç MSDTC n servidr: 1. Executar n servidr ficheir Bat TransaccesDistribuidasMSDTC.bat que se encntra na pasta b. Aceder à pçã Executar d menu Iniciar, para tal pde usar as teclas de atalh Tecla Windws + Tecla R : i. Na janela Executar : 1. Na cmbbx Abrir: especificar text dcmcnfg. Janela Executar 2. Carregar n btã OK. c. Ns Serviçs cmpnentes : i. Seleccinar nde Raiz da cnsla Serviçs cmpnentes :

34 1. Se surgir um Alerta de segurança d Windws idêntic a apresentad de seguida: Alerta de segurança d Windws a. Carregar n btã Manter Blquead. ii. Expandir nde Raiz da cnsla Serviçs cmpnentes. iii. Expandir nde Raiz da cnsla Serviçs cmpnentes Cmputadres. 1. Seleccinar nde Raiz da cnsla Serviçs cmpnentes O meu cmputadr. 2. Carregar cm btã direit d rat n nde referid n pnt anterir. 3. N menu de cntext, que surge: a. Seleccinar a pçã Prpriedades. Serviçs cmpnentes 4. Na janela Prpriedades de O meu cmputadr : a. Seleccinar a tab MSDTC. Tab MSDTC da janela Prpriedades de O meu cmputadr

35 b. Na tab MSDTC : i. Carregar n btã Cnfiguraçã de segurança. c. Na janela Cnfiguraçã de segurança : i. Seleccinar as checkbxes : 1. Acess a DTC na rede. 2. Permitir clientes remts. 3. Permitir recepçã. 4. Permitir emissã. ii. Seleccinar a ptinbuttn Autenticaçã nã necessária. iii. Garantir que valr da textbx Cnta: é NT AUTHORITY\NetwrkService. Janela Cnfiguraçã de segurança iv. Carregar n btã OK. v. Na mensagem de avis, que surge: vi. vii. Mensagem de avis 1. Carregar n btã Sim. Aguardar até ser apresentada uma mensagem de infrmaçã. Na mensagem de infrmaçã de que MSDTC fi reiniciad, que surge: viii. Mensagem de infrmaçã 1. Carregar n btã OK. Carregar n btã OK para fechar a janela Prpriedades de O meu cmputadr.

36 1. Expandir nde Raiz da cnsla Serviçs cmpnentes Cmputadres O meu cmputadr. 2. Expandir nde Raiz da cnsla Serviçs cmpnentes Cmputadres O meu cmputadr Crdenadr de Transacções Distribuídas. 3. Seleccinar nde Raiz da cnsla Serviçs cmpnentes Cmputadres O meu cmputadr Crdenadr de Transacções Distribuídas DTC Lcal. 4. Carregar cm btã direit d rat n nde referid n pnt anterir. 5. N menu de cntext, que surge: a. Seleccinar a pçã Prpriedades. Serviçs cmpnentes 6. Na janela Prpriedades de DTC Lcal : a. Seleccinar a tab Segurança. b. Na tab Segurança : i. Seleccinar as checkbxes : 1. Acess a DTC na rede. 2. Permitir clientes remts. 3. Permitir recepçã. 4. Permitir emissã. ii. Seleccinar a ptinbuttn Autenticaçã nã necessária. iii. Garantir que valr da textbx Cnta: é NT AUTHORITY\NetwrkService. Tab Segurança da janela Prpriedades de DTC Lcal

37 c. Carregar n btã OK. d. Fechar Serviçs cmpnentes. 2. N Servidr BD B : a. Repetir prcess especificad para Servidr BD A mas n âmbit d Servidr BD B. O crret funcinament d mecanism de Transacções distribuídas exige a crrecta cnfiguraçã da Firewall d Windws, n âmbit ds servidres envlvids. Para tal, tem-se de: 1. N Servidr BD A : a. N Painel de cntrl : i. Seleccinar a pçã Firewall d Windws. b. Na Firewall d Windws : i. Seleccinar tab Excepções. Painel de cntrl ii. iii. Tab Excepções da Firewall d Windws Na tab Excepções : 1. Carregar n btã Adic. prgrama. Na janela Adicinar um prgrama :

38 Janela Adicinar um prgrama 1. Carregar n btã Prcurar. 2. Na janela Prcurar : a. Navegar até à pasta de sistema, geralmente será C:\WINDOWS\system32\. b. Seleccinar ficheir msdtc.exe. Janela Prcurar c. Carregar n btã Abrir. 3. Carregar n btã Ok. iv. Na tab Excepções : 1. Carregar n btã Adicinar prta. v. Na janela Adicinar uma prta : 1. Na textbx Nme: : a. Especificar valr Prta Na texbx Prta: : a. Especificar valr Seleccinar a ptinbuttn TCP.

39 Janela Adicinar uma prta 4. Carregar n btã OK. vi. Carregar n btã OK. c. Fechar Painel de cntrl. 2. N Servidr BD B : a. Repetir prcess especificad para Servidr BD A mas n âmbit d Servidr BD B. É imprtante referir que em servidres Windws Server 2008 pde existir necessidade de cnfigurações adicinais na firewall. A Micrsft dispnibiliza um pequen utilitári que permite validar se s servidres envlvids n mecanism de Transacções distribuídas estã crrectamente cnfigurads. Este utilitári é designad DTCPing e pde ser encntrad na pasta De frma a validar se a cnfiguraçã ds servidres está crrecta tem-se de: 1. N Servidr BD A : a. Executar ficheir Dtcping.exe existente: 1. Se surgir um Alerta de segurança d Windws idêntic a apresentad de seguida: a. Carregar n btã Desblquear. 2. N Servidr BD B : a. Repetir prcess especificad para Servidr BD A mas n âmbit d Servidr BD B. 3. N Servidr BD A : a. N utilitári DTCPing : 1. Na textbx Remte Server Name: : a. Especificar valr <Servidr BD B>.

40 Utilitári DTCPing n Servidr BD A 2. Carregar n btã PING. 3. Verificar se resultad btid: a. Se fi sucess: Utilitári DTCPing n Servidr BD A i. Avançar para pnt 6. b. Se fi insucess: Utilitári DTCPing n Servidr BD A Utilitári DTCPing n Servidr BD A Para slucinar eventuais prblemas devem cntactar

41 Cas prcess autmátic definid nas secções anterires, pr alguma razã, nã surta efeit desejad pderá validar/cnfigurar manualmente a cnfiguraçã d mesm. De frma a validar crrect funcinament d DNS tem-se de: 1. N Servidr BD A : a. N utilitári Linha de cmands : i. Executar cmand ipcnfig, de frma a verificar qual Endereç IP v4 d servidr: Utilitári ipcnfig n Servidr BD A 2. N Servidr BD B : a. N utilitári Linha de cmands : i. Executar cmand ipcnfig, de frma a verificar qual Endereç IP v4 d servidr: Utilitári ipcnfig n Servidr BD B 3. N Servidr BD A : a. N utilitári Linha de cmands : i. Executar cmand ping <Servidr BD B>, de frma a verificar acess a Servidr BD B.

42 Utilitári ping <Servidr BD B> n Servidr BD A ii. Verificar se Endereç IP v4 indicad para Servidr BD B crrespnda a Endereç IP v4 identificad pel cmand ipcnfig realizad n Servidr BD B : 1. Cas a verificaçã seja psitiva: a. N âmbit d mecanism que estams a analisar a indicaçã que nã é pssível atingir destin nã é relevante. 2. Cas a verificaçã seja negativa: a. Cntactar administradr da rede. 4. N Servidr BD B : a. N utilitári Linha de cmands : i. Executar cmand ping <Servidr BD A>, de frma a verificar acess a Servidr BD A. Utilitári ping <Servidr BD A> n Servidr BD B ii. Verificar se Endereç IP v4 indicad para Servidr BD A crrespnda a Endereç IP v4 identificad pel cmand ipcnfig realizad n Servidr BD A : 1. Cas a verificaçã seja psitiva: a. N âmbit d mecanism que estams a analisar a indicaçã que nã é pssível atingir destin nã é relevante. 2. Cas a verificaçã seja negativa: a. Cntactar administradr da rede.

43 Para que serviç esteja activ e cnfigurad crrectamente tem-se de: 1. N Servidr BD A : a. Cnfigurar crrectamente serviç RPC n servidr: 1. Clicar cm btã direit d rat na pçã O meu cmputadr. 2. N menu de cntext, que surge: a. Seleccinar a pçã Gerir. Acess à gestã d servidr 3. Na Gestã de cmputadres : a. Expandir nde Serviçs e aplicações. b. Seleccinar nde Serviçs. c. Na lista de serviçs apresentads clicar cm btã direit d rat n serviç Lcalizadr RPC (Remte Prcedure Call). d. N menu de cntext, que surge: i. Seleccinar a pçã Prpriedades. Gestã de cmputadres e. Na janela Lcalizadr RPC (Remte Prcedure Call) Prpriedades : i. Na cmbbx Tip de arranque: : 1. Seleccinar a pçã Autmátic.

44 ii. Janela Lcalizadr RPC (Remte Prcedure Call) Prpriedades Se btã Iniciar estiver dispnível: 1. Carregar n btã Iniciar. Janela Cntrl de serviçs 2. Aguardar que serviç inicie. Lcalizadr RPC (Remte Prcedure Call) Prpriedades 3. Carregar n btã OK. f. Fechar a Gestã de cmputadres. b. Cnfigurar crrectamente serviç RPC n registry d servidr: 1. Aceder a Editr de regist : a. Expandir e seleccinar a chave O meu cmputadr\hkey_local_machine\software\pli cies\micrsft\windws NT. b. Se nã existir a chave RPC, dentr da chave referida n pnt anterir: i. Criar a chave RPC. c. Se nã existir valr RestrictRemteClients dentr da chave O meu cmputadr\hkey_local_machine\software\pli cies\micrsft\windws NT\RPC : i. Criar valr RestrictRemteClients.

45 d. Se s dads assciads a valr RestrictRemteClients da chave O meu cmputadr\hkey_local_machine\software\pli cies\micrsft\windws NT\RPC nã fr 0x (0) : i. Alterar s dads d valr RestrictRemteClients, send que tem de ser garantid que: 1. Na textbx Dads d valr: : a. O valr especificad é O ptinbuttn Hexadecimal está seleccinad. Janela Editar valr DWORD 3. Carregar n btã OK. 2. Fechar Editr de regist. 2. N Servidr BD B : a. Repetir prcess especificad para Servidr BD A mas n âmbit d Servidr BD B. Para que serviç esteja activ e cnfigurad crrectamente tem-se de: 3. N Servidr BD A : a. Cnfigurar crrectamente serviç MSDTC n servidr: 1. Clicar cm btã direit d rat na pçã O meu cmputadr. 2. N menu de cntext, que surge: a. Seleccinar a pçã Gerir. Acess à gestã d servidr 3. Na Gestã de cmputadres : a. Expandir nde Serviçs e aplicações. b. Seleccinar nde Serviçs. c. Na lista de serviçs apresentads clicar cm btã direit d rat n serviç DTC (Crdenadr de transações distribuídas). d. N menu de cntext, que surge:

46 i. Seleccinar a pçã Prpriedades. Gestã de cmputadres e. Na janela DTC (Crdenadr de transacções distribuídas) Prpriedades : i. Na cmbbx Tip de arranque: : 1. Seleccinar a pçã Autmátic. ii. Janela DTC (Crdenadr de transacções distribuídas) Prpriedades Se btã Iniciar estiver dispnível: 1. Carregar n btã Iniciar. Janela Cntrl de serviçs 2. Aguardar que serviç inicie. Janela DTC (Crdenadr de transacções distribuídas) Prpriedades 3. Carregar n btã OK. f. Fechar a Gestã de cmputadres. b. Ver (Pnt 1.b. 1.c e 1.d da secçã 8.3. Cnfiguraçã d serviç MSDTC ) 4. N Servidr BD B :

47 a. Repetir prcess especificad para Servidr BD A mas n âmbit d Servidr BD B. Ver secçã 8.4 d dcument Ver secçã 8.5 d dcument Para slucinar eventuais prblemas devem cntactar

48 O crrect funcinament d webservice WSF3M é apenas garantid na versã u superir. De frma a agilizar prcess de cmunicaçã entre as sluções F3M e uma platafrma externa, pretende -se criar um Webservice que servirá cm pnte de cmunicaçã entre as duas platafrmas. O Webservice dispnibilizará métds cnsiderads relevantes para prcess de integraçã e cnsulta às bases de dads das sluções F3M. Este dcument tem cm prpósit descrever a arquitectur a d Webservice para integraçã cm aplicações externas cm sluções F3M. Para dispnibilizar webservice ns clientes devem ser garantids s seguintes requisits: Internet Infrmatin Services (IIS) instalada e peracinal. IP fix, u funcinalidade de IP através de uma ferramenta (ex. dyndns, etc.) Cas exista Firewall ativa, incluir as exceções para as prtas que dispnibilizam serviç. A pasta nde está clcad Webservice tem que ter permissões de escrita e leitura. O Webservice deverá estar aljad num pst nde se encntra mtr de Base de Dads. Cliente Platafrmas Externas Webservice WSF3M Internet Web Disp. móveis Sluções F3M Aplicações Sã definidas as seguintes regras para Webservice: Devem ser respeitads s frmats de dads passads pr parâmetr ns métds tip (string, lng, integer,date e blean). O frmat ds camps das datas devem ser passads n frmat an mês -dia yyyy-mm-dd. O Cnteúd ds dads e resultads da invcaçã d WebService serã devlvids pr Object e pr ficheirs de text. O Object devlvid ChavesCriadas divide-se em 2 duas listas ( RespstaPedid que cntem s camps Cdig e Descrica e PedidApi cntem s camps CdEntidade, CdEntidadeLigada, CdTipEntidade, mmetd e mstrretrn).

49 Para reclher respsta ds métds deve ser utilizada a bibliteca Micrsft XML4 para ler bject ChavesCriadas que é d tip IXMLDOMSelectin. Os Ficheirs de text devlvids têm s nmes de wsf3m_brwsedata +an+mês+dia+hra+minut, wsf3m_brwsedatainf +an+mês+dia+hra+minut e ws +an+mês+dia Os Ficheirs ws +an+mês+dia cntem s resultads das chaves de regists criads na sluçã F3M e infrmaçã de errs u dads inválids na invcaçã ds métds d webservice. Os Ficheirs wsf3m_brwsedata +an+mês+dia+hra+minut cntem resultad da cnsulta de dads n frmat JSON. Os Ficheirs wsf3m_brwsedatainf +an+mês+dia+hra+minut cntem infrmaçã de errs u dads inválids na invcaçã ds métds d webservice.estã dispníveis s seguintes métds n WebService: O métd BrwseData que permite fazer cnsultas às bases de dads. O métd mcdigs permite adicinar, editar e cnsultar dads na tabela de códigs Cdigs nas bases dads da WinUTE. O métd mvalencias permite adicinar, editar e cnsultar dads na tabela de valências Valencias nas bases dads da WinUTE. O métd mtiputentes permite adicinar, editar e cnsultar dads na tabela de Tips de Utentes TipUtentes nas bases dads da WinUTE. O métd mutentesrespnsaveis permite adicinar, editar e cnsultar dads nas tabelas de Utentes e Respnsaveis Utentes e Respnsaveis nas bases dads da WinUTE. O métd mcdigsutente permite adicinar, editar e cnsultar dads na tabela de Códigs de Utentes CdigsUtente nas bases dads da WinUTE. Cm bjetiv de garantir a segurança n acess as métds dispnibilizads pel WebService na invcaçã de cada métd será necessári enviar pr parâmetr s camps PrdutF3M Identifica prdut para qual pretende utilizar métd, BDDestin identifica a base de dads das sluções F3M a utilizar, Utilizadr e Passwrd. Passwrd: esta passwrd que irá cnsumir Webservice, de md a impedir manuseament de dads nã autrizadas à base de dads. Esta Passwrd é definida pr uma Hash MD5 cmpsta pela cncatenaçã da palavra-chave cmbinada e pel valr d camp cndiçã. MD5 (WSF3M/web.cnfig/key="WSF3MPasswrd" value="ws2015f3m" + PrdutF3M)

50 O métd BrwseData que permite fazer cnsultas à base de dads. BrwseData(ByVal PrdutF3M As String, ByVal BDDestin As String, ByVal Utilizadr As String, ByVal Passwrd As String,ByVal Tabela As String, ByVal Cndica As String, ByVal Camps As String, ByVal Grup As String) As String Parâmetrs de Entrada PrdutF3M: Text (Tamanh=6) que identifica prdut F3M. Ex.: WinUTE BDDestin: Text Text (Tamanh=6) que identifica a base de dads da Sluçã F3M a tratar. Ex.: UTE01 Utilizadr: Utilizadr (Tamanh=6) da sluçã F3M. Ex.: Administradr Passwrd: Text (Tamanh=8) Passwrd de utilizadr da sluçã F3M. Ex.: Tabela: Text tabela u cnsulta rigem ds dads. Ex.: tabclientelja Cndica: Text Filtr lógic u pesquisa que se pde aplicar à tabela. Ex.: Cdcliente<50 Camps: Text lista de camps que se pretende cnsultar. Ex.: Cdcliente, sum(ttalpnts) as ttal Grup: Text camps de agregaçã, cas haja ttalizadres. Ex.: Cdcliente Parâmetrs de Saída O Webservice devlve uma respsta d tip text. Cas existam regists, resultad é a lista de camps/valres de btids pela cnsulta. Os resultads sã exprtads n frmat JSON para ficheir de text wsf3m_brwsedata +an+mês+dia+hra+minut (este ficheir cntem s dads) e para wsf3m_brwsedatainf +an+mês+dia+hra+minut e ws +an+mês+dia (este ultim ficheir cntem infrmações sbre a execuçã d métd) Exempl: [{"cdcliente":"2","nme":"clientef3mrevenda","rua":"ruaaltssbreir","numplicia":"100","cdpst al":" ","ttalpnts":"378,4500"},{"cdcliente":"4","nme":"paulojorgeparadelacamacho","rua":" RUAMANUELPADRE CRUZ","numplicia":"123","cdpstal":" ","ttalpnts":"167,8600"},{"cdcliente":"6","nme":"VICTORIA SEGUROS","rua":"","numplicia":"","cdpstal":"","ttalpnts":"415,7000"},{"cdcliente":"7","nme" :"Teste","rua":"","numplicia":"","cdpstal":"","ttalpnts":"150,0000"},{"cdcliente":"8","nme":" ADVANCE","rua":"","numplicia":"","cdpstal":"","ttalpnts":"98,6000"},{"cdcliente":"9","nme": "KIKOGIRO","rua":"","numplicia":"","cdpstal":"","ttalpnts":"49,3000"},{"cdcliente":"10","nm e":"cliente CATEGORIA","rua":"","numplicia":"","cdpstal":"","ttalpnts":"49,4100"}]

51 O métd mcdigs permite fazer adiçã, ediçã e cnsultas à Tabela de Códigs Cdigs na s bases de dads da WinUTE. mcdigs(byval PrdutF3M As String, ByVal BDDestin As String, ByVal Utilizadr As String, ByVal Passwrd As String, ByVal Acca As Integer, ByVal Cdig As Integer, ByVal Descrica As String,ByVal Activ As Blean, ByVal IRS As Blean, ByVal TipPrdut As String,ByVal CntaPrcCnsums As Blean) As ChavesCriadas Parâmetrs de Entrada Este métd tem s seguintes parâmetrs de entrada: PrdutF3M: Text (Tamanh=6) que identifica prdut F3M. Ex.: WinUTE BDDestin: Text (Tamanh=6) que identifica a base de dads da Sluçã F3M a tratar. Ex.: UTE01 Utilizadr: Text (Tamanh=6) Utilizadr da sluçã F3M. Ex.: UserName Passwrd: Text (Tamanh=8) Utilizadr Passwrd de utilizadr da sluçã F3M. Ex.: Acca: Numéric (Tamanh=1) Identifica a acçã que se pretende que métd faça. Ex.: 1 Adicinar nv regist. 2 Ediçã de regist. 3 Cnsulta de regist. Cdig: Numéric (Tamanh=4) Camp numéric códig. Ex.: 1 Descica: Text (Tamanh= 50) Camp de text para descriçã. Ex.: Acmpanhament a estud Activ: Blean (Pssíveis = True ; False) Camp de blean que infrma se um regist se encntra activ. Ex.: True IRS: Blean (Pssíveis = True ; False) Camp de blean que infrma se um códig cnta para a declaraçã d IRS. Ex.: False TipPrdut: Text (Tamanh =1) Camp de text para identificar Tip de Prdut ( para SAF-PT) d Códig. Valres pssíveis: - Vazi S - Serviçs P - Prdut O - Outrs CntaPrcCnsums: Blean (Pssíveis = True ; False) Camp de blean que infrma se um códig cnta para prcessament de cnsums. Parâmetrs de Saída O Webservice devlve uma respsta n bject ChavesCriadas e gera ficheirs de text Ex.: Adiçã de Códig 765

52 O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg Exempl: :39:57;WinUTE;UTE01;Pedr;mCdigs;1;5-{"CdEntidade":"765"}Adicinad cm sucess :47:10;WinUTE;UTE01;Pedr;mCdigs;1;3-Já existe regist para 765 Nta : A ediçã de regist funcina da mesma frma. Ex.: Cnsulta O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg cm resultad da cnsulta em frmat JASON :08:11;WinUTE;UTE01;Pedr;mCdigs;3;8-Cnsulta : {"Cdig":"782","Descrica":"Teste manual","activ":"true","irs":"true","tipprdut":"p","cntaprccnsums":"true"} :14:38;WinUTE;UTE01;Pedr;mCdigs;3;8-Cnsulta : {"Cdig":"734","Descrica":"Teste de manual","activ":"true","irs":"true","tipprdut":"p","cntaprccnsums":"true"} O métd mtiputentes permite fazer adiçã, ediçã e cnsultas à Tabela de Tip Utentes TipUtentes nas bases de dads da WinUTE. mtiputentes(byval PrdutF3M As String, ByVal BDDestin As String, ByVal Utilizadr As String, ByVal Passwrd As String, ByVal Acca As Integer,ByVal Cdig As Integer, ByVal Descrica As String) As ChavesCriadas Parâmetrs de Entrada Este métd tem s seguintes parâmetrs de entrada: PrdutF3M: Text (Tamanh=6) que identifica prdut F3M. Ex.: WinUTE BDDestin: Text (Tamanh=6) que identifica a base de dads da Sluçã F3M a tratar. Ex.: UTE01 Utilizadr: Text (Tamanh=6) Utilizadr da sluçã F3M. Ex.: UserName Passwrd: Text (Tamanh=8) Utilizadr Passwrd de utilizadr da sluçã F3M. Ex.: Acca: Numéric (Tamanh=1) Identifica a acçã que se pretende que métd faça. Ex.: 1 Adicinar nv regist. 2 Ediçã de regist. 3 Cnsulta de regist.

53 Cdig: Numéric (Tamanh=2) Camp numéric códig. Ex.: 1 Descica: Text (Tamanh=20) Camp de text para descriçã. Ex.: Acmpanhament a estud Parâmetrs de Saída O Webservice devlve uma respsta n bject ChavesCriadas e gera ficheirs de text Ex.: Ediçã de Códig 9 O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg Exempl: :39:36;WinUTE;UTE01;Ja Pedr;mTipUtentes;3;8-Cnsulta : {"Cdig":"9","Descrica":"Teste de WebService" } Nta : A Adiçã de regist funcina da mesma frma. Ex.: Cnsulta O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg cm resultad da cnsulta em frmat JASON :39:36;WinUTE;UTE01;Ja Pedr;mTipUtentes;3;8-Cnsulta : {"Cdig":"9","Descrica":"Teste de WebService" }

54 O métd mvalencias permite fazer adiçã, ediçã e cnsultas à Tabela de Valências Valencias nas bases de dads da WinUTE. mvalencias(byval PrdutF3M As String, ByVal BDDestin As String, ByVal Utilizadr As String, ByVal Passwrd As String, ByVal Acca As Integer,ByVal Cdig As Decimal, ByVal Descrica As String, ByVal Activ As Blean, ByVal CrecheMdel1 As String, ByVal CrecheMdel2 As Integer) As ChavesCriadas Parâmetrs de Entrada Este métd tem s seguintes parâmetrs de entrada: PrdutF3M: Text (Tamanh=6) que identifica prdut F3M. Ex.: WinUTE BDDestin: Text (Tamanh=6) que identifica a base de dads da Sluçã F3M a tratar. Ex.: UTE01 Utilizadr: Text (Tamanh=6) Utilizadr da sluçã F3M. Ex.: UserName Passwrd: Text (Tamanh=8) Utilizadr Passwrd de utilizadr da sluçã F3M. Ex.: Acca: Numéric (Tamanh=1) Identifica a acçã que se pretende que métd faça. Ex.: 1 Adicinar nv regist. 2 Ediçã de regist. 3 Cnsulta de regist. Cdig: Numéric (Tamanh=10) Camp numéric códig. Ex.: 1 Descica: Text ( Tamanh=40) Camp de text para descriçã. Ex.: Acmpanhament a estud Activ: Blean (Pssíveis = True ; False) Camp de blean que infrma se um regist se encntra activ. Ex.: True CrecheMdel1: Text (Tamanh =1) Camp de Text Identifica Mdel1 Lista de valres Pssiveis : A = Creche acplada I = Creche Islada = Outr CrecheMdel2: Numéric (Tamanh=3) Camp de Inteir Identifica Mdel2 é uma percentagem que pde ser de 0 a 100. Ex.: 25 Parâmetrs de Saída O Webservice devlve uma respsta n bject ChavesCriadas e gera ficheirs de text

55 Ex.: Adiçã de Códig 898 O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg Exempl: :26:37;WinUTE;UTE01;Vitr;mValencias;1;5-{"CdEntidade":"898"}Adicinad cm sucess. Nta : A ediçã de regist funcina da mesma frma. Ex.: Cnsulta O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg cm resultad da cnsulta em frmat JASON :33:47;WinUTE;UTE01;Vitr;mValencias;3;8-Cnsulta : {"Cdig":"898","Descrica":"Valencia d 898 WebService","Activ":"True","CrecheMdel1":"1","CrecheMdel2":"1"} O métd mcdigsutente permite fazer adiçã, ediçã e cnsultas à Tabela de Códigs de Utente CdigsUtente nas bases de dads da WinUTE. mcdigsutente(byval PrdutF3M As String, ByVal BDDestin As String, ByVal Utilizadr As String, ByVal Passwrd As String, ByVal Acca As Integer, ByVal CdTipUtente As Lng, ByVal CdigUtente As Lng, ByVal CdCdig As Lng,ByVal Valr As Decimal, ByVal Prcessa_Jan As Blean,ByVal Prcessa_Fev As Blean, ByVal Prcessa_Mar As Blean, ByVal Prcessa_Abr As Blean,ByVal Prcessa_Mai As Blean, ByVal Prcessa_Jun As Blean, ByVal Prcessa_Jul As Blean, ByVal Prcessa_Ag As Blean, ByVal Prcessa_Set As Blean, ByVal Prcessa_Out As Blean, ByVal Prcessa_Nv As Blean, ByVal Prcessa_Dez As Blean) As ChavesCriadas Parâmetrs de Entrada Este métd tem s seguintes parâmetrs de entrada: PrdutF3M: Text (Tamanh=6) que identifica prdut F3M. Ex.: WinUTE BDDestin: Text (Tamanh=6) que identifica a base de dads da Sluçã F3M a tratar. Ex.: UTE01 Utilizadr: Text (Tamanh=6) Utilizadr da sluçã F3M. Ex.: UserName

56 Passwrd: Text (Tamanh=8) Utilizadr Passwrd de utilizadr da sluçã F3M. Ex.: Acca: Numéric (Tamanh=1) Identifica a acçã que se pretende que métd faça. Ex.: 1 Adicinar nv regist. 2 Ediçã de regist. 3 Cnsulta de regist. CdTipUtente: Numéric (Tamanh=2) Camp numéric para identificaçã d Tip de Utente. Ex.: 1 CdigUtente: Numéric (Tamanh=5) Camp numéric para identificaçã d Utente. Ex.: 1 CdCdig: Numéric (Tamanh=5) Camp numéric para identificaçã d Códig. Ex.: 5 Valr: Decimal (Tamanh =8,2) Camp Decimal para indicaçã de valr. Ex.: 500 Prcessa_Jan: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Janeir. Ex.: True Prcessa_Fev: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Fevereir. Ex.: True Prcessa_Mar: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Març. Ex.: True Prcessa_Abr: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Abril. Ex.: True Prcessa_Mai: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Mai. Ex.: False Prcessa_Jun: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Junh. Ex.: False Prcessa_Jul: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Julh. Ex.: True Prcessa_Ag: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Agst. Ex.: True Prcessa_Set: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Setembr. Ex.: True Prcessa_Out: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Outubr. Ex.: False Prcessa_Nv: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Nvembr. Ex.: False Prcessa_Dez: Blean (Pssíveis = True ; False) Camp blean que infrma se valr é prcessad n mês de Dezembr. Ex.: True Parâmetrs de Saída O Webservice devlve uma respsta n bject ChavesCriadas e gera ficheirs de text

57 Ex.: Ediçã de Códig O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg Exempl: :10:15;WinUTE;UTE01;Pedr;mCdigsUtentes;2;5- {"CdTipEntidade":"9","CdEntidade":"1","CdEntidadeLigada":"4"}Actualizad cm sucess. Nta : A Adiçã de regist funcina da mesma frma. Ex.: Cnsulta O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg cm resultad da cnsulta em frmat JASON :15:45;WinUTE;UTE01;Pedr;mCdigsUtente;3;8-Cnsulta : {"IDUtente":"2647","CdigUtente":"4","CdigTipUtente":"9","CdCdig":"1","Valr":"800","MnthlyPrcess Jan":"True","MnthlyPrcessFeb":"False","MnthlyPrcessMar":"False","MnthlyPrcessApr":"False","MnthlyPr cessmay":"false""mnthlyprcessjun":"false""mnthlyprcessjly":"true""mnthlyprcessaug":"false""mnthlypr cesssep":"true""mnthlyprcessoct":"false""mnthlyprcessnv":"true""mnthlyprcessdec":"true"} O métd mutentesrespnsaveis permite fazer adiçã, ediçã e cnsultas à Tabela de Utentes e Respnsaveis Utentes e Respnsavel nas bases de dads da WinUTE. mutentesrespnsaveis(byval PrdutF3M As String, ByVal BDDestin As String, ByVal Utilizadr As String, ByVal Passwrd As String, ByVal Acca As Integer, ByVal UtenteRespnsavel As String, ByVal CdTipUtente As Lng, ByVal CdigUtente As Lng, ByVal Nme As String,ByVal Activ As Blean, ByVal Mrada As String, ByVal DataInscrica As String, ByVal DataAdmissa As String, ByVal Valencia As Lng, ByVal Cntribuinte As String, ByVal NumRespnsavel As Lng) As ChavesCriadas Parâmetrs de Entrada Este métd tem s seguintes parâmetrs de entrada: PrdutF3M: Text (Tamanh=6) que identifica prdut F3M. Ex.: WinUTE BDDestin: Text (Tamanh=6) que identifica a base de dads da Sluçã F3M a tratar. Ex.: UTE01 Utilizadr: Text (Tamanh=6) Utilizadr da sluçã F3M. Ex.: UserName Passwrd: Text (Tamanh=8) Utilizadr Passwrd de utilizadr da sluçã F3M. Ex.: Acca: Numéric (Tamanh=1) Identifica a acçã que se pretende que métd faça.

58 Ex.: 1 Adicinar nv regist. 2 Ediçã de regist. 3 Cnsulta de regist. UtenteRespnsavel: Text (Tamanh=1) Camp de text que permite infrmar se pretendems tratar utentes u respnsáveis. Lista de valres Pssíveis: U Utentes R Respnsáveis Nta: A tratar utente (parâmetr UtenteRespnsavel = U ) é criad um regist na tabela de respnsáveis nde utente é própri respnsável. O mesm funcina na ediçã de Utente, u seja se alterarms um regist de utente, esta alteraçã vai reflectir-se na tabela de respnsáveis nde respnsável é própri utente. Se entrar n métd cm parâmetr UtenteRespnsavel = R vams só tratar respnsaveis de um determinad utente (Tip de Utente + Cdig de Utente). CdTipUtente: Numéric (Tamanh=2) Camp numéric identifica códig d tip de utente.. Este camp valida na tabela de tips de utentes da WinUTE Ex.: 1 CdigUtente: Numéric (Tamanh=5) Camp numéric identifica códig utente. Este camp valida na tabela de utentes da WinUTE Ex.: 1 Nme: Text (Tamanh=50) Camp text Nme de Utente e Respnsável. Ex.: 1 Activ: Blean (Pssíveis = True ; False) Camp Blean indica se Utente u Respnsável se encntra activ. Ex.: True Mrada: Text (Tamanh =100) Camp text Mrada de Utente e Respnsável. Ex.: Rua 5 Outubr, nº238 DataInscrica : Data (Tamanh= 10) Camp text que indica a data de inscriçã d Utente Ex.: sempre em frmat an-mês-dia aaaa-mm-dd DataAdmissa: Data (Tamanh= 10) Camp text que indica a data de admissã d Utente Ex.: sempre em frmat an-mês-dia aaaa-mm-dd Valencia: Numéric (Tamanh=10) Camp numéric que identifica a valencia d utente. Este camp é validad na tabela de Valências da WinUTE. Ex.: 2 Cntribuinte: Text (Tamanh=15) Camp numéric que identifica númer de cntribuinte d utente. Ex.: NumRespnsavel: Numéric (Tamanh=2) Camp numéric que identifica númer de Respnsável. Ex.: 12 Parâmetrs de Saída O Webservice devlve uma respsta n bject ChavesCriada s e gera ficheirs de text Ex.: Adiçã de Utente

59 O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg Exempl: :49:38;WinUTE;UTE01;Ja Pedr;mUtentesRespnsaveis;1;5- {"CdTipEntidade":"9","CdEntidade":"5","CdEntidadeLigada":"1"}Adicinad cm sucess. Nta : A ediçã de regist funcina da mesma frma. Ex.: Cnsulta O Webservice devlve também uma respsta para ficheir de text ws +an+mês+dia lg cm resultad da cnsulta em frmat JASON :53:28;WinUTE;UTE01;Ja Pedr;mUtentesRespnsaveis;3;8-Cnsulta : {"ID":"2650","Cdig":"5","CdTip":"9","Nme":"Antóni Silva","Mrada":"Rua Cmendadr XPTO","Activ":"True","Cntribuinte":"","DataInscrica":" :00:00","DataAdmissa":" :00:00","CdValencia":"1"} A seguir sã apresentads exempls de scripts que pderã ser utilizads na invcaçã d Webservice. Cndica= CdTip =1 Tabela= UtentesRegistads UR INNER JOIN Utentes U ON UR.ID= U.ID Camps= U.ID,U.Nme,U.Mrada,U.Telefne,U.BI,U. Grup= U.Cncelh A seguir sã apresentads s errs que pderã surgir na invcaçã d métd BrwseData d Webservice. A palavra-chave inserida nã está crreta. Retrna "2;Palavra chave inválida" Ns parâmetrs Tabela, Camps, Cndica, Grup fram inseridas palavras inválidas (pr exempl: ;, delete, drp, alter, insert, update, exec, etc.) Retrna "3;Parâmetrs inválids" Nã fi encntrad nenhum regist na pesquisa Retrna "4;Nã fi encntrad nenhum regist" Outr err nã previst. Return "5; <descriçã d err>

60 N servidr nde se encntram instaladas as bases de dads das sluções F3M, para instalar webservice devem ser seguids as seguintes etapas: 1. Instalar IIS e selecinar as features de acrd cm a imagem apresentada de seguida e n final clicar na tecla OK. 2. Criar uma nva subpasta cm nme WINIPSS na lcalizaçã c:\inetpub\wwwrt. 3. Garantir premissões de escrita e leitura na nva pasta.

61 4. Cpiar s ficheirs da distribuiçã (\\dds\dds\distribuiçã\slidariedade\28\prject\wsf3m\instalaca)para a nva pasta que fi criada. 5. Aceder à pçã Internet Infrmatin Services (IIS) na Opçã Administrative Tls. 6. N IIS na pçã Default Site cm btã d lad direit d rat e esclher item Add Applicatin.

62 7. Nesta janela deve ser inserid Nme d Serviç =WINIPSS n camp Alias e inserir nme d caminh = c:\inetpub\wwwrt\winipss n camp Physical path Clique n btã Select 8. Na janela Select Applicatin Pl esclha a pçã.net v2.0

63 9 Pr fim abrir ficheir web.cnfig que está na pasta d webservice 5. Segurança) 9.1. Inserir a infrmaçã d nme d servidr SQL, nme da base de dads ds prduts WinIPSS bem cm s dads d utilizadr da base de dads Definir passwrd de utilizaçã d webservice que vai ser utilizada na invcaçã ds métds (ver Para cmputadres de 64bits deverã fazer ainda as seguintes etapas: 1. Clicar na pçã Applicatin Pls cm btã d lad direit d rat e esclher item.net 2.0 n separadr da direita. 2. Clicar n btã d lad direit d rat e esclher a pçã Advanced Settings 10 Na janela Advanced Settings clcar valr TRUE n item Enable 32-Bit Applicatins.

64 11 Verificar IP n Elance/HTTP para default webservice.