Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | crmapi/apiCrmIntegrTarEcm.p |
Considerações Gerais
Objetivo
Listar e relacionar os processos do ECM a ação da campanha no CRM. Verificar e validar a parametrização referente a integração com o ECM.
Funcionamento
Na forma padrão, realiza-se a chamada por intermédio de um comando RUN normal, passando-se as temp-tables carregadas com as informações necessárias.
A sintaxe para a chamada da API é:
run crmapi/apiCrmIntegrTarEcm.p. |
A sintaxe para executar a API em modo persistente é:
run crmapi/apiCrmIntegrTarEcm.p persistent set h-handle. |
A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.
Tabelas Temporárias
Nos atributos das tabelas temporárias de entrada e saída:
ttWorkFlowTemplate | Entrada/Saída |
| Entrada/Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
active | Logico | True/false | Ativo? | Sim | |
processId | Char | | Processo | Sim | |
Seq | Int | | Sequencia | sim | |
RowErrors | Entrada/Saída |
Tabela de Erros | Entrada/Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ErrorSequence | Int | | Sequência | | |
ErrorNumber | Int | | Número | | |
ErrorDescription | Char | | Descrição | | |
ErrorParameters | Char | | Parâmetros | | |
ErrorType | Char | | Tipo | | |
ErrorHelp | Char | | Ajuda | | |
ErrorSubType | Char | | Sub Tipo | | |
Método Básico
Quando a API for executada em modo persistente, os seguintes métodos estarão disponíveis para execução:
returnParamPed |
Requisito | |
Sintaxe | |
Descrição | Retorna os parâmetros de acesso ao ecm. |
Parâmetros | Descrição |
Pusername | Código do usuário |
Ppassword | Senha |
pcompanyId | Empresa |
puserId1 | Usuário logado |
Retorno | Out / Pusername Out / Ppassword Out / pcompanyId Out / puserId1 |
returnParamConfigEcm |
Requisito | |
Sintaxe | |
Descrição | Retorna os parâmetros de acesso e conexão com o ECM . |
Parâmetros | Descrição |
PcWebService | servico desejado |
Pusername | Código do usuário |
Ppassword | Senha |
pcompanyId | Empresa |
puserId1 | Usuário logado |
ppserver | Sevidor ecm |
Retorno | Out / Pusername Out / Ppassword Out / pcompanyId Out / puserId1 Out / ppserver |
returnParamEcm |
Requisito | |
Sintaxe | |
Descrição | Verificar se integração com ECM está ativa. |
Parâmetros | Descrição |
plEcm | Integração com ECM ativa? |
Retorno | Out / plEcm |
Método Negócio
relacionaWorkflow |
Requisito | |
Sintaxe | |
Descrição | Relaciona o processo a ação da campanha. |
Parâmetros | Descrição |
numIdCampanhaAcao | Chave da ação da campanha |
plEncerra | Encerra tarefa? |
ttWorkFlowTemplate | Processo que será relacionado a ação da campanha |
RowErrors | Erros |
Retorno | O método irá retornar os erros ocorridos durante a execução do método Out / RowErrors. |
returnWorkflowTemplate |
Requisito | |
Sintaxe | |
Descrição | Retornar os processos disponíveis para abrir um workflow. |
Parâmetros | Descrição |
iCurrentPage | pagina |
| iPageSize | Registros por pagina |
| iCampAcao | Id campanha |
| pProcessId | Id do processo |
| ttWorkFlowTemplate | Processos disponíveis |
| RowErrors | Erros |
| totalRecord | Total de registros |
Retorno | O método irá retornar os processos disponíveis no ECM (ttWorkFlowTemplate) e se ocorreu algum erro durante a execução do método (RowErrors). |
returnProcess |
Requisito | |
Sintaxe | |
Descrição | Retornar os processos disponíveis para abrir um workflow filtrados conforme parametrização em tela. |
Parâmetros | Descrição |
iCurrentPage | pagina |
| iPageSize | Registros por pagina |
| iCampAcao | Id campanha |
| pProcessId | Id do processo |
| ttWorkFlowTemplate | Processos disponíveis |
| RowErrors | Erros |
| totalRecord | Total de registros |
Retorno | O método irá retornar os processos disponíveis no ECM (ttWorkFlowTemplate) e se ocorreu algum erro durante a execução do método (RowErrors). |
connectWebservice |
Requisito | |
Sintaxe | |
Descrição | Conecta no web service e retorna os processos. |
Parâmetros | Descrição |
ttWorkFlowTemplate | Processos |
RowErrors | Erros |
Retorno | O método irá retornar os processos disponíveis no ECM (ttWorkFlowTemplate), se ocorrer algum erro durante a execução do método (RowErrors). |
returnLinkWorkflow |
Requisito | |
Sintaxe | |
Descrição | Retorna a url para detalhar o workflow passado como parâmetro. |
Parâmetros | Descrição |
pNumIdTar | tarefa |
pcLink | url |
Retorno | O método irá retornar a url para detalhar o workflow da tarefa. |

#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))