Histórico da Página

Objetivo:

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

post

Painel

title	Exemplos de uso

api/framework/v1/smartSchedApi

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

Parâmetros body

Nome	Tipo	Descrição	Obrigatório
firstExecution	Character	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
processID	Character	Função/Rotina a ser atribuída.	X
executionParameter	Json	Informações referentes a execução do agendamento.	X
daily	Json	Definições de período DIÁRIO.
weekly	Json	Definições de período SEMANAL.
monthly	Json	Definições de período MENSAL.
rangeExecutions	Json	Definições do range de execuções.	X
recurrent	Boolean	Define recorrência ativa.	X
status	Character	Status do agendamento. Por exemplo, active, inactive ou completed.	X

Parâmetros body: executionParameter

Nome	Tipo	Descrição	Obrigatório
company	arrayArray(character)	código do grupo de empresas	X
branch	arrayArray(character)	código da filial
moduleid	Character	Código do módulo.	X
userid	Character	Código do usuário.	X
description	Character	Descrição do agendamento.
companybranch	Character	Empresa/Filial que serão atribuídas. Por exemplo, T1/D MG 01.	X

Parâmetros body: daily

Nome	Tipo	Descrição	Obrigatório	Valor Padrão

title	Character	Título da Impressão.
printFormat
day	Numeric	Dia de execução	X	hour	Numeric	Hora de execução	X	minute	Numeric	Minuto de execução	X

Parâmetros body: weekly

NomeTipoDescriçãoObrigatórioValor PadrãodayNumericDia de execuçãoX

Formato de Impressão (1-Web Spool/2-Email).
fileMail	Character	Nome do arquivo de impressão ou e-mail destinatário.
printType	Numeric	Tipo de impressão (1-HTML/2-PDF/3-Planilha).
sheetFormat	Numeric	Formato da planilha (1-Normal/2-Suprime linhas brancas e totais/3-Tabela).
MV_PAR??	Any	Definição dos parâmetros(MV_PAR's) Formato Pergunte(SX1): MV_PAR01 MV_PAR02 MV_PAR03 ... Obs.: preenchimento deve respeitar a tipagem de cada pergunte definido no dicionário SX1, como: caractere, numérico ou data. Formato PARAMDEF: MV_PAR01 numérico: ORDEM MV_PAR02 caractere: DE MV_PAR03 caractere: ATE
MV_FOR??	Character	Fórmula(expressão) a ser executada para preenchimento do parâmetro. Formato Pergunte(SX1): MV_FOR01 MV_POR02 MV_POR03 ... Obs.: Formulas são utilizadas apenas quando os parâmetros são definidos via Pergunte(SX1).

Parâmetros body: daily

hourNumericHora de execuçãoXminuteNumericMinuto de execuçãoX

Parâmetros body: montly

Nome	Tipo	Descrição	Obrigatório	Valor Padrão
day	Numeric
Nome	Tipo	Descrição	Obrigatório	Valor Padrão
day	Numeric
Dia de execução	X
hour	Numeric	Hora de execução	X
minute	Numeric	Minuto de execução	X

Parâmetros body:

rangeExecutions

weekly

Nome	Tipo	Descrição	Obrigatório	Valor Padrão

frequency

day

Json

Numeric

Definições

Dia de

frequência.

execução

X

rangeLimit

hour

Json

Numeric

Definições de limite

Hora de execução

.

X

Parâmetros rangeExecutions: frequency


minute	Numeric	Minuto de execução	X

Parâmetros body: montly

Nome	Tipo	Descrição	Obrigatório	Valor Padrão

type

day

Character

Numeric

Tipo de frequencia, exemplo: day, hour, minute.

Dia de execução	X
hour	Numeric	Hora de execução	X

value


minute	Numeric

Intervalo da frequencia.

Minuto de execução

X

Parâmetros body: rangeExecutions

: rangeLimit

Nome Tipo Descrição Obrigatório Valor Padrão
dayfrequency NumericJson Dia Definições de execuçãofrequência.hour X
NumericrangeLimit Json Definições Hora de limite de execução minute Numeric Minuto de execução daysOfWeek Array Dias da semana de execução, exemplo:
Sunday;
Monday;
Tuesday;
Wednesday;
Thursday;
Friday;
Saturday;
Exemplo UNICA (Body Parameters)
. X

Parâmetros rangeExecutions: frequency

Nome	Tipo	Descrição	Obrigatório	Valor Padrão
type	Character	Tipo de frequencia, exemplo: day, hour, minute.	X
value	Numeric	Intervalo da frequencia.	X

Parâmetros rangeExecutions: rangeLimit

Nome	Tipo	Descrição
day	Numeric	Dia de execução
hour	Numeric	Hora de execução
minute	Numeric	Minuto de execução
daysOfWeek	Array	Dias da semana de execução, exemplo: Sunday; Monday; Tuesday; Wednesday; Thursday; Friday; Saturday;

Exemplo (Body Parameters) UNICA

Bloco de código

language	js
theme	Midnight
title	Body Parameters
collapse	true

{
    "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 (Body Parameters) MENSAL com MULTI-FILIAIS, PARAMETROS(SX1), PARAMETROS DE IMPRESSÃO e RECORRENCIA.

Bloco de código

language	js
theme	Midnight
title	Body Parameters
collapse	true

{
    "firstExecution": "2023-12-20T17:33:00-03:00",
    "recurrent": true,
    "executionParameter": {
        "company": [
            "T1"
        ],
        "branch": [
            "T1/M SP 01",
            "T1/M SP 02"
        ],
        "moduleid": 5,

Bloco de código

language	js
theme	Midnight
title	Body Parameters
collapse	true

{
    "firstExecution": "2023-12-13T12:28:00-03:00",
    "recurrent": false,
    "executionParameter": {
        "companyuserid": [
    "000000",
        "T2"
        ]description": "Agendamento Automatico Mensal",
        "branchMV_PAR01": "",
000001           "moduleid": 6,
        "userid": "000000",
        "description": "Agendamento UNICO",
        "companybranch": "T2;"
    },
    "processID": "TSTEMP",
    "status": "active"
}

Exemplo MENSAL (Body Parameters)

Bloco de código

language	js
theme	Midnight
title	Body Parameters
collapse	true

{
,
       "firstExecution": "2023-12-12T15:07:00-03:00",
	"processID": "TSTEMP",
 "MV_PAR02": "999999                    "executionParameter": {
        "company": [
            "T1",
            "T2",
         ]"MV_PAR03": "Date(20230101)",
        "branchMV_PAR04": "Date(20231231)"",
        "moduleidMV_PAR05": 52,
        "useridMV_PAR06": "000000",
C7_DESCRI        "description": "TESTE ",
        "companybranch": "T1;T2;"
    },
    "monthly": {
        "day": 1,
        "hour": 8,
          "minute": 0,
    },
    "rangeExecutionsMV_PAR07": {1,
        "frequencyMV_PAR08": {
    1,
        "typeMV_PAR09": "minute"3,
            "valueMV_PAR10": 301,
         }"MV_PAR11": 1,
        "rangeLimitMV_PAR12": {"",
            "hour"MV_PAR13": 12,
"            "minute": 0,
            "day": 10
        }
    },
	"recurrent": true,
    "status": "active"
}

Exemplo SEMANAL (Body Parameters)

Bloco de código

language	js
theme	Midnight
title	Body Parameters
collapse	true

{
                  "firstExecution": "2023-12-13T12:15:00-03:00",
        "recurrentMV_PAR14": true1,
        "executionParametertitle": {"Automática",
        "companyprintFormat": [1,
            "T1""fileMail": "arquivo",
        ]"printType": 1,
        "branchsheetFormat": [1,
            "T1/M SP 01 "MV_FOR01": "",
            "T1/M SP 02 "MV_FOR02": "",
            "T1/M PR 01 "MV_FOR03": "",
        ]"MV_FOR04": "",
        "moduleidMV_FOR05": 5"",
        "useridMV_FOR06": "000000",
        "descriptionMV_FOR07": "Agendamento SEMANAL",
        "MV_PAR01FOR08": ""000001,
        "MV_FOR09": "",
        "MV_FOR10": "",
        "MV_FOR11": "",
        "MV_FOR12": "",
        "MV_FOR13": "",
          "MV_FOR14": "",
        "MV_PAR02companybranch": "999999T1/M SP 01;T1/M      SP 02;"
    },
    "monthly": {
        "day": 10,
        "hour": 10,
        "minute": 0
    },
      ","rangeExecutions": {
        "MV_PAR03frequency": "Date(20110101)",
{
            "MV_PAR04type": "Date(20291231)hour",
        "MV_PAR05    "value": 2
        },
        "MV_PAR06rangeLimit": "C7_DESCRI{
            "hour": 18,
            "minute": 0,
            "day": 20
        }
    "},
        "MV_PAR07processID": 1"MATR110",
     "status": "active"
}

Exemplo (Body Parameters) SEMANAL com MULTI-FILIAIS.

Bloco de código

language	js
theme	Midnight
title	Body Parameters
collapse	true

{   "MV_PAR08": 1,
        "MV_PAR09": 3,
    "firstExecution": "2023-12-13T12:15:00-03:00",
    "MV_PAR10recurrent": 2true,
        "MV_PAR11executionParameter": 1,{
        "MV_PAR12company": "",[
        "MV_PAR13": "   "T1"
        ],
        "branch": [
             "T1/M SP 01 ",
            "T1/M SP 02 ",
         ",
   "T1/M PR    "MV_PAR14": 2,01 "
        "title": ""],
        "printFormatmoduleid": 15,
        "fileMailuserid": "000000",
        "printTypedescription": "Agendamento 1SEMANAL",
        "sheetFormatcompanybranch": 1,
        "MV_FOR01": "","T1/M SP 01 ;T1/M SP 02 ;T1/M PR 01 ;"
    },
    "MV_FOR02weekly": "",{
        "MV_FOR03daysOfWeek": "",
[
           "MV_FOR04": "Monday",
           "MV_FOR05": "Tuesday",

           "MV_FOR06": "Wednesday",
        "MV_FOR07":    "Friday",
           "MV_FOR08": "Thursday",
        "MV_FOR09": ""],
        "MV_FOR10hour": ""0,
        "MV_FOR11minute": "",0
    },
    "MV_FOR12rangeExecutions": "",{
        "MV_FOR13frequency": "",{
        "MV_FOR14    "type": "hour",
            "companybranchvalue": "T1/M SP 01 ;T1/M SP 02 ;T1/M PR 01 ;"24
        },
    },
    "weeklyrangeLimit": {
            "daysOfWeekhour": [23,
            "Mondayminute",: 59
        }
    "Tuesday"},
    "processID": "TSTEMP",
       "status": "active"
}

Exemplo (Body Parameters) DIARIO com PARAMDEF(SA1) e PARÂMETROS DE IMPRESSÃO FORMATO PLANILHA.

Bloco de código

language	js
theme	Midnight
title	Body Parameters
collapse	true

{"Wednesday",
            "Friday",
            "Thursday"
        ],
        "hour": 0"firstExecution": "2023-12-20T17:50:00-03:00",
        "minuterecurrent": 0
    }false,
    "rangeExecutionsexecutionParameter": {
        "frequencycompany": {[
            "type": "hour"T2",
            "valueT1": 24
        }],
        "rangeLimitbranch": {
            "hour": 23,[
            "minute": 59T2/D MG 01",
        }
    },
    "processID": "MATR110","T1/D RJ 01"
    "status": "active"
}

Exemplo DIARIO (Body Parameters)

Bloco de código

language	js
theme	Midnight
title	Body Parameters
collapse	true

{
    ],
        "firstExecutionmoduleid": "2023-12-13T12:22:00-03:00"1,
        "recurrentuserid": true"000000",
        "executionParameterdescription": { "Agendamento Diário PARAMDEF",
        "companyorder": [1,
          "paramdef1":  "T100000101",
        ]"paramdef2": "99999901",
        "branchtitle": "",
        "moduleidprintFormat": 2,
        "useridfileMail": "000000[email protected]",
        "descriptionprintType": 3,
 "Agendamento DIARIO"       "sheetFormat": 3,
        "companybranch": "T2/D MG 01;T1/D RJ 01;"
    },
    "daily": {
        "hour": 1210,
        "minute": 0
    },
    "rangeExecutions": {
        "frequency": {
            "type": "minute",
            "value": 30
        },
        "rangeLimit": {
            "hour": 1716,
            "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)
200	Success	Não há	Não há
400	Bad Request	Não há	Não há

Response: application/json, text/json

Bloco de código

language	js
theme	RDark
title	200 - Success
collapse	true

{
    "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"
}

Páginas filhas

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

Objetivo:

post

Parâmetros body

Parâmetros body: executionParameter

Parâmetros body: daily

Parâmetros body: weekly

Parâmetros body: daily

Parâmetros body: montly

Parâmetros body:

weekly

Parâmetros body: montly

Parâmetros body: rangeExecutions

Parâmetros rangeExecutions: frequency

Parâmetros rangeExecutions: rangeLimit

Informações para Resposta (Response Information)

Descrição do Recurso (Resource Description)

Formatos de Resposta (Response Formats)