Pular para o conteúdo principal

Tabelas Personalizadas

Visão geral​

As Tabelas Personalizadas permitem ampliar o modelo de dados do Skills Workflow com tabelas, colunas e tipos de dados próprios.

  1. Vá em Maintenance
  2. Selecione o módulo Custom Tables

img-box-shadow

Lista de tabelas personalizadas

Criar uma tabela personalizada​

  1. Clique em +
  2. Defina o nome da tabela
  3. Configure a coluna chave, normalmente Oid
  4. Adicione colunas e tipos de dados

img-box-shadow

Criação de uma nova tabela personalizada

Permissões​

Cada tabela possui:

  • Read Role para leitura
  • Save Role para inserção, atualização e remoção

img-box-shadow

Configuração de permissões

Ler dados com queries​

Use o namespace CustomTable e consulte o schema [customtables].

SELECT Oid, Name, Price, IsActive
FROM [customtables].[ProductCatalog]
WHERE IsActive = 1
ORDER BY Name

Referência do SDK​

Ver métodos do SDK

get​

Descrição​

Obtém todas as linhas de uma tabela personalizada e retorna como objetos JavaScript simples.

Uso básico​

const rows = await SW.Document.CustomTable.get("ProductCatalog");

create​

Descrição​

Cria a definição de uma tabela personalizada ou adiciona colunas a uma tabela existente.

await SW.Document.CustomTable.create("ProductCatalog", {
    KeyColumnName: "Oid",
    KeyDataTypeId: 9,
    Columns: [
        { ColumnName: "Name", ColumnDataTypeId: 6 },
        { ColumnName: "Price", ColumnDataTypeId: 4 }
    ]
});

insert​

Descrição​

Insere ou atualiza linhas em uma tabela personalizada.

await SW.Document.CustomTable.insert("ProductCatalog", {
    KeyValue: SW.Utils.Guid.getNew(),
    KeyColumnName: "Oid",
    Columns: [
        { ColumnName: "Name", ColumnDataTypeId: 6, Value: "Widget A" },
        { ColumnName: "Price", ColumnDataTypeId: 4, Value: 29.99 }
    ]
});

Referência da API​

Ver endpoints da API

Todos os endpoints exigem autenticação pelo cabeçalho X-AccessToken.

Base path: api/v3

Endpoints​

MétodoRotaDescrição
GET/custom-tablesLista as tabelas personalizadas
GET/custom-tables/{tableName}/rows/valuesRetorna todas as linhas
POST/custom-tables/{tableName}Cria a tabela ou adiciona colunas
PUT/custom-tables/{tableName}/rowsInsere ou atualiza linhas
DELETE/custom-tables/{tableName}/rowsRemove linhas
GET/custom-tables/{tableName}/exportExporta para JSON
PUT/custom-tables/{tableName}/importImporta de JSON

Leitura por query​

Use CustomTable como namespace nas queries e consulte [customtables].