Jump to: navigation, search

Difference between revisions of "RESTPost (Activity)"


 
(27 intermediate revisions by the same user not shown)
Line 1: Line 1:
This activity verifies login information and retrieves an Authentication Object using the UBIK USAM Service.
+
This activity is used to create a new resource on a server and performs an "Post" operation using any web service.
  
 
<!-- DO NOT REMOVE THIS -->{{Template:Activity/Begin}}<!-- DO NOT REMOVE THIS -->
 
<!-- DO NOT REMOVE THIS -->{{Template:Activity/Begin}}<!-- DO NOT REMOVE THIS -->
Line 9: Line 9:
 
| image =  
 
| image =  
 
| imagecaption = Activity RESTPost
 
| imagecaption = Activity RESTPost
| purpose = Verifies login information and retrieves an Authentication Object using the UBIK USAM Service
+
| purpose = Create a new resource on a server using the UBIK USAM Service
 
| category = UBIK Web
 
| category = UBIK Web
 
| returns = true if successful
 
| returns = true if successful
| version = 3.5
+
| version = 3.5.0+
 
}}
 
}}
  
Line 20: Line 20:
 
! Argument !! Type !! Direction !! Purpose  
 
! Argument !! Type !! Direction !! Purpose  
 
|- align="left"
 
|- align="left"
| Body || {{String}} || In ||  
+
| Body || {{String}} || In || Contains information wich is sent to the server
 
|- align="left"
 
|- align="left"
| DisplayName || {{String}} ||  ||  
+
| DisplayName || {{String}} ||  || Display's the name
 
|- align="left"
 
|- align="left"
| Error || {{String}} || Out ||  
+
| Error || {{String}} || Out || Display's error message, appears when something is wrong with your request
 
|- align="left"
 
|- align="left"
| DisplayName || {{String}} || In ||  
+
| Headers || Dictionary<{{String}}, {{String}}> || In || Authentication and providing information
 
|- align="left"
 
|- align="left"
| Headers || {{String}} || In ||  
+
| MethodName || {{String}} || In || Name of the method
 
|- align="left"
 
|- align="left"
| MethodName || {{String}} || In ||  
+
| Parameter || String[] || In || Refers to one of the pieces of data provided as input
 
|- align="left"
 
|- align="left"
| Parameter || {{String}} || In ||  
+
| Response || {{String}} || Out || Data sent back to you
 
|- align="left"
 
|- align="left"
| Response || {{String}} || Out ||  
+
| Result || {{String}} || Out || Result data sent back to you
 
|- align="left"
 
|- align="left"
| Result || {{String}} || Out ||  
+
| Url || {{String}} || In || Specified Url
 
|- align="left"
 
|- align="left"
| Url || {{String}} || In ||  
+
|}
 +
 
 +
 
 +
===Usage===
 +
Use this activity to create a new "Post" resource on any server using the UBIK Content service.
 +
 
 +
 
 +
 
 +
 
 +
=Example=
 +
Exemplary values using RESTPost to get Hierarchy details from UBIK Content service.
 +
{| class="wikitable" | width = "50%"
 +
|-
 +
! A+B Assign !! Value
 
|- align="left"
 
|- align="left"
| Result || {{Boolean}} || Out || True or False
+
| DisplayName || Assign
 +
|- align="left"
 +
| To || args
 +
|- align="left"
 +
| Value || New UBIK.Service.DTO.V211.HierarchyDeltaArguments()
 +
|- align="left"
 +
|}
 +
 
 +
{| class="wikitable" | width = "50%"
 +
|-
 +
! A+B Assign !! Value
 +
|- align="left"
 +
| DisplayName || Assign
 +
|- align="left"
 +
| To || args.StartingPoint
 +
|- align="left"
 +
| Value || New UBIK.Service.DTO.V211.HierarchyRoot()
 +
|- align="left"
 +
|}
 +
 
 +
{| class="wikitable" | width = "50%"
 +
|-
 +
! A+B Assign !! Value
 +
|- align="left"
 +
| DisplayName || Assign
 +
|- align="left"
 +
| To || args.ChildrenDepth
 +
|- align="left"
 +
| Value || 1
 +
|- align="left"
 +
|}
 +
 
 +
{| class="wikitable" | width = "50%"
 +
|-
 +
! A+B Assign !! Value
 +
|- align="left"
 +
| DisplayName || Assign
 +
|- align="left"
 +
| To || authToken
 +
|- align="left"
 +
| Value || "e1191c36-2081-4ffe-8d8e-4b798d4523a1"
 +
|- align="left"
 +
|}
 +
 
 +
{| class="wikitable" | width = "50%"
 +
|-
 +
! RESTPost!! Value
 +
|- align="left"
 +
| Body || args
 +
|- align="left"
 +
| DisplayName || RESTPost<BCHierarchyDeltaShipments,HierarchyDeltaArguments>
 +
|- align="left"
 +
| Error ||
 +
|- align="left"
 +
| Headers ||
 +
|- align="left"
 +
| MethodName || "GetHierarchyDeltasV212"
 +
|- align="left"
 +
| Parameter || New String(){"APP_MT","CXT_MT",authToken,"264"}
 +
|- align="left"
 +
| Response ||
 +
|- align="left"
 +
| Result|| result
 +
|- align="left"
 +
| Url || "https://81.10.184.186:888/UBIK/DBG/AUG/MT/TEMPLATE/Content/UbikContent.svc"
 
|- align="left"
 
|- align="left"
 
|}
 
|}
  
  
===Usage===
 
Use this activity to verify the login information and retrieve an Authentication Object using the UBIK USAM Service.
 
  
  
Line 54: Line 129:
 
==See also==
 
==See also==
 
* [[Workflow Designer]]
 
* [[Workflow Designer]]
* [[Activity:CreatePushScope (Activity)]]This activity verifies login information and retrieves an Authentication Object using the UBIK USAM Service.
+
 
 +
 
 +
==Useful Links [What is REST Service]==
 +
* https://www.sitepoint.com/developers-rest-api/
 +
* https://mlsdev.com/blog/81-a-beginner-s-tutorial-for-understanding-restful-api
 +
* https://www.smashingmagazine.com/2018/01/understanding-using-rest-api/
  
 
<!-- DO NOT REMOVE THIS -->{{Template:Activity/Begin}}<!-- DO NOT REMOVE THIS -->
 
<!-- DO NOT REMOVE THIS -->{{Template:Activity/Begin}}<!-- DO NOT REMOVE THIS -->

Latest revision as of 08:55, 14 April 2020

This activity is used to create a new resource on a server and performs an "Post" operation using any web service.


[edit]

Description

RESTPost
Name RESTPost
Purpose Create a new resource on a server using the UBIK USAM Service
Category UBIK Web
Returns true if successful
Version 3.5.0+

Arguments

Argument Type Direction Purpose
Body String In Contains information wich is sent to the server
DisplayName String Display's the name
Error String Out Display's error message, appears when something is wrong with your request
Headers Dictionary<String, String> In Authentication and providing information
MethodName String In Name of the method
Parameter String[] In Refers to one of the pieces of data provided as input
Response String Out Data sent back to you
Result String Out Result data sent back to you
Url String In Specified Url


Usage

Use this activity to create a new "Post" resource on any server using the UBIK Content service.



Example

Exemplary values using RESTPost to get Hierarchy details from UBIK Content service.

A+B Assign Value
DisplayName Assign
To args
Value New UBIK.Service.DTO.V211.HierarchyDeltaArguments()
A+B Assign Value
DisplayName Assign
To args.StartingPoint
Value New UBIK.Service.DTO.V211.HierarchyRoot()
A+B Assign Value
DisplayName Assign
To args.ChildrenDepth
Value 1
A+B Assign Value
DisplayName Assign
To authToken
Value "e1191c36-2081-4ffe-8d8e-4b798d4523a1"
RESTPost Value
Body args
DisplayName RESTPost<BCHierarchyDeltaShipments,HierarchyDeltaArguments>
Error
Headers
MethodName "GetHierarchyDeltasV212"
Parameter New String(){"APP_MT","CXT_MT",authToken,"264"}
Response
Result result
Url "https://81.10.184.186:888/UBIK/DBG/AUG/MT/TEMPLATE/Content/UbikContent.svc"




See also


Useful Links [What is REST Service]