Função PROPERTIES( )

Retorna informações sobre as propriedades do item do projeto do Analytics especificado.

Sintaxe

PROPERTIES(nome; tipo_obj; tipo_info)

Parâmetros

Nome	Tipo	Descrição
nome	caractere	O nome do item do projeto do Analytics do qual se quer obter informações. nome não diferencia minúsculas e maiúsculas. Caso o item de projeto seja uma tabela do Analytics, especifique o nome do layout da tabela, não o nome do arquivo de dados. Por exemplo: "Faturas", não "faturas_janeiro.fil" Se você usar a função PROPERTIES( ) para retornar o nome da tabela ativa, especifique o nome "activetable"
tipo_obj	caractere	O tipo de item do projeto do Analytics referenciado em nome. Nota "Table" é o único tipo de item de projeto aceito atualmente.
tipo_info	caractere	O tipo de informação desejada sobre o item do projeto do Analytics. Para obter mais informações, consulte Tipos de informações de propriedades.

Saída

Caractere. O comprimento máximo da cadeia de caracteres de saída é de 260 caracteres. Caso nenhuma informação possa ser encontrada sobre as propriedades, uma cadeia vazia é retornada.

Exemplos

Exemplos básicos

Informações sobre o arquivo de dados do Analytics (.fil)

Retorna "Trans_Cp.fil":

PROPERTIES("Trans_CP"; "table"; "filename")

Retorna "C:\ACL DATA\Arquivos de dados da amostra":

PROPERTIES("Trans_CP"; "table"; "filepath")

Informações sobre a tabela do Analytics aberta

Retorna "Trans_Cp":

PROPERTIES("activetable"; "table"; "open")

Informações sobre uma origem de dados externa

Retorna "Trans_Maio.xls":

PROPERTIES("Trans_Maio"; "table"; "sourcename")

Retorna "C:\Project Data\Faturas Mensais_Excel":

PROPERTIES("Trans_Maio"; "table"; "sourcepath")

Retorna "EXCEL":

PROPERTIES("Trans_Maio"; "table"; "sourcetype")

Observações

Informações do arquivo

Os tipos de informações que começam com "file" fornecem informações sobre o arquivo de dados da tabela do Analytics (.fil) associado a uma tabela do Analytics.

Informações da origem

Os tipos de informações que começam com "source" fornecem informações sobre origens externas de dados possivelmente associadas a uma tabela do Analytics. Apenas as seguintes origens externas de dados, compatíveis com a atualização de tabelas do Analytics, podem ser reportadas com a função PROPERTIES( ):

• Microsoft Excel
• Microsoft Access
• Texto delimitado
• Adobe Acrobat (PDF)
• Imagem de impressão (relatório)
• Formato de arquivo privado SAP/DART
• XML
• XBRL
• Origens de dados ODBC

Tipos de informações de propriedades

A tabela abaixo lista os tipos de informações de propriedades que podem ser retornados pela função PROPERTIES( ). No momento, as tabelas do Analytics são o único tipo de item de projeto do Analytics que pode ser usado na função PROPERTIES( ):

tipo_obj	tipo_info	Retorna:
"table"	"filename"	O nome do arquivo de dados associado à tabela do Analytics.
	"filepath"	O caminho do arquivo de dados associado à tabela do Analytics.
	"filesize"	O tamanho, em KB, do arquivo de dados associado à tabela do Analytics.
	"filemodifiedat"	A data e hora da última modificação do arquivo de dados associado à tabela do Analytics.
	"sourcename"	O nome da origem de dados associada à tabela do Analytics. As origens de dados podem ser arquivos externos em Excel, Access, PDF, XML ou arquivos de texto delimitados, ou origens de dados ODBC.
	"sourcepath"	O caminho da origem de dados associada à tabela do Analytics. Não é compatível com origens de dados ODBC.
	"sourcetype"	O tipo da origem de dados associada à tabela do Analytics.
	"sourcesize"	O tamanho, em KB, da origem de dados associada à tabela do Analytics. Não é compatível com origens de dados ODBC.
	"sourcemodifiedat"	A data e hora da última modificação da origem de dados associada à tabela do Analytics. Não é compatível com origens de dados ODBC.
	"open"	O nome da tabela do Analytics atualmente ativa. Nota Várias tabelas do Analytics podem estar abertas ao mesmo tempo, mas na interface do usuário apenas uma tabela pode estar ativa por vez.