Trabalhando com tabelas do MaviBot
Criar um novo registro na tabela com os valores especificados
Criar um novo registro em uma tabela com os valores especificados.
new_record(table_id, data)
table_id
ID da tabela
data
um dicionário com os dados a serem registrados. Exemplo: {"column_name1": "value1", "column_name2": "value2"}. Se a coluna não existir, ela é criada.
Resposta: ID do novo registro
Exemplo
Editar um registro existente na tabela
edit_record(table_id, record_id, data)
table_id
ID da tabela
record_id
ID do registro editado
data
um dicionário com os dados a serem editados. Exemplo: {"column_name1": "value3", "column_name2": "value4"}. Se a coluna não existir, ela NÃO é criada.
Resposta:
Retorna os dados completos do registro editado no formato: {"column_name1": "value3", "column_name2": "value4"}.
Exemplo
Excluir um registro da tabela pelo seu ID
delete_record(table_id, record_id)
table_id
ID da tabela
record_id
ID do registro excluído
Resposta:
{'message': 'Registros excluídos: 1'}
Encontrar um registro na tabela pelo valor especificado
find_record(table_id, value, find_in, return_from)
table_id
ID da tabela
value
o valor a ser correspondido
find_in -
parâmetro opcional. O nome da coluna pela qual pesquisar. Se não for especificado, a busca será realizada em todas as colunas.
return_from
parâmetro opcional. O nome da coluna da qual retornar o valor.
Resposta:
Se return_from for especificado, o valor da coluna especificada (se ela existir na tabela) será retornado. Se return_from não for especificado ou a coluna não existir, os dados completos do registro encontrado serão retornados na resposta, por exemplo: {"column_name1": "value3", "column_name2": "value4"}.
Exemplo
Obtendo um valor do registro especificado
get_record_data(table_id, record_id)
table_id
ID da tabela
record_id
ID do registro do qual os valores são recuperados
return_column
parâmetro opcional. O nome da coluna da qual o valor deve ser retornado.
Resposta: Se um registro for encontrado, é retornado um dicionário como {"column_name1": "value1", "column_name2": "value2"}. Se o parâmetro return_column for fornecido e essa coluna existir, será retornado apenas o valor dessa coluna.
Onde posso encontrar o ID da tabela?
Para trabalhar com as funções do chatbot, você precisará do ID da tabela. Encontre a tabela desejada na lista e clique nela.
Em seguida, clique na barra de endereços.
Na barra de endereços, você verá uma URL como https://salebot.pro/projects/11111/table/2, onde pode encontrar o ID da tabela desejada:
Recuperando um registro da tabela
get_records_from_table(table_id, start_row, count, start_col, end_col) - recuperando um registro da tabela.
table_id
ID da tabela
start_row
Parâmetro opcional, um inteiro. Especifica o início do intervalo de linhas.
O número da linha a partir da qual começar a leitura (inclusive). Escreva sem aspas.
count
Parâmetro opcional, um inteiro. Especifica o número de linhas a recuperar.
Por padrão, o valor é 1000, com máximo de 5000. Especifique sem aspas.
start_col
Parâmetro opcional, uma string. Especifica o início do intervalo de colunas.
O nome da coluna a partir da qual começar a leitura (inclusive). Escreva entre aspas.
end_col
Parâmetro opcional, uma string. Especifica o fim do intervalo de colunas.
O nome da coluna até a qual ler os valores da tabela (inclusive). Escreva entre aspas.
Se você especificar apenas o início do intervalo de linhas ou colunas, todos os dados a partir desse ponto serão retornados. Você também pode omitir o início e especificar apenas o fim para obter os dados até esse ponto.
Exemplo
No bloco em que você precisa recuperar registros da tabela, vá para a "Calculadora" seção nas configurações do bloco e insira a função com os parâmetros necessários.
Vamos ver como os dados são exibidos na tabela.
Agora, execute o bloco "Início" no modo de teste.
Podemos ver os dados que foram gravados na variável a partir da tabela na mensagem enviada pelo bot. Como referenciamos a variável na mensagem usando a sintaxe #{} , os dados armazenados nela foram exibidos no chat do bot.
Recuperar dados da tabela dentro de um intervalo especificado
table_read_cells(table_id, cell_data) - permite recuperar dados da tabela especificando intervalos.
! table_id
parâmetro obrigatório, ID da tabela
! cell_data
parâmetro obrigatório, um dicionário com intervalos.
cell_data exemplo: '{"a1":"a1", "a3": "b4", "c1": "c3"}'
Se não ocorrerem problemas durante a solicitação, a resposta será um dicionário contendo o status e todas as células com seus valores:
{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd"ou, em caso de erro: {"status": false, "err": "Mensagem ou descrição do erro"}
Exemplo na Calculadora
Por exemplo, as células da tabela contêm os seguintes valores especificados:
Para recuperar dados da tabela via bot, passe os intervalos necessários para as funções na Calculadora.
No exemplo, a construção #{res}, que contém uma variável, ajuda a exibir na mensagem os dados recuperados usando a função e o intervalo especificado:
Se os nomes das colunas forem diferentes (por exemplo, "Produto", "Número", "Quantidade"), você deve especificar o intervalo usando o formato {"Produto1":"Quantidade3"}, onde:
• Produto é o nome da primeira coluna • 1 indica que é a coluna número 1 • Valor é o nome da terceira coluna • 3 indica que é a coluna número 3
Atualizado