RetrieveWidgetplacements

ApplicationService / RetrieveWidgetplacements

Description: Retrieve Widgetplacements by Layout

URL: http://{your-server-url}/api/v1/core/applications/layouts/{layoutId}/widgetplacements

Method: GET

Token Required: True

Request Headers:

content-type: application/json or content-type: application/xml
token: {token}
currentaccountid: {accountid - optional and default value is user's own account}

Required Roles:

Portal Administrator, Account Administrator, Account Owner, Content Administrator, Widget Manager

Rights:

Type: Nexus.AppSpace.Service.Contract.Model.Enums.Rights.Rights

Right	Require
Widget Management	Yes

Request Query Parameters:

Parameter	Type	Nullable	Description
rpp	int	True	records per page, default = 50, max = 500
widgetids	int[]	True	comma separated values, eg. widgetids=1,2,3
page	int	True	page number

Example: http://{your-server-url}/api/v1/core/applications/layouts/{layoutId}/widgetplacements?rpp=100&widgetids=1,2,3&page=100

Response:

Type: Nexus.AppSpace.Service.Contract.Messages.AppSpaceIntegration.v1.Application.ApplicationResponse

Parameter	Type
Response.Rpp	int
Response.CurrentPage	int
Response.TotalPages	int
Response.WidgetPlacements	Nexus.AppSpace.Service.Contract.Model.DTO.AppSpaceIntegration.v1.Applications.WidgetPlacement[]

Enums:

Field	Name	Values
Type	Nexus.AppSpace.Service.Contract.Model.Enums.Application.ElementType	MediaZone = 0, TextTicker = 1, RSSTicker = 2, DateTime = 3, WeatherInfo = 4, RSSViewer = 5, PlainText = 6, InfoMenu = 7, Button = 8, HTMLSnippet = 9, EventCalendar = 10, CloneWidget = 11, SlideBar = 12, FlashContainer = 13, WayFinder = 14, TableListing = 15, MediaTicker = 16, KeyPad = 17, MediaContainer = 18, RemoteControl = 19, ExtensionWidget = 20, SIPWidget = 21

The following is an example response Xml body:

<ApplicationResponse xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages.AppSpaceIntegration.v1.Application" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <DebugMessage xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages">String</DebugMessage>
  <Errors xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages">
    <Error>
      <Code>String</Code>
      <Message>String</Message>
      <StackTrace>String</StackTrace>
    </Error>
  </Errors>
  <Status xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages">Success</Status>
  <CurrentPage>123</CurrentPage>
  <Rpp>123</Rpp>
  <TotalPages>123</TotalPages>
  <WidgetPlacements xmlns:a="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Model.DTO.AppSpaceIntegration.v1.Applications">
    <a:WidgetPlacement>
      <a:Color>String</a:Color>
      <a:Height>1000</a:Height>
      <a:Left>1000</a:Left>
      <a:MetaData xmlns:b="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Model.DTO">
        <b:KeyValuePair>
          <b:Key>String</b:Key>
          <b:Value>String</b:Value>
        </b:KeyValuePair>
      </a:MetaData>
      <a:Opacity>1000</a:Opacity>
      <a:Top>1000</a:Top>
      <a:TransitionInType>String</a:TransitionInType>
      <a:TransitionOutType>String</a:TransitionOutType>
      <a:WidgetId>123</a:WidgetId>
      <a:WidgetName>String</a:WidgetName>
      <a:Width>1000</a:Width>
    </a:WidgetPlacement>
  </WidgetPlacements>
</ApplicationResponse>

The following is an example response Json body:

{
	"DebugMessage":"String",
	"Errors":[
		{
			"Code":"String",
			"Message":"String",
			"StackTrace":"String"
		}
	],
	"Status":1,
	"CurrentPage":123,
	"Rpp":123,
	"TotalPages":123,
	"WidgetPlacements":[
		{
			"Color":"String",
			"Height":1000,
			"Left":1000,
			"MetaData":[
				{
					"Key":"String",
					"Value":"String"
				}
			],
			"Opacity":1000,
			"Top":1000,
			"TransitionInType":"String",
			"TransitionOutType":"String",
			"WidgetId":123,
			"WidgetName":"String",
			"Width":1000
		}
	]
}