Management Studio User Guide


Table of Contents

Introduction

Management Studio is a developing tool built in addition to the CityNext Big Data Solution Accelerator. It is a mechanism that provides developers the ability to manage big data and schema for the solution accelerator.


About this Guide

This guide will walk you through everything you need to know about Management Studio. Whether you read this from beginning to end, or jump all around, we hope you will find this guide useful as you get to know Management Studio.


How to Utilize Management Studio

On the home page you can see the navigation bar on the left, and the introduction of each menu item on the right. To access a certain menu item you can either click on the navigation bar and any subsequent listed item that follows, or on the arrow button of any menu item listed in the section to the right.
2 How to Utilize Management Studio.png



Data Ingestion

Data Ingestion interacts with external and internal data sources to ensure diverse data can be ingested into the big data solution accelerator.

Pull channel management

Create and edit channels for data ingestion.

Pull source management

Create, edit and manage pull source content for data ingestion.

Push source management

Create, edit and manage push source content for data ingestion.


City Artifacts Management

City Artifacts Management is the main data storage and supports data enrichment, discovery and aggregation.

Object schema management

On this page, you can review and manage indexes and computed attributes of the object schema, which store and manage the data.
2.2.1 Object schema management.png


To review the object schema in alphabetical order, click Cannot resolve image macro, invalid image name or id. beside “name”.

To catch a glimpse of the name, the attributes or computed attributes, move the mouse over the according item, like this:
2.2.1 Object schema management 2.png


To review and manage a certain object schema, select it with a click.
2.2.1 Object schema management 3.png


To review the details of the schema, click Details button icon.png to enter the detail page. The name, index, raw attributes (name, type, indexed status), computed attributes (name, type, computation rule) should be shown
2.2.1 Object schema management 4.png


To review the data of the schema, click Data button icon.png to enter the data page. The values of each attributes, including computed attributes, should be shown.
2.2.1 Object schema management 5.png


To manage the indexes, click Indexes button icon.png to enter the index page. Click Open check box icon.png to create index for the unindexed attribute. Click Checked box icon.png to delete index for the indexed attribute.
2.2.1 Object schema management 6.png
Note: The indexing will occur in the background and may take some time to complete depending on the data size.

Computed attributes are attributes defined by the computed result of some existing attributes.
To manage the computed attributes, click Computed attributes button icon.png on the lower right corner to enter computed attribute list page.
2.2.1 Object schema management 7.png


To create a new computed attribute, click New button icon.png on the lower left corner to enter computed attribute creation page.
2.2.1 Object schema management 8.png


Enter the name. Note: The name can only contain letters, numbers and underscores, and starts with letters. Choose the data type. There are 24 types for you to choose from: sbyte, sbyte?, short, short?, int, int?, long, long?, float, float?, double, double?, bool, bool?, guid, guid?, string, binary, datetime, datetime?, decimal, decimal?, byte, byte?.
2.2.1 Object schema management 9.png


Enter the computation rule. Click Question mark button icon.png to get help with the rule. The help page lists operators and functions you may need to set the rule.
2.2.1 Object schema management 10.png


For example, to create a computed attribute to concat, two attributes of string type “Country” and “City”, enter “Concat(Country, City)”. Click Validate button icon.png and then you can get a preview of the computed date.
Note: the data will not be saved until you submit the creation.
2.2.1 Object schema management 11.png


Click Submit button icon.png.The computed attribute and the according data will be saved. The new computed attribute should be seen on the computed attribute list page.
To edit a certain computed attribute, click Edit button icon.png on the lower right corner to enter the edit page.
2.2.1 Object schema management 12.png


The edit operation is the same as the creation operation, except that the name of the existing computed attribute cannot be changed.
To delete the current computed attribute, click Delete button icon.png.


Entity schema management

On this page you can create and edit entity schema. You can choose the data that interests you from object schema, and map them to some entity schemas, in order to review and manage them better.
Entity schema management.png


To review the entity schema in alphabetical order, click Cannot resolve image macro, invalid image name or id. beside “Name”; in chronological order, click the button beside “Updated Time”.

To catch a glimpse of the attributes, the bindings, and the permissions, move the mouse over the related item.

To review and manage a certain entity schema, select it with a click.
Entity schema management 2.png


To review the details of the schema, click Details button icon.png to enter the detail page. The name, attributes, binding schema, permission status should be shown.
Cannot resolve image macro, invalid image name or id.


To review the data of the schema, click Data button icon.png to enter the data page.

To create a new computed attribute, click New button icon.png on the lower left corner to enter entity schema creation page.

Enter the name and choose a creation type.
Entity schema management 4.png


There are three ways to create a new entity:
  1. Create all of the entity attributes and the object schema they are mapped from.
  2. Copy attributes from object schema. You need to choose an existing object schema. All of its attributes will be mapped to an entity attribute.
  3. Copy from entity schema. You need to choose an existing entity schema. All of its attributes will be copied to the new entity schema.

Click Side arrow button icon.png to go to the properties & mappings page. The entity attributes which are mapped from existing object schema or copied from existing entity schema should already be listed.

For example, you can create an entity schema and copy attributes from an existing object schema.
Entity schema management 5.png
Entity schema management 6.png


If you want to create other entity attributes or other mappings, click Plus sign button icon.png below the entity attributes.
Entity schema management 7.png


Enter the name and choose the data type, and click Floppy disk button icon.png. Choose an attribute of the current object schema. Note: there are choices only if there is any available property in this object for the corresponding data type.
Entity schema management 8.png

Entity schema management 9.png


Click Plus sign button icon.png on the right to add an object schema for mapping.
Every existing item in this table can be edited or deleted. To edit or delete a certain item, move your mouse over it.
Edit and delete button icon.png


To edit a certain entity schema, click Edit button icon.png on the lower right corner to enter the edit page.
Entity schema management 10.png


To delete the current computed attribute, click Delete button icon.png.

To edit the permission status of the current computed attribute, click Permissions button icon.png to enter the permission page.
Entity schema management 11.png


Click Add button icon.png to add a new permission.
Entity schema management 12.png


Choose user/group/everyone, enter the account, and choose permission as “allow” to grant the user/group access, or “denied” to deny the user/group access.
Entity schema management 13.png


Click Delete button icon 2.png to delete the current permission.

Click Submit button icon.png to submit the edit.
Note: only the user/group with “allow” permission can access the related OData URL.


City Services Management

City Services Management enables operators to manage the big data empowered services registration and release.

Business entity management



Diagnostics

Functional self-test

Create and run diagnostics on-demand to check the functionality of the platform.

SCOM monitoring

System health monitoring.

SCOM report

SCOM daily health check report.





Last edited Nov 17, 2014 at 10:02 AM by gheadd, version 6