forked from LHeffner/Practice-Repo
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathMarketplace.html
More file actions
483 lines (377 loc) · 22.2 KB
/
Marketplace.html
File metadata and controls
483 lines (377 loc) · 22.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
<!DOCTYPE html>
<html>
<head>
<title></title>
</head>
<body>
<h1 pbzloc="734">Marketplace</h1>
<h2>Overview</h2>
<p>Use Marketplace to find the applications you need to do your work. You can explore it using search, filters and categories or add your own listings. <a href="ContentSteward.html">Content Stewards</a> manage listings.</p>
<p><img alt="Search and Discovery Page" src="../ozp-help/Doc_images/Marketplace-search-and-discovery-page.png" style="height: 749px; width: 624px" title="Search and Discovery Page" /></p>
<p>When you enter OZONE, the first thing you’ll see is the Marketplace Search and Discovery Page. It displays Featured, New Arrivals and the Most Popular listings. Use the categories on the left to reduce the number of listings you see on the page. From the top of the page, you can search for a listing and results will be returned based on listing name, description, tags, etc. You'll find a complete description of listings and search in the follow related sections.</p>
<h1>Listings: View, Create, Edit</h1>
<h2><a id="definitions" name="definitions">Definitions</a></h2>
<p><b>Listing</b> –Any software application or component that a user enters into Marketplace is called a “listing.” Like apps on smart phones, listings in Marketplace contain various types of Web content.</p>
<p>From Marketplace, you can save listings to your HUD or open them in a new browser tab.</p>
<h2>Listing: <a id="shortListingView" name="shortListingView">Short</a> View</h2>
<p>On the Search and Discovery Page, you see each listing’s icon, name, rating and organizational association. Hover over the listing to display its Short View.</p>
<p><img alt="Listing Short View" src="file:///C:/Users/ssaylor/Desktop/BUILD/ozp-help/Doc_images/Listing-Short-View.png" style="height: 236px; width: 624px" title="Listing Short View" /><br />
<b>Listing Short View</b></p>
<p>From the Listing Short View you can read a short description, open or bookmark a listing:</p>
<p><img alt="Listing Actions" src="file:///C:/Users/ssaylor/Desktop/BUILD/ozp-help/Doc_images/listing-actions.png" style="height: 170px; width: 324px" title="Listing Actions" /><br />
<b>Listing Actions</b></p>
<h2>Listing: <a id="detailedListingView" name="detailedListingView">Detailed</a> View</h2>
<p>While the Listing Short View displays basic information, its Detailed View provides much more information. Click inside the view to open the Detailed Listing View. Each tab is described in this section:</p>
<p><img alt="Listing Detailed View" src="../ozp-help/Doc_images/Listing-detailed-view.png" style="height: 372px; width: 684px" title="Listing Detailed View" /><br />
<b>Listing Detailed View</b></p>
<p>The listing’s header information and actions appear on each tab. Its header includes: listing icon, name, rating, organizational affiliation and actions such as opening, bookmarking and editing:</p>
<p><img alt="Listing heading" src="../ozp-help/Doc_images/Listing-heading.png" style="height: 127px; width: 624px" title="Listing heading" /><br />
<b>Listing Heading</b></p>
<p>Basic listing information:</p>
<table border="0" cellpadding="0" cellspacing="0" style="width: 500px">
<tbody>
<tr>
<td>
<p><img alt="Left-side details of the listing header" src="../ozp-help/Doc_images/Left-side-listing-view-header.png" style="height: 184px; width: 244px" title="Left-side details of the listing header" /></p>
</td>
<td>
<p> </p>
<p>At the top of the listing's Detailed View, you will see the listing's:</p>
<p><u1></u1></p>
<ul>
<li><b>Icon</b></li>
<li><b>Name</b></li>
<li><b>Rating</b></li>
<li><b>Organizational association</b></li>
</ul>
<p> </p>
</td>
</tr>
</tbody>
</table>
<p><strong>Left-side Detailed Listing View Header</strong></p>
<p> </p>
<table border="0" cellpadding="0" cellspacing="0" style="width: 500px">
<tbody>
<tr>
<td>
<p><img alt="Right-side detailed listing view header" src="../ozp-help/Doc_images/Right-side-detailed-listing-view-header.png" style="height: 147px; width: 214px" title="Right-side detailed listing view header" /></p>
</td>
<td>
<p> </p>
<p>The right-side of the listing's Detailed View houses three actions:</p>
<ul>
<li><b>Open in a new tab</b></li>
<li><b>Add to your HUB</b></li>
<li><b>Edit</b> (if you are the listing owner)</li>
<li><b>Close</b></li>
</ul>
<p> </p>
</td>
</tr>
</tbody>
</table>
<p><b>Right-side Detailed Listing View Header</b></p>
<p> </p>
<h3>Overview Tab</h3>
<p>When you open the listing’s Detailed View you’ll see the Overview tab which includes screenshots and the long description.</p>
<p><img alt="Listing Detailed View" src="../ozp-help/Doc_images/Listing-detailed-view.png" style="height: 248px; width: 456px" title="Listing Detailed View" /><br />
</p>
<p><b>Overview Tab on the Listing's Detailed View</b></p>
<p>The Overview tab displays the listing's screenshots and long description. Here's what you should know about them:</p>
<p><b>Screenshots</b> – If there are more than one, use the arrows on the left or right to scroll. Click the screenshot for a larger view of it. Close the expanded view using the <b>x</b> in the upper-right corner. Scroll from one image to the next using the arrows on the right and left.</p>
<p><b>Long Description</b> – This description can provide more content than the Short View. The listing owner enters the description and the owner or a content steward can edit it.</p>
<h3>Reviews Tab</h3>
<p>Click the Reviews tab to add a comment or rating. Also, you can read other users’ comments and see how many users rated the listing. For instructions about writing or editing a review see FUTURE LINK.</p>
<p><img alt="Review tab on detailed view" src="../ozp-help/Doc_images/Review-tab-on-listings-detailed-view.png" style="height: 286px; width: 624px" title="Review tab on detailed view" /><br />
<b>Review Tab on the Listing's Detailed View</b></p>
<h3>Details Tab</h3>
<p>The Details tab displays important information about the listing. The owner and stewards can edit it from the Create/Edit page. Descriptions of each field are included in the <a href="#createListing">Create a Listing section</a>.</p>
<p><img alt="Details tab on listing's detailed view" src="../ozp-help/Doc_images/Details-tab-detailed-listing-view.png" style="height: 337px; width: 624px" title="Details tab on listing's detailed view" /><br />
<b>Details Tab on the Listing's Detailed View</b></p>
<h3>Resources Tab</h3>
<p>The Resources tab links to information and people that support the app. Descriptions of each filed are included in the <a href="#createListing">Create a Listing section</a>.</p>
<p><img alt="Resources tab on the listing details view" src="../ozp-help/Doc_images/resources-tab-listing-details-view.png" style="height: 263px; width: 624px" title="Resources tab on the listing details view" /><br />
<b>Resources Tab on the Listing's Detailed View</b></p>
<h3>Administration Tab</h3>
<p>The Administration tab only appears if you are the listing owner or a content steward. From this tab, stewards approve or reject listings; make them visible or hide them from Marketplace (Enabled) and decide if the listing will be featured in the banner at the top of the Discovery Page. Stewards can find instructions about administering listings in section FUTURE LINK.</p>
<p><img alt="Admin tab on the listing details view" src="../ozp-help/Doc_images/admin-tab-listing-details-view.png" style="height: 334px; width: 624px" title="Admin tab on the listing details view" /><br />
<b>Administration Tab on the Listing's Detailed View</b></p>
<p> </p>
<h1><a id="createListing" name="createListing">Create</a> a Listing</h1>
<p>Anyone can create a listing. Only stewards can approve them. This section explains how to create a listing and it defines each field on the Create/Edit Listing Form.</p>
<p>To create a listing:</p>
<p>From the Global Toolbar, click the drop-down Main Menu</p>
<p><img alt="Submit a listing" src="../ozp-help/Doc_images/submit-a-listing.png" style="height: 316px; width: 207px" title="Submit a listing" /></p>
<ol>
<li>Select <b>Submit a Listing</b></li>
<li>The Listing Create/Edit Form opens. To save the listing, you must enter a <b>Name, Type and Owner</b>.<br />
<i>At this point, you may save the listing without completing it. If you do this, you can open it from your Profile and Listing Management.</i></li>
<li>Complete the listing. All fields are required unless marked optional.</li>
<li>Click <img alt="Save" src="../ozp-help/Doc_images/save.png" style="height: 30px; width: 33px" title="Save" /> at the top of the form to save. The save icon switches to a green checkmark after saving.</li>
<li>To preview the listing, click <img alt="show" src="../ozp-help/Doc_images/show-icon.png" style="height: 35px; width: 45px" title="show" />.</li>
<li>When you are ready to publish the listing, click <img alt="Send the listing to a steward for review" src="../ozp-help/Doc_images/send-to-steward.png" style="height: 39px; width: 49px" title="Send the listing to a steward for review" /> to notify the Organizational Steward that the listing is ready for review. <br />
<i>Find steward approval instructions in FUTURE LINK</i></li>
<li>After an organizational steward and Marketplace steward approve the listing, it will appear in Marketplace.</li>
</ol>
<h2><a id="submitListing" name="submitListing">Submit</a> a Listing</h2>
<p>After creating a listing, a Marketplace and Org Steward must approve it. Follow the instructions in the <a href="#createListing">Create a Listing section</a> to submit the listing. After approval by both stewards, your listing will appear in Marketplace.</p>
<h1>Fields on the Create/Edit <a id="form" name="form">Form</a></h1>
<p>The following fields appear on the Create/Edit Listing Form:<br />
</p>
<h2>Basic Listing Information</h2>
<p><img alt="Basic Listing Information section of the Create/Edit Listing Form" src="../ozp-help/Doc_images/Create-Edit-Listing-Form-BasicInfo.png" style="height: 503px; width: 624px" title="Enter Basic Listing Information" /><br />
<b>Basic Listing Information</b><br />
Owners and stewards add tags from the Create/Edit Form.</p>
<ul>
<li>Tags influence search results.</li>
<li>The tags appear on the Details tab on the Detailed View
<ul>
</ul>
</li>
</ul>
<table border="1" cellpadding="2" cellspacing="2" style="width: 100%; text-align: left">
<tbody>
<tr>
<td><b>Field</b></td>
<td><b>Description</b></td>
<td><b>Additional Information</b></td>
</tr>
<tr>
<td>Name</td>
<td>The name/title of the listing.</td>
<td>Names are not required to be unique within the system.</td>
</tr>
<tr>
<td>Listing Type</td>
<td>The listing technology description (e.g. Widget, Web Application).</td>
<td> </td>
</tr>
<tr>
<td>Categories</td>
<td>The categories associated with the listing used to group them. Stewards can add and remove categories as needed.</td>
<td>A listing can be associated with multiple categories.</td>
</tr>
<tr>
<td>Tags</td>
<td>
<p>A list of user generated words used to describe the listing.</p>
<ul>
<li>Tags influence search results.</li>
<li>Tags appear on the Details tab on the Detailed View.</li>
</ul>
</td>
<td>Owners and stewards add tags from the Create/Edit Form.</td>
</tr>
<tr>
<td>Full Description</td>
<td>
<p>This field can contain 4,000 characters. To make it easier for users to determine the nature of the listing, a succinct summary should be captured in the first few lines of the description.</p>
</td>
<td>The full dscription appears on the Overview tab of the listing's Detailed View.</td>
</tr>
<tr>
<td>Short<br />
Description</td>
<td>This 100 character description appears when a user hovers over a listing on the Search and Discovery Page.</td>
<td>This description can differ from the full description.</td>
</tr>
</tbody>
</table>
<p> </p>
<h2>Listing Details</h2>
<p><img alt="Create/Edit Listing Form -- Listing Details" src="../ozp-help/Doc_images/Create-Edit-Listing-Form-ListingDetails.png" style="height: 462px; width: 624px" title="Create/Edit Listing Form -- Listing Details" /><br />
<b>Create/Edit Listing Form -- Listing Details</b><br />
</p>
<table border="1" cellpadding="2" cellspacing="2" style="width: 100%; text-align: left">
<tbody>
<tr>
<td><b>Field</b></td>
<td><b>Description</b></td>
<td><b>Additional Information</b></td>
</tr>
<tr>
<td>Version Number</td>
<td>An identifier used to distinguish one version from another.</td>
<td>This is a free text field.</td>
</tr>
<tr>
<td>Listing URL</td>
<td>The address where users can access the listing.</td>
<td> </td>
</tr>
<tr>
<td>Usage Requirements</td>
<td>A list of any required dependencies.</td>
<td>Example: This listing requires Adobe Flash and functions best on IE9 or newer browsers.</td>
</tr>
<tr>
<td>What’s New (optional)</td>
<td>A message from the owner or a stewards</td>
<td>Example: This release enhanced the search features and corrected a bug with editing.</td>
</tr>
<tr>
<td>Intents</td>
<td>Intents are the instructions for carrying out a listing’s intentions.</td>
<td>There are three main aspects of intents:
<ul>
<li>Action</li>
<li>Data Type</li>
<li>Send/Receive</li>
</ul>
</td>
</tr>
</tbody>
</table>
<p> </p>
<h2>Resources</h2>
<p><img alt="Create Edit Listing Form Resources" src="../ozp-help/Doc_images/Create-Edit-Listing-Form-Resources.png" style="height: 251px; width: 624px" title="Create Edit Listing Form Resources" /></p>
<p><b>Create/Edit Listing Form -- Resources</b></p>
<table border="1" cellpadding="2" cellspacing="2" style="width: 100%; text-align: left">
<tbody>
<tr>
<td><b>Field</b></td>
<td><b>Description</b></td>
<td><b>Additional information</b></td>
</tr>
<tr>
<td>Resources (optional)</td>
<td>Links to tools that will help people use the listing</td>
<td>Examples: User Guides, reference sites</td>
</tr>
</tbody>
</table>
<p> The next section of the form houses information about all the graphics in the listing. To make the listing more useful, add graphics that help users understand what the listing does and how to use it.<br />
<br />
<i>Note: Images must be smaller than 1MiB (1.048576 megabytes). Specific pixel size restrictions appear on the Listing Create/Edit Form.</i></p>
<h2> Graphics</h2>
<p><img alt="Create Edit Listing Form -- Graphics Section" src="../ozp-help/Doc_images/Create-Edit-Listing-Form-Graphics.png" style="height: 414px; width: 624px" title="Create Edit Listing Form -- Graphics Section" /></p>
<p><b>Create/Edit Listing Form: Graphics</b></p>
<p>The following figure displays the large and small banner icons on the Search and Discovery Page:<br />
<br />
<img alt="Large and Small Banner Image Examples" src="../ozp-help/Doc_images/lg-sm-banner-image.png" style="height: 351px; width: 457px" title="Large and Small Banner Image Examples" /><br />
<b>Large and Small Banner Image Examples</b></p>
<table border="1" cellpadding="2" cellspacing="2" style="width: 100%; text-align: left">
<tbody>
<tr>
<td><b>Field</b></td>
<td><b>Description</b></td>
<td><b>Additional information</b></td>
</tr>
<tr>
<td>Small Icon</td>
<td>Used to identify the listing in Webtop.</td>
<td> </td>
</tr>
<tr>
<td>Large Icon</td>
<td>Appears in the upper-left corner of the listing’s Detailed View</td>
<td> </td>
</tr>
<tr>
<td>Small Banner</td>
<td>This icon appears on the Search and Discovery Page in the New Arrivals and Most Popular sections. Also, this icon appears in the search results.</td>
<td>
<p>It is the most common view users will have of a listing.</p>
</td>
</tr>
<tr>
<td>Large Banner</td>
<td>When a listing is featured on the Search and Discovery Page, this icon appears.</td>
<td> </td>
</tr>
<tr>
<td>Screenshots</td>
<td>Houses the images that appear in the Overview tab on the listing’s Detailed View.</td>
<td>You can add infinite screenshots. The system asks for a:
<ul>
<li>Preview Image<br />
<i>Appears on the Overview tab</i></li>
<li>Full Size Image<br />
<i>Opens outside the Overview tab after a user clicks the Preview Image</i></li>
</ul>
</td>
</tr>
</tbody>
</table>
<h2>Owners & Contacts</h2>
<p>The next section of the Create/Edit Form addresses owners and contacts. This establishes who is responsible for the listing, who can see it in Marketplace and who should be contacted regarding it:</p>
<p><img alt="Create/Edit Listing Form: Owners & Contacts Section" src="../ozp-help/Doc_images/Create-Edit-Listing-Form-Owner-Contact-Section.png" style="height: 273px; width: 624px" title="Create/Edit Listing Form: Owners & Contacts Section" /><br />
<b>Create/Edit Listing Form: Owners & Contacts Section</b></p>
<table border="1" cellpadding="2" cellspacing="2" style="width: 100%; text-align: left">
<tbody>
<tr>
<td><b>Field</b></td>
<td><b>Description</b></td>
<td><b>Additional information</b></td>
</tr>
<tr>
<td>Associated Organization</td>
<td>Use this field to identify which organization will see the listing in Marketplace.</td>
<td>A drop-down list displays all organizations.</td>
</tr>
<tr>
<td>Owners</td>
<td>Pre-populated with the name of the person who creates the listing, ownership can be reassigned by typing a new owner’s name in the owner field on the listing page.</td>
<td>
<ul>
<li>To add more than one listing owner, type the name of the next owner after selecting the first one.</li>
</ul>
<ul>
<li>Only a listing’s owner(s) and content stewards can edit the listing.</li>
</ul>
</td>
</tr>
<tr>
<td>Contacts</td>
<td>A field that can contain the contact’s information that the submitter wishes to enter (e.g., email, phone).</td>
<td>
<ul>
<li>Click Add to associate more than one contact with a listing.</li>
</ul>
<ul>
<li>The Marketplace steward decides if the field is optional or required.</li>
</ul>
</td>
</tr>
</tbody>
</table>
<h2><a id="editListing" name="editListing">Edit</a> a Listing</h2>
<p>Only listing owners and content stewards can change listings.<br />
To edit a listing:</p>
<ol>
<li>Click the listing icon to open the Listing Detailed View.</li>
<li>From the top-right, click <img alt="Edit" src="../ozp-help/Doc_images/edit-icon.png" style="height: 28px; width: 31px" title="Edit" />, this will open the Create/Edit Form.</li>
<li>Update the listing, then, click <img alt="save" src="../ozp-help/Doc_images/save.png" style="height: 30px; width: 33px" title="save" /> to save. The save icon switches to a green checkmark after saving. The listing will update in the system.</li>
</ol>
<h2><a id="reviewListing" name="reviewListing"></a>Review a Listing</h2>
<p> Any user can add a comment or rating to a listing. Only content stewards and the person who submits the Review can edit or delete it.</p>
<p>To submit a review:</p>
<ol>
<li>Click the listing icon to open the listing's Detailed View.</li>
<li>Click the Reviews tab:</li>
<li>Your review options are located on the right, enter a <b>Star Rating</b> and type a comment in the <b>Description field</b>:<br />
<img alt="Reviewing a Listing Example" src="../ozp-help/Doc_images/Reviewing-a-listing-example.png" style="height: 295px; width: 624px" title="Reviewing a Listing Example" /><br />
<b>Reviewing a Listing Example</b></li>
<li>Click Submit, your comment will be added to the listing Reviews and affect the Star rating.</li>
</ol>
<h1><a id="User_listingManagementPage" name="User_listingManagementPage" pbzloc="746">Listing Management Page for a User</a></h1>
<p pbzloc="747">The Listing Mangement Page tells users where their listings are in the approval process. To access this page, click the drop-down Main Menu on the right side of the Global Toolbar and select Listing Management:</p>
<p pbzloc="748"><img alt="Link to Listing Management Page from Global Toolbar" pbzloc="737" src="../ozp-help/Doc_images/ListingManagementLink.png" style="height: 320px; width: 200px" title="Listing Management Page" /></p>
<p pbzloc="751">As a user, the Manage section displays information about listings you own. <a href="ContentSteward.html#Steward_listingManagementPage" pbzloc="749">Stewards will see additional settings</a> related to administering listing in their organization; Marketplace stewards can access system settings from this drop-down.</p>
<p><img alt="Listing Management Page" src="../ozp-help/Doc_images/ListingManagementPage.png" style="height: 236px; width: 624px" title="Listing Management Page" /></p>
<p pbzloc="752">The Listing Management page displays different information for different users. The following sections explain each field as it relates to a user. For Steward information about the Listing Management Page <a href="ContentSteward.html#Steward_listingManagementPage">see the Content Steward View</a>.</p>
<h2 pbzloc="739">User View: Listing Management Page</h2>
<p pbzloc="735">As a <b>user</b>, you see all the listings that you own (including active, disabled and draft listings); the Recent Activity tab describes changes to listings you own; and the State panel on the left side provides an overview on the status of your listings:</p>
<ul>
<li><b>All</b> -- Listings you own in the system</li>
<li><b>Published</b> -- Listings that are approved by Marketplace and organizational stewards in the system (this number includes listings that are Disabled)</li>
<li><b>Needs action</b> -- Listings returned from a steward. To see the reason a listing was returned, click the arrow in the upper-right corner of the listing and select Read Feedback:<br />
<img alt="Listing Action drop-down" src="../ozp-help/Doc_images/ListingAction_drop-down.png" style="height: 141px; width: 225px" title="Listing Action drop-down" /></li>
<li><b>Pending</b> -- Listings waiting for approval from a steward</li>
<li><b>Draft</b> -- Listings that you have not yet submitted for approval</li>
</ul>
<p> </p>
<h2> </h2>
</body>
</html>