Função PYLOGICAL( )

Retorna um valor lógico calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

Sintaxe

PYLOGICAL("ArquivoPy; FunçãoPy" <; campo|valor <;...n>>)

Parâmetros

Nome	Tipo	Descrição
ArquivoPy; FunçãoPy	caractere	O nome do script do Python a ser executado, seguido por uma vírgula e o nome da função que retorna o valor: "meuScript;minhaFunção" Ao especificar o script do Python, omita a extensão do arquivo. A função chamada pode conter outras funções dentro do script ou de outros scripts. No entanto, todos os scripts executados devem ser colocados em uma pasta na variável de ambiente do sistema PYTHONPATH antes da execução. Para obter mais informações, consulte Configuração do Python para uso com o Analytics. Nota Sua PyFunção deve retornar um valor de verdade do Python.
campo\|valor <;...n> opcional	caractere numérico datahora lógico	Essa é uma lista de campos, expressões ou valores literais para usar como argumentos para a função do Python. Os valores são passados para a função chamada na ordem em que são especificados. Você pode incluir o número de argumentos necessário para atender à definição da função no script do Python. Nota Use a função ALLTRIM( ) para remover todos os espaços à esquerda ou à direita de entradas de caracteres: ALLTRIM(cadeia). Para obter mais informações, consulte Função ALLTRIM( ).

Nome

Tipo

Descrição

ArquivoPy; FunçãoPy

caractere

O nome do script do Python a ser executado, seguido por uma vírgula e o nome da função que retorna o valor:

"meuScript;minhaFunção"

Ao especificar o script do Python, omita a extensão do arquivo. A função chamada pode conter outras funções dentro do script ou de outros scripts. No entanto, todos os scripts executados devem ser colocados em uma pasta na variável de ambiente do sistema PYTHONPATH antes da execução.

Para obter mais informações, consulte Configuração do Python para uso com o Analytics.

Nota

Sua PyFunção deve retornar um valor de verdade do Python.

campo|valor <;...n>

opcional

caractere

numérico

datahora

lógico

Essa é uma lista de campos, expressões ou valores literais para usar como argumentos para a função do Python. Os valores são passados para a função chamada na ordem em que são especificados.

Você pode incluir o número de argumentos necessário para atender à definição da função no script do Python.

Nota

Use a função ALLTRIM( ) para remover todos os espaços à esquerda ou à direita de entradas de caracteres: ALLTRIM(cadeia). Para obter mais informações, consulte Função ALLTRIM( ).

Saída

Lógico.

Exemplos

Exemplos básicos

Retorna F:

PYLOGICAL( "hello,str_compare"; "basquete"; "beisebol"; "b" )

Script do Python externo que compara str1 e str2 usando a contagem de caracteres passada como char:

# conteúdo de hello.py
def str_compare(str1, str2, char):
    return str1.count(char) > str2.count(char)

Exemplos avançados

Uso de campos

Retorna um valor de verdade ao comparar Nome_Fornecedor e Cidade_Fornecedor:

PYLOGICAL( "hello;str_compare"; Nome_Fornecedor; Cidade_Fornecedor; "b" )

Script do Python externo que compara str1 e str2 usando a contagem de caracteres passada como char:

# conteúdo de hello.py
def str_compare(str1, str2, char):
    return str1.count(char) > str2.count(char)

[ Voltar ao início ]

Guia de scripting do ACL 14.1