Árvore de páginas

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicocrmrel/apiCrmRelPedItemCli.p

 

Objetivo

Gerar um relatório no formato Excel com as informações pertinentes ao pedido de venda, CRM analítico.

 

Tabelas Temporárias

Atributos das tabelas temporárias de entrada e saída:

ttCli

 

Atributo

Tipo

Formato

        Descrição

Obr.

numIdPessoa

Int

 

Código conta CRM

 

cod-emitente

Int

 

Código conta erp

 

 

A definição das demais tabelas temporárias pertencentes às includes abaixo podem ser encontradas no documento crmrel_df_temp_table.docx.

 

{crmrel/ttExcel.i}

{crmboCustom/contaUsuar.i tt-cta_usuar}

{crmrel/UtilRelPedVda.i}

{crmrel/ttCondPag.i ttCondPag}

{crmrel/ttNatuOper.i ttNatuOper}

{crmrel/ttParamRelPedItem.i ttParamRelPedItem}

{crmrel/UtilRelHierTime.i}

 

Parâmetros de input e output da api

 

Parâmetro

Tipo

Formato

I

O

IO

Descrição

 

 

 

 

 

 

 

 

Métodos

Métodos básicos

 

Método: gerarRelatorio

Descrição: Método principal chamado pela aplicação de tela para executar a geração do relatório, efetua o controle e validação de alguns dados de tela, popula a temp-table utilizada para gerar as colunas no Excel e gerencia os demais métodos.         

Requisitos: Nenhum

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

pDtIni

Char

 

X

 

 

Data inicial

pDtFim

Char

 

x

 

 

Data final

pClien

Char

 

X

 

 

Código conta CRM

pRepres

Char

 

x

 

 

Código representante CRM

pTitRelat

Char

 

x

 

 

Titulo relatório

RowErrors

Tt

 

 

 

x

Relação de erros encontrados

 

Método: carga 

Descrição: método utilizado para popular as temp-tables que serão enviadas como parametro para geração do relatório em xlsx, também efetuar contagem pra totalizadores e determina como será o agrupamento no relatório.          

Requisitos: Nenhum

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

ttParamRelPedItem

tt

 

X

 

 

Relação de itens do pedido

ttParamRelClienPed

 

 

X

 

 

Relação de cliente VS pedido

ttUsuarSubor

Tt

 

X

 

 

Relação de usuários, hier time

ttComponente

Tt

 

 

x

 

Controle para os agrupadores

ttColunaComponente

Tt

 

 

X

 

Valores para apresentação do relatório

ttUpdateCel

Tt

 

 

x

 

Controle para os totalizadores

 

Método: createttUpdateCel 

Descrição: Adiciona registro com valor do totalizador a ser apresentado em uma das células do relatório.           

Requisitos: Nenhum

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

Seq

char

 

X

 

 

Sequencia

Grupo

Int

 

X

 

 

Grupo

Valor

Char

 

X

 

 

Valor totalizador

letraCol

Char

 

X

 

 

Coluna Excel

lftBold

Log

 

X

 

 

Fonte bolde?

iftCor

Int

 

X

 

 

Valor fonte cor

iftSize

Int

 

X

 

 

Valor tamanho fonte

iLtColor

Int

 

X

 

 

Não utilizado

Ibdcolor

Int

 

X

 

 

Cor borda

 

Método: createttColunaComponente 

Descrição: Adiciona os registros com valores de cada uma das colunas a ser apresentada no relatório.           

Requisitos: Nenhum

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

Cod

Char

 

X

 

 

Código grupo

Colun

Int

 

X

 

 

Valor da coluna correspondente

Ordem

Int

 

X

 

 

Ordem pra controle das linhas

Valor

Char

 

X

 

 

Valor a ser apresentado na célula

 

Método: assignTTLabelCol 

Descrição: Adiciona os registros com valores dos labels de cada uma das colunas a ser apresentada no relatório.           

Requisitos: Nenhum

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

iPosicao

Int

 

X

 

 

Posição, utilizado p/ pos. na coluna

cLabel

Char

 

X

 

 

Valor label coluna

lftBold

Log

 

X

 

 

Fonte bolde?

iftCor

Int

 

X

 

 

Valor correspondente a cor da fonte

iftSize

Int

 

X

 

 

Tamanho da fonte

iLtColor

Int

 

X

 

 

Cor célula

Ibdcolor

Int

 

X

 

 

Cor borda

 

Método: FindMessageError

Descrição: Adiciona erros na temp-table de retorno de erros RowErros.          

Requisitos: Nenhum

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

numMsg

Int

 

X

 

 

Código da mensagem de erro

Param1

Char

 

X

 

 

Paramtro 1

Param2

Char

 

X

 

 

Parametro 2

RowErrors

Tt

 

 

X

 

Relação de erros encontrados

 

Método: SearchSupervClienRecursive

Descrição: método utilizado para identificar o usuário supervisor da conta dentre a relação de usuários retornada pela hierarquia de times.           

Requisitos: Nenhum

Parâmetros:

Parâmetro

Tipo

Formato

I

O

IO

Descrição

Iuser

Int

 

X

 

 

Código usuário CRM

iuserSuperv

Int

 

X

 

 

Código usuário CRM

nomSuperv

Char

 

 

X

 

Usuário supervisor