TOTVSTEC

Árvore de páginas

Mapeia os campos de seleção no banco de dados.

Sintaxe

TCSrvMap( < cAlias >, [ cMap ], [ bRefresh ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cAlias

character

Alias da área de trabalho.

X


cMap

character

Campos da tabela separado por virgula.



bRefresh

logical

Flag para realizar um refresh após o mapeamento.



Retorno

Nome

Tipo

Descrição

Retorna

logical

.T. (Verdadeiro) caso de sucesso, caso contrário, .F. (Falso).

Observações

  • Somente será mapeado para tabela com no mínimo 25 colunas, caso queira alterar esse valor utilize a função TCMaxMap.
  • Essa função é utilizada para reduzir o trafego de dados entre o banco de dados e DBAccess.
  • Se quiser limpar o mapeamento, escreva TCSrvMap(cAlias).
  • Caso a função TCSrvMap seja chamada por um alias de Query a instrução será ignorada, e a mensagem "SrvMap in Query - Statement ignored" será apresentada por padrão no console.


Atenção

A partir da versão 20.3.1.10 do 

Erro ao processar a macro "excerpt-include"

User 'null' does not have permission to view the page.

a mensagem "SrvMap in Query - Statement ignored" não será mais apresentada por padrão no console. Para habilitar esta mensagem é necessário utilizar a chave Trace.

Exemplos

FUNCTION Example()
  Local cT1 := "T1"
  Local cMap := "FIELDCOL1,FIELDCOL2,FIELDCOL3"
  
  TCLink()
  
  DBCreate("T1", {{"FIELDCOL1", "C", 10, 0}, ;
                  {"FIELDCOL2", "C", 10, 0}, ;
                  {"FIELDCOL3", "C", 10, 0}, ;
                  {"FIELDCOL4", "C", 10, 0}, ;
                  {"FIELDCOL5", "C", 10, 0}, ;
                  {"FIELDCOL6", "C", 10, 0}, ;
                  {"FIELDCOL7", "C", 10, 0}, ;
                  {"FIELDCOL8", "C", 10, 0}, ;
                  {"FIELDCOL9", "C", 10, 0}, ;
                  {"FIELDCOL10", "C", 10, 0}, ;
                  {"FIELDCOL11", "C", 10, 0}, ;
                  {"FIELDCOL12", "C", 10, 0}, ;
                  {"FIELDCOL13", "C", 10, 0}, ;
                  {"FIELDCOL14", "C", 10, 0}, ;
                  {"FIELDCOL15", "C", 10, 0}, ;
                  {"FIELDCOL16", "C", 10, 0}, ;
                  {"FIELDCOL17", "C", 10, 0}, ;
                  {"FIELDCOL18", "C", 10, 0}, ;
                  {"FIELDCOL19", "C", 10, 0}, ;
                  {"FIELDCOL20", "C", 10, 0}, ;
                  {"FIELDCOL21", "C", 10, 0}, ;
                  {"FIELDCOL22", "C", 10, 0}, ;
                  {"FIELDCOL23", "C", 10, 0}, ;
                  {"FIELDCOL24", "C", 10, 0}, ;
                  {"FIELDCOL25", "C", 10, 0}, ;
                  {"FIELDCOL26", "C", 10, 0}, ;
                  {"FIELDCOL27", "C", 10, 0}}, "TOPCONN")
                  

  DBUseArea(.F., 'TOPCONN', cT1, (cT1), .F., .T.)

  // mapeia os campos 'FIELDCOL1,FIELDCOL2,FIELDCOL3'
  TCSrvMap('T1', cMap, .T.)
  
  // TODO: realiza alguma ação
  
  DBCloseArea()
  
  TCUnlink()
RETURN

Veja também

  • Sem rótulos