Árvore de páginas

Permite renomear uma View do SGBD, criada através das funções TCViewOne() e/ou TCViewMulti().

Sintaxe

TCViewRen( < cViewName >, < cViewNewName > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cViewName

caractere

Indica o nome da View existente a ser renomeada.

X


cViewNewName

caractere

Indica o novo nome da View a ser renomeada.

X


Retorno

Nome

Tipo

Descrição

lRet

lógico

Retorna .T. em caso de sucesso na operação de renomear a View. Caso contrário retorna .F., e maiores informações sobre a falha na operação podem ser obtidas através da função TCSqlError()

Observações

  • Essa função verifica as condições mínimas para a execução da operação, e internamente recupera as definições da View informada, remove a View do SGDB, e recria a View com o novo nome informado.
  • Esta funcionalidade está disponível a partir do TOTVS | Application Server build 7.00.131227A, com data de geração igual ou superior a 14/10/2016.
  • Esta funcionalidade também requer a atualização da DBAPI.DLL / SO do DBAccess atualizada, bem como o DBAccess Build 20160913 ou superior, com data de geração superior a 14/10/2016.

Exemplos

User Function TSTView()
  Local cViewSrc := "SA1010_PAD"
  Local cNewView := "SA1010_001"
  Local lOk
  
  lOk := TcViewRen(cViewSrc,cNewView)

  If !lOk
    msgStop("Rename View Error",TCSqlError())
  Else
    MsgInfo("Rename View OK")
  Endif

Return

Abrangência

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

Veja também

  • Sem rótulos