Instruções:

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.

&ValorPedirVarios

Categoria: Variáveis | Chamada: Pedir vários valores | Data de Atualização: 03/06/2024

Permite solicitar vários valores de uma só vez, para serem atribuídos em diversas variáveis. Se a variável solicitada já existir, o valor dela é colocada como valor padrão do campo

Estrutura de uso:

&ValorPedirVarios("título do formulário"; "nome_campo1, nome_campo2:título de exibição::ajuda sobre o campo|opção1#opção2")[0] //*

Exemplo:

// 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] //*

Ajuda:

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

Outras funções desta categoria:

&ValorDefinir

Categoria: Variáveis | Chamada: Definir variável

Aloca um valor em uma variável

&ValorPedir

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

&ValorInc

Categoria: Variáveis | Chamada: Incrementar valor

Incrementa ou decrementa um valor do tipo número inteiro, em uma variável

&ValorProcessar

Categoria: Variáveis | Chamada: Processar variáveis de um texto

Exemplo: "Olá [nome], como vai?" -> "Olá Fulano, como vai?"

&ValorLerCampo

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

&ValorInserirLinha

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

 Fale conosco