Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

CriaTrab

CriaTrab( <aArray>, <lDbf> ) --> cNome

Distingue obtenção de nome de criação de arquivo de trabalho.

CriaTrabAdvPL
01 · VISÃO GERAL

Visão geral

A referência histórica descreve CriaTrab(aArray,lDbf): verdadeiro cria arquivo com a estrutura; falso somente obtém um nome. O exemplo oficial de integração Crystal Reports utiliza CriaTrab(Nil,.F.) para obter o nome de apoio, sem demonstrar criação de tabela nessa chamada. Não confundir isso com uma tabela temporária SQL gerenciada por FWTemporaryTable. A ficha atual específica não foi localizada; esta página delimita o contrato histórico e não garante suporte aos drivers locais em qualquer ambiente. O exemplo solicita apenas o nome e não o usa como caminho de gravação. (TOTVS, s.d., ref. 1; FERREIRA, 2023, ref. 2)

02 · SINTAXE

Sintaxe

CriaTrab( <aArray>, <lDbf> ) --> cNome

Parâmetros

aArray
QualquerObrigatório

Estrutura dos campos; Nil no modo apenas nome.

lDbf
LógicoObrigatório

Verdadeiro cria arquivo; falso somente nome, no contrato histórico.

Retorno

Nome de arquivo de trabalho segundo a referência histórica.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed317()
    Local cNome := CriaTrab(Nil, .F.)
    // Nao cria arquivo; nao presume que o nome e uma tabela aberta.
    ConOut(cValToChar(Len(cNome)))
Return Nil
Resultado esperado

Comprimento do nome gerado, sem conteúdo fixo presumido; nenhum arquivo criado pelo exemplo. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Verificar suporte da infraestrutura e preferir a abstração de temporário adequada. Não apagar arquivos arbitrários para liberar um nome.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. CriaTrab. TDN. Consulta em 2026-10-26.
  2. FERREIRA, Bia. Advpl CriaTrab. Bynem, atualização de 25 jun. 2023. Referência histórica. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha