A API /api/Relatorio é uma API temporária. Sua chamada definitiva será /api/item/hystory/create.
Nome: Relatorio
Descrição: Insere valores históricos na base de dados
Método: Post
Chamada: https://api.scadaflex.online:8787/api/Relatorio
Parâmtros de Entrada:
- ID Integração: Identificador de cada equipamento de campo. Para cadastrar ou saber qual o ID Integração, acesse o Cadastro de Dispositivo.
- TagGlobal: Identifica a variável, pelo nome global. Para saber qual o identificador, verifique a Tag Global no Cadastro de Variável e seu código na Tabela de Tag Global.
- Lista de Valores/Datas: Um par de Valor e sua respectiva data.
Regras:
1. ID de Integração é um número inteiro;
2. Tag Global é um texto de identificação da variável. O código está na 2a. coluna da Lista de Tags Globais
3. Valor é inserido no formato definido no Cadastro de Variáveis. Para valores do tipo float, a entrada deve ter separador por ponto ".", por exemplo, 1.2 ou 23.65432.
4. Data é inserida no formato YYYY-MM-DDTHH:MM:SS.sssZ, onde:
YYYY: Ano, com 4 digitos
MM: Mês, com 2 dígitos
DD: Dia, com 2 dígitos
T: Separador de DiaTHora
HH: Hora, no formato 24hs
MM: Minuto, com 2 dígitos
SS: Segundo, com 2 dígitos
sss: Milésimos de segundo, com 3 dígitos
Z : localidade do fuso horário. Normalmente o valor é inserido como Z (Zulu) com a hora GMT (Greenwitch Mean Time).
Exemplo: 2018-07-15T21:09:36.000Z
IMPORTANTE: A data inserida deve ser POSTERIOR à última data (mais recente) existente no banco, ou seja, não pode ser inserida data ANTERIOR ao último registro existente. Também não podem ser inseridas datas futuras ao horário atual, com flexibilidade de até 3hs. Exemplo: se agora é 2018-07-15T14:00:00.000Z, a máxima data que pode ser inserida será 2018-07-15T17:59:59.999Z. Essa regra visa evitar a inserção de datas erradas.
Modelo:
HistoricoVariavelViewModel {
IdIntegracao (integer, optional),
TagGlobal (string, optional),
VarHistoricoList (ArrayVarHistorico, optional)
}VarHistorico {
Valor (string, optional),
Data (string, optional)
}
Exemplo:
{
"IdIntegracao": 3001,
"TagGlobal": "PressaoMedicao",
"VarHistoricoList": "Data": "2018-07-15T21:09:36.390Z"
}
" rel="">
{
"Valor": "2.34",
"Data": "2018-07-15T21:09:36.390Z"
}
}