Arquivo de condições de propriedade

As etapas com base no modelo de etapas SetDocPropsFromConditions definem as propriedades de documento ou propriedades de tarefa da tarefa atual usando um arquivo de condições de propriedade. As condições definidas no arquivo usam um formato valor separado por vírgula (CSV). Um arquivo de amostra de condições de propriedade está em /aiw/aiw1/samples/doc/DocPropConditions.csv. Se você tiver o recurso Ativação postal, arquivos de amostra adicionais estarão em /aiw/aiw1/samples/control_files/postal.
    Importante:
  • Ao editar o arquivo de condições da propriedade, abra-o em um editor de texto. Não edite o arquivo no Microsoft Excel.

Você pode usar o arquivo de condições de propriedade para definir os valores das propriedades com ou sem as condições. Você também pode usar um arquivo separado incluir para definir as propriedades usando um formato propriedade = valor.

Definindo valores utilizando condições

A primeira linha no arquivo de condições de propriedade é uma linha de cabeçalho que lista os nomes de banco de dados das propriedades da tarefa ou do documento, separados por vírgulas. Normalmente, a parte mais à esquerda da linha do cabeçalho especifica as propriedades para testar uma ou mais condições, embora esta ordem não seja necessária.

A linha de cabeçalho é seguida por uma ou mais linhas de condição que define as condições e os valores de propriedade a serem definidos quando todas as condições nessa linha forem verdadeiras. Você pode pensar em cada linha representando uma instrução de condição se-então. Todas as condições especificadas em uma linha são logicamente Ligadas juntas e devem ser todas verdadeiras. Se qualquer uma das condições de uma linha não for verdadeira, nenhum dos valores dessa linha será definido. Os valores das linhas de condição são separados por vírgulas.

Este exemplo mostra o conteúdo de um arquivo de condições de propriedade que define valores de propriedade com base nas condições:

Doc.Custom.MailCategory,Job.Name,Doc.Run.PAVE
=USPS,,Yes
=USPS,~XYZ*,No
=NonUSPS,,No
=Exception,,No

A primeira condição se-então especifica se uma categoria de correspondência é USPS, RICOH ProcessDirector define a propriedade Doc.Run.PAVE como Sim. A segunda linha definirá o valor de Doc.Run.PAVE como Não se o nome da tarefa começar com XYZ.

Recomendamos que você coloque todas as propriedades que fazem parte das condições para a esquerda das propriedades que estão recebendo valores.

As propriedades que fazem parte das condições usam os caracteres da condição deste conjunto:

Os caracteres de condição no arquivo de condições

Caracteres de condição Condição Exemplo/Observação
=[valor] igual a =Fir
<>[valor] Não Igual a () <>Fir
<[valor] menor que <4900000
>[valor] maior que >61000
<=[valor] Menor ou igual a <=61207
>=[valor] maior queou igual a () >=61207
~[valor] similar ~INSURE*.PDF
!~[valor] não semelhante !~*.PDF
"([val1],[val2],...)" em (deve iniciar e terminar entre parênteses cercados por aspas) "(PRTA, PRTB)"
"!([val1],[val2],...)" não em (deve iniciar e terminar entre parênteses cercados por aspas) "!(PRTA, PRTB)"
(em branco) curinga (*) Quando uma condição está em branco, isto é sempre considerado verdadeiro.

    Obs.:
  • Você pode usar o sinal de cerquilha (#) para adicionar comentários. Apenas as linhas completas podem ser consideradas para comentários, o caractere # deve estar na primeira posição na linha.
  • Os espaços podem separar os caracteres de palavra-chave dos valores de condição.
  • Ao configurar propriedades posicionais, você pode escolher um destes dois formatos: property-name[process-name][phase-name][step-name] ou [phase-name][step-name]. Você não pode usar as propriedades de posição para definir outras propriedades.
  • Os caracteres ? e * são caracteres curinga utilizados com as condições similar e não similar. O ponto de interrogação corresponde aos caracteres simples e o asterisco corresponde a qualquer número de caracteres.
  • Você pode usar a notação de símbolos do RICOH ProcessDirector no arquivo de condições para configurar condições ou designar valores com base no valor atual de determinado documento ou propriedade de tarefa. Consulte o tópico intitulado Notação de símbolos do RICOH ProcessDirector no Centro de Informações para obter uma descrição da sintaxe de notação de símbolos. Você também pode usar a notação simbólica com valores literais de cadeia; consulte abaixo para ter mais informações.
  • Se um campo de condição possui um sinal de igual (=) sem um valor, a condição será verdadeira se o valor da propriedade da tarefa for nulo. Se um campo tiver um valor vazio, a propriedade é ignorada para essa linha, não faz parte de qualquer condição e seu valor não é alterado. Devido a esta regra, a etapa não poderá definir uma propriedade de tarefa como nula. Para configurar uma propriedade como nula manualmente, use a expressão ${null}.
  • Cada linha é avaliada de forma independente.
  • Todas as linhas com as condições que correspondem a propriedades de uma tarefa ou documento são aplicadas. As linhas são aplicadas na ordem em que ocorrem no arquivo de condições. Dentro de cada linha, os valores de propriedade são aplicados da esquerda para a direita.
  • Os espaços em branco do início à esquerda e do final à direita são removidos dos valores de campo antes que qualquer comparação ou operação de conjunto ocorra. Os espaços em branco dentro de um valor (não à esquerda ou à direita) são mantidos.

Uso de um segmento de um valor de propriedade com a notação símbolo e o especificador de subcadeia

Se você quiser usar apenas uma parte de uma propriedade em uma condição - como usar apenas os 5 primeiros caracteres do valor de uma propriedade - você poderá usar o especificador de subcadeia para indicar a parte da propriedade que deseja usar.

A sintaxe é:

  • ${property_name;substr;start;length}
em que:
  • property_name é o nome da propriedade, como Job.Name.
  • início é a posição da cadeia de onde você deseja iniciar.
  • extensão é o número de caracteres a ser usado na condição, se você digitar uma extensão que tiver um número de caracteres acima do número da propriedade, o restante da propriedade será usado.

    Obs.:
  • A cadeia é indexada em base zero, por exemplo, o primeiro caractere está na posição 0 e o 5° caractere está na posição 4.

Esta tabela mostra alguns exemplos:

Exemplos de valores de sub cadeia

O arquivo de condições de propriedade contém... Valor da propriedade Resultado
${Job.Name;substr;0;4} Job.Name = USPS-FullService USPS
${Job.Name;substr;5;8} Job.Name = USPS-OversizeFlat Tamanho excessivo

Criação de valores concatenados com a notação de símbolo

Além de usar a notação de símbolo para definir as condições ou atribuir valores com base no valor atual de uma determinada propriedade, você pode combinar símbolos para criar um valor único concatenado, ou usá-los com cadeias literais.

Esta tabela mostra alguns exemplos:

Exemplos de concatenação de valores de propriedade

O arquivo de condições de propriedade contém... Valores de propriedade reais Resultado
Job.Custom.A,Job.Custom.Z

${Job.Custom.D}${Job.Custom.E},4

Job.Custom.D=5 and Job.Custom.E=9 Job.Custom.A=59

Job.Custom.Z=4

Doc.Custom.MailCategory,Job.Name,Doc.Run.PAVE

=USPS,${Job.Custom.D} Flat,No

Doc.Custom.MailCategory=USPS e Job.Custom.D=Oversize

Job.Name=Oversize Flat

Doc.Run.PAVE=No

Definição de valores sem definição das condições

O formato do arquivo de condições é o mesmo, com uma linha de cabeçalho que contém nomes de propriedades de banco de dados e uma segunda linha que lista valores de propriedade. No entanto, o arquivo de condições contém apenas duas linhas. Se você incluir mais de uma linha de valores de propriedade, apenas os valores especificados na última linha serão salvos.

Este exemplo mostra o conteúdo de um arquivo de condições de propriedade que define valores de propriedade sem o uso de condições:

Doc.Custom.MailCategory,Job.Name,Doc.Run.PAVE
USPS,PostalDiscount,Yes

Definindo valores com um arquivo de inclusão em separado

Se você tiver uma coleção de propriedades que permanece a mesma para vários fluxos de trabalho, defina essas propriedades em um arquivo de inclusão separado que você consulta no arquivo de condições de propriedade.

Para fazer referência a um arquivo de inclusão separado, coloque @include na linha de cabeçalho do arquivo de condições de propriedades e especifique o caminho relativo ou absoluto para o arquivo de inclusão na segunda linha do arquivo de condições de propriedades.

    Importante:
  • Use o caractere delimitador do Linux (/) para especificar o caminho de diretório absoluto para o arquivo de inclusão em um sistema Windows. Por exemplo, se o arquivo de inclusão em um sistema Windows estiver em C:\Projects\data.txt, especifique /Projects/data.txt.

Este exemplo mostra o conteúdo de um arquivo de condições de propriedades que contém @include e um caminho para um arquivo de inclusão separado:

Doc.Custom.MailCategory,Job.Name,@include
USPS,Priority,../prop-assignments/usps-properties.txt

Neste exemplo, a propriedade Categoria de Correio é atribuída com o valor de USPS, a propriedade Nome da tarefa é atribuída com valor Prioridade, e o caminho relativo para o arquivo de inclusão usps-properties.txt é especificado.

O arquivo de inclusão define valores de propriedade com o uso do formato. Nome de propriedade = Value. Este exemplo mostra o formato do arquivo de inclusão:

Doc.Insert.RecipientName=George Rogers
Job.CustomerName=CerbCo

O arquivo de condições é processado da esquerda para a direita e de cima para baixo. Esta tabela contém exemplos para mostrar como o arquivo de condições de propriedade e o arquivo de inclusão podem substituir propriedades que foram definidas anteriormente. (Estes exemplos são apenas para ilustração e não são destinados a usos reais do arquivo de condições).

Exemplos de ordem de processamento para o arquivo de condições e arquivo de inclusão

O arquivo de condições de propriedade contém... O arquivo de inclusão contém... Resultado
Job.Name,@include

=,../prop-assignments/usps-properties.txt

Job.Name=FlatFold Se o Nome da tarefa não estiver definido, o arquivo de inclusão define como FlatFold.
Doc.Custom.Zip, Doc.Custom.Location, Doc.Custom.Location, @include

<50000, EAST, NEW HAMPSHIRE, /Projects/data.txt

Job.CityPopulation = 42400 Se Zip for <50000, o arquivo de condições definirá Location = EAST e, em seguida, o arquivo de condições definirá Location = NEW HAMPSHIRE e, em seguida, o arquivo de inclusão /Projects/data.txt definirá CityPopulation = 42400.

Doc.Custom.Location = NEW HAMPSHIRE

Job.CityPopulation = 42400

Doc.Custom.Zip, Doc.Custom.Location, @include, Doc.Custom.Location

<50000, EAST, /Projects/data.txt, NEW HAMPSHIRE

Doc.Custom.Location = CONCORD

Job.CityPopulation = 42400

Se o Zip for <50000, o arquivo de condições definirá Location = EAST e, em seguida, o arquivo de inclusão /Projects/data.txt definirá Location = CONCORD e CityPopulation = 42400 e, em seguida, o arquivo de condições definirá Location = NEW HAMPSHIRE.

Doc.Custom.Location = NEW HAMPSHIRE

Job.CityPopulation = 42400

Doc.Custom.Zip, Doc.Custom.Location, @include, @include

<50000, EAST, /Projects/data.txt, /Projects/data2.txt

/Projects/data.txt

Doc.Custom.Location = CONCORD

Job.CityPopulation = 42400

/Projects/data2.txt

Doc.Custom.Location = US ROUTE 202

Job.CityPopulation = 52400

Se Zip for <50000, o arquivo de condições definirá Location = EAST e, em seguida, o arquivo de inclusão /Projects/data.txt definirá Location = CONCORD e Population = 42400 e, em seguida, o arquivo de inclusão /Projects/data2.txt definirá Location = US ROUTE 202 e CityPopulation = 52400.

Doc.Custom.Location = US ROUTE 202

Job.CityPopulation = 52400

    Obs.:
  • Você pode usar a notação de símbolos do RICOH ProcessDirector como parte do nome do arquivo de inclusão. Por exemplo, se você usar o nome do arquivo de inclusão ${Job.RequestedPrinter}.equipmentprops.txt, o sistema pode escolher o conjunto correto de propriedades a definir para cada impressora solicitada (para cada valor de Job.RequestedPrinter). Consulte o tópico relacionado sobre Referência para obter uma descrição da sintaxe de notação de símbolo.