Web service ProcessPermissions

Lista de processos do Workflow.

WSDL

Síncrono: http://example.com/TaskManagerServices/ProcessPermissions?WSDL

Porta

processList

Obtém os processos permitidos para que um determinado usuário possa executar.

Necessita autenticação: Sim.

Situação da versão: Atual.

Versão: 1.

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:processList>
         <user>String</user>
         <pass>String</pass>
         <encrypted>Int</encrypted>
         <parameters>String</parameters>
      </ser:processList>
   </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
user	Obrigatório	String	Nome do usuário para autenticação.
pass	Obrigatório	String	Senha do usuário para autenticação.
encrypted	Obrigatório	Integer	Campo utilizado para encriptação de senha. Pode ser: 0 (Sem encriptação) e 1 (encriptado). Quando a chamada for realizada por um sistema não Senior, sempre deve ser informado parâmetro zero (0), pois este sistema não terá como encriptar a senha no padrão Senior.
parameters	Opcional	Integer	Parâmetros de filtro para saber de qual usuário e permissão serão retornados os processos permitidos. Caso este parâmetro não seja informado ou seja nulo, o retorno será vazio, pois não há informações a serem usadas como filtro.

Resposta:

Observação

Envelope SOAP de resposta de requisições síncronas.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Body>
      <ns2:processListResponse xmlns:ns2=_"http://services.senior.com.br">
         <return>OK</return>
      </ns2:processListResponse>
   </soapenv:Body>
</soapenv:Envelope>

Após a execução do serviço de obtenção de processos, um retorno é disponibilizado informando o resultado da execução, podendo ser:

Sucesso: retorna uma lista com todos os processos que o usuário tem a permissão, no seguinte formato: OK={ "Process" : [ "$nome_processo", "$nome_processo", "$nome_processo" ] };
1. $nome_processo: representa o nome do processo que o usuário tem permissão.
Retorno vazio: caso nenhum processo seja encontrado para um determinado usuário, a lista retorna vazia. O retorno segue o formato: OK={ "Process" : [ ] };
Erros contornáveis:
1. Caso não seja possível autenticar, a obtenção dos processos é abortada;
2. Usuário informado no parâmetro para obter processo é inválido;
3. Permissão informada no parâmetro para obter processo é inválida;
4. Existe um timeout de 60 segundos para cada chamada de serviço. Este tempo não poderá ser alterado. Caso a solicitação de início ultrapasse, a execução é cancelada. Esta é a única ocorrência de erro contornável que é registrada no log do servidor.
Erros desconhecidos:
1. Retorna a mensagem do erro ocorrido, que será de acordo com o erro ocorrido;
2. Quando a mensagem de retorno é vazia: "Erro desconhecido".

Exemplo de execução:

Chamada do serviço até o seu retorno com um cenário de sucesso:

Execute a chamada do web service:
- URL: http://<servidor>:<porta>/TaskManagerServices/ProcessPermissions
- Operação: processList
Informe os parâmetros de entrada. Os dados dos campos usuário e senha são utilizados para autenticar o usuário informado. Também são validados os Parâmetros de entrada do processo:
- Usuário: senior
- Senha: senior
- Encriptação: 0 (sem encriptação)
Parâmetros de entrada do processo:

<pmPermission>faExecute</pmPermission> <pmUser>NomeUsuario</pmUser>

Acima, em <pmPermission>, é necessário informar e validar a permissão faExecute. Este parâmetro de entrada retornará quais processos possuem a permissão anteriormente citada para o usuário informado: NomeUsuario em <pmUser>.

O sistema processa a requisição e busca os processos que o usuário possui;
Retorna todos os processos que o usuário tem permissão: OK={"Process" : ["$nome_processo", "$nome_processo"]}.

PORTAL DE DOCUMENTAÇÃO
Workflow - versão 6.10.1