Softools (versão prévia)
O Softools é uma plataforma de aplicativo baseada na Web em que aplicativos personalizados e off-the-shelf podem ser projetados, criados e implantados em horas.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao Softools |
| URL | https://support.softools.net |
| support@softools.net |
| Metadados do conector | |
|---|---|
| Publicador | Softools Limited |
| Site da Web | https://www.softools.net |
| Política de privacidade | https://www.softools.net/privacy-policy |
| Categorias | Business Intelligence; Dados |
O Softools é uma plataforma líder noCode para a criação de aplicativos de processo empresarial. O Softools é uma plataforma de aplicativo baseada na Web em que aplicativos personalizados e off-the-shelf podem ser projetados, criados e implantados em horas.
Pré-requisitos
Os usuários exigem uma Licença Enterprise ou têm um site do Softools para usar nossas apis.
Uma chave de API é necessária para chamar a API, que pode ser encontrada My Profile em seu Site do Softools.
Uma App Identifier é necessária na maioria das chamadas à API.
Como obter credenciais
Os usuários exigem uma Licença Enterprise ou têm um site do Softools para usar nossas apis. Uma chave de API pode ser encontrada My Profile em seu Site do Softools.
Introdução ao conector
Use estas instruções para implantar esse conector como um conector personalizado no Microsoft Power Automate e no Power Apps.
Problemas e limitações conhecidos
Os limites de taxa podem ser encontrados aqui
Erros e soluções comuns
N/A
perguntas frequentes
Mais documentação de suporte podem ser encontradas aqui
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| CHAVE | secureString | A CHAVE para esta API | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Arquivar um registro |
Arquive um registro. Chame isso antes de excluir. |
| Corrigir um registro |
A API softools atende às atualizações delta, o que significa que você pode enviar apenas as alterações relevantes e não todo o documento por solicitação PATCH. |
| Criar um registro |
Enviar todos os valores de campo, incluindo padrões ao adicionar um novo registro a um aplicativo |
| Desarquivar um registro |
Desarquivar um registro. |
| Excluir um registro |
Excluir um registro. Para excluir um registro, você precisa arquivar primeiro. |
| Obter informações básicas do campo |
Obter dados de campo básicos para um aplicativo |
| Obter registros de relatório |
Obtém uma lista de registros do relatório, limitado a 250 registros por solicitação. Retorna apenas dados de campo de relatório. Pode iterar usando $top e $skip |
| Obter todos os registros |
Obtém uma lista de todos os registros do aplicativo. Pode iterar usando $top e $skip |
| Obter um registro |
Obtém um registro |
Arquivar um registro
Arquive um registro. Chame isso antes de excluir.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador de aplicativo
|
AppIdentifier | True | string |
O identificador do aplicativo pode ser encontrado na URL do aplicativo /App/{AppIdentifier} ou /{AppIdentifier} |
|
Identificador do registro
|
RecordID | True | string |
Identificador do registro |
|
Identificador de Inquilino
|
tenant | True | string |
O locatário pode ser obtido do administrador do sistema |
Retornos
- Corpo
- Message
Corrigir um registro
A API softools atende às atualizações delta, o que significa que você pode enviar apenas as alterações relevantes e não todo o documento por solicitação PATCH.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador de aplicativo
|
AppIdentifier | True | string |
Identificador do aplicativo. Pode ser encontrado na URL do aplicativo /App/{AppIdentifier} ou /{AppIdentifier} |
|
Identificador do registro
|
RecordID | True | string |
ID do registro |
|
Identificador de Inquilino
|
tenant | True | string |
O locatário pode ser obtido do administrador do sistema |
|
|
object |
Retornos
- Corpo
- Message
Criar um registro
Enviar todos os valores de campo, incluindo padrões ao adicionar um novo registro a um aplicativo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador de aplicativo
|
AppIdentifier | True | string |
O identificador do aplicativo pode ser encontrado na URL do aplicativo /App/{AppIdentifier} ou /{AppIdentifier} |
|
Identificador de Inquilino
|
tenant | True | string |
O locatário pode ser obtido do administrador do sistema |
|
|
object |
Retornos
- Corpo
- Message
Desarquivar um registro
Desarquivar um registro.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador de aplicativo
|
AppIdentifier | True | string |
O identificador do aplicativo pode ser encontrado na URL do aplicativo /App/{AppIdentifier} ou /{AppIdentifier} |
|
Identificador do registro
|
RecordID | True | string |
Identificador do registro |
|
Identificador de Inquilino
|
tenant | True | string |
O locatário pode ser obtido do administrador do sistema |
Retornos
- Corpo
- Message
Excluir um registro
Excluir um registro. Para excluir um registro, você precisa arquivar primeiro.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador de aplicativo
|
AppIdentifier | True | string |
O identificador do aplicativo pode ser encontrado na URL do aplicativo /App/{AppIdentifier} ou /{AppIdentifier} |
|
Identificador do registro
|
RecordID | True | string |
Identificador do registro |
|
Identificador de Inquilino
|
tenant | True | string |
O locatário pode ser obtido do administrador do sistema |
Retornos
- Corpo
- Message
Obter informações básicas do campo
Obter dados de campo básicos para um aplicativo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador de aplicativo
|
AppIdentifier | True | string |
O identificador do aplicativo pode ser encontrado na URL do aplicativo /App/{AppIdentifier} ou /{AppIdentifier} |
|
Identificador de Inquilino
|
tenant | True | string |
O locatário geralmente está na URL do site {tenant}.off.softools.net, no entanto, às vezes, esse é um alias. Contate o administrador de sistemas para confirmá-lo. |
Retornos
- Itens
- basic-fields-response
Obter registros de relatório
Obtém uma lista de registros do relatório, limitado a 250 registros por solicitação. Retorna apenas dados de campo de relatório. Pode iterar usando $top e $skip
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador de aplicativo
|
AppIdentifier | True | string |
O identificador do aplicativo pode ser encontrado na URL do aplicativo /App/{AppIdentifier} ou /{AppIdentifier} |
|
Identificador do registro
|
ReportID | True | number |
ID do relatório |
|
Número ou registros para ignorar
|
$skip | True | number |
Ignora registros, a configuração como 1 retornará o segundo registro |
|
Número ou registros a serem necessários
|
$top | True | number |
O número de registros a serem retornados, máximo = 250 |
|
O indentifier de campo a ser ordenado em chaves [FieldIdentifier]
|
$orderby | string |
Campo a ser ordenado por [fieldIdentifier] asc/desc |
|
|
Exemplo de filtro Odata [TextField1] eq 'Meu registro'
|
$filter | string |
Forneça uma cadeia de caracteres de filtro oData para filtrar registros. No formulário [fieldIdentifier] exemplo de filterValue de operação [textField] eq 'Text' Operadores permitidos Eq Equal /Suppliers?$filter=[City] eq 'Redmond' Ne Not equal /Suppliers?$filter=[City] ne 'London' Gt Greater than /Products?$filter=[Price] gt 20 Ge Greater than or equal /Products?$filter=[Preço] ge 10 Lt Menor que /Products?$filter=[Preço] lt 20 Le Menor ou igual /Products?$filter=[Preço] le 100 And Logical and /Products?$filter=[Price] le 200 and Price gt 3.5 |
|
|
Identificador de Inquilino
|
tenant | True | string |
O locatário pode ser obtido do administrador do sistema |
Retornos
- Itens
- List-record-response
Obter todos os registros
Obtém uma lista de todos os registros do aplicativo. Pode iterar usando $top e $skip
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador de aplicativo
|
AppIdentifier | True | string |
O identificador do aplicativo pode ser encontrado na URL do aplicativo /App/{AppIdentifier} ou /{AppIdentifier} |
|
Número ou registros para ignorar
|
$skip | True | number |
Ignora registros, a configuração como 1 retornará o segundo registro |
|
Número ou registros a serem necessários
|
$top | True | number |
O número de registros a serem retornados, máximo = 250 |
|
O indentifier de campo a ser ordenado em chaves [FieldIdentifier]
|
$orderby | string |
Campo a ser ordenado por [fieldIdentifier] asc/desc |
|
|
Exemplo de filtro Odata [TextField1] eq 'Meu registro'
|
$filter | string |
Forneça uma cadeia de caracteres de filtro oData para filtrar registros. No formulário [fieldIdentifier] exemplo de filterValue de operação [textField] eq 'Text' Operadores permitidos Eq Equal /Suppliers?$filter=[City] eq 'Redmond' Ne Not equal /Suppliers?$filter=[City] ne 'London' Gt Greater than /Products?$filter=[Price] gt 20 Ge Greater than or equal /Products?$filter=[Preço] ge 10 Lt Menor que /Products?$filter=[Preço] lt 20 Le Menor ou igual /Products?$filter=[Preço] le 100 And Logical and /Products?$filter=[Price] le 200 and Price gt 3.5 |
|
|
Identificador de Inquilino
|
tenant | True | string |
O locatário pode ser obtido do administrador do sistema |
Retornos
- Itens
- List-record-response
Obter um registro
Obtém um registro
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificador de aplicativo
|
AppIdentifier | True | string |
O identificador do aplicativo pode ser encontrado na URL do aplicativo /App/{AppIdentifier} ou /{AppIdentifier} |
|
Identificador do registro
|
RecordID | True | string |
Identificador do registro |
|
Identificador de Inquilino
|
tenant | True | string |
O locatário pode ser obtido do administrador do sistema |
Retornos
- Corpo
- Record-Response
Definições
Message
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
Message | string |
basic-fields-response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Identificador
|
Identifier | string | |
|
Tipo
|
Type | integer |
Listar registro-resposta
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
Record-Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
_id
|
_id | string | |
|
AppIdentifier
|
AppIdentifier | string | |
|
CreatedByUserId
|
CreatedByUserId | string | |
|
CreatedByUser
|
CreatedByUser | string | |
|
$date
|
CreatedDate.$date | integer | |
|
UpdatedByUserId
|
UpdatedByUserId | string | |
|
UpdatedByUser
|
UpdatedByUser | string | |
|
$date
|
UpdatedDate.$date | integer | |
|
Identificador
|
Identifier | string | |
|
QuickFilterSearchText
|
QuickFilterSearchText | string | |
|
ID
|
Id | string | |
|
EditableAccessForUser
|
EditableAccessForUser | boolean |