O namespace do sistema de arquivos é novo desde MarvelClient Release 4.
A tabela a seguir lista os parâmetros disponíveis para o namespace do sistema de arquivos.
A sintaxe para o namespace do sistema de arquivos é a seguinte:
comando[_ ]-caminho[?regex]
1 exemplo:
Verifica se o arquivo existe.
2 exemplo:
Determina o tamanho do diretório de dados do IBM Notes em Megabytes.
OBSERVE que alguns dos comandos do sistema de arquivos podem levar mais tempo para serem executados, especialmente quando direcionados a recursos de rede e/ou recorrentes em muitos subdiretórios e arquivos.
NOTA: É aconselhável usar um ponto de exclamação como tipo de execução para referências de sistema de arquivos para indicar que elas são sempre executadas novamente, mesmo se a mesma referência de sistema de arquivos for usada mais de uma vez. Embora, por enquanto, não faça diferença se você usa dois pontos, ponto de exclamação ou barra vertical (:, !, |), o comportamento pode mudar no futuro release.
NOTA: Você NÃO deve codificar nenhum caminho de arquivo! , por exemplo, falhará devido aos dois pontos no caminho do arquivo (lembre-se, os dois pontos (:) são um caractere reservado nas referências). Passando dois pontos através de um sub-referência funciona bem, no entanto.
Os parâmetros mais importantes do namespace do sistema de arquivos | |||
|---|---|---|---|
| Command | parâmetros | Tipo de Alvo | Descrição |
| existe | Nenhum | qualquer | Retorna "1" se o caminho de destino existir, "0" caso contrário |
| édiretório | Nenhum | qualquer | Retorna "1" se o caminho de destino for um diretório, "0" caso contrário |
| arquivo is | Nenhum | qualquer | Retorna "1" se o caminho de destino for um arquivo, "0" caso contrário |
| está vazia | Nenhum | qualquer | Para um diretório: retorna "1" se o caminho de destino não tiver arquivos ou subdiretórios, "0" caso contrário Para um arquivo: retorna "1" se o caminho de destino for um arquivo vazio, "0" caso contrário |
| tamanho | mb - tamanho de retorno em megabytes; Deve ser providenciado | arquivo ou diretório | Retorna o tamanho do arquivo ou diretório de destino (incluindo subdiretórios) em megabytes (arredonda para baixo) Exemplo: = tamanho da caixa de correio do usuário em megabytes Observe que a barra "/" funciona independentemente do sistema operacional - é aconselhável NÃO usar uma barra invertida "\". |
| última modificação | Nenhum | qualquer | Retorna a data e hora em que o caminho de destino foi modificado pela última vez (aaaammddThhnnss) |
| checksum | Nenhum | lima | Retorna uma soma de verificação MD5 para o arquivo no caminho de destino |
| checkwrite access | Nenhum | anuário | Retorna "1" se o acesso de gravação for permitido, "0" caso contrário Cria um arquivo temporário (mc_temp.tmp) no diretório de destino e o exclui posteriormente para verificar o acesso de gravação efetivo. NOTA Se já existir um arquivo mc_temp.tmp, MarvelClient tentará sobrescrevê-lo. Qualquer caminho pode ser fornecido, o MC irá subir um nível até que um diretório existente seja encontrado. Exemplo: c:\notes\data\foo\bar.nsf é fornecido (NÃO codificado, mas através de uma sub-referência!), mas nenhum arquivo bar.nsf ou diretório foo existe. O acesso de gravação será verificado para c:\notes\data. |
| contar | l - limite ao diretório atual (sem subdiretórios) d - contar apenas diretórios f - conta apenas arquivos x - usar regex d e f não podem ser combinados, use um ou outro (ou nenhum) | anuário | Retorna o número de objetos do sistema de arquivos encontrados de acordo com os parâmetros/regex Conta o conteúdo do caminho de destino fornecido. Se o caminho para um arquivo for fornecido, o diretório pai do arquivo será usado. Se um regex for usado, limitará a contagem a arquivos/diretórios que correspondem ao regex. A regex é aplicada apenas ao nome do arquivo (+extensão), não ao caminho completo ou parcial. 1 exemplo: - contará todos os arquivos com extensão .ntf no diretório de dados (recursivamente) 2 exemplo: - contará todos os subdiretórios em C:\Temp, mas não recursivamente e sem arquivos 3 exemplo: - contará todos os arquivos e diretórios, recursivamente |
| find | l - limite ao diretório atual (sem subdiretórios) d - encontra apenas diretórios f - encontra apenas arquivos x - usar regex a - retorna caminhos absolutos d e f não podem ser combinados, use um ou outro (ou nenhum) | anuário | Retorna uma lista separada por vírgulas de todos os arquivos encontrados (relativo ao diretório de destino ou absoluto se "a" for fornecido como parâmetro). NOTA: O tamanho máximo da string retornada é 2 GB. Não é uma boa idéia chegar perto de uma string retornada desse tamanho, ou seja, você não deve encontrar todos os arquivos em C:\. Procura todos os arquivos no caminho de destino fornecido que correspondam aos parâmetros/regex fornecidos. Se o caminho para um arquivo for fornecido, o diretório pai do arquivo será usado. Se um regex for usado, limitará a pesquisa a arquivos/diretórios que correspondam ao regex. A regex é aplicada apenas ao nome do arquivo (+extensão), não ao caminho completo ou parcial. 1 exemplo: - lista todos os arquivos que terminam em .box dentro do diretório de dados (e subdiretórios) 2 exemplo: - lista todos os arquivos e diretórios no diretório de destino (recursivamente) 3 exemplo: <filesystem!find_x-{notes#idfile_path}?hugo.*\.nsf - lista todos os arquivos no diretório onde o ID do usuário está armazenado (e subdiretórios) que começam com hugo e têm a extensão .nsf |
| espaço | free_mb - espaço livre disponível para o usuário atual (honrando cota) total_mb - espaço total disponível para o usuário atual totalfree_mb - espaço total no disco (não honrando a cota) Consulte MSDN para obter detalhes | anuário | Retorna o valor solicitado (em megabytes) como um número. Calcule o espaço livre/usado para o disco do caminho de destino. Se o caminho para um arquivo for fornecido, o diretório pai do arquivo será usado. Qualquer diretório em um disco pode ser usado. |