TCViewOne

Cria uma view para uma tabela no modelo 1 para 1, ou seja, todos os campos da tabela serão mapeados na view.

Sintaxe

TCViewOne( < cView >, < cTable > )

Parâmetros

Nome	Tipo	Descrição	Obrigatório	Referência
cView	caractere	Nome da view a ser criada.	X
cTable	caractere	Nome da tabela master da view.	X

Retorno

Nome	Tipo	Descrição
lRet	lógico	Retorna .T. se a view foi criada, caso contrário, retorna .F. e o motivo do erro pode ser verificado com a função TCSQLError.

Observações

Possíveis causas de falha:

Já existe uma tabela ou view no SGBD, com o nome informado em cView;
A tabela informada em cTable não existe no SGBD;
A tabela informada em cTable é uma view ou tabela temporária;
A tabela informada em cTable, já está relacionada como tabela auxiliar de outra view (TCViewMulti).

Exemplos

STATIC FUNCTION CreateTable()
  TCDelFile("VIEW1")
  TCDelFile("T1")
  
  DBCreate("T1", {{"FIELD_NAME", "C", 10, 0}, ;
                  {"FIELD_TYPE", "C", 10, 0}}, "TOPCONN")
RETURN

FUNCTION u_TCViewOne()
  TCLink()
  
  CreateTable()
  
  IIF(TCViewOne("VIEW1", "T1"), CONOUT('TRUE'), CONOUT('FALSE'))    // retorna .T., ou seja, criou a view VIEW1
  IIF(TCViewOne("VIEW1", "T1"), CONOUT('TRUE'), CONOUT('FALSE'))    // retorna .F., pois, VIEW1 já foi criada acima
  IIF(TCViewOne("VIEW2", "T3"), CONOUT('TRUE'), CONOUT('FALSE'))    // retorna .F., pois, a tabela T3 não existe no SGBD
  IIF(TCViewOne("VIEW2", "VIEW1"), CONOUT('TRUE'), CONOUT('FALSE')) // retorna .F., pois, não é possível criar uma view a partir de outra view
  
  TCUnlink()
RETURN

Abrangência

Esta função está disponível no Application Server - build 7.00.131227A, com data de geração superior a 09/08/2016 e depende de um DBAccess com build superior a 20160402.

Árvore de páginas