Funções de Arquivo¶

As funções de arquivo permitem que scripts manipulem arquivos em agentes, disponíveis por meio de atividades configuradas baseadas em arquivos que podem ser usadas como origens ou destinos.

ArchiveFile¶

Declaração¶

void ArchiveFile(string sourceId, string targetId[, bool deleteSource])

Sintaxe¶

ArchiveFile(<sourceId>, <targetId>[, <deleteSource>])

Parâmetros Obrigatórios¶

• sourceId: Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual**
  
• targetId:** Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual

Parâmetros Opcionais¶

• deleteSource: Sinalizador booleano (padrão false) indicando se a fonte deve ser excluída após gravar com sucesso no destino

Descrição¶

Lê um arquivo de uma atividade de origem do tipo de arquivo e grava-o em uma atividade de destino do tipo de arquivo. Esta função combina o ReadFile e WriteFile funções, executa automaticamente FlushFile e fornece uma opção para excluir o arquivo de origem.

A origem e o destino usados nesta chamada de função devem ser definidos como atividades associadas aos endpoints do tipo arquivo no projeto atual. Isso inclui atividades configuradas de compartilhamento de arquivos, FTP, HTTP, armazenamento local e armazenamento temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints seção em Jitterbit Script.

Como apenas um arquivo é arquivado, recomenda-se que a fonte seja criada para retornar apenas um único arquivo. Se vários arquivos forem retornados, apenas o primeiro será usado.

Como o WriteFile função, esta função não substituirá um arquivo existente no destino.

Se o ArchiveFile função falha, a operação não falha. Um script será abortado, um aviso será adicionado ao log da operação e a operação continuará.

Arquivar Versus Copiar¶

• Se deleteSource é true, o arquivo é arquivado (em outras palavras, movido) da origem para o destino e removido da origem.
• Se deleteSource é false, o arquivo será copiado da origem para o destino e permanecerá na origem.

Exemplos¶

// Retrieve list of files from a source
localFiles = FileList("<TAG>activity:localstorage/Local Storage Endpoint/localstorage_read/CSV Files</TAG>");

// Create a global archive filename
$archiveFilename = "archive.[date]-[time]." + localFiles[0];

// Archive (moves) a file, using [nome do arquivo] in the target filename(s) field
ArchiveFile("<TAG>activity:localstorage/Local Storage Endpoint/localstorage_read/CSV Files</TAG>",
    "<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>", true);

// Copies a file, using [nome do arquivo] in the target filename(s) field
ArchiveFile("<TAG>activity:localstorage/Local Storage Endpoint/localstorage_read/CSV Files</TAG>",
    "<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>", false);

DeleteFile¶

Declaração¶

int DeleteFile(string sourceId[, string fileFilter])

Sintaxe¶

DeleteFile(<sourceId>[, <fileFilter>])

Parâmetros Obrigatórios¶

• sourceId: Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual

Parâmetros Opcionais¶

• fileFilter: Filtro de arquivo ou nome de arquivo para substituir a configuração da atividade

Descrição¶

Exclui um arquivo da origem especificada.

A origem usada nesta chamada de função deve ser definida como uma atividade associada a um endpoint de tipo de arquivo no projeto atual. Isso inclui atividades configuradas de compartilhamento de arquivos, FTP, HTTP, armazenamento local e armazenamento temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints seção em Jitterbit Script.

Se o filtro de origem selecionar mais de um arquivo, um erro será gerado. Para excluir vários arquivos, use o DeleteFiles funcionar em vez disso.

O método retorna um número inteiro 0 ou 1: retorna 1 se o arquivo foi excluído; 0 se o arquivo não puder ser encontrado.

O segundo parâmetro, fileFilter, é opcional e pode ser usado para substituir o filtro de arquivo usado na configuração da atividade. Um nome de arquivo pode ser usado. Alternativamente, uma variável global pode ser usada para substituir o filtro de arquivo na configuração da atividade. Variáveis globais são referenciadas como [de_name] na configuração da atividade.

Exemplos¶

// Delete the file "ExampleFile.txt" from the "CSV Files"
DeleteFile("<TAG>activity:localstorage/Local Storage Endpoint/localstorage_read/CSV Files</TAG>",
    "ExampleFile.txt");

DeleteFiles¶

Declaração¶

int DeleteFiles(string sourceId[, string fileFilter])

Sintaxe¶

DeleteFiles(<sourceId>[, <fileFilter>])

Parâmetros Obrigatórios¶

• sourceId: Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual

Parâmetros Opcionais¶

• fileFilter: Filtro de arquivo ou nome de arquivo para substituir a configuração da atividade

Descrição¶

Exclui um ou mais arquivos da origem especificada.

A origem usada nesta chamada de função deve ser definida como uma atividade associada a um endpoint de tipo de arquivo no projeto atual. Isso inclui atividades configuradas de compartilhamento de arquivos, FTP, HTTP, armazenamento local e armazenamento temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints seção em Jitterbit Script.

Este método excluirá vários arquivos, se algum for encontrado, com base no filtro de arquivo da configuração da atividade. Um número inteiro é retornado especificando quantos arquivos foram excluídos. Retornar 0 significa que nenhum arquivo correspondente ao filtro de arquivo foi encontrado.

Se um caminho especificado na origem não puder ser encontrado, um erro será gerado. Se isso for uma possibilidade, a função deve ser envolvida em um Eval função.

Para excluir um único arquivo, use o DeleteFile funcionar em vez disso.

O segundo parâmetro, fileFilter, é opcional e pode ser usado para substituir o filtro de arquivo usado na configuração da atividade. Um nome de arquivo pode ser usado. Alternativamente, uma variável global pode ser usada para substituir o filtro de arquivo na configuração da atividade. Variáveis globais são referenciadas como [de_name] na configuração da atividade.

Exemplos¶

// Delete all text (".txt") files in the "FTP Files"
DeleteFiles("<TAG>activity:ftp/FTP Endpoint/ftp_read/FTP Files</TAG>", "*.txt");

DirList¶

Declaração¶

array DirList(string sourceId[, string path, string fileFilter])

Sintaxe¶

DirList(<sourceId>[, <path>, <fileFilter>])

Parâmetros Obrigatórios¶

• sourceId: Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual

Parâmetros Opcionais¶

• path: Caminho do arquivo para substituir a configuração da atividade**
  
• fileFilter:** Filtro de arquivo ou nome de arquivo para substituir a configuração da atividade

Descrição¶

Retorna uma lista de diretórios contidos em uma fonte, especificando opcionalmente um caminho e um filtro para restringir os resultados.

Este método retorna um array contendo os nomes dos diretórios.

A origem usada nesta chamada de função deve ser definida como uma atividade associada a um endpoint de tipo de arquivo no projeto atual. Isso inclui atividades configuradas de compartilhamento de arquivos, FTP, HTTP, armazenamento local e armazenamento temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints seção em Jitterbit Script.

O parâmetro fileFilter é opcional e pode ser usado para substituir o filtro de arquivo usado na configuração da atividade. Um nome de arquivo pode ser usado. Alternativamente, uma variável global pode ser usada para substituir o filtro de arquivo na configuração da atividade. Variáveis globais são referenciadas como [de_name] na configuração da atividade.

Exemplos¶

// Returns the count of the list of all the text
// files (".txt") in the "example" folder of the
// File Share Read "File Share"
Length(DirList("<TAG>activity:fileshare/File Share Endpoint/fileshare_read/File Share</TAG>",
        "\\\\server\\example","*.txt"));

FileList¶

Declaração¶

array FileList(string sourceId[, string path, string fileFilter])

Sintaxe¶

FileList(<sourceId>[, <path>, <fileFilter>])

Parâmetros Obrigatórios¶

• sourceId: Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual

Parâmetros Opcionais¶

• path: Caminho do arquivo para substituir a configuração da atividade
• fileFilter: Filtro de arquivo ou nome de arquivo para substituir a configuração da atividade

Descrição¶

Retorna uma lista de nomes de arquivos contidos em uma fonte. Esta será a mesma lista de arquivos recebidos quando a conexão de uma origem de tipo de arquivo for testada, a menos que um filtro de arquivo seja especificado para substituir o filtro especificado na configuração da atividade.

A origem usada nesta chamada de função deve ser definida como uma atividade associada a um endpoint de tipo de arquivo no projeto atual. Isso inclui atividades configuradas de compartilhamento de arquivos, FTP, HTTP, armazenamento local e armazenamento temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints seção em Jitterbit Script.

O parâmetro path é opcional e pode ser usado para substituir o caminho usado na configuração da atividade.

O parâmetro fileFilter é opcional e pode ser usado para substituir o filtro de arquivo usado na configuração da atividade. Um nome de arquivo pode ser usado. Alternativamente, uma variável global pode ser usada para substituir o filtro de arquivo na configuração da atividade. Variáveis globais são referenciadas como [de_name] na configuração da atividade.

O método retorna uma matriz contendo os nomes de arquivos que correspondem ao filtro de arquivo da atividade de origem ou à origem substituída.

Exemplos¶

// Returns the count of the list of all the
// files in the FTP endpoint "FTP Files"
Length(FileList("<TAG>activity:ftp/FTP Endpoint/ftp_read/FTP Files</TAG>"));

FlushAllFiles¶

Declaração¶

void FlushAllFiles([string targetId])

Sintaxe¶

FlushAllFiles([<targetId>])

Parâmetros Opcionais¶

• targetId: Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual

Descrição¶

Persiste dados gravados em um buffer de arquivo com WriteFile.

O destino usado nesta chamada de função deve ser definido como uma atividade associada a um endpoint de tipo de arquivo no projeto atual. Isso inclui atividades configuradas de compartilhamento de arquivos, FTP, HTTP, armazenamento local e armazenamento temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints seção em Jitterbit Script.

Se FlushAllFiles é chamado com um targetId como argumento, todos os arquivos escritos usando esse alvo serão liberados (veja o FlushFile função). Se FlushAllFiles é chamado sem argumento, todos os arquivos escritos usando WriteFile a quaisquer atividades utilizadas como metas serão persistidas em suas respectivas metas.

Veja também o FlushFiles função.

Exemplos¶

// Write the value of "contents1" to the file specified by
// the FTP Write activity "FTP Files"
WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>",
    contents1);

// Write  the value of "contents2" to a file "copy.txt", overriding
// that specified by the FTP Write activity "FTP Files"
WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>",
    contents2, "copy.txt");

// Flush both files to the FTP Write activity "FTP Files"
FlushAllFiles("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>");

FlushFile¶

Declaração¶

void FlushFile(string targetId[, string filename])

Sintaxe¶

FlushFile(<targetId>[, <filename>])

Parâmetros Obrigatórios¶

• targetId: Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual

Parâmetros Opcionais¶

• filename: Nome do arquivo para substituir a configuração da atividade

Descrição¶

Persiste dados gravados em um buffer de arquivo com WriteFile. Quando FlushFile é chamado, o conteúdo atual do buffer é gravado no destino e o buffer local é descartado.

O destino usado nesta chamada de função deve ser definido como uma atividade associada a um endpoint de tipo de arquivo no projeto atual. Isso inclui atividades configuradas de compartilhamento de arquivos, FTP, HTTP, armazenamento local e armazenamento temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints seção em Jitterbit Script.

O parâmetro opcional, filename, pode ser usado para substituir o nome do arquivo usado na configuração da atividade se ele tiver sido substituído de forma semelhante na chamada para o WriteFile função. Liberar um arquivo que nunca foi gravado não tem efeito.

Alternativamente, uma variável global pode ser usada para substituir o nome do arquivo na configuração da atividade. Variáveis globais são referenciadas como [de_name] na configuração da atividade. Se um nome de arquivo de substituição for usado, cada buffer será liberado separadamente para cada nome exclusivo.

Veja também o FlushAllFiles função.

Exemplos¶

// Write the variable "contents" to the file specified by
// the FTP Write activity "FTP Files"
WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>",
    contents);

// Flushing (actually writing) to the activity
FlushFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>");

// Write to another file (overriding the filename in the target)
WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>",
    contents, "test.txt");

// Flushing the "test.txt" file explicitly
FlushFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>",
    "test.txt");

ReadFile¶

Declaração¶

string ReadFile(string sourceId[, string fileFilter])

Sintaxe¶

ReadFile(<sourceId>[, <fileFilter>])

Parâmetros Obrigatórios¶

• sourceId: Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual

Parâmetros Opcionais¶

• fileFilter: Filtro de arquivo ou nome de arquivo para substituir a configuração da atividade

Descrição¶

Lê o conteúdo de um arquivo de uma origem.

A origem usada nesta chamada de função deve ser definida como uma atividade associada a um endpoint de tipo de arquivo no projeto atual. Isso inclui atividades configuradas de compartilhamento de arquivos, FTP, HTTP, armazenamento local e armazenamento temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints seção em Jitterbit Script.

O método retorna o conteúdo do arquivo apontado pela fonte. Caso o filtro de origem selecione mais de um arquivo, o primeiro será utilizado. Recomenda-se especificar uma fonte que identifique exclusivamente um único arquivo.

O parâmetro fileFilter é opcional e pode ser usado para substituir o filtro de arquivo usado na configuração da atividade. Um nome de arquivo pode ser usado. Alternativamente, uma variável global pode ser usada para substituir o filtro de arquivo na configuração da atividade. Variáveis globais são referenciadas como [de_name] na configuração da atividade.

Se o ReadFile() função falha, a operação não falha. Um script será abortado, um aviso será adicionado ao log da operação e a operação continuará.

Este método pode ser usado para ler dados de uma fonte HTTP. Nesse caso, todos os Jitterbit $jitterbit.source.http.* variáveis serão preenchidas.

Exemplos¶

$fileContents = ReadFile("<TAG>activity:ftp/FTP Endpoint/ftp_read/FTP Files</TAG>")

WriteFile¶

Declaração¶

void WriteFile(string targetId, type fileContents[, string filename])

Sintaxe¶

WriteFile(<targetId>, <fileContents>[, <filename>])

Parâmetros Obrigatórios¶

• targetId: Um caminho de referência de string para uma atividade associada a um endpoint de tipo de arquivo no projeto atual

Parâmetros Opcionais¶

• fileContents: Dados a serem gravados no arquivo
• filename: Nome do arquivo para substituir a configuração da atividade

Descrição¶

Escreve o fileContents para o alvo especificado por targetId. Se fileContents for do tipo binário, os dados binários serão gravados no arquivo. Em todos os outros casos, uma representação em string dos dados é gravada.

O destino usado nesta chamada de função deve ser definido como uma atividade associada a um endpoint de tipo de arquivo no projeto atual. Isso inclui atividades configuradas de compartilhamento de arquivos, FTP, HTTP, armazenamento local e armazenamento temporário. Para obter mais informações, consulte as instruções sobre como inserir endpoints em Endpoints seção em Jitterbit Script.

O terceiro parâmetro, filename, é opcional e pode ser usado para substituir o nome do arquivo usado na configuração da atividade. Alternativamente, uma variável global pode ser usada para substituir o nome do arquivo na configuração da atividade. Variáveis globais são referenciadas como [de_name] na configuração da atividade.

Este método também pode ser usado para gravar/postar dados em um destino HTTP. Nesse caso, $jitterbit.target.http.* variáveis serão preenchidas.

Se o WriteFile() função falha, a operação não falha. Um script será abortado, um aviso será adicionado ao log da operação e a operação continuará.

Buffer e Descarga¶

O conteúdo do arquivo é armazenado em buffer localmente até que FlushFile ou FlushAllFiles é chamado no destino ou a transformação é concluída com êxito. Chamando WriteFile várias vezes sem ligar FlushFile anexará dados ao buffer atual e tudo será gravado no destino real do tipo de arquivo somente quando for liberado. Um buffer de arquivo é identificado exclusivamente pelo destino (e potencialmente pelo filename); por exemplo, o mesmo destino pode ser usado para gravar em arquivos diferentes no mesmo diretório, especificando um nome de arquivo e cada buffer de arquivo será separado.

Os arquivos não são realmente gravados no destino em uma transformação de teste, a menos que FlushFile ou FlushAllFiles é chamado. Se uma transformação for executada em uma operação ou como parte de uma operação de teste, o arquivo será gravado quando a transformação for concluída com êxito ou quando FlushFile ou FlushAllFiles é chamado no script.

Veja também o FlushAllFiles e FlushFiles funções.

Exemplos¶

// Write "contents" to a file in an activity
WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>", contents);

// Use the filename "test.txt" instead of
// what is defined in an activity
WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>", contents, "test.txt");