Uso de funções personalizadas

Nota  Esse recurso fica disponível quando o ajuste geral Usar ferramentas avançadas está selecionado. Consulte Uso de ferramentas avançadas.

Para criar uma função personalizada:

  1. Selecione o menu Arquivo > Gerenciar > Funções personalizadas.

  2. Na caixa de diálogo Gerenciar funções personalizadas, clique em Novo.

  3. Na caixa de diálogo Editar função personalizada, em Nome da função, digite um nome para a nova função.

    Os nomes de função personalizada devem ser exclusivos e não exceder 100 caracteres.

  4. Crie uma fórmula.

    Consulte Trabalho com fórmulas e funções.

  5. Se a fórmula necessitar de parâmetros, em Parâmetros de função, digite o nome do parâmetro e clique em Adicionar botão Adicionar. Você pode editar ou excluir um nome de parâmetro selecionando-o na lista e clicando em Editar botão Editar ou Excluir botão Excluir.

  6. Clique onde deseja que um item apareça na caixa de fórmula e execute uma das seguintes ações.

    7. Para adicionar um(a)

    Faça isso

    Referência a um parâmetro

    Na lista de parâmetros, clique duas vezes no nome de um parâmetro.

    Operador matemático ou de texto

    No teclado, clique em um operador.

    Operador de comparação ou lógico

    Para Operadores, escolha um operador na lista.

    Valor constante

    Tipo de valor.

    Função

    Na lista de funções, clique duas vezes em uma função. Na caixa de fórmula, substitua o parâmetro do espaço reservado por um valor ou expressão.

    Você pode também digitar nomes de parâmetro, operadores e funções na caixa de diálogo Editar função personalizada, em vez de usar as listas ou o teclado.

  7. Todas as contas é a opção padrão para Disponibilidade e permite que todos os usuários do banco de dados atual vejam e usem a função personalizada. Se quiser que a função personalizada esteja disponível apenas àqueles com os privilégios de acesso total, selecione Somente contas com privilégios de acesso total.

  8. Clique em OK para fechar a caixa de diálogo Editar função personalizada.

  9. Continue criando funções personalizadas ou clique em OK para fechar a caixa de diálogo Gerenciar funções personalizadas.

Para alterar, duplicar ou excluir uma função personalizada:

  1. Selecione o menu Arquivo > Gerenciar > Funções personalizadas.

  2. Na caixa de diálogo Gerenciar funções personalizadas:

    3. Para

    Faça isso

    Editar uma função personalizada

    Para Nome da função, selecione a função personalizada e clique em Editar. Na caixa de diálogo Editar função personalizada, faça as alterações e clique em OK.

    Duplicar uma função personalizada

    Para Nome da função, selecione a função personalizada e clique em Duplicar.

    Excluir uma função personalizada

    Para Nome da função, selecione a função personalizada e clique em Excluir.

  3. Na caixa de diálogo Gerenciar funções personalizadas, clique em OK.

Para organizar funções personalizadas em pastas:

  1. Selecione o menu Arquivo > Gerenciar > Funções personalizadas.

  2. Na caixa de diálogo Gerenciar funções personalizadas:

    3. Para

    Faça isso

    Criar uma pasta

    Clique na seta ao lado de Novo e escolha Pasta. Na caixa de diálogo Editar pasta, digite o nome da pasta.

    Renomear uma pasta

    Clique duas vezes na pasta para renomear. Digite um nome na caixa de diálogo Editar pasta.

    Duplicar uma pasta

    Selecione a pasta e clique em Duplicar. Todas as suas funções e subpastas personalizadas são duplicadas.

    Mover uma função personalizada para fora ou para dentro uma pasta

    Para mover uma função personalizada para uma pasta, expanda a pasta. Arraste a função personalizada para dentro da pasta expandida.

    Para mover uma função personalizada para fora de uma pasta, arraste a função personalizada para fora da pasta expandida. Ou arraste o a função personalizada para baixo do último item na pasta e à esquerda.

    Excluir uma pasta

    Selecione a pasta e clique em Excluir. Não é possível desfazer a exclusão de uma pasta. A pasta e todas as suas funções e subpastas personalizadas são excluídas.

    Exibir pastas e seu conteúdo por nome de pasta

    Na lista no canto superior esquerdo da caixa de diálogo, escolha um nome de pasta.

    Para mostrar todas as funções personalizadas, escolha Mostrar tudo.

    Filtrar a lista de pastas e funções personalizadas pelo nome

    Na caixa de pesquisa, digite todo ou parte de um nome de pasta ou função personalizada. A lista é filtrada conforme você digita; digitar um nome de função personalizada exibe a função personalizada na lista e digitar um nome de pasta exibe a pasta e suas funções personalizadas e subpastas.

    Para mostrar todas as pastas e funções personalizadas, limpe a caixa.

Para copiar uma função personalizada para outro arquivo do FileMaker Pro:

  1. Selecione o menu Arquivo > Gerenciar > Funções personalizadas.

  2. Na caixa de diálogo Gerenciar funções personalizadas, selecione uma ou mais funções que deseja copiar.

    Dica  Você pode pressionar Ctrl+clique (Windows) ou Command-clique (macOS) para selecionar funções não contíguas ou Shift-clique para selecionar funções contíguas.

  3. Pressione Ctrl+C (Windows) ou Command-C (macOS) para copiar as funções e clique em OK.

    Dica  macOS: Você pode escolher o menu Arquivo > Copiar para copiar uma função selecionada.

  4. Abra um arquivo diferente do FileMaker Pro.

  5. Selecione o menu Arquivo > Gerenciar > Funções personalizadas.

  6. Pressione Ctrl+V (Windows) ou Command-V (macOS) para colar as funções.

    Dica  macOS: Você pode escolher o menu Arquivo > Colar para colar uma função selecionada.

    A função personalizada copiada aparece na parte inferior da lista. Se o FileMaker Pro determinar que essa função é inválida no contexto do arquivo de destino (por exemplo, se uma função dependente, um campo ou um cálculo estiver faltando no arquivo ou se a função tiver uma referência de tipo de campo inválida), a função colada será colocada entre caracteres de comentários (/*definição_função*/). Consulte Regras de dependência de função personalizada.

  7. Clique em OK.

Notas 

  • Sua conta deve ter privilégios de acesso total ou o privilégio Gerenciar bancos de dados, fontes de dados, containers e funções personalizadas para abrir a caixa de diálogo Gerenciar funções personalizadas. O conteúdo de uma função personalizada está protegido mesmo que a Disponibilidade esteja definida como Todas as contas.

  • Se você não tiver privilégios de Acesso total e tentar editar um cálculo que usa uma função personalizada restrita a contas de Acesso total, você verá a string <Função privada> em vez de a função personalizada. Não será possível alterar o cálculo enquanto a declaração <Função privada> aparecer na fórmula.

  • Se tiver anteriormente criado funções personalizadas, e os nomes forem idênticos às novas funções do FileMaker, as funções do FileMaker substituirão suas funções personalizadas. Verifique os nomes da função personalizada com relação às funções do FileMaker e altere seus nomes de função personalizada se necessário.

Tópicos relacionados