Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 8 Atual »

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.

Veja também

  • Sem rótulos