Você pode especificar caminhos de arquivo para um arquivo externo ou uma fonte de dados externa do FileMaker. Cada arquivo nomeado ou fonte de dados do FileMaker pode conter um ou mais caminhos de arquivo. Use vários caminhos de arquivo quando desejar que os clientes do FileMaker pesquisem uma lista de possíveis arquivos.
Para obter informações sobre como adicionar fontes de dados do FileMaker e especificar caminhos de arquivo, consulte Conexão com fontes de dados externas.
Os clientes do FileMaker são compatíveis com caminhos de arquivo em formatos especiais do FileMaker:
Tipo de caminho | Descrição | Formato |
Relativo | O caminho para um arquivo de destino especificado de um local do banco de dados atual ou da pasta Documentos do usuário (consulte as notas abaixo) |
|
Local ou remoto completos (macOS) | O caminho absoluto para uma pasta ou arquivo de destino, seja local ou em um volume remoto, começando no nível superior do sistema de arquivos |
|
Local completo (Windows) | O caminho absoluto para uma pasta ou arquivo de destino no Windows, começando no nível superior do sistema de arquivos |
|
Remoto completo (Windows) | O caminho absoluto para uma pasta ou arquivo de destino em um volume do Windows compartilhado usando o recurso de compartilhamento de arquivos do Windows |
|
Rede FileMaker | O caminho de rede para um arquivo compartilhado do FileMaker Pro Advanced |
|
O prefixo de caminho determina quando os clientes do FileMaker podem usar um caminho específico:
•Prefixos que iniciam com file
, image
ou movie
especificam o tipo de dados do arquivo. As etapas de script que funcionam somente com tipos de dados específicos exigem image
ou movie
(consulte abaixo); caso contrário use file
.
•Os prefixos que terminam com win
, mac
ou linux
especificam a plataforma na qual o caminho pode ser usado.
•O prefixo fmnet
especifica um caminho de rede para um arquivo compartilhado do FileMaker Pro Advanced.
Você pode usar prefixos que começam com file
para qualquer caminho completo ou relativo. O prefixo file
pode ser usado em qualquer plataforma.
Devido à dificuldade de criar vários caminhos específicos da plataforma, em muitos casos é mais fácil usar somente o prefixo file
(sem a terminação da plataforma) junto com a Função Get (TemporaryPath) ou a Função Get (DocumentsPath) para especificar um único caminho como uma variável. No runtime, um caminho de variável usando essas funções funciona especificamente na plataforma atual do cliente. Por exemplo, uma variável definida com a expressão a seguir especifica o arquivo myfile.txt na pasta temporária do cliente:
"file:" & Get ( TemporaryPath ) & "myfile.txt"
A tabela a seguir lista todos os prefixos de caminho suportados e fornece exemplos dos locais onde eles podem ser usados.
Prefixo de caminho | Usado para |
| Importar e exportar dados usando a Etapa de script Importar registros e a Etapa de script Exportar registros, fontes de dados do FileMaker, arquivos inseridos em campos de container usando a Etapa de script Inserir arquivo e etapas de script que funcionam com arquivos de dados |
| Arquivos de imagem ou PDF inseridos em campos de container usando a Etapa de script Inserir PDF ou a Etapa de script Inserir imagem, respectivamente |
| Arquivos de áudio/vídeo inseridos em campos de container usando a Etapa de script Inserir áudio/vídeo |
Se você adicionar fontes de dados externas ou criar scripts que acessam arquivos, poderá usar vários caminhos de arquivos quando quiser que os clientes do FileMaker pesquisem uma lista de possíveis arquivos. Os caminhos de arquivo são pesquisados na ordem em que aparecem. O cliente do FileMaker abre o primeiro arquivo que consegue localizar com êxito, concluindo a pesquisa. Cada caminho de arquivo deve estar em uma linha separada.
•Exemplo 1: neste exemplo, um banco de dados do FileMaker Pro Advanced deve funcionar em dois sistemas operacionais diferentes: um sistema Windows e um sistema macOS que acessem arquivos locais. Nas duas plataformas, o banco de dados deve acessar um arquivo local nomeado teste.xlsx.
filewin:/C:/ArquivosExcel/Hosted/teste.xlsx
filemac:/MacintoshHD/ExcelFiles/Hosted/teste.xlsx
Como alternativa, se a pasta Hospedados existir na pasta Documentos dos dois sistemas, você poderá usar uma variável configurada com esta expressão para especificar um único caminho que funcione nas duas plataformas:
"file:" & Get ( DocumentsPath ) & "Hospedados/test.xlsx"
Consulte "Exemplos do uso de variáveis em caminhos de arquivo" abaixo.
•Exemplo 2: neste exemplo de uma importação de registro com script, um banco de dados do FileMaker Pro Advanced deve acessar um arquivo hospedado. Entretanto, como o host pode não estar disponível, você também faz referência a dois arquivos alternativos, um hospedado em um servidor diferente e outro armazenado localmente no seu disco rígido. Se o primeiro arquivo de rede estiver indisponível, os clientes do FileMaker pesquisarão o segundo arquivo de rede. Se o segundo arquivo de rede também estiver indisponível, os clientes do FileMaker pesquisarão o arquivo local.
fmnet:/host1.domain.com/Databases/test.fmp12
fmnet:/host2.domain.com/Databases/test.fmp12
file:../BancosDeDados/teste.fmp12
As variáveis permitem que você especifique caminhos de arquivo ou pasta dinamicamente em muitas etapas de script, como a Etapa de script Inserir arquivo e a Etapa de script Importar registros. Consulte Utilização de variáveis.
Nos exemplos abaixo, considere as seguintes variáveis:
$fileName = "teste.xlsx"
$username = "JonasSilva"
$targetDir = "Documentos/Clientes"
$chosenType = "filewin"
$$source = "file:Documentos/2019/arquivos de demonstração"
$driveLetter = "G:"
$docsFilePath = "file:" & Get ( DocumentsPath ) & "test.xlsx"
$searchList = "file:resultados antigos.txt
file:../archived/resultados antigos.txt"
Para | Entrada na lista de caminhos | Lista de caminhos resolvidos |
Especificar somente um nome de arquivo |
|
|
Especificar um ou mais diretórios em um caminho |
|
|
Especificar um arquivo na pasta Documentos em qualquer plataforma compatível |
| Windows: macOS: |
Especificar caminhos absolutos ou caminhos relativos, com diferentes prefixos de tipo de caminho |
|
|
Especificar um prefixo de tipo de caminho dinamicamente ou como parte de um caminho mais longo |
|
|
Especificar um ou mais caminhos completos |
|
|
Especificar um diretório (não um arquivo) |
|
|
•Para acessar um arquivo localmente em um volume Windows compartilhado, use o formato de caminho de rede. Esse formato é compatível apenas com volumes Windows compartilhados. Ele não é compatível com volumes compartilhados do macOS ou com o compartilhamento na Rede FileMaker.
•Para acessar um arquivo localizado em um volume macOS remoto, certifique-se de que o volume seja montado primeiro e comece o caminho com filemac
. Por exemplo, para exportar registros para o arquivo intitulado teste.xlsx
na pasta Clientes
no volume Início
no servidor meuhost
, o caminho seria filemac:/Início/Clientes/teste.xlsx
se você montasse o volume Início
em meuhost
.
•Não use asterisco (*) como caractere curinga em caminhos de arquivo de rede, pois isso pode tornar o tráfego de rede do FileMaker mais lento. Sempre que possível. substitua o asterisco pelo endereço IP apropriado ou use variáveis em caminhos de arquivo.
•Use os seguintes caracteres como separadores em uma lista de caminhos de arquivo: "/", ":" ou retorno de carro.
•É possível usar variáveis em referências de fontes de dados do FileMaker. Consulte Edição de fontes de dados do FileMaker.
•Se o banco de dados atual foi aberto localmente, o caminho relativo será o caminho para um arquivo de destino especificado do local do banco de dados atual. Se o banco de dados foi aberto remotamente, o caminho relativo será o caminho para um arquivo de destino especificado do seguinte local:
•endereço de rede do host, se o caminho for para um arquivo do FileMaker Pro Advanced (as pastas no caminho são ignoradas)
•pasta Documentos do usuário, se o caminho for para um arquivo de qualquer outro tipo
•O acesso aos arquivos varia por cliente:
•Para FileMaker Pro Advanced e FileMaker Go, o acesso aos arquivos locais é limitado somente pelo sistema operacional.
•Para scripts no lado do servidor, o acesso a arquivos é limitado à pasta Documentos e à pasta temporária. Consulte Caminhos em scripts no lado do servidor.
•O FileMaker WebDirect, o FileMaker Data API e a Publicação na Web personalizada não conseguem acessar o sistema de arquivos do servidor.