Difference between revisions of "UBIK Content Web Service"

/// <summary>
/// Uploads the given stream and saves it as a file
/// </summary>
/// <param name="stream">The stream.</param>
/// <returns></returns>
UBIK.Service.BCDataShipment UploadFile(Stream stream);

/// <summary>
/// Provides a stream to the document referenced by the contentId.
/// </summary>
/// <param name="appName">Name of the application</param>
/// <param name="contextName">Name of the context</param>
/// <param name="documentId">ID of the document content object</param>
/// <param name="authentication">authentication (tokenid) for the user/device to access this service</param>
/// <param name="version">Version of the data contract</param>
/// <returns>A stream to the document</returns>
Stream DownloadDocumentV212(string appName, string contextName, string documentId, string authentication, string version);

/// <summary>
/// Delivers a list of all defined MetaClass Objects for the given Application and the given DeviceID
/// </summary>
/// <param name="appName">Name of the Application</param>
/// <param name="contextName">Name of the Context</param>
/// <param name="authentication">authentication (tokenid) for the user/device to access this service</param>
/// <param name="version">Version of the data contract</param>
/// <returns>a list of MetaDefinitions</returns>
UBIK.Service.BCMetaDefinitions GetMetaDefinitionsV212(String appName, String contextName, string authentication, string version);

/// <summary>
/// Gets the hierarchy deltas
/// </summary>
/// <param name="appName">Name of the application.</param>
/// <param name="contextName">Name of the context.</param>
/// <param name="args">The arguments.</param>
/// <param name="authentication">The authentication.</param>
/// <param name="version">The version of the data contract.</param>
/// <returns></returns>
UBIK.Service.DTO.V211.BCHierarchyDeltaShipments GetHierarchyDeltasV212(string appName, string contextName, HierarchyDeltaArguments args, String authentication, string version);

/// <summary>
/// Updates the content list.
/// </summary>
/// <param name="appName">Name of the application.</param>
/// <param name="contextName">Name of the context.</param>
/// <param name="authentication">The authentication.</param>
/// <param name="dataShipments">The data shipments.</param>
/// <param name="version">The version of the data contract.</param>
/// <returns></returns>
UBIK.Service.BCDataShipments UpdateContentListV212(string appName, string contextName, string authentication, UbikContent[] dataShipments, string version);

/// <summary>
/// Creates the single content V212.
/// </summary>
/// <param name="appName">Name of the application.</param>
/// <param name="contextName">Name of the context.</param>
/// <param name="ownerID">The owner identifier.</param>
/// <param name="authentication">The authentication.</param>
/// <param name="dataShipment">The data shipment.</param>
/// <param name="version">The version of the data contract.</param>
/// <returns></returns>
UBIK.Service.BCDataShipment CreateSingleContentV212(string appName, string contextName, string ownerID, string authentication, UbikContent dataShipment, string version);

/// <summary>
/// Provides a Testaccess to GetHierarchyDeltas.
/// args must be either ("root", "infra" or a valid UID of the start object)
/// </summary>
/// <param name="appName">Name of the application.</param>
/// <param name="contextName">Name of the context.</param>
/// <param name="args">The arguments as string parameter.</param>
/// <param name="childDepth">child depth as string</param>
/// <param name="parentDepth">parent depth as string</param>
/// <param name="authentication">The authentication.</param>
/// <param name="version">The version of the data contract.</param>
/// <returns></returns>
UBIK.Service.DTO.V211.BCHierarchyDeltaShipments DebugHierarchyDeltas(string appName, string contextName, string args, string childDepth, string parentDepth, string authentication, string version);

/// <summary>
/// Gets the live values.
/// </summary>
/// <param name="appName">Name of the application.</param>
/// <param name="contextName">Name of the context.</param>
/// <param name="args">The arguments.</param>
/// <param name="authentication">The authentication.</param>
/// <param name="version">The version.</param>
/// <returns></returns>
UBIK.Service.DTO.V244.BCLiveValues GetLiveValues(string appName, string contextName, PropertyKey[] args, string authentication, string version);

/// <summary>
/// Delivers info about the current status of the Live Value Server.
/// </summary>
/// <param name="token">authentication token</param>
string GetLiveValueServerStatus(string token);         

/// <summary>
/// Starts a diagnosis of the web service infrastructure and delivers the result as SystemDiagnosisResult object.
/// </summary>
/// <param name="authentication">The authentication.</param>
/// <param name="version">The version.</param>
/// <returns></returns>
UBIK.Service.DTO.V243.SystemDiagnosisResult SystemDiagnosis(string authentication, string version);            

/// <summary>
/// Uploads a document for diagnosis issues
/// </summary>
/// <param name="stream">The stream.</param>
/// <returns></returns>
UBIK.Service.BroadcastEnvelope UploadDocumentDiagnosis(Stream stream);         

/// <summary>
/// Downloads a document for diagnosis issues
/// </summary>
/// <param name="fileExtension">The file extension.</param>
/// <param name="authentication">The authentication.</param>
/// <param name="version">The version.</param>
/// <returns></returns>
Stream DownloadDocumentDiagnosis(string fileExtension, string authentication, string version);         

/// <summary>
/// Delivers a collection of all configured service urls for diagnosis issues
/// </summary>
/// <param name="authentication">The authentication.</param>
/// <param name="version">The version.</param>
/// <returns></returns>
UBIK.Service.DTO.V243.ServiceURLInformation[] ServiceURLDiagnosis( string authentication, string version);             

/// <summary>
/// Gets information abut the state of view cache.
/// </summary>
/// <param name="appName">Name of the application.</param>
/// <param name="contextName">Name of the context.</param>
/// <param name="authentication">The authentication.</param>
/// <returns>Information about the state of the view cache as human readable string</returns>
string GetViewStateInformation(string appName, string contextName, string authentication);             

/// <summary>
/// Triggers a refresh of the view cache.
/// The current cache stays valid until the new cache was fully built.
/// </summary>
/// <param name="appName">Name of the application.</param>
/// <param name="contextName">Name of the context.</param>
/// <param name="authentication">The authentication.</param>
/// <returns>true as the refresh was triggered successfully, false otherwise</returns>
bool TriggerViewStateRefresh(string appName, string contextName, string authentication);               

/// <summary>
/// Test member for testing the View Cache.
/// </summary>
/// <param name="appName">Name of the application.</param>
/// <param name="contextName">Name of the context.</param>
/// <param name="ownerUID">UID of the object the test should be executed for (e.g. root object). All data below this object will be delivered.</param>
/// <param name="authentication">The authentication.</param>
/// <returns>data stored in the view cache as BCHierarchyDeltaShipments</returns>
UBIK.Service.DTO.V211.BCHierarchyDeltaShipments TestViewState(string appName, string contextName, string ownerUID, string authentication);             

/// <summary>
/// Downloads the custom images.
/// </summary>
/// <param name="appName">Name of the application.</param>
/// <param name="contextName">Name of the context.</param>
/// <param name="authentication">The authentication.</param>
/// <param name="deviceID">The device identifier.</param>
/// <returns></returns>
Stream DownloadCustomImages(string appName, string contextName, string authentication, string deviceID);