Criar um novo registro na tabela com os valores especificados
Cria um novo registro em uma tabela com os valores especificados.
new_record(table_id, data)
Resposta: novo ID do registro
Exemplo
Editar um registro existente na tabela
edit_record(table_id, record_id, data)
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)
Resposta:
{'message': 'Deleted records: 1'}
Encontrar um registro na tabela pelo valor especificado
find_record(table_id, value, find_in, return_from)
Resposta:
Se return_from for especificado, o valor da coluna especificada (se 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
Recuperar um valor do registro especificado
get_record_data(table_id, record_id)
Resposta: Se um registro for encontrado, um dicionário como {"column_name1": "value1", "column_name2": "value2"} é retornado. Se o parâmetro return_column for fornecido e tal coluna existir, apenas o valor dessa coluna será retornado.
Onde posso encontrar o ID da tabela?
Para trabalhar com 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ço.
Na barra de endereço, você verá uma URL como
https://salebot.pro/projects/11111/table/2,
onde você pode encontrar o ID da tabela desejada:
Recuperar um registro da tabela
get_records_from_table(table_id, start_row, count, start_col, end_col) - recupera um registro da tabela.
| Parâmetro | Descrição | Observação |
|---|---|---|
| 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 para começar a ler (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 um 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 para começar a ler (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 dados até esse ponto.
Exemplo
No bloco onde você precisa recuperar registros da tabela, vá para a seção "Calculadora" 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 "Iniciar" em modo de teste.
Podemos ver os dados que foram escritos na variável a partir da tabela na mensagem enviada pelo bot. Porque 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.
Se nenhum problema ocorrer durante a requisiçã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 através do 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", "Valor"), você deve especificar o intervalo usando o formato {"Produto1":"Valor3"}, 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
