GetServiceTypes:

       Através desta função é possível obter uma lista dos tipos de TAS disponíveis. Na arquitetura do TOTVS API Services, podem ser criados vários tipos diferentes, como:

• MashupStudioService – Mashups criados com a ferramenta Mashup Studio
• MetadataService – Serviços de informações dos Mashups
• WebServices – Mashups baseados em WebServices

  Parâmetros: (SOAConnectionData)

  Resultados: Array de strings com a lista de ServiceTypes.

   Classe: SOAConnectionData:

• ClientID: String – ID do Client do TOTVS API Services
• UserName: String – Nome do usuário do TOTVS API Services
• Password: String – Senha do usuário

GetServiceNames:

       Através desta função é possível obter uma lista dos serviços do TAS disponíveis para o ServiceType selecionado. Cada ServiceType pode ter vários serviços publicados.

  Parâmetros: (SOAConnectionData; ServiceType: String)

  Resultados: Array de strings com a lista de serviços do TAS.

GetServicesInfo:

       Através desta função é possível obter uma lista com detalhes dos serviços do TAS disponíveis para o SearchType e SearchValue informados. Esta função retorna diversas informações sobre os TAS que estão definidas na classe SOAServiceInfo.

  Parâmetros:

• SOAConnectionData
• SearchType: Enumerado (All, ServiceName, ServiceTitle, Description, Provider, Tag)
• SearchValue: String

  Resultados: Array de SOAServiceInfo.

  Classe: SOAServiceInfo

• ServiceType: String – Tipo de serviço do Mashup
• ServiceName: String – Nome do Mashup
• ServiceVersion: Integer – Versão do Mashup
• ServiceTitle: String – Título do Mashup
• ServiceProvider: String – Provedor dos dados do Mashup
• ServiceDescription: String – Descrição detalhada do Mashup
• ServiceTags: Strings – Tags relacionadas ao Mashup
• ServiceDate: DateTime – Data da publicação/alteração do Mashup

GetService:

       Através desta função é iniciado o processo de execução do TAS, ela retorna todas as informações de execução do TAS como Parâmetros e Resultados da execução do TOTVS API Services.

  Parâmetros: (SOAConnectionData; ServiceType: String; ServiceName: String; ServiceVersion: Integer)

  Resultados: SOAServiceData.

  Classe: SOAServiceData

• ServiceExecutionID: String – ID da execução do Mashup
• ServiceType: String – Tipo de serviço do Mashup
• ServiceName: String – Nome do Mashup
• ServiceVersion: Integer – Versão do Mashup
• ServiceTitle: String – Título do Mashup
• CurrentState: String – Estado da execução do Mashup
• CurrentStateDescription: String – Descrição do estado da execução do Mashup
• Data: Array de SOAData – Dados da execução do Mashup  

  Classe: SOAData

• DataKind: Enumerado – Tipo do dado do Mashup:
  • Param: Indica que o dado é um parâmetro do Mashup
  • Info: Indica que o dado é uma informação a ser mostrada do Mashup
  • Result: Indica que o dado é um resultado da execução do Mashup
  • Internal: Indica que é um dado para uso interno do Mashup
• DataType: Enumero – Indica o tipo de dado do valor
  • Boolean: Indica um dado do tipo boolean (True, False);
  • Integer: Indica um dado de tipo número inteiro;
  • Number: Indica um dado de tipo número (Double), deve ser usado o separador de decimal “.” (Ponto) e sem separador de milhar;
  • DateTime: Indica um dado no formato data/hora canônico (aaaa-MM-dd hh:mm:ss), caso o valor indicar somente hora, a data deve ser igual a “01/01/0001”;
  • String: Indica um dado do tipo texto;
  • List: Indica um dado que contem uma lista de valores/descrições;
  • Image: Indica um dado que contem uma imagem (JPEG com Codificação Base64);
  • Table: Indica um dado que contem uma tabela de valores detalhada abaixo;
• Name: String – Nome do dado do Mashup
• Description: String – Descrição do dado do Mashup
• StateName: String – Indica o nome do estado referente ao dado (somente para parâmetros)
• Value: String – Contém o valor do dado de acordo com o tipo de dado.
• ListItems: Array de SOADataListItem (válido somente para o DataType = List)
• Columns: Array de SOAData (válido somente para o DataType = Table)
• Required: Boolean – Indica se o parâmetro é obrigatório para a execução do Mashup
• Code: String – Código do valor do item da Lista
• Description: String – Descrição do item da Lista

    Classe: SOADataListItem

• Code: String – Código do valor do item da Lista
• Description: String – Descrição do item da Lista

Execute:

Através desta função é feita a execução do estado atual do Mashup, após a chamada da função GetService e de preenchido os parâmetros obrigatórios do Mashup, deve-se chamar a função Execute para iniciar a execução.

Parâmetros: (SOAConnectionData; SOAServiceData)

Resultados:

• SOAServiceData – Dados da execução do Mashup
• ResultType: Enumerado – Indica o resultado da execução do Mashup
  • Continue – Indica que a execução do Mashup não chegou ao final e que deve ser preenchido os parâmetros do estado atual.
  • Finished – Indica que o Mashup terminou a sua execução com sucesso.
  • Error – Indica que houve um erro na execução do Mashup e a mesma deve ser interrompida.
  • Warning – O mesmo que um erro, também implica no fim da execução do Mashup.
  • InvalidParam – Indica que um parâmetro informado não é válido, o parâmetro deve ser informado corretamente e a execução do Mashup pode ser continuada.
• ResultMessage: String – Contém a mensagem de erro quando o ResultType é Error, Warning ou InvalidParam.
• ResultMessageCode: Integer – Contém um código relativo a mensagem de erro.

Quando o tipo de dado é do tipo Table, o string do valor contém uma estrutura com os dados da tabela. O XML é formado da seguinte maneira:

<?xml version=”1.0” encoding=”utf-8”>

<TotvsMashupTable SelectedIndex=0>
  <Schema>
    <Column>
      <Name>Nome da Coluna</Name>
      <DataType>Tipo de dados da Coluna (SOADataType)</DataType>
    </Column>
  </Schema>
  <Data>
    <Row>
      <Nome da Coluna 1>Valor da Coluna 1</Nome da Coluna 1>
      <Nome da Coluna 2>Valor da Coluna 2</Nome da Coluna 2>
    </Row>
  </Data>
</TotvsMashupTable>

A propriedade SelectedIndex do TotvsMashupTable deve ser informada com o índice da Row selecionada pelo usuário, quando a tabela é um parâmetro do Mashup.

A tabela tem a sua definição informada no Schema, para cada coluna da tabela, existe uma entrada de <Column> no Schema.

Para cada <Row> é informado o valor de acordo com o tipo de dado da coluna.