Criação de caminhos de arquivo

Em várias caixas de diálogo do FileMaker Pro, você pode especificar caminhos de arquivo para um arquivo externo ou uma fonte de dados externa do FileMaker. Na maioria dos casos, 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 e hosts do FileMaker são compatíveis com caminhos de arquivo em um formato especial 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)	`file:nomeDiretório/nomeArquivo` `filemac:nomeDiretório/` `filewin:../nomeArquivo`
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	`filemac:/nomeVolume/nomeDiretório/nomeArquivo` `filemac:/nomeVolume/nomeDiretório/`
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	`filewin:/letraunidade:/nomeDiretório/nomeArquivo` `filewin:/letraunidade:/nomeDiretório/`
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	`filewin://nomeComputador/nomeCompartilhamento/nomeDiretório/nomeArquivo` `filewin://nomeComputador/nomeCompartilhamento/nomeDiretório/`
Rede FileMaker	O caminho de rede para um arquivo compartilhado do FileMaker Pro	`fmnet:/nomeHostOuendereçoIPhost/nomeArquivo`

Sobre prefixos de caminho

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. Se nenhum desses finais for especificado, o caminho poderá ser usado em qualquer plataforma.
O prefixo fmnet especifica um caminho de rede para um arquivo compartilhado do FileMaker Pro.

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
`file` `filemac` `filewin` `filelinux`	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
`image` `imagemac` `imagewin` `imagelinux`	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
`movie` `moviemac` `moviewin` `movielinux`	Arquivos de áudio/vídeo inseridos em campos de container usando a Etapa de script Inserir áudio/vídeo

Exemplos de vários caminhos de arquivo

Quando você adicionar fontes de dados externas ou usar a maioria das etapas de script 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 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:/ExcelFiles/Hosted/test.xlsx
filemac:/MacintoshHD/ExcelFiles/Hosted/test.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 ) & "Hosted/test.xlsx"
```
Consulte "Exemplos de utilização 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 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:../Databases/test.fmp12
```

Exemplos do uso de variáveis em caminhos de arquivo

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 = "test.xlsx"
$username = "JohnSmith"
$targetDir = "Documents/Clients"
$chosenType = "filewin"
$$source = "file:Documents/2019/demo files"
$driveLetter = "G:"
$docsFilePath = "file:" & Get ( DocumentsPath ) & "test.xlsx"
$searchList = "file:old results.txt
               file:../archived/old results.txt"

Para	Entrada na lista de caminhos	Lista de caminhos resolvidos
Especificar somente um nome de arquivo	`file:testing/$fileName`	`file:testing/teste.xlsx`
Especificar um ou mais diretórios em um caminho	`file:$username/$fileName`	`file:JonasSilva/teste.xlsx`
Especificar um arquivo na pasta Documentos em qualquer plataforma compatível	`$docsFilePath`	Windows: `arquivo:/C:/Usuários/John Smith/Documentos/teste.xlsx` macOS: `arquivo:/Macintosh HD/Usuários/johnsmith/Documentos/teste.xlsx`
Especificar caminhos absolutos ou caminhos relativos, com diferentes prefixos de tipo de caminho	`filewin:/$driveLetter/$targetDir/contatos.txt` `imagemac:../$targetDir/photo.jpg` `movie:$targetDir/movie.mp4`	`filewin:/G:/Documentos/Clientes/contatos.txt` `imagemac:../Documents/Clients/photo.jpg` `movie:Documents/Clients/movie.mp4`
Especificar um prefixo de tipo de caminho dinamicamente ou como parte de um caminho mais longo	`$chosenType:/$driveLetter/$targetDir` `$$source/$fileName`	`filewin:/G:/Documentos/Clientes` `file:Documentos/2019/arquivos de demonstração/teste.xlsx`
Especificar um ou mais caminhos completos	`$searchList`	`file:resultados antigos.txt` `file:../archived/resultados antigos.txt`
Especificar um diretório (não um arquivo)	`file:$targetDir/` `$$source/` `file:$targetDir/$username/`	`file:Documentos/Clientes/` `file:Documentos/2019/arquivos de demonstração/` `file:Documentos/Clientes/JonasSilva/`

Notas

Para converter um caminho em formato FileMaker para um formato padrão do sistema operacional ou formato URL, use a Função ConvertFromFileMakerPath, por exemplo, para converter um caminho do FileMaker ao formato de URL para uso na Etapa de script Inserir do URL. Por outro lado, use a Função ConvertToFileMakerPath para converter um caminho padrão para o formato FileMaker.
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 nome de domínio totalmente qualificado do host ou use variáveis em caminhos de arquivo.
É 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 (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 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.