Páginas filhas
  • POST - api/framework/v1/smartSchedApi

Versões comparadas

Chave

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

Objetivo:

A finalidade deste método é possibilitar a inclusão de Agendamentos do Smart Schedule.


post

Painel
titleExemplos de uso

api/framework/v1/smartSchedApi


Informações para Requisição (Request Information)

Exemplo (Body Parameters)

Bloco de código
languagejs
themeMidnight
titleExemplo de body
{
    "firstExecution": "2023-12-12T15:07:00-03:00",
	"processID": "TSTEMP",
    "executionParameter": {
        "company": [
            "T1",
            "T2"
        ],
        "branch": "",
        "moduleid": 5,
        "userid": "000000",
        "description": "TESTE ",
        "companybranch": "T1;T2;"
    },
    "monthly": {
        "day": 1,
        "hour": 8,
        "minute": 0
    },
    "rangeExecutions": {
        "frequency": {
            "type": "minute",
            "value": 30
        },
        "rangeLimit": {
            "hour": 12,
            "minute": 0,
            "day": 10
        }
    },
	"recurrent": true,
    "status": "active"
}

Parâmetros body

NomeTipoDescriçãoObrigatórioValor padrão
firstExecutionCharacter

Data e hora inicial, para primeira execução.
Formato UTC aaaa-mm-ddThh:mm:ss-+Time Zone (coloca a hora local + o timezone (ISO 8601))

X
processIDCharacter

Função/Rotina a ser atribuída.

X
executionParameterJson

Informações referentes a execução do agendamento.

X


dailyJson

Definições de período DIÁRIO.



weeklyJson

Definições de período SEMANAL.



monthlyJson

Definições de período MENSAL.



rangeExecutionsJson

Definições do range de execuções.

X
recurrentBoolean

Define recorrência ativa.

X
statusCharacter

Status do agendamento. Por exemplo, active, inactive ou completed.

X


Parâmetros body: executionParameter

NomeTipoDescriçãoObrigatórioValor Padrão
companyarray(character)código do grupo de empresasX
brancharray(character)código da filial

moduleidCharacter

Código do módulo.

X
useridCharacter

Código do usuário.

X
descriptionCharacter

Descrição do agendamento.



companybranchCharacter

Empresa/Filial que serão atribuídas. Por exemplo, T1/D MG 01.

X


Parâmetros body: daily

NomeTipoDescriçãoObrigatórioValor Padrão
dayNumericDia de execuçãoX
hourNumericHora de execuçãoX
minuteNumericMinuto de execuçãoX


Parâmetros body: weekly

NomeTipoDescriçãoObrigatórioValor Padrão
dayNumericDia de execuçãoX
hourNumericHora de execuçãoX
minuteNumericMinuto de execuçãoX


Parâmetros body: montly

NomeTipoDescriçãoObrigatórioValor Padrão
dayNumericDia de execuçãoX
hourNumericHora de execuçãoX
minuteNumericMinuto de execuçãoX


Parâmetros body: rangeExecutions

NomeTipoDescriçãoObrigatórioValor Padrão
frequencyJsonDefinições de frequência.X
rangeLimitJsonDefinições de limite de execução.X


Parâmetros rangeExecutions: frequency

NomeTipoDescriçãoObrigatórioValor Padrão
typeCharacterTipo de frequencia, exemplo: day, hour, minute.X
valueNumericIntervalo da frequencia.X


Parâmetros rangeExecutions: rangeLimit

NomeTipoDescriçãoObrigatórioValor Padrão
dayNumericDia de execução

hourNumericHora de execução

minuteNumericMinuto de execução

daysOfWeekArrayDias da semana de execução, exemplo:
Sunday;
Monday;
Tuesday;
Wednesday;
Thursday;
Friday;
Saturday;



Exemplo UNICA (Body Parameters)

Bloco de código
languagejs
themeMidnight
titleBody Parameters
collapsetrue
{
    "firstExecution": "2023-12-13T12:28:00-03:00",
    "recurrent": false,
    "executionParameter": {
        "company": [
            "T2"
        ],
        "branch": "",
        "moduleid": 6,
        "userid": "000000",
        "description": "Agendamento UNICO",
        "companybranch": "T2;"
    },
    "processID": "TSTEMP",
    "status": "active"
}


Exemplo MENSAL (Body Parameters)

Bloco de código
languagejs
themeMidnight
titleBody Parameters
collapsetrue
{
    "firstExecution": "2023-12-12T15:07:00-03:00",
	"processID": "TSTEMP",
    "executionParameter": {
        "company": [
            "T1",
            "T2"
        ],
        "branch": "",
        "moduleid": 5,
        "userid": "000000",
        "description": "TESTE ",
        "companybranch": "T1;T2;"
    },
    "monthly": {
        "day": 1,
        "hour": 8,
        "minute": 0
    },
    "rangeExecutions": {
        "frequency": {
            "type": "minute",
            "value": 30
        },
        "rangeLimit": {
            "hour": 12,
            "minute": 0,
            "day": 10
        }
    },
	"recurrent": true,
    "status": "active"
}


Exemplo SEMANAL (Body Parameters)

Bloco de código
languagejs
themeMidnight
titleBody Parameters
collapsetrue
{
    "firstExecution": "2023-12-13T12:15:00-03:00",
    "recurrent": true,
    "executionParameter": {
        "company": [
            "T1"
        ],
        "branch": [
            "T1/M SP 01 ",
            "T1/M SP 02 ",
            "T1/M PR 01 "
        ],
        "moduleid": 5,
        "userid": "000000",
        "description": "Agendamento SEMANAL",
        "MV_PAR01": "000001                                                      ",
        "MV_PAR02": "999999                                                      ",
        "MV_PAR03": "Date(20110101)",
        "MV_PAR04": "Date(20291231)",
        "MV_PAR05": 2,
        "MV_PAR06": "C7_DESCRI                                                   ",
        "MV_PAR07": 1,
        "MV_PAR08": 1,
        "MV_PAR09": 3,
        "MV_PAR10": 2,
        "MV_PAR11": 1,
        "MV_PAR12": "",
        "MV_PAR13": "                                                            ",
        "MV_PAR14": 2,
        "title": "",
        "printFormat": 1,
        "fileMail": "",
        "printType": 1,
        "sheetFormat": 1,
        "MV_FOR01": "",
        "MV_FOR02": "",
        "MV_FOR03": "",
        "MV_FOR04": "",
        "MV_FOR05": "",
        "MV_FOR06": "",
        "MV_FOR07": "",
        "MV_FOR08": "",
        "MV_FOR09": "",
        "MV_FOR10": "",
        "MV_FOR11": "",
        "MV_FOR12": "",
        "MV_FOR13": "",
        "MV_FOR14": "",
        "companybranch": "T1/M SP 01 ;T1/M SP 02 ;T1/M PR 01 ;"
    },
    "weekly": {
        "daysOfWeek": [
            "Monday",
            "Tuesday",
            "Wednesday",
            "Friday",
            "Thursday"
        ],
        "hour": 0,
        "minute": 0
    },
    "rangeExecutions": {
        "frequency": {
            "type": "hour",
            "value": 24
        },
        "rangeLimit": {
            "hour": 23,
            "minute": 59
        }
    },
    "processID": "MATR110",
    "status": "active"
}


Exemplo DIARIO (Body Parameters)

Bloco de código
languagejs
themeMidnight
titleBody Parameters
collapsetrue
{
    "firstExecution": "2023-12-13T12:22:00-03:00",
    "recurrent": true,
    "executionParameter": {
        "company": [
            "T1"
        ],
        "branch": "",
        "moduleid": 2,
        "userid": "000000",
        "description": "Agendamento DIARIO",
        "companybranch": "T1;"
    },
    "daily": {
        "hour": 12,
        "minute": 0
    },
    "rangeExecutions": {
        "frequency": {
            "type": "minute",
            "value": 30
        },
        "rangeLimit": {
            "hour": 17,
            "minute": 0
        }
    },
    "processID": "TSTEMP",
    "status": "active"
}


Informações para Resposta (Response Information)

Descrição do Recurso (Resource Description)

Não há. 

Formatos de Resposta (Response Formats)

Código (Code)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
200SuccessNão háNão há
400Bad RequestNão háNão há


Response: application/json, text/json 

Bloco de código
languagejs
themeRDark
title200 - Success
collapsetrue
{
    "isNewSchedule": true,
    "jobscheduleid": "000007",
    "processID": "TSTEMP                                                                          ",
    "recurrent": true,
    "monthly": {
        "day": 1,
        "hour": 8,
        "minute": 0
    },
    "rangeExecutions": {
        "frequency": {
            "type": "minute",
            "value": 30
        },
        "rangeLimit": {
            "day": 10,
            "hour": 12,
            "minute": 0
        }
    },
    "status": "active",
    "firstExecution": "2023-12-12T15:07:00-03:00",
    "executionParameter": {
        "printType": 1,
        "sheetFormat": 1,
        "paramdef1": null,
        "paramdef2": null,
        "company": [
            "T1",
            "T2"
        ],
        "userid": "000000",
        "moduleid": 5,
        "description": "TESTE "
    },
    "manageable": "1"
}

Response

Parâmetro

Tipo

Descrição

Valores

isNewScheduleBooleanjobscheduleidprocessIDrecurrentstatusmanageable