Jump to: navigation, search

UBIK Web ServiceV264


Revision as of 12:38, 22 August 2019 by MHM (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The following section describes UBIK Webservice Methods with a simplyfied interface designed to be used from external systems (e.g. IOT use case)

  • Create Content
  • Delete Content
  • Get DisplayValues of Content
  • Get Property DisplayValue of Content
  • Update Property Value
[edit]

Create Content

WebCreateContent

WebCreateContent provides the possibility to create a single content object.

        /// <summary>
        /// WebCreateContent provides the possibility to create a single content object.
        /// WebCreateContent provides a simplified interface optimized for being used in simple use cases (IOT).
        /// </summary>
        /// <param name="app">The application.</param>
        /// <param name="context">The context.</param>
        /// <param name="metaClassUID">ID of the MetaClass (Type) of the new instance.</param>
        /// <param name="parentUID">ID of the hierarchical parent of the new instance.</param>
        /// <param name="authentication">Authentication (tokenid) for the user/device to access this service</param>
        /// <param name="version">Client Web Service Version number.</param>
        /// <returns>The ID of the new instance if creation was successfull, Guid.Empty otherwise. </returns>
        [OperationContract]
        [WebInvoke(UriTemplate = "WebCreateContent/{app}/{context}/{metaClassUID}/{parentUID}/{authentication}/{version}", Method = "GET",
                   RequestFormat = WebMessageFormat.Json,
                   ResponseFormat = WebMessageFormat.Json)]
        Guid WebCreateContent(string app, string context, string metaClassUID, string parentUID, string authentication, string version);


List ofParameters

Name Type Description
app String Name of the Application
context String Name of the Context
metaClassUID String/Guid ID of the MetaClass (Type) of the new instance.
parentUID String/Guid ID of the hierarchical parent of the new instance.
authentication String Valid auth token
version String Indicator of the expected data format version

Delete Content

WebDeleteContent

WebDeleteContent provides the possibility to delete a single content object.

        /// <summary>
        /// WebDeleteContent provides the possibility to delete a single content object.
        /// WebDeleteContent provides a simplified interface optimized for being used in simple use cases (IOT).
        /// </summary>
        /// <param name="app">The application.</param>
        /// <param name="context">The context.</param>
        /// <param name="uid">The id of the object to delete.</param>
        /// <param name="authentication">Authentication (tokenid) for the user/device to access this service</param>
        /// <param name="version">Client Web Service Version number.</param>
        /// <returns>True if deletion was successfull, False otherwise.</returns>
        [OperationContract]
        [WebInvoke(UriTemplate = "WebDeleteContent/{app}/{context}/{uid}/{authentication}/{version}", Method = "GET",
                   RequestFormat = WebMessageFormat.Json,
                   ResponseFormat = WebMessageFormat.Json)]
        bool WebDeleteContent(string app, string context, string uid, string authentication, string version);

List ofParameters

Name Type Description
app String Name of the Application
context String Name of the Context
uid String/Guid ID of the object to be deleted
authentication String Valid auth token
version String Indicator of the expected data format version

Web GetDisplayValues

WebGetDisplayValues

WebGetDisplayValues provides the possibility to fetch the display strings of one content object

        /// <summary>
        /// WebGetDisplayValues provides the possibility to fetch the display strings of one content object
        /// WebGetDisplayValues provides a simplified interface optimized for being used in simple use cases (IOT).
        /// <param name="app">The application.</param>
        /// <param name="context">The context.</param>
        /// <param name="uid">The id of the content object.</param>
        /// <param name="authentication">Authentication (tokenid) for the user/device to access this service</param>
        /// <param name="version">Client Web Service Version number.</param>
        /// <returns>The Displaystrings (as array) for the given content object if successfull, null otherwise.</returns>
        [OperationContract]
        [WebInvoke(UriTemplate = "WebGetDisplayValues/{app}/{context}/{uid}/{authentication}/{version}", Method = "GET",
                   RequestFormat = WebMessageFormat.Json,
                   ResponseFormat = WebMessageFormat.Json)]
        string[] WebGetDisplayValues(string app, string context, string uid, string authentication, string version);

List ofParameters

Name Type Description
app String Name of the Application
context String Name of the Context
uid String/Guid ID of the object
authentication String Valid auth token
version String Indicator of the expected data format version


Get Property Display Value

WebGetPropertyDisplayValue

WebGetPropertyDisplayValue provides the possibility to fetch the display strings of one property of one content object

        /// WebGetPropertyDisplayValue provides the possibility to fetch the display strings of one property of one content object
        /// WebGetPropertyDisplayValue provides a simplified interface optimized for being used in simple use cases (IOT).
        /// <param name="app">The application.</param>
        /// <param name="context">The context.</param>
        /// <param name="uid">The id of the content object.</param>
        /// <param name="metaProperty">The id or the name of the meta property.</param>
        /// <param name="index">The index of the proeprty.</param>
        /// <param name="authentication">Authentication (tokenid) for the user/device to access this service</param>
        /// <param name="version">Client Web Service Version number.</param>
        /// <returns>The display value of the given property if successfull, null otherwise</returns>
        [OperationContract]
        [WebInvoke(UriTemplate = "WebGetPropertyDisplayValue/{app}/{context}/{uid}/{metaProperty}/{index}/{authentication}/{version}", Method = "GET",
                   RequestFormat = WebMessageFormat.Json,
                   ResponseFormat = WebMessageFormat.Json)]
        string WebGetPropertyDisplayValue(string app, string context, string uid, string metaProperty, string index, string authentication, string version);

List ofParameters

Name Type Description
app String Name of the Application
context String Name of the Context
uid String/Guid ID of the object
metaProperty String/Guid Name of MetaID of the Property you want to fetch
index int Index of the property value
authentication String Valid auth token
version String Indicator of the expected data format version


Update Property Value

WebUpdatePropertyValue

WebUpdatePropertyValue provides the possibility to edit the value of one property of one content object

        /// WebUpdatePropertyValue provides the possibility to edit the value of one property of one content object
        /// WebUpdatePropertyValue provides a simplified interface optimized for being used in simple use cases (IOT).
        /// <param name="app">The application.</param>
        /// <param name="context">The context.</param>
        /// <param name="uid">The id of the content object.</param>
        /// <param name="metaProperty">The id or the name of the meta property to edit.</param>
        /// <param name="index">The index of the proeprty.</param>
        /// <param name="value">The value to set.</param>
        /// <param name="VTS">Validation time stamp.</param>
        /// <param name="authentication">Authentication (tokenid) for the user/device to access this service</param>
        /// <param name="version">Client Web Service Version number.</param>
        /// <returns>True if deletion was successfull, False otherwise.</returns>
        [OperationContract]
        [WebInvoke(UriTemplate = "WebUpdatePropertyValue/{app}/{context}/{uid}/{metaProperty}/{index}/{value}/{vts}/{authentication}/{version}", Method = "GET",
                   RequestFormat = WebMessageFormat.Json,
                   ResponseFormat = WebMessageFormat.Json)]
        bool WebUpdatePropertyValue(string app, string context, string uid, string metaProperty, string index, string value, string VTS, string authentication, string version);

List ofParameters

Name Type Description
app String Name of the Application
context String Name of the Context
uid String/Guid ID of the object
metaProperty String/Guid Name of MetaID of the Property you want to fetch
index int Index of the property value
authentication String Valid auth token
version String Indicator of the expected data format version