Header Web
Logo_PHC_Software
Manuais
Configuração de API
Para que possa invocar e executar o código de um Script, a partir de uma aplicação API - Interface de Programação de Aplicações, o utilizador deverá utilizar percorrer os seguintes passos:
    1 -Ter configurado um registo de Script, dedicado à necessidade específica do utilizador. Por exemplo: - Preenchimento dos dados de um Cliente através de uma API: Código do Script: cllistaExpressão no Programa Interno do Script:
    dim sql as new stringbuildersql.appendformat("select * from cl (nolock) where cl.no={0}",mstamp)dim dt as datatable = cdata.getdatatable(sql.tostring)return dt.WriteXmlToString()
    2 - Após a criação do Script, o utilizador poderá aceder à API, colocando no URL o seguinte caminho: [url da aplicação]/ws/wscript.asmx.Por exemplo: http://maisritmo.phc.pt/intranet/ws/wscript.asmx Pode usar esta API em qualquer aplicação que chame webservices.Para testar o código, o mesmo pode ser invocado diretamente no browser que, por motivos de segurança só pode ser utilizado na máquina onde a aplicação está instalada.Ao colocar o caminho indicado anteriormente, o utilizador vai invocar o método "RunCode" desse webservice.
    3 - Posteriormente, ao clicar na opção RunCode, dependendo da aplicação pela qual se está a aceder à API (Intranet ou Extranet), é pedido ao utilizador para preencher os seguintes parâmetros:
    • Intranet
    • Onde deverá preencher os seguintes parâmetros:
      userName: id de utilizador para login;password: palavra passe do utilizador para login; code: código do registo de scripts do utilizador a executar. Este código tem sempre que retornar uma string;parameter: parâmetro para o código. A variável no código chama-se mstamp.
    • Extranet
    • Onde deverá preencher os seguintes parâmetros:
      custumerCode: Nº de cliente;userName: id de cliente para login;password: Palavra passe do utilizador para login;code: Código do registo de scripts do utilizador a executar. Este código tem sempre que retornar uma string;parameter: Parâmetro para o código. A variável no código chama-se mstamp.
    Regressando ao exemplo, os campo que se indicam de seguida deverão ser preenchidos com a informação que se indica:code: cllista - Representa o Código do registo do Script do utilizador. parameter: 02 - De acordo com o exemplo, representa o número de cliente.4 - Posteriormente, ao clicar na opção Invoke a aplicação ATI irá retornar uma string XML com os dados do cliente nº 2 resultantes do "select" efetuado à base de dados, incluído no Script.
Esta string poderá resultar num documento com extensão ".XML", que pode ser utilizado por exemplo, para exportar todos os dados existentes num registo (neste caso de clientes), num ficheiro XML, de forma rápida, fácil e assertiva.