Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

Obě strany předchozí revize Předchozí verze
Následující verze
Předchozí verze
cs:mervis-scada:50-api [2024/04/16 11:25]
v.musilek [api/set/executeActions]
cs:mervis-scada:50-api [2025/07/24 09:10] (aktuální)
p.dostalek [Přehled základních API metod]
Řádek 7: Řádek 7:
 ^Function^Description| ^Function^Description|
  
-^api/checkCredentials||+^api/v2/get/authenticate|| 
 +^api/checkCredentials [deprecated]||
 ^api/logout|| ^api/logout||
 ^api/get/projects|| ^api/get/projects||
 ^api/get/projectData|| ^api/get/projectData||
 ^api/get/projectByParts|| ^api/get/projectByParts||
-^api/get/history||+^api/get/history [deprecated]||
 ^api/get/history/specific|| ^api/get/history/specific||
 ^api/set/history|| ^api/set/history||
Řádek 33: Řádek 34:
 ===== Příklad ===== ===== Příklad =====
  
-==== api/checkCredentials ====+==== api/v2/get/authenticate ==== 
 + 
 +**Request** 
 + 
 +   * URL: https://scada.mervis.info/api/v2/get/authenticate?format=xml 
 +   * Method: POST 
 + 
 + 
 +<code javascript> 
 +{"data":{"cred":{"n":"demo","p":"demo","pe":0}}} 
 +</code> 
 + 
 +**Response XML** 
 + 
 +<code xml> 
 +<?xml version="1.0" encoding="utf-8"?> 
 +<globalResponse xmlns:r="http://dev.rcware.eu/serialization/references" xmlns:n1="http://dev.rcware.eu/scada/projects/domainWrapperClientDs2" xmlns="http://dev.rcware.eu/core/globalRequestResponse"> 
 +    <data n1:token="3:d487f7c1-d372-41a4-bee8-c16eb76fe948" n1:tokenValidFor="P1D" n1:login="demo" n1:username="" n1:user="48141739-5d16-4ca3-8ae1-33e27d9eb22e" n1:domain="3c73477a-6c95-4939-b047-7bbf902bcef1" n1:clientType="DS3" r:type="34945d89-d9ab-42be-a0ec-7676745641fb" /> 
 +    <result code="0" codeTxt="" desc="" dataType="" /> 
 +</globalResponse> 
 +</code> 
 + 
 +**Response JSON** 
 + 
 +<code javascript> 
 +
 +    "data":
 +        "ChangePwdBefore": null, 
 +        "ClientType": 2, 
 +        "Domain": "3c73477a-6c95-4939-b047-7bbf902bcef1", 
 +        "DomainName": "GlobalDomain", 
 +        "FullName": "GlobalDomain\\demo", 
 +        "Login": "demo", 
 +        "NotifyNearingPwdExpirationIn": null, 
 +        "Token": "3:ae378e2d-c7ec-4046-aad1-12310f8f72cc", 
 +        "TokenValidFor": "P1D", 
 +        "User": "48141739-5d16-4ca3-8ae1-33e27d9eb22e", 
 +        "Username": "" 
 +    }, 
 +    "result":
 +        "code": 0, 
 +        "codeTxt": null, 
 +        "dataType": null, 
 +        "desc": null 
 +    } 
 +
 +</code> 
 +  * Získaný token **t** je třeba použít místo dvojice jméno/heslo v následujících API voláních. 
 + 
 + 
 + 
 +==== [Deprecated] api/checkCredentials ====
  
 **Request** **Request**
Řádek 54: Řádek 106:
   * Získaný token **t** je třeba použít místo dvojice jméno/heslo v následujících API voláních.   * Získaný token **t** je třeba použít místo dvojice jméno/heslo v následujících API voláních.
  
 +==== api/get/projects ====
  
 +**Request**
  
 +   * URL: https://scada.mervis.info/api/get/projects?format=xml
 +   * Method: POST
  
 +Formát reponse je xml a nebo json podle volané url.
 +
 +<code javascript>
 +{"cred": {"t": "2:85be00d3-5875-4dec-a9b4-c98e2ff2acbe" }}
 +</code>
 +
 +**Response XML**
 +
 +<code xml>
 +<?xml version="1.0" encoding="utf-8"?>
 +<getProjectsResult xmlns:r="http://dev.rcware.eu/serialization/references" xmlns:n1="http://dev.rcware.eu/scada/schemas" xmlns:n2="http://dev.rcware.eu/scada/notifications" xmlns:n3="http://dev.rcware.eu/projectMetadata" xmlns:n4="http://dev.rcware.eu/loc" xmlns:n5="http://dev.rcware.eu/groups" dataVersion="K3JgNExrzoSBu8JwZ2NDYg==" xmlns="http://dev.rcware.eu/scada/projects">
 +    <projects>
 +        <project id="2a7f1615-42f2-44ef-a643-f1438ed44e2a" name="Weather" domain="GlobalDomain" tz="Europe/Prague" r:def="2">
 +            <mdi>
 +                <mi n1:totalAllowedSchemasCount="0" n1:totalSchemasCount="0" r:type="aa8818ce-d47d-41ff-9be5-3de9f34d7ebf" />
 +                <mi n2:moduleInstantiated="true" r:type="073d1b6c-24f5-435a-a5bd-1d54e04b0d06" />
 +            </mdi>
 +        </project>
 +        <project id="1b2623be-eaa4-4e29-8596-c66dd85d5643" name="SIMPLE_DEMO" domain="GlobalDomain" tz="Europe/Prague" r:def="3">
 +            <metadata>
 +                <metadata n3:k="oplog.config" n3:v=".." />
 +                <metadata n3:k="oplog.enabled" n3:v="true" />
 +                <metadata n3:k="oplog.engine" n3:v="podio" /></metadata>
 +            <mdi>
 +                <mi n2:moduleInstantiated="true" r:type="073d1b6c-24f5-435a-a5bd-1d54e04b0d06" r:def="1" />
 +                <mi n1:totalAllowedSchemasCount="0" n1:totalSchemasCount="0" r:type="aa8818ce-d47d-41ff-9be5-3de9f34d7ebf" />
 +            </mdi>
 +        </project>
 +        <project id="5abf8ca0-94ba-48df-8d3c-7ebe87a12fd0" name="PLYNOVA_KOTELNA" domain="GlobalDomain" tz="Europe/Prague" r:def="4">
 +            <loc>
 +                <n4:gps lat="50.091056" lon="14.401667" />
 +            </loc>
 +            <metadata>
 +                <metadata n3:k="oplog.enabled" n3:v="true" />
 +                <metadata n3:k="oplog.engine" n3:v="podio" />
 +                <metadata n3:k="oplog.podio.url" n3:v="https://podio.com/energocentrumcz/mervis-oplog/apps/operational-log" /></metadata>
 +            <mdi>
 +                <mi r:ref="1" r:type="073d1b6c-24f5-435a-a5bd-1d54e04b0d06" />
 +                <mi n1:totalAllowedSchemasCount="1" n1:totalSchemasCount="1" r:type="aa8818ce-d47d-41ff-9be5-3de9f34d7ebf" />
 +            </mdi>
 +        </project>
 +        <project id="b9ad5380-7d1d-4043-b675-bd406df6003b" name="CVUT_HERBERTOV" domain="GlobalDomain" tz="Europe/Prague" r:def="5">
 +            <loc>
 +                <n4:gps lat="48.621247" lon="14.350967" />
 +            </loc>
 +            <mdi>
 +                <mi n2:moduleInstantiated="true" r:type="073d1b6c-24f5-435a-a5bd-1d54e04b0d06" />
 +                <mi n1:totalAllowedSchemasCount="1" n1:totalSchemasCount="1" r:type="aa8818ce-d47d-41ff-9be5-3de9f34d7ebf" />
 +            </mdi>
 +        </project>
 +        <project id="843855a2-21b4-4e84-b74d-ff3901b54e37" name="PRVNI_KROKY" domain="GlobalDomain" tz="Europe/Prague" r:def="6">
 +            <mdi>
 +                <mi n2:moduleInstantiated="true" r:type="073d1b6c-24f5-435a-a5bd-1d54e04b0d06" />
 +                <mi n1:totalAllowedSchemasCount="6" n1:totalSchemasCount="6" r:type="aa8818ce-d47d-41ff-9be5-3de9f34d7ebf" />
 +            </mdi>
 +        </project>
 +    </projects>
 +    <projectGroups>
 +        <group n5:name="// fixme - flat merge instead of real one!!!">
 +            <n5:elements>
 +                <n5:projectItem>
 +                    <project r:ref="2" />
 +                </n5:projectItem>
 +                <n5:projectItem>
 +                    <project r:ref="3" />
 +                </n5:projectItem>
 +                <n5:projectItem>
 +                    <project r:ref="4" />
 +                </n5:projectItem>
 +                <n5:projectItem>
 +                    <project r:ref="5" />
 +                </n5:projectItem>
 +                <n5:projectItem>
 +                    <project r:ref="6" />
 +                </n5:projectItem>
 +            </n5:elements>
 +        </group>
 +    </projectGroups>
 +</getProjectsResult>
 +</code>
 +
 +**Response JSON**
 +
 +<code javascript>
 +{
 +    "ns": {
 +        "r": "http://dev.rcware.eu/serialization/references",
 +        "n1": "http://dev.rcware.eu/scada/projects",
 +        "n2": "http://dev.rcware.eu/scada/schemas",
 +        "n3": "http://dev.rcware.eu/scada/notifications",
 +        "n4": "http://dev.rcware.eu/projectMetadata",
 +        "n5": "http://dev.rcware.eu/loc",
 +        "n6": "http://dev.rcware.eu/groups"
 +    },
 +    "doc": {
 +        "n1:getProjectsResult": {
 +            "n1:projects": [
 +                {
 +                    "n1:project": {
 +                        "@": {
 +                            "n1:id": "2a7f1615-42f2-44ef-a643-f1438ed44e2a",
 +                            "n1:name": "Weather",
 +                            "n1:domain": "GlobalDomain",
 +                            "n1:tz": "Europe/Prague",
 +                            "r:def": "2"
 +                        },
 +                        "n1:mdi": [
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "n2:totalAllowedSchemasCount": 0,
 +                                        "n2:totalSchemasCount": 0,
 +                                        "r:type": "aa8818ce-d47d-41ff-9be5-3de9f34d7ebf"
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "n3:moduleInstantiated": true,
 +                                        "r:type": "073d1b6c-24f5-435a-a5bd-1d54e04b0d06"
 +                                    }
 +                                }
 +                            }
 +                        ]
 +                    }
 +                },
 +                {
 +                    "n1:project": {
 +                        "@": {
 +                            "n1:id": "1b2623be-eaa4-4e29-8596-c66dd85d5643",
 +                            "n1:name": "SIMPLE_DEMO",
 +                            "n1:domain": "GlobalDomain",
 +                            "n1:tz": "Europe/Prague",
 +                            "r:def": "3"
 +                        },
 +                        "n1:metadata": [
 +                            {
 +                                "n1:metadata": {
 +                                    "@": {
 +                                        "n4:k": "oplog.config",
 +                                        "n4:v": "..."
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n1:metadata": {
 +                                    "@": {
 +                                        "n4:k": "oplog.enabled",
 +                                        "n4:v": "true"
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n1:metadata": {
 +                                    "@": {
 +                                        "n4:k": "oplog.engine",
 +                                        "n4:v": "podio"
 +                                    }
 +                                }
 +                            }
 +                        ],
 +                        "n1:mdi": [
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "n3:moduleInstantiated": true,
 +                                        "r:type": "073d1b6c-24f5-435a-a5bd-1d54e04b0d06",
 +                                        "r:def": "1"
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "n2:totalAllowedSchemasCount": 0,
 +                                        "n2:totalSchemasCount": 0,
 +                                        "r:type": "aa8818ce-d47d-41ff-9be5-3de9f34d7ebf"
 +                                    }
 +                                }
 +                            }
 +                        ]
 +                    }
 +                },
 +                {
 +                    "n1:project": {
 +                        "@": {
 +                            "n1:id": "5abf8ca0-94ba-48df-8d3c-7ebe87a12fd0",
 +                            "n1:name": "PLYNOVA_KOTELNA",
 +                            "n1:domain": "GlobalDomain",
 +                            "n1:tz": "Europe/Prague",
 +                            "r:def": "4"
 +                        },
 +                        "n1:loc": {
 +                            "n5:gps": {
 +                                "@": {
 +                                    "n5:lat": 50.091056,
 +                                    "n5:lon": 14.401667
 +                                }
 +                            }
 +                        },
 +                        "n1:metadata": [
 +                            {
 +                                "n1:metadata": {
 +                                    "@": {
 +                                        "n4:k": "oplog.enabled",
 +                                        "n4:v": "true"
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n1:metadata": {
 +                                    "@": {
 +                                        "n4:k": "oplog.engine",
 +                                        "n4:v": "podio"
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n1:metadata": {
 +                                    "@": {
 +                                        "n4:k": "oplog.podio.url",
 +                                        "n4:v": "https://podio.com/energocentrumcz/mervis-oplog/apps/operational-log"
 +                                    }
 +                                }
 +                            }
 +                        ],
 +                        "n1:mdi": [
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "r:ref": "1",
 +                                        "r:type": "073d1b6c-24f5-435a-a5bd-1d54e04b0d06"
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "n2:totalAllowedSchemasCount": 1,
 +                                        "n2:totalSchemasCount": 1,
 +                                        "r:type": "aa8818ce-d47d-41ff-9be5-3de9f34d7ebf"
 +                                    }
 +                                }
 +                            }
 +                        ]
 +                    }
 +                },
 +                {
 +                    "n1:project": {
 +                        "@": {
 +                            "n1:id": "b9ad5380-7d1d-4043-b675-bd406df6003b",
 +                            "n1:name": "CVUT_HERBERTOV",
 +                            "n1:domain": "GlobalDomain",
 +                            "n1:tz": "Europe/Prague",
 +                            "r:def": "5"
 +                        },
 +                        "n1:loc": {
 +                            "n5:gps": {
 +                                "@": {
 +                                    "n5:lat": 48.621247,
 +                                    "n5:lon": 14.350967
 +                                }
 +                            }
 +                        },
 +                        "n1:mdi": [
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "n3:moduleInstantiated": true,
 +                                        "r:type": "073d1b6c-24f5-435a-a5bd-1d54e04b0d06"
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "n2:totalAllowedSchemasCount": 1,
 +                                        "n2:totalSchemasCount": 1,
 +                                        "r:type": "aa8818ce-d47d-41ff-9be5-3de9f34d7ebf"
 +                                    }
 +                                }
 +                            }
 +                        ]
 +                    }
 +                },
 +                {
 +                    "n1:project": {
 +                        "@": {
 +                            "n1:id": "843855a2-21b4-4e84-b74d-ff3901b54e37",
 +                            "n1:name": "PRVNI_KROKY",
 +                            "n1:domain": "GlobalDomain",
 +                            "n1:tz": "Europe/Prague",
 +                            "r:def": "6"
 +                        },
 +                        "n1:mdi": [
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "n3:moduleInstantiated": true,
 +                                        "r:type": "073d1b6c-24f5-435a-a5bd-1d54e04b0d06"
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n1:mi": {
 +                                    "@": {
 +                                        "n2:totalAllowedSchemasCount": 6,
 +                                        "n2:totalSchemasCount": 6,
 +                                        "r:type": "aa8818ce-d47d-41ff-9be5-3de9f34d7ebf"
 +                                    }
 +                                }
 +                            }
 +                        ]
 +                    }
 +                }
 +            ],
 +            "n1:projectGroups": [
 +                {
 +                    "n1:group": {
 +                        "@": {
 +                            "n6:name": "// fixme - flat merge instead of real one!!!"
 +                        },
 +                        "n6:elements": [
 +                            {
 +                                "n6:projectItem": {
 +                                    "n1:project": {
 +                                        "@": {
 +                                            "r:ref": "2"
 +                                        }
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n6:projectItem": {
 +                                    "n1:project": {
 +                                        "@": {
 +                                            "r:ref": "3"
 +                                        }
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n6:projectItem": {
 +                                    "n1:project": {
 +                                        "@": {
 +                                            "r:ref": "4"
 +                                        }
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n6:projectItem": {
 +                                    "n1:project": {
 +                                        "@": {
 +                                            "r:ref": "5"
 +                                        }
 +                                    }
 +                                }
 +                            },
 +                            {
 +                                "n6:projectItem": {
 +                                    "n1:project": {
 +                                        "@": {
 +                                            "r:ref": "6"
 +                                        }
 +                                    }
 +                                }
 +                            }
 +                        ]
 +                    }
 +                }
 +            ],
 +            "@": {
 +                "n1:dataVersion": "K3JgNExrzoSBu8JwZ2NDYg=="
 +            }
 +        }
 +    }
 +}
 +</code>
 +
 +
 +==== api/get/projectByParts ====
 +
 +**Request**
 +
 +   * URL: https://scada.mervis.info/api/get/projectByParts?format=xml
 +   * Method: POST
 +
 +
 +<code javascript>
 +{
 +    "cred": {
 +        "t": "2:85be00d3-5875-4dec-a9b4-c98e2ff2acbe"
 +    },
 +    "projId": "1b2623be-eaa4-4e29-8596-c66dd85d5643",
 +    "treeId": "Visual tree",
 +    "partType": 0,
 +    "offset": 0,
 +    "count": 2000
 +}
 +</code>
 +
 +**Response XML**
 +
 +<code xml>
 +<?xml version="1.0" encoding="utf-8"?>
 +<getProjectByPartsResult xmlns:r="http://dev.rcware.eu/serialization/references" projId="1b2623be-eaa4-4e29-8596-c66dd85d5643" dataVersion="638854006248661233" totalCount="15" nextOffset="-1" xmlns:n1="http://dev.rcware.eu/scada/basic-props" xmlns:n2="http://dev.rcware.eu/scada/legacy-props" xmlns:n3="http://dev.rcware.eu/rt2com" xmlns="http://dev.rcware.eu/scada/datapoints">
 +    <dps>
 +        <dp id="07d538d9-9f4b-46ca-ba4d-13b13b5302ff" n="analog setpoint" canAct="true" canAlr="true">
 +            <v>
 +                <props>
 +                    <p n="Source" u="°C" t="2025-07-16T23:26:36.0742528Z" q="Good" r:type="b133774d-21ce-42b6-add3-57c012079c55" r:def="1">
 +                        <n1:v>6</n1:v>
 +                    </p>
 +                    <p n="Output" u="°C" t="2025-07-16T23:26:36.0742528Z" q="Good" r:type="b133774d-21ce-42b6-add3-57c012079c55">
 +                        <n1:v>6</n1:v>
 +                    </p>
 +                    <p n="Dec" u="°C" t="2024-09-11T13:40:30.8120217Z" q="Good" r:type="b133774d-21ce-42b6-add3-57c012079c55">
 +                        <n1:v>-1</n1:v>
 +                    </p>
 +                    <p n="Inc" u="°C" t="2024-09-11T13:40:30.8122506Z" q="Good" r:type="b133774d-21ce-42b6-add3-57c012079c55">
 +                        <n1:v>1</n1:v>
 +                    </p>
 +                    <p n="Min" u="°C" t="2024-09-11T13:40:30.8112955Z" q="Good" r:type="b133774d-21ce-42b6-add3-57c012079c55">
 +                        <n1:v>-10</n1:v>
 +                    </p>
 +                    <p n="Max" u="°C" t="2024-09-11T13:40:30.8112988Z" q="Good" r:type="b133774d-21ce-42b6-add3-57c012079c55">
 +                        <n1:v>20</n1:v>
 +                    </p>
 +                    <p n="StdVis_V1" t="2024-09-11T13:40:30.8112085Z" q="Good" r:type="b0db7bd7-0375-4830-90f2-6d918bac41ee">
 +                        <n1:v>
 +                            <n1:props>
 +                                <n1:p>
 +                                    <n1:pn>Output</n1:pn>
 +                                    <n1:props>
 +                                        <n1:p r:type="033dd98a-337f-4908-9866-55961696f646">
 +                                            <n1:dec>3</n1:dec>
 +                                            <n1:fs></n1:fs>
 +                                        </n1:p>
 +                                    </n1:props>
 +                                </n1:p>
 +                            </n1:props>
 +                        </n1:v>
 +                    </p>
 +                    <p n="CheckMin" t="2024-09-11T13:40:30.8114074Z" q="Good" r:type="e4c0288b-9d7b-48d8-93be-fa4a0a787a36">
 +                        <n1:v>true</n1:v>
 +                    </p>
 +                    <p n="CheckMax" t="2024-09-11T13:40:30.811645Z" q="Good" r:type="e4c0288b-9d7b-48d8-93be-fa4a0a787a36">
 +                        <n1:v>true</n1:v>
 +                    </p>
 +                    <p n="LegacyRcAddress_V1" t="2024-09-11T13:40:30.8132286Z" q="Good" r:type="f426f6d7-8dd5-40a3-ac73-dd98e927fd74">
 +                        <n2:v e="1" g="1" n="2" o="15">
 +                            <n2:m>
 +                                <n2:inpm i="0" p="Source" />
 +                                <n2:inpm i="15" p="Output" />
 +                                <n2:inpm i="7" p="Min" />
 +                                <n2:inpm i="8" p="Max" />
 +                                <n2:inpm i="5" p="Dec" />
 +                                <n2:inpm i="9" a="true" p="-" />
 +                                <n2:inpm i="6" p="Inc" />
 +                                <n2:inpm i="10" a="true" p="+" />
 +                                <n2:inpm i="11" a="true" p="INIT" />
 +                            </n2:m>
 +                        </n2:v>
 +                    </p>
 +                    <p n="Tags_V1" t="2019-06-14T12:00:04.9014633Z" q="Good" r:type="e1b9ddbd-bf76-4c04-9f61-0626d2d774bb">
 +                        <n1:v>
 +                            <tags>
 +                                <t vt="String" k="pointy_type" v="one" />
 +                            </tags>
 +                        </n1:v>
 +                    </p>
 +                    <p n="LAlr" u="°C" t="0001-01-01T00:00:00" q="Unknown" r:type="b133774d-21ce-42b6-add3-57c012079c55">
 +                        <n1:v>0</n1:v>
 +                    </p>
 +                    <p n="HAlr" u="°C" t="0001-01-01T00:00:00" q="Unknown" r:type="b133774d-21ce-42b6-add3-57c012079c55">
 +                        <n1:v>0</n1:v>
 +                    </p>
 +                    <p n="LAlrAct" t="0001-01-01T00:00:00" q="Unknown" r:type="e4c0288b-9d7b-48d8-93be-fa4a0a787a36">
 +                        <n1:v>false</n1:v>
 +                    </p>
 +                    <p n="HAlrAct" t="0001-01-01T00:00:00" q="Unknown" r:type="e4c0288b-9d7b-48d8-93be-fa4a0a787a36">
 +                        <n1:v>false</n1:v>
 +                    </p>
 +                </props>
 +            </v>
 +            <a>
 +                <props>
 +                    <p n="-" r:type="2e0a871a-af8e-4234-8d27-e3145aeb6bd3">
 +                        <n1:diff>Dec</n1:diff>
 +                        <n1:target>Output</n1:target>
 +                    </p>
 +                    <p n="+" r:type="2e0a871a-af8e-4234-8d27-e3145aeb6bd3">
 +                        <n1:diff>Inc</n1:diff>
 +                        <n1:target>Output</n1:target>
 +                    </p>
 +                    <p n="INIT" r:type="90d4f1b9-c18c-4ce9-9799-d1475d949139">
 +                        <n1:interactive>true</n1:interactive>
 +                        <n1:interactiveTimestamp>false</n1:interactiveTimestamp>
 +                        <n1:target>Output</n1:target>
 +                        <n1:nonInteractiveValue>0</n1:nonInteractiveValue>
 +                    </p>
 +                </props>
 +            </a>
 +            <core r:type="ffdebc6e-11fc-4bcb-949d-04c05dabc6d5" />
 +        </dp>
 + ...
 +    </dps>
 +</getProjectByPartsResult>
 +</code>
 +
 +**Response JSON**
 +
 +<code javascript>
 +{
 +    "ns": {
 +        "r": "http://dev.rcware.eu/serialization/references",
 +        "n1": "http://dev.rcware.eu/scada/datapoints",
 +        "n2": "http://dev.rcware.eu/scada/basic-props",
 +        "n3": "http://dev.rcware.eu/scada/legacy-props",
 +        "n4": "http://dev.rcware.eu/rt2com"
 +    },
 +    "doc": {
 +        "n1:getProjectByPartsResult": {
 +            "@": {
 +                "n1:projId": "1b2623be-eaa4-4e29-8596-c66dd85d5643",
 +                "n1:dataVersion": "638854006248661233",
 +                "n1:totalCount": 15,
 +                "n1:nextOffset": -1
 +            },
 +            "n1:dps": [
 +                {
 +                    "n1:dp": {
 +                        "@": {
 +                            "n1:id": "07d538d9-9f4b-46ca-ba4d-13b13b5302ff",
 +                            "n1:n": "analog setpoint",
 +                            "n1:canAct": true,
 +                            "n1:canAlr": true
 +                        },
 +                        "n1:v": {
 +                            "n1:props": [
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "Source",
 +                                            "n1:u": "°C",
 +                                            "n1:t": "2025-07-16T23:26:36.0742528Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "b133774d-21ce-42b6-add3-57c012079c55",
 +                                            "r:def": "1"
 +                                        },
 +                                        "n2:v": 6.0
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "Output",
 +                                            "n1:u": "°C",
 +                                            "n1:t": "2025-07-16T23:26:36.0742528Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "b133774d-21ce-42b6-add3-57c012079c55"
 +                                        },
 +                                        "n2:v": 6.0
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "Dec",
 +                                            "n1:u": "°C",
 +                                            "n1:t": "2024-09-11T13:40:30.8120217Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "b133774d-21ce-42b6-add3-57c012079c55"
 +                                        },
 +                                        "n2:v": -1.0
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "Inc",
 +                                            "n1:u": "°C",
 +                                            "n1:t": "2024-09-11T13:40:30.8122506Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "b133774d-21ce-42b6-add3-57c012079c55"
 +                                        },
 +                                        "n2:v": 1.0
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "Min",
 +                                            "n1:u": "°C",
 +                                            "n1:t": "2024-09-11T13:40:30.8112955Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "b133774d-21ce-42b6-add3-57c012079c55"
 +                                        },
 +                                        "n2:v": -10.0
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "Max",
 +                                            "n1:u": "°C",
 +                                            "n1:t": "2024-09-11T13:40:30.8112988Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "b133774d-21ce-42b6-add3-57c012079c55"
 +                                        },
 +                                        "n2:v": 20.0
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "StdVis_V1",
 +                                            "n1:t": "2024-09-11T13:40:30.8112085Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "b0db7bd7-0375-4830-90f2-6d918bac41ee"
 +                                        },
 +                                        "n2:v": {
 +                                            "n2:props": [
 +                                                {
 +                                                    "n2:p": {
 +                                                        "n2:pn": "Output",
 +                                                        "n2:props": [
 +                                                            {
 +                                                                "n2:p": {
 +                                                                    "n2:dec": 3,
 +                                                                    "n2:fs": "",
 +                                                                    "@": {
 +                                                                        "r:type": "033dd98a-337f-4908-9866-55961696f646"
 +                                                                    }
 +                                                                }
 +                                                            }
 +                                                        ]
 +                                                    }
 +                                                }
 +                                            ]
 +                                        }
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "CheckMin",
 +                                            "n1:t": "2024-09-11T13:40:30.8114074Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "e4c0288b-9d7b-48d8-93be-fa4a0a787a36"
 +                                        },
 +                                        "n2:v": true
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "CheckMax",
 +                                            "n1:t": "2024-09-11T13:40:30.811645Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "e4c0288b-9d7b-48d8-93be-fa4a0a787a36"
 +                                        },
 +                                        "n2:v": true
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "LegacyRcAddress_V1",
 +                                            "n1:t": "2024-09-11T13:40:30.8132286Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "f426f6d7-8dd5-40a3-ac73-dd98e927fd74"
 +                                        },
 +                                        "n3:v": {
 +                                            "@": {
 +                                                "n3:e": 1,
 +                                                "n3:g": 1,
 +                                                "n3:n": 2,
 +                                                "n3:o": 15
 +                                            },
 +                                            "n3:m": [
 +                                                {
 +                                                    "n3:inpm": {
 +                                                        "@": {
 +                                                            "n3:i": 0,
 +                                                            "n3:p": "Source"
 +                                                        }
 +                                                    }
 +                                                },
 +                                                {
 +                                                    "n3:inpm": {
 +                                                        "@": {
 +                                                            "n3:i": 15,
 +                                                            "n3:p": "Output"
 +                                                        }
 +                                                    }
 +                                                },
 +                                                {
 +                                                    "n3:inpm": {
 +                                                        "@": {
 +                                                            "n3:i": 7,
 +                                                            "n3:p": "Min"
 +                                                        }
 +                                                    }
 +                                                },
 +                                                {
 +                                                    "n3:inpm": {
 +                                                        "@": {
 +                                                            "n3:i": 8,
 +                                                            "n3:p": "Max"
 +                                                        }
 +                                                    }
 +                                                },
 +                                                {
 +                                                    "n3:inpm": {
 +                                                        "@": {
 +                                                            "n3:i": 5,
 +                                                            "n3:p": "Dec"
 +                                                        }
 +                                                    }
 +                                                },
 +                                                {
 +                                                    "n3:inpm": {
 +                                                        "@": {
 +                                                            "n3:i": 9,
 +                                                            "n3:a": true,
 +                                                            "n3:p": "-"
 +                                                        }
 +                                                    }
 +                                                },
 +                                                {
 +                                                    "n3:inpm": {
 +                                                        "@": {
 +                                                            "n3:i": 6,
 +                                                            "n3:p": "Inc"
 +                                                        }
 +                                                    }
 +                                                },
 +                                                {
 +                                                    "n3:inpm": {
 +                                                        "@": {
 +                                                            "n3:i": 10,
 +                                                            "n3:a": true,
 +                                                            "n3:p": "+"
 +                                                        }
 +                                                    }
 +                                                },
 +                                                {
 +                                                    "n3:inpm": {
 +                                                        "@": {
 +                                                            "n3:i": 11,
 +                                                            "n3:a": true,
 +                                                            "n3:p": "INIT"
 +                                                        }
 +                                                    }
 +                                                }
 +                                            ]
 +                                        }
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "Tags_V1",
 +                                            "n1:t": "2019-06-14T12:00:04.9014633Z",
 +                                            "n1:q": "Good",
 +                                            "r:type": "e1b9ddbd-bf76-4c04-9f61-0626d2d774bb"
 +                                        },
 +                                        "n2:v": {
 +                                            "n1:tags": [
 +                                                {
 +                                                    "n1:t": {
 +                                                        "@": {
 +                                                            "n1:vt": "String",
 +                                                            "n1:k": "pointy_type",
 +                                                            "n1:v": "one"
 +                                                        }
 +                                                    }
 +                                                }
 +                                            ]
 +                                        }
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "LAlr",
 +                                            "n1:u": "°C",
 +                                            "n1:t": "0001-01-01T00:00:00",
 +                                            "n1:q": "Unknown",
 +                                            "r:type": "b133774d-21ce-42b6-add3-57c012079c55"
 +                                        },
 +                                        "n2:v": 0.0
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "HAlr",
 +                                            "n1:u": "°C",
 +                                            "n1:t": "0001-01-01T00:00:00",
 +                                            "n1:q": "Unknown",
 +                                            "r:type": "b133774d-21ce-42b6-add3-57c012079c55"
 +                                        },
 +                                        "n2:v": 0.0
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "LAlrAct",
 +                                            "n1:t": "0001-01-01T00:00:00",
 +                                            "n1:q": "Unknown",
 +                                            "r:type": "e4c0288b-9d7b-48d8-93be-fa4a0a787a36"
 +                                        },
 +                                        "n2:v": false
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "HAlrAct",
 +                                            "n1:t": "0001-01-01T00:00:00",
 +                                            "n1:q": "Unknown",
 +                                            "r:type": "e4c0288b-9d7b-48d8-93be-fa4a0a787a36"
 +                                        },
 +                                        "n2:v": false
 +                                    }
 +                                }
 +                            ]
 +                        },
 +                        "n1:a": {
 +                            "n1:props": [
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "-",
 +                                            "r:type": "2e0a871a-af8e-4234-8d27-e3145aeb6bd3"
 +                                        },
 +                                        "n2:diff": "Dec",
 +                                        "n2:target": "Output"
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "+",
 +                                            "r:type": "2e0a871a-af8e-4234-8d27-e3145aeb6bd3"
 +                                        },
 +                                        "n2:diff": "Inc",
 +                                        "n2:target": "Output"
 +                                    }
 +                                },
 +                                {
 +                                    "n1:p": {
 +                                        "@": {
 +                                            "n1:n": "INIT",
 +                                            "r:type": "90d4f1b9-c18c-4ce9-9799-d1475d949139"
 +                                        },
 +                                        "n2:interactive": true,
 +                                        "n2:interactiveTimestamp": false,
 +                                        "n2:target": "Output",
 +                                        "n2:nonInteractiveValue": 0.0
 +                                    }
 +                                }
 +                            ]
 +                        },
 +                        "n1:core": {
 +                            "@": {
 +                                "r:type": "ffdebc6e-11fc-4bcb-949d-04c05dabc6d5"
 +                            }
 +                        }
 +                    }
 +                }
 +         ...
 +            ]
 +        }
 +    }
 +}
 +</code>
  
 ==== api/v3/get/history ==== ==== api/v3/get/history ====
Řádek 445: Řádek 1383:
  
 ====api/get/values==== ====api/get/values====
 +
 +   * URL: /api/get/values?format=xml
 +   * Method: POST
 +
 +===Output property===
  
 Nejvhodnější způsob vyčtení aktuálních hodnot datových bodů (property "Output") z jednoho nebo více projektů. Nejvhodnější způsob vyčtení aktuálních hodnot datových bodů (property "Output") z jednoho nebo více projektů.
  
 **Request** **Request**
- 
-   * URL: /api/get/values?format=xml 
-   * Method: POST 
  
 <code javascript> <code javascript>
Řádek 496: Řádek 1436:
  </vals>  </vals>
 </values></code> </values></code>
 +
 +===PlanningCalendar property===
 +
 +**Request**
 +
 +<code javascript>
 +{
 + "cred": {
 +  "t": "xxxxxx" //token
 + },
 + "propNamesToSerialize": ["PlanningCalendar"],
 + "offset": 0,
 + "count": 1000,
 + "serverState": null,
 + "dps": [{
 +   "projId": "17d3ff08-40c1-41c0-ad6a-bad4489323c7",
 +   "dpIds": ["d1243034-0809-444d-a48a-d04d800b4095"]
 +  }
 + ]
 +}
 +
 +</code>
 +
 +**Response**
 +
 +<code xml>
 +<?xml version="1.0" encoding="utf-8"?>
 +<values xmlns:r="http://dev.rcware.eu/serialization/references" nextOffset="-1" serverTime="2024-04-16T09:27:44.9304393Z" xmlns:n1="http://dev.rcware.eu/scada/basic-props" xmlns="http://dev.rcware.eu/scada/datapoints">
 +  <vals>
 +    <v projId="17d3ff08-40c1-41c0-ad6a-bad4489323c7" dataVersion="638482651650000000" serverTime="2024-04-16T09:27:44.9304393Z">
 +      <dps>
 +        <d id="d1243034-0809-444d-a48a-d04d800b4095" serAlr="true">
 +          <props>
 +            <p n="PlanningCalendar" t="2024-04-15T11:50:38.2117669Z" q="Good" r:type="11c39f56-7d5e-489b-9615-51d2daaf25f8">
 +              <n1:v defaultValue="0" emailForNotifications="" type="1">
 +                <n1:layers>
 +                  <n1:l name="Decimal" type="" defaultValue="0">
 +                    <n1:events>
 +                      <n1:e rev="3">
 +                        <n1:def start="2024-04-11T04:00:00Z" end="2024-04-11T11:00:00Z" id="2" state="Enabled" dval="12.5" p="1" comment="test" pLayer="" lastEditedBy="admin" lastEdited="2024-04-11T13:35:01.2373164Z" />
 +                      </n1:e>
 +                      <n1:e rev="4">
 +                        <n1:def start="2024-04-11T22:00:00Z" end="2024-04-12T01:00:00Z" id="3" state="Enabled" dval="5.6" p="1" comment="test2" pLayer="" lastEditedBy="admin" lastEdited="2024-04-12T06:18:17.0853588Z" />
 +                      </n1:e>
 +                    </n1:events>
 +                    <n1:items />
 +                  </n1:l>
 +                  <n1:l name="Positive" type="" defaultValue="0">
 +                    <n1:events>
 +                      <n1:e rev="3">
 +                        <n1:def start="2024-04-11T10:00:00Z" end="2024-04-11T13:00:00Z" id="2" state="Enabled" ival="25" p="1" comment="test3" pLayer="" lastEditedBy="admin" lastEdited="2024-04-11T13:22:07.0652508Z" />
 +                      </n1:e>
 +                      <n1:e rev="5">
 +                        <n1:def start="2024-04-11T22:00:00Z" end="2024-04-12T01:00:00Z" id="5" state="Enabled" ival="30" p="1" comment="test4" pLayer="" lastEditedBy="admin" lastEdited="2024-04-12T06:18:17.0853759Z" />
 +                      </n1:e>
 +                    </n1:events>
 +                    <n1:items />
 +                  </n1:l>
 +                  <n1:l name="Negative" type="" defaultValue="0">
 +                    <n1:events>
 +                      <n1:e rev="6">
 +                        <n1:def start="2024-04-11T22:00:00Z" end="2024-04-12T01:00:00Z" id="7" state="Enabled" ival="-50" p="1" comment="test5" pLayer="" lastEditedBy="admin" lastEdited="2024-04-12T06:18:17.0854241Z" />
 +                      </n1:e>
 +                    </n1:events>
 +                    <n1:items />
 +                  </n1:l>
 +                </n1:layers>
 +              </n1:v>
 +            </p>
 +          </props>
 +        </d>
 +      </dps>
 +    </v>
 +  </vals>
 +</values>
 +</code>
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
  
  
  
  • © Energocentrum Plus, s.r.o. 2017 - 2025