Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Informar limites de parâmetros e retornos

Pagetitle
TCSPExec
TCSPExec

Executa Função que executa uma stored procedure do no banco de dados atual.

Sintaxe

aResult := tcSPExec(<cStoredProcedure>[, <xParam>])

Bloco de código
collapsefalse
TCSPExec( < cStoredProcedure >, [ xParam ] )

Parâmetros

Indica o nome Qualquer

Nome

Tipo

Descrição

Obrigatório

Referência

cStoredProcedure

caractere

Nome

ParâmetroTipoObrigatórioDescrição
cStoredProcedureCaractere(seleção)

da stored procedure a ser executada.

X


xParam

caractere

 

Indica uma ou mais expressões, separadas por vírgula, indicando os parâmetros necessários para a execução da stored procedure.



Retorno

chamda

Nome

Tipo

Descrição

aResult

Array

vetor

Retorna um array que contêm os valores de retorno da stored procedure. O retorno será nulo se nenhum valor for retornado pela stored procedure ou ocorrer algum erro na

chamada da procedure.

Exemplo

Exemplo de Stored Procedure

Exemplo de stored procedure para o banco SQL Server

[attention] Esta função não está disponível para uso com RPODB=SQLITE. [attention]

Informações
icontrue
titleObservações
  • Quando utilizar o tipo Data como input na Procedure, use a função DToS
  • O Tamanho máximo de cada valor informado como parâmetro ou retorno da Stored Procedure não deve exceder 999 bytes.
  • O Tamanho total de todos os parâmetros informados ou retornados não deve exceder 4 KB.

Exemplos

Exemplo de stored procedure já existente no banco de dados.

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
Bloco de código
languagesql
Create Procedure USRTESTE( @IN_VALUE@inValue int, @OUT_STR@outStr char(64) OUTOUTPUT, @OUT_VALUE@outValue int OUTOUTPUT) As
Begin
set @OUT_STR@outStr = 'Teste'
set @OUT_VALUE@outValue = @IN_VALUE@inValue + 3
End
End 

 

Exemplo de chamada AdvPL

Programa de teste para utilizar a função TCSPExec.

code
Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
#include "totvs.ch"
User Function exemplo()

Local aResult := {}
  aResult := TCSPEXEC("USRTESTE", 100)
  
IF empty(aResult)
    Conout('Erro na execução da Stored Procedure : '+TcSqlError())
  Else
    Conout("Retorno String : "+aResult[1])
    Conout("Retorno Numerico : "+str(aResult[2]))
    MsgInfo("Procedure Executada")
  Endif

Return

Veja também