Esta função pode ser usada em qualquer script criado no sistema zBot.
Instale o zBot (para Windows). Crie seus próprios scripts ou baixe sistemas e exemplos prontos para uso na loja, gratuitamente.
Categoria: Variáveis | Chamada: Pedir vários valores | Data de Atualização: 02/08/2024
&ValorPedirVarios("título do formulário"; "nome_campo1, nome_campo2:título de exibição::ajuda sobre o campo|opção1#opção2")[0] //*
// Cada campo pode ter até 4 componentes:
// Nome do campo (obrigatório)
// Título de exibição (para ficar mais amigável)
// Hint de ajuda (para detalhar a utilidade do campo)
// Opções, separadas por hashtag, exemplo: item1#item2#item3
//***
// Apenas o nome do campo é obrigatório
// Cada campo é separado por vírgula
&ValorPedirVarios("título do formulário"; "nome|item1#item2,E-mail::ajuda do email")[0] //*
&Mensagem([nome] - [e-mail])
&ValorPedirVarios("título do formulário"; "nome_cliente:Nome do Cliente:: Informe neste campo o nome do cliente")[0] //*
&ValorPedirVarios("título do formulário"; "nome, email, tratamento|Sr.#Sra")[0] //*
Esta é uma das funções mais úteis e versáteis. Apesar do nome &ValorPedirVarios(), muitas vezes é também adequada para solicitar a entrada de um único valor. Esta função oferece uma caixa de entrada de dados completa, com várias possibilidades de personalização e detalhamento dos valores solicitados.
Os campos devem ser separados por vírgula, exemplo:
nome, email, telefone
Cada campo pode ter até 4 elementos, que tem seu próprio separador para o sistema entender do que se trata:
Título de exibição -> ":"
Hint de ajuda -> "::"
Opções de seleção -> "|"
Um exemplo de definição de campos seria:
nome:Nome do Cliente::Informe o nome do cliente, tratamento:Pronome de tratamento::Selecione o pronome de tratamento para você|Sr.#Sra.
Perceba que nesta composição são definidos dois campos, mas com todas as personalizações opcionais definidas. O campo nome está separado do campo tratamento por uma vírgula. O campo tratamento faz uso de todos os marcadores possíveis para a personalização da experiência de uso, fornecendo um título personalizado de exibição, um texto de ajuda e duas opções que podem ser selecionadas para o valor do campo, ao invés de pedir uma entrada de dados livre, como ocorre com o campo nome.
Confirmando o preenchimento, os valores são automaticamente alocados nas variáveis definidas com o "nome do campo". Desse modo você pode usar um ou mais valores facilmente no restante do script
Categoria: Variáveis | Chamada: Pedir valor
Abre uma caixa de diálogo para pedir que um valor seja inserido, para então este valor ser atribuído em uma variável
Categoria: Variáveis | Chamada: Incrementar valor
Incrementa ou decrementa um valor do tipo número inteiro, em uma variável
Categoria: Variáveis | Chamada: Processar variáveis de um texto
Exemplo: "Olá [nome], como vai?" -> "Olá Fulano, como vai?"
Categoria: Variáveis | Chamada: Obter valor de um texto delimitado (linha e coluna)
Passe a linha que quer ler e o índice do valor delimitado que quer ler. Serve para ler dados em tabelas de texto com um delimitador
Categoria: Variáveis | Chamada: Adicionar linha em uma variável
Atribui uma linha extra em uma variável, com um valor passado por parâmetro