Árvore de páginas
Ir para o final dos metadados
Ir para o início dos metadados

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

caractere

Alias da área de trabalho.

X


cMap

caractere

Campos da tabela separado por virgula.



bRefresh

lógico

Flag para realizar um refresh após o mapeamento.



Retorno

Nome

Tipo

Descrição

Retorna

lógico

.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)

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