Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | crmrel/apiCrmRelPedCondPgto.p |
Objetivo
Gerar um relatório no formato Excel de pedido x condição de pagamento, CRM analítico.
Tabelas Temporárias
Atributos das tabelas temporárias de entrada e saída:
ttCli |
| |||
Atributo | Tipo | Formato | Descrição | Obr. |
Id | Int |
| Código conta CRM |
|
idUsuario | Int |
| Código usuário CRM |
|
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}
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 |
pUsuar | Char |
| X |
|
| Código usuário CRM |
pClien | Char |
| x |
|
| Código conta CRM |
pRepres | Char |
| X |
|
| Código representante CRM |
pTitRelat | Char |
| x |
|
| Titulo relatório |
ttParamLegend | Tt |
| X |
|
| Relação de status |
ttParamLegend1 | Tt |
| X |
|
| Relação de modalidades |
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 |
ttParamRelClienPed | Tt |
| X |
|
| Registros filtrados p/ impressão |
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 |