Sintaxe getFileName e getAbsoluteFileName

Para utilizar o método getFileName do RICOH ProcessDirector ou o método getAbsoluteFileName, utilize a notação simbólica para se referir a eles como fórmulas simbólicas do RICOH ProcessDirector. Utilize uma das seguintes sintaxes:

Sintaxe 1, procura única:

${getFileName(UsageKeyword, DatatypeKeyword, FileaccessKeyword)}

${getAbsoluteFileName(UsageKeyword, DatatypeKeyword, FileaccessKeyword)}

Sintaxe 2, procura iterativa:

${getFileName(UsageKeyword, (DatatypeKeyword1, DatatypeKeyword2...), 
FileaccessKeyword)}

${getAbsoluteFileName(UsageKeyword, (DatatypeKeyword1, 
DatatypeKeyword2...), FileaccessKeyword)}

em que:

UsageKeyword

Uma palavra-chave com distinção entre maiúsculas e minúsculas que identifica o tipo de uso do arquivo em spool. Os valores que os usuários autorizados podem especificar são os mesmos valores que a parte do tipo de uso do nome do arquivo em spool pode conter. Por exemplo, você pode especificar estas palavras-chave fornecidas pelo RICOH ProcessDirector: aiwlist, control, overrides ou print. Também é possível especificar suas próprias palavras-chave definidas pelo usuário.

DatatypeKeyword ou (DatatypeKeyword1, DatatypeKeyword2...)

Uma palavra-chave com distinção entre maiúsculas e minúsculas que especifica o tipo de dados do arquivo em spool. Os valores que os usuários autorizados podem especificar são os mesmos valores que a parte do tipo de dados que o arquivo em spool pode conter. Por exemplo, é possível especificar palavras-chave fornecidas por RICOH ProcessDirector, como jdf, pdf ou gif. Também é possível especificar suas próprias palavras-chave definidas pelo usuário.

Se quiser que o RICOH ProcessDirector continue procurando outro arquivo em spool caso ele não localize um arquivo em spool do tipo inicial, você pode especificar diversas palavras-chave de tipos de dados. Separe-as com vírgulas e coloque-as entre parênteses. Por exemplo:

${getFileName(UsageKeyword, (print, pdf), FileaccessKeyword)}

Neste exemplo, o método getFileName primeiro procura um arquivo em spool com um tipo de dados de impressão. Se não localizar um nome de arquivo em spool correspondente, ele procura um arquivo em spool com tipo de dados pdf. Se ainda não localizar um nome de arquivo em spool correspondente, ele procura um arquivo em spool com um tipo de dados desconhecido. Se esse arquivo em spool não existir, o RICOH ProcessDirector emitirá uma mensagem de erro.

Obs.: O ponto de processamento em que o RICOH ProcessDirector tenta resolver o nome do arquivo determina se o método localizará o arquivo. Se o fluxo de trabalho incluir a etapa SetJobPropsFromTextFile, utilize o método getAbsoluteFileName no lugar do método getFileName. A etapa SetJobPropsFromTextFile tenta resolver o nome do arquivo que o método getFileName representa imediatamente após o dispositivo de entrada criar a tarefa; nem todos os arquivos em spool estão disponíveis nesse ponto no processamento. RICOH ProcessDirectornão tenta resolver o nome do arquivo que o método getAbsoluteFileName representa imediatamente depois da criação da tarefa.

Também é possível especificar diversos valores de tipo de dados com o método getAbsoluteFileName, como:

${getAbsoluteFileName(UsageKeyword, (pdf, postscript, text), 
FileaccessKeyword)}

O método getAbsoluteFileName procura arquivos em spool da mesma maneira que o método getFileName, com uma exceção. Se não existir nenhum arquivo em spool com qualquer um dos tipos de dados especificados, o padrão é que o método getAbsoluteFileName não procure um arquivo em spool com o tipo de dados desconhecido.

FileaccessKeyword

A palavra-chave de acesso ao arquivo, que é read ou write, especifica se o programa externo lê o arquivo no diretório em spool ou grava o arquivo no diretório em spool. RICOH ProcessDirector cria arquivos nos subdiretórios do diretório em spool, dependendo se o programa externo lê ou grava um arquivo:

subdiretório /checkpoints

Quando o programa externo faz alterações no arquivo através de uma operação de gravação, o RICOH ProcessDirector move a versão original do arquivo para seu subdiretório. Se um usuário autorizado solicitar subsequentemente uma ação processar-novamente, o RICOH ProcessDirector pode restaurar o arquivo em spool original a partir do subdiretório /checkpoints. Isso garante que o programa externo tenha a mesma entrada disponível para sua operação de gravação que da primeira vez em que processou o arquivo.

subdiretório /tmp

Quando o programa externo cria um novo arquivo, o RICOH ProcessDirector armazena o novo arquivo neste subdiretório até que a etapa externa que chama o programa seja concluída. Quando a etapa é concluída, o RICOH ProcessDirector move o novo arquivo para o diretório spool.

Obs.: Programas externos que criam tarefas filhas devem gravá-las no subdiretório /filhos do diretório spool para a tarefa. O nome do arquivo da tarefa filha que o programa externo cria deve estar neste formato:

JobNumber.Usagetype.Datatype,ChildGroupID,Job.JobType=JobType

ChildGroupID deve ser o mesmo para todos os arquivos associados a uma única tarefa filha. Se o programa externo gerar mais uma tarefa filho, ele deve incrementar o ChildGroupID para cada conjunto de arquivos associado com a nova tarefa filho.

O programa externo anexa ,Job.JobType= ao nome do arquivo, que é o nome do banco de dados para a propriedade do fluxo de trabalho. O valor JobType é o nome do fluxo de trabalho que a tarefa filho exige; o fluxo de trabalho deve existir e deve estar ativado.