Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Expandir
Informações
iconfalse
titleDelete

Máscara de Url: http://{domínio}:{porta}/api/educational/financial/v1/pricetableterms/{internalId}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

internalId: 1|1|3|73

Url Utilizada: http://localhost:8051/api/educational/financial/v1/pricetableterms/1|1|3|73

Informações
iconfalse
titleExemplo de Resultado Positivo Postman

Obs.: Em caso de sucesso, será retornado o respondeCode = 204 e a resposta em branco.

Informações
iconfalse
titleExemplo de Resultado Negativo
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "code": null,
    "message": "Não existe um cadastro de Período Letivo de Ingresso vinculado à Tabela de Preço com o ID informado para exclusão.",
    "detailedMessage": null,
    "helpUrl": null,
    "details": null
}

4 -

...

Processo Vínculo Matriz Aplicada e Campus/Polo da Matriz Aplicada

...

O vínculo da tabela de preço como default para a matriz aplicada e/ou campus/polo da matriz aplicada, pode ser realizada pelo método POST da API de JobScheduler.

Expandir
Informações
iconfalse
titlePost

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/jobscheduler

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Url Utilizada: http://localhost:8051/api/framework/v1/jobscheduler

Informações
iconfalse
titleExemplo de entrada 3 camadas

Caso a propriedade recurrent seja igual a true, obrigatoriamente deve-se informar o Tipo de Recorrência.

Propriedades obrigatórias:

processID, firstExecution, recurrent, executionParameter

executionParameter: Context, ProcessName, UserName, PrimaryKeyList, PrimaryKeyNames


Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "processID": "EduVinculaTabelaPrecoMatrizAplicadaData",
    "firstExecution": "2025-02-17T18:12:00-03:00",
    "recurrent": false,
    "executionParameter": {
        "Context": {
            "_params": {
                "$CODCOLIGADA": 1,
                "$CODFILIAL": 1,
                "$CODTIPOCURSO": 1,
                "$CODUSUARIO": "mestre",
                "$CODSISTEMA": "S"
            }
        },
        "ProcessName": "Vinculo Matriz Aplicada e Campus/Polo",
        "UserName": "mestre",
        "PrimaryKeyList": [
            [
                "1|1|6"
            ]
        ],
        "PrimaryKeyNames": [
            "internalId"
        ],
Expandir
titleDescrição dos campos JSON de entrada/retorno

Tabela de Preço

  • companyCode: Código da coligada
  • levelEducationCode: Código do nível de ensino/tipo de curso
  • id: Identificador único da tabela de preço
  • internalId: Identificador da tabela de preço no formato:
    • "Código da Coligada | Código do Nível de Ensino | Identificador da Tabela de Preço"
  • code: Código da tabela de preço definido pelo usuário no sistema
  • name: Nome da tabela de preço
  • reccreatedon: Data de criação da tabela de preço
  • active: Informa se a tabela de preço está ativa
  • pricetableinuse: Informa se a tabela de preço está em uso
  • appliedMatrixes: Listagem das matrizes aplicadas vinculadas à tabela de preço
  • terms: Listagem dos período letivos de ingresso vinculados à tabela de preço

Matriz Aplicada vinculada à Tabela de Preço

  • companyCode: Código da coligada
  • branchCode: Código da filial
  • levelEducationCode: Código do nível de ensino/tipo de curso
  • appliedMatrixCode: Identificador da matriz aplicada
  • priceTableCode: Identificador da tabela de preço
  • branchName: Nome da filial
  • courseCode: Código do curso
  • courseName: Nome do curso
  • curriculumGridCode: Código da grade/matriz curricular
  • curriculumGridName: Nome da grade/matriz curricular
  • majorCode: Código da habilitação
  • majorName: Nome da habilitação
  • classShiftCode: Código do turno
  • classShiftName: Nome do turno
  • Status: Informar o status do preenchimento do valor de créditos da disciplinas, valores possíveis
    • 0: Informa que todas as disciplinas não tem o valor de créditos preenchido
    • 1: Informa que têm algumas disciplinas sem ter o valor de créditos preenchido
    • 2: Informa que todas as disciplinas já tem o valor de créditos preenchido
  • disciplines: Listagem das disciplinas vinculadas a matriz aplicada
  • actionState: Informar o controle de modificação
    • 1: Informa a inclusão da matriz aplicada na tabela de preço
    • 2: Informa a remoção da matriz aplicada na tabela de preço

Disciplina vinculada à Matriz Aplicada

  • companyCode: Código da coligada
  • priceTableCode: Identificador da tabela de preço
  • appliedMatrixCode: Identificador da matriz aplicada
  • levelEducationCode: Código do nível de ensino/tipo de curso
  • internalId: Identificador da disciplina no formato:
    • "Código da Coligada | Identificador da Tabela de Preço | Identificador da Matriz Aplicada | Código do Nível de Ensino | Código da Disciplina"
  • disciplineCode: Código da disciplina
  • creditsValue: Valor de créditos
  • periodCode: Código do período
  • periodDescription: Descrição do período
  • disciplineName: Nome da disciplina
  • workload: Número da carga horária da disciplina
  • actionState: Informar o controle de modificação
    • 1: Informa a inclusão da disciplina da matriz aplicada
    • 2: Informa a remoção da disciplina da matriz aplicada
    • 3: Informa a modificação da disciplina da matriz aplicada
  • recCreatedBy: Usuário de criação
  • recCreatedOn: Data de criação
  • recModifiedBy: Usuário de alteração
  • recModifiedOn: Data de alteração

Período Letivo de Ingresso vinculado à Matriz Aplicada

  • companyCode: Código da coligada
  • priceTableCode: Identificador da tabela de preço
  • levelEducationCode: Código do nível de ensino/tipo de curso
  • termId: identidicador do período letivo de ingresso
  • internalId: Identificador da disciplina no formato:
    • "Código da Coligada|Identificador da Tabela de Preço|Identificador do Período Letivo de Ingresso|Código do Nível de Ensino"
  • termCode: Código do período letivo de ingresso definido pelo usuário no sistema
  • branchName: Nome da filial
  • branchCode: Código da filial
  • actionState: Informar o controle de modificação
    • 1: Informa a inclusão do período letivo de ingresso na tabela de preço
    • 2: Informa a remoção do período letivo de ingresso na tabela de preço
  • recCreatedBy: Usuário de criação
  • recCreatedOn: Data de criação
  • recModifiedBy: Usuário de alteração
  • recModifiedOn: Data de alteração

5 - Processo Vínculo Matriz Aplicada e Campus/Polo da Matriz Aplicada

O vínculo da tabela de preço como default para a matriz aplicada e/ou campus/polo da matriz aplicada, pode ser realizada pelo método POST da API de JobScheduler.

Expandir
Informações
iconfalse
titlePost

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/jobscheduler

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Url Utilizada: http://localhost:8051/api/framework/v1/jobscheduler

Informações
iconfalse
titleExemplo de entrada 3 camadas

Caso a propriedade recurrent seja igual a true, obrigatoriamente deve-se informar o Tipo de Recorrência.

Propriedades obrigatórias:

processID, firstExecution, recurrent, executionParameter

executionParameter: Context, ProcessName, UserName, PrimaryKeyList, PrimaryKeyNames

Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "processID": "EduVinculaTabelaPrecoMatrizAplicadaData",
    "firstExecution": "2025-02-17T18:12:00-03:00",
    "recurrent": false,
    "executionParameter": {
        "Context": {
            "_paramsHostName": {"HOST",
        "appliedMatrixCodeList": [
       "$CODCOLIGADA": 1,
    21,
            "$CODFILIAL": 125,
                "$CODTIPOCURSO": 1,26
        ],
        "$CODUSUARIOappliedMatrixCampusCodeList": "mestre",[
            "21|1",
    "$CODSISTEMA": "S"
        "25|1"
    }
    ]
    }
}
Informações
iconfalse
titleExemplo de entrada ambiente local

Se o Host estiver executando local (3camadas = false) não é possível criar um agendamento de job. Neste cenário, para executar o job imediatamente, é preciso que no Body da requisição a recorrência esteja como 'false' e não sejam enviadas as propriedades "ScheduleDateTime" e Tipo de Recorrência.

Propriedades obrigatórias:

processID, recurrent, executionParameter

executionParameter: Context, ProcessName, UserName, PrimaryKeyList, PrimaryKeyNames


Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{},
        "ProcessNameprocessID": "VinculoEduVinculaTabelaPrecoMatrizAplicadaData",
 Matriz Aplicada e Campus/Polo""recurrent": false,
        "UserNameexecutionParameter": "mestre",{
        "PrimaryKeyListContext": [{
            ["_params": {
                "$CODCOLIGADA"1|1|6"
: 1,
                 ]"$CODFILIAL": 1,
        ],
        "PrimaryKeyNames$CODTIPOCURSO": [
1,
                "$CODUSUARIO": "internalIdmestre",
        ],
        "HostName$CODSISTEMA": "HOSTS",
          "appliedMatrixCodeList": [  }
        },
    21,
      "ProcessName": "Vinculo Matriz Aplicada e Campus/Polo",
          25"UserName": "mestre",
            26"PrimaryKeyList": [
        ],
    [
    "appliedMatrixCampusCodeList": [
            "211|1|6",
            "25|1"]
        ],
    }
}
Informações
iconfalse
titleExemplo de entrada ambiente local

Se o Host estiver executando local (3camadas = false) não é possível criar um agendamento de job. Neste cenário, para executar o job imediatamente, é preciso que no Body da requisição a recorrência esteja como 'false' e não sejam enviadas as propriedades "ScheduleDateTime" e Tipo de Recorrência.

Propriedades obrigatórias:

processID, recurrent, executionParameter

executionParameter: Context, ProcessName, UserName, PrimaryKeyList, PrimaryKeyNames

Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "processID": "EduVinculaTabelaPrecoMatrizAplicadaData",
    "recurrent": false,
    "executionParameter": {    "PrimaryKeyNames": [
            "internalId"
        ],
        "HostName": "HOST",
        "appliedMatrixCodeList": [
            21,
            25,
            26
        ],
        "ContextappliedMatrixCampusCodeList": {[
            "_params": {21|1",
            "25|1"
    "$CODCOLIGADA": 1,
   ]
    }
}
Informações
iconfalse
titleExemplo de resultado positivo
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "jobScheduleId": "105783",
    "$CODFILIALstatus": 1"active",
    "lastModified": "2025-02-17T18:40:27-03:00",
       "processId": "EduVinculaTabelaPrecoMatrizAplicadaData",
    "$CODTIPOCURSOfirstExecution": 1"2025-02-17T18:40:00-03:00",
                "$CODUSUARIO"user": "mestre",
    "recurrent": false,
    "executionParameter": {
        "$CODSISTEMAappliedMatrixCodeList": "S"[
            }
21,
            }25,
        "ProcessName": "Vinculo Matriz Aplicada e Campus/Polo",26
        "UserName": "mestre"],
        "PrimaryKeyListappliedMatrixCampusCodeList": [
            [
   "21|1",
             "125|1|6"
            ],
        ]"CodColigada": 0,
        "PrimaryKeyNamesCodFilial": [
    0,
        "internalId"
        ]CodTipoCurso": 0,
        "HostNameInitialized": "HOST"false,
        "appliedMatrixCodeListPrimaryKeyList": [
            21,[
              25,  "1|1|6"
            26]
        ],
        "appliedMatrixCampusCodeListPrimaryKeyNames": [
            "21|1internalId",
        ],
     "25|1"
   "PrimaryKeyTableName": null,
         ]"OnlineMode": false,
    }
}
Informações
iconfalse
titleExemplo de resultado positivo
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "jobScheduleIdSyncExecution": "105783"false,
        "statusHideProgressDialog": "active",
 false,
        "lastModifiedSaveParamsExecution": "2025-02-17T18:40:27-03:00"false,
        "processIdCodUsuario": "EduVinculaTabelaPrecoMatrizAplicadaDatamestre",
        "firstExecutionContext": "2025-02-17T18:40:00-03:00",{
    "user        "$id": "mestre1",
       "recurrent": false,
    "executionParameter_params": {
                "appliedMatrixCodeList$CODFILIAL": [1,
            21    "$CODSISTEMA": "S",
            25    "$CODCOLIGADA": 1,
                26"$CODUSUARIO": "mestre",
        ],
        "appliedMatrixCampusCodeList$CODTIPOCURSO": [1
            "21|1"},
            "25|1"Environment": 0
        ]},
        "CodColigadaUserName": 0"mestre",
        "CodFilialConnectionId": 0null,
        "CodTipoCursoConnectionString": 0null,
        "InitializedDriverType": falsenull,
        "PrimaryKeyListIp": [null,
        "HostName": "",
   [
        "JobServerHostName": "BHN050104619",
        "1|1|6"ActionName": null,
        "MasterActionName": null,
   ]
        ]"ActionModule": null,
        "PrimaryKeyNamesJobID": [{
            "internalIdID": 105783,
        ],
        "PrimaryKeyTableNameExecID": null1,
            "OnlineModeIsPriorityJob": false,
            "SyncExecutionChildren": false,[]
        "HideProgressDialog": false},
        "SaveParamsExecutionShowReExecuteButton": falsetrue,
        "CodUsuarioExecutionId": "mestref414352f-fe43-444c-a437-80cb6390388e",
        "ContextProcessName": {
"Vinculo Matriz Aplicada e Campus/Polo",
        "$idServerName": "1"null,
            "_params"ServiceInterface": {null,
        "Scheduler": 1,
        "$CODFILIALUseJobMonitor": 1true,
        "ScheduleDateTime": "2025-02-17T18:40:26-03:00",
        "$CODSISTEMACanSendMail": "S"false,
        "CanWaitSchedule": false,
        "$CODCOLIGADASendMail": 1false,
        "FriendlyLogs": null,
        "$CODUSUARIOSuccessMessage": "mestreProcesso executado com sucesso",
        "FailureMessage": "Falha na execução do    "$CODTIPOCURSO": 1
  processo",
          }"SaveLogInDatabase": true,
            "EnvironmentStatusMessage": 0null,
        "WaitSchedule": }false,
        "UserNameIsolateProcess": "mestre"false,
        "ConnectionIdDisableIsolateProcess": nullfalse,
        "ConnectionStringNetworkUser": null"",
        "DriverTypeCustomData": null,
        "IpCanParallelize": nullfalse,
        "HostNameShouldParallelize": ""false,
        "JobServerHostNameQuantityOfSplits": "BHN050104619"0,
        "ActionNameMinimumQuantityOfPrimaryKeysPerProcess": null1,
        "MasterActionNameMaximumQuantityOfPrimaryKeysPerProcess": null1000,
        "ActionModuleNotifyFluig": nullfalse,
        "JobIDNotifyEmail": {false,
            "IDNotifyEmailList": 105783,null
       }
}
{ "Code": "FE016", "Message": "O corpo da mensagem contém valores inválidos.", "DetailMessage": "", "HelpUrl": "http://tdn.totvs.com/x/e0F0GQ", "Details": null }
Informações
iconfalse
titleExemplo de resultado negativo
Expandir
titleResultado (JSON)
Bloco de código
languagejs
firstline1
titleVer resultado JSON...
linenumberstrue
{
     "ExecIDCode": 1"FE016",
    "Message": "O corpo da mensagem contém valores inválidos.",
    "IsPriorityJobDetailMessage": false"",
    "HelpUrl": "http://tdn.totvs.com/x/e0F0GQ",
       "Children": []
        },
        "ShowReExecuteButton": true,
        "ExecutionId": "f414352f-fe43-444c-a437-80cb6390388e",
        "ProcessName": "Vinculo Matriz Aplicada e Campus/Polo",
        "ServerName": null,
        "ServiceInterface": null,
        "Scheduler": 1,
        "UseJobMonitor": true,
        "ScheduleDateTime": "2025-02-17T18:40:26-03:00",
        "CanSendMail": false,
        "CanWaitSchedule": false,
        "SendMail": false,
        "FriendlyLogs": null,
        "SuccessMessage": "Processo executado com sucesso",
        "FailureMessage": "Falha na execução do processo",
        "SaveLogInDatabase": true,
        "StatusMessage": null,
        "WaitSchedule": false,
        "IsolateProcess": false,
        "DisableIsolateProcess": false,
        "NetworkUser": "",
        "CustomData": null,
        "CanParallelize": false,
        "ShouldParallelize": false,
        "QuantityOfSplits": 0,
        "MinimumQuantityOfPrimaryKeysPerProcess": 1,
        "MaximumQuantityOfPrimaryKeysPerProcess": 1000,
        "NotifyFluig": false,
        "NotifyEmail": false,
        "NotifyEmailList": null
    }
}
Informações
iconfalse
titleExemplo de resultado negativo
Expandir
titleResultado (JSON)
Bloco de código
languagejs
firstline1
titleVer resultado JSON...
linenumberstrue
"Details": null
}

5 - Descrição dos campos JSON de entrada/retorno

...

Expandir
titleDescrição dos campos JSON de entrada/retorno

Tabela de Preço

  • companyCode: Código da coligada
  • levelEducationCode: Código do nível de ensino/tipo de curso
  • id: Identificador único da tabela de preço
  • internalId: Identificador da tabela de preço no formato:
    • "Código da Coligada | Código do Nível de Ensino | Identificador da Tabela de Preço"
  • code: Código da tabela de preço definido pelo usuário no sistema
  • name: Nome da tabela de preço
  • reccreatedon: Data de criação da tabela de preço
  • active: Informa se a tabela de preço está ativa
  • pricetableinuse: Informa se a tabela de preço está em uso
  • appliedMatrixes: Listagem das matrizes aplicadas vinculadas à tabela de preço
  • terms: Listagem dos período letivos de ingresso vinculados à tabela de preço

Matriz Aplicada vinculada à Tabela de Preço

  • companyCode: Código da coligada
  • branchCode: Código da filial
  • levelEducationCode: Código do nível de ensino/tipo de curso
  • appliedMatrixCode: Identificador da matriz aplicada
  • priceTableCode: Identificador da tabela de preço
  • branchName: Nome da filial
  • courseCode: Código do curso
  • courseName: Nome do curso
  • curriculumGridCode: Código da grade/matriz curricular
  • curriculumGridName: Nome da grade/matriz curricular
  • majorCode: Código da habilitação
  • majorName: Nome da habilitação
  • classShiftCode: Código do turno
  • classShiftName: Nome do turno
  • Status: Informar o status do preenchimento do valor de créditos da disciplinas, valores possíveis
    • 0: Informa que todas as disciplinas não tem o valor de créditos preenchido
    • 1: Informa que têm algumas disciplinas sem ter o valor de créditos preenchido
    • 2: Informa que todas as disciplinas já tem o valor de créditos preenchido
  • disciplines: Listagem das disciplinas vinculadas a matriz aplicada
  • actionState: Informar o controle de modificação
    • 1: Informa a inclusão da matriz aplicada na tabela de preço
    • 2: Informa a remoção da matriz aplicada na tabela de preço

Disciplina vinculada à Matriz Aplicada

  • companyCode: Código da coligada
  • priceTableCode: Identificador da tabela de preço
  • appliedMatrixCode: Identificador da matriz aplicada
  • levelEducationCode: Código do nível de ensino/tipo de curso
  • internalId: Identificador da disciplina no formato:
    • "Código da Coligada | Identificador da Tabela de Preço | Identificador da Matriz Aplicada | Código do Nível de Ensino | Código da Disciplina"
  • disciplineCode: Código da disciplina
  • creditsValue: Valor de créditos
  • periodCode: Código do período
  • periodDescription: Descrição do período
  • disciplineName: Nome da disciplina
  • workload: Número da carga horária da disciplina
  • actionState: Informar o controle de modificação
    • 1: Informa a inclusão da disciplina da matriz aplicada
    • 2: Informa a remoção da disciplina da matriz aplicada
    • 3: Informa a modificação da disciplina da matriz aplicada
  • recCreatedBy: Usuário de criação
  • recCreatedOn: Data de criação
  • recModifiedBy: Usuário de alteração
  • recModifiedOn: Data de alteração

Período Letivo de Ingresso vinculado à Matriz Aplicada

  • companyCode: Código da coligada
  • priceTableCode: Identificador da tabela de preço
  • levelEducationCode: Código do nível de ensino/tipo de curso
  • termId: identidicador do período letivo de ingresso
  • internalId: Identificador da disciplina no formato:
    • "Código da Coligada|Identificador da Tabela de Preço|Identificador do Período Letivo de Ingresso|Código do Nível de Ensino"
  • termCode: Código do período letivo de ingresso definido pelo usuário no sistema
  • branchName: Nome da filial
  • branchCode: Código da filial
  • actionState: Informar o controle de modificação
    • 1: Informa a inclusão do período letivo de ingresso na tabela de preço
    • 2: Informa a remoção do período letivo de ingresso na tabela de preço
  • recCreatedBy: Usuário de criação
  • recCreatedOn: Data de criação
  • recModifiedBy: Usuário de alteração
  • recModifiedOn: Data de alteração