Skip to content

Commit 36b5963

Browse files
committed
Merge remote-tracking branch 'upstream/staging' into staging
2 parents 0bc1982 + e9da5ea commit 36b5963

28 files changed

+1277
-148
lines changed

docs/sp-add-ins/incident-manager-a-cloud-business-add-in-tutorial.md

Lines changed: 41 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,3 @@
1-
---
2-
title: Incident manager: A cloud business add-in tutorial
3-
ms.prod: SHAREPOINT
4-
ms.assetid: 8dec09e6-e197-4f68-bcc2-ca41105c5d61
5-
---
6-
71

82
# Incident manager: A cloud business add-in tutorial
93
By using the **Cloud Business Add-in** template in Visual Studio, you can create a SharePoint hosted in which mobile users can view, add, and update data from remote locations by using modern, touch-oriented devices such as phones and tablets. In this tutorial, you'll create an add-in for a fictional Contoso Fire Department to handle on-scene incident management. The walkthrough covers the core concepts of building a Cloud Business Add-in as well as more advanced concepts such as integrating SharePoint lists and document libraries.
@@ -56,7 +50,7 @@ You will build the mobile add-in that will be used to enter basic information ab
5650

5751

5852

59-
![Cloud Business App template](images/CBA_IM1.PNG)
53+
![Cloud Business App template](../../images/CBA_IM1.PNG)
6054

6155

6256

@@ -152,7 +146,7 @@ You will build the mobile add-in that will be used to enter basic information ab
152146

153147

154148

155-
![The Incident entity](images/CBA_IM_2.PNG)
149+
![The Incident entity](../../images/CBA_IM_2.PNG)
156150

157151

158152

@@ -190,13 +184,9 @@ You will build the mobile add-in that will be used to enter basic information ab
190184
|7|Service Call|
191185
|||
192186

193-
At run time, a list of the display names will be presented to the user. When they make a choice, the corresponding **Integer** value will be stored in the database.
194-
195-
196-
197-
187+
At run time, a list of the display names will be presented to the user. When they make a choice, the corresponding **Integer** value will be stored in the database.
198188

199-
In the next step, you'll add a Patient entity. Many of the fire department's incidents involve medical aid, and a single incident often involves multiple patients.
189+
In the next step, you'll add a Patient entity. Many of the fire department's incidents involve medical aid, and a single incident often involves multiple patients.
200190

201191

202192

@@ -215,7 +205,7 @@ You will build the mobile add-in that will be used to enter basic information ab
215205

216206

217207

218-
![The Patient entity](images/CBA_IM_2a.PNG)
208+
![The Patient entity](../../images/CBA_IM_2a.PNG)
219209

220210

221211

@@ -252,7 +242,7 @@ You will build the mobile add-in that will be used to enter basic information ab
252242

253243

254244

255-
![The relationship between Incident and Patient](images/CBA_IM_3.PNG)
245+
![The relationship between Incident and Patient](../../images/CBA_IM_3.PNG)
256246

257247

258248
This creates a zero or one to many relationship between incidents and patients. An incident record doesn't have to have a patient, but every patient has to have a related incident record.
@@ -294,7 +284,7 @@ You will build the mobile add-in that will be used to enter basic information ab
294284

295285

296286

297-
![The Incidents screen set](images/CBA_IM_4.PNG)
287+
![The Incidents screen set](../../images/CBA_IM_4.PNG)
298288

299289

300290
Browse, View Details, and Add/Edit screens are added to the HTMLClient project. The Browse screen is automatically set as the home screen for the application, and the necessary commands for launching the View and Add/Edit screens are automatically provided.
@@ -342,7 +332,7 @@ You will build the mobile add-in that will be used to enter basic information ab
342332

343333

344334

345-
![Browse screen layout](images/CBA_IM4a.PNG)
335+
![Browse screen layout](../../images/CBA_IM4a.PNG)
346336

347337

348338
At run time the screen will display a tile for each incident, and each tile will display the incident number, date, and address.
@@ -375,7 +365,7 @@ You will build the mobile add-in that will be used to enter basic information ab
375365

376366

377367

378-
![The Add Patients link](images/CBA_IM_5.PNG)
368+
![The Add Patients link](../../images/CBA_IM_5.PNG)
379369

380370

381371

@@ -390,7 +380,7 @@ You will build the mobile add-in that will be used to enter basic information ab
390380

391381

392382

393-
![Add/Edit screen layout](images/CBA_IM_5a.PNG)
383+
![Add/Edit screen layout](../../images/CBA_IM_5a.PNG)
394384

395385

396386

@@ -434,7 +424,7 @@ You will build the mobile add-in that will be used to enter basic information ab
434424

435425

436426

437-
![Add/Edit screen layout](images/CBA_IM_6.PNG)
427+
![Add/Edit screen layout](../../images/CBA_IM_6.PNG)
438428

439429

440430

@@ -460,7 +450,7 @@ You will build the mobile add-in that will be used to enter basic information ab
460450

461451

462452

463-
![The Add Incident Popup](images/CBA_IM_7.PNG)
453+
![The Add Incident Popup](../../images/CBA_IM_7.PNG)
464454

465455

466456

@@ -494,7 +484,7 @@ You will build the mobile add-in that will be used to enter basic information ab
494484

495485

496486

497-
![The Add Patient Popup](images/CBA_IM_8.PNG)
487+
![The Add Patient Popup](../../images/CBA_IM_8.PNG)
498488

499489

500490

@@ -597,7 +587,7 @@ The first step is to add a couple of pre-populated list templates to your develo
597587

598588

599589

600-
![Navigate to the SharePoint developer site](images/CBA_IM_8a.PNG)
590+
![Navigate to the SharePoint developer site](../../images/CBA_IM_8a.PNG)
601591

602592

603593

@@ -612,7 +602,7 @@ The first step is to add a couple of pre-populated list templates to your develo
612602

613603

614604

615-
![Site Settings link](images/CBA_IM_8b.PNG)
605+
![Site Settings link](../../images/CBA_IM_8b.PNG)
616606

617607

618608

@@ -624,7 +614,7 @@ The first step is to add a couple of pre-populated list templates to your develo
624614

625615

626616

627-
![List templates list](images/CBA_IM_8c.PNG)
617+
![List templates list](../../images/CBA_IM_8c.PNG)
628618

629619

630620

@@ -648,7 +638,7 @@ The first step is to add a couple of pre-populated list templates to your develo
648638

649639

650640

651-
![The Contoso templates](images/CBA_IM_8d.PNG)
641+
![The Contoso templates](../../images/CBA_IM_8d.PNG)
652642

653643

654644

@@ -690,7 +680,7 @@ The first step is to add a couple of pre-populated list templates to your develo
690680

691681

692682

693-
![SharePoint data source](images/CBA_IM_9.PNG)
683+
![SharePoint data source](../../images/CBA_IM_9.PNG)
694684

695685

696686

@@ -705,7 +695,7 @@ The first step is to add a couple of pre-populated list templates to your develo
705695

706696

707697

708-
![SharePoint lists](images/CBA_IM_9a.PNG)
698+
![SharePoint lists](../../images/CBA_IM_9a.PNG)
709699

710700

711701
The entities are added to a new **Developer Data** node under the **Data Sources** node in **Solution Explorer**, and the **ContosoApparatus** entity opens in the entity designer.
@@ -745,7 +735,7 @@ The first step is to add a couple of pre-populated list templates to your develo
745735

746736

747737

748-
![The AvailableApparatus query](images/CBA_IM_10.PNG)
738+
![The AvailableApparatus query](../../images/CBA_IM_10.PNG)
749739

750740

751741

@@ -779,7 +769,7 @@ The first step is to add a couple of pre-populated list templates to your develo
779769

780770

781771

782-
![The Relationship dialog](images/CBA_IM_10a.PNG)
772+
![The Relationship dialog](../../images/CBA_IM_10a.PNG)
783773

784774

785775

@@ -816,7 +806,7 @@ The first step is to add a couple of pre-populated list templates to your develo
816806

817807

818808

819-
![Add a query](images/CBA_IM_11.PNG)
809+
![Add a query](../../images/CBA_IM_11.PNG)
820810

821811

822812
The **AvailableApparatus** collection is added to the left pane of the screen designer.
@@ -849,7 +839,7 @@ The first step is to add a couple of pre-populated list templates to your develo
849839

850840

851841

852-
![The Resources tab layout](images/CBA_IM_11a.PNG)
842+
![The Resources tab layout](../../images/CBA_IM_11a.PNG)
853843

854844

855845

@@ -885,7 +875,7 @@ On the scene of an incident the Incident Commander has to document many things,
885875

886876

887877

888-
![Navigate to the SharePoint developer site](images/CBA_IM_8a.PNG)
878+
![Navigate to the SharePoint developer site](../../images/CBA_IM_8a.PNG)
889879

890880

891881

@@ -918,7 +908,7 @@ On the scene of an incident the Incident Commander has to document many things,
918908

919909

920910

921-
![Document library with IncidentNumber column](images/CBA_IM_12.PNG)
911+
![Document library with IncidentNumber column](../../images/CBA_IM_12.PNG)
922912

923913

924914
In order to associate the document library with your add-in, the document library must contain a custom column that maps to a unique field in your entity. In this case the **IncidentNumber** column maps to the **IncidentNumber** field in the **Incidents** entity.
@@ -943,7 +933,7 @@ On the scene of an incident the Incident Commander has to document many things,
943933

944934

945935

946-
![Select the document library](images/CBA_IM_13.PNG)
936+
![Select the document library](../../images/CBA_IM_13.PNG)
947937

948938

949939
An **IncidentDocuments.lsml** node is added to Solution Explorer.
@@ -971,7 +961,7 @@ On the scene of an incident the Incident Commander has to document many things,
971961

972962

973963

974-
![The relationship between entities](images/CBA_IM_11b.PNG)
964+
![The relationship between entities](../../images/CBA_IM_11b.PNG)
975965

976966

977967

@@ -989,7 +979,7 @@ On the scene of an incident the Incident Commander has to document many things,
989979

990980

991981

992-
![The associated fields](images/CBA_IM_11c.PNG)
982+
![The associated fields](../../images/CBA_IM_11c.PNG)
993983

994984

995985

@@ -1027,7 +1017,7 @@ On the scene of an incident the Incident Commander has to document many things,
10271017

10281018

10291019

1030-
![Button to create or upload documents](images/CBA_IM_14.PNG)
1020+
![Button to create or upload documents](../../images/CBA_IM_14.PNG)
10311021

10321022

10331023

@@ -1051,7 +1041,7 @@ On the scene of an incident the Incident Commander has to document many things,
10511041

10521042

10531043

1054-
![The SharePoint Create a new file dialog](images/CBA_IM_15.PNG)
1044+
![The SharePoint Create a new file dialog](../../images/CBA_IM_15.PNG)
10551045

10561046

10571047

@@ -1073,7 +1063,7 @@ On the scene of an incident the Incident Commander has to document many things,
10731063

10741064

10751065

1076-
![The file name](images/CBA_IM_16.PNG)
1066+
![The file name](../../images/CBA_IM_16.PNG)
10771067

10781068

10791069
This will be used as the file name for the document.
@@ -1113,7 +1103,7 @@ The Contoso Fire Department is pleased with the additions to the Incident Manage
11131103

11141104

11151105

1116-
![The logo and splash screen files](images/CBA_IM_17.PNG)
1106+
![The logo and splash screen files](../../images/CBA_IM_17.PNG)
11171107

11181108

11191109

@@ -1261,7 +1251,7 @@ So far you've only run the add-in in Debug mode, which uses SharePoint to provid
12611251

12621252

12631253

1264-
![The IncidentManager node](images/CBA_IM_18.PNG)
1254+
![The IncidentManager node](../../images/CBA_IM_18.PNG)
12651255

12661256

12671257
The **LightSwitch Publish Application Wizard** appears.
@@ -1273,7 +1263,7 @@ So far you've only run the add-in in Debug mode, which uses SharePoint to provid
12731263

12741264

12751265

1276-
![The Publish wizard](images/CBA_IM_19.PNG)
1266+
![The Publish wizard](../../images/CBA_IM_19.PNG)
12771267

12781268

12791269
When your add-in is published, **File Explorer** appears and displays the **Publish** folder for your project.
@@ -1288,7 +1278,7 @@ So far you've only run the add-in in Debug mode, which uses SharePoint to provid
12881278

12891279

12901280

1291-
![The Apps in Test list](images/CBA_IM_20.PNG)
1281+
![The Apps in Test list](../../images/CBA_IM_20.PNG)
12921282

12931283

12941284

@@ -1303,7 +1293,7 @@ So far you've only run the add-in in Debug mode, which uses SharePoint to provid
13031293

13041294

13051295

1306-
![The Deploy App dialog](images/CBA_IM_20a.PNG)
1296+
![The Deploy App dialog](../../images/CBA_IM_20a.PNG)
13071297

13081298

13091299
The **Upload Add-in** dialog box opens.
@@ -1328,7 +1318,7 @@ So far you've only run the add-in in Debug mode, which uses SharePoint to provid
13281318

13291319

13301320

1331-
![App is installing](images/CBA_IM_21.PNG)
1321+
![App is installing](../../images/CBA_IM_21.PNG)
13321322

13331323

13341324

@@ -1343,7 +1333,7 @@ So far you've only run the add-in in Debug mode, which uses SharePoint to provid
13431333

13441334

13451335

1346-
![App is installing](images/CBA_IM_22.PNG)
1336+
![App is installing](../../images/CBA_IM_22.PNG)
13471337

13481338

13491339

@@ -1358,7 +1348,7 @@ So far you've only run the add-in in Debug mode, which uses SharePoint to provid
13581348

13591349

13601350

1361-
![The app is ready to run](images/CBA_IM_23.PNG)
1351+
![The app is ready to run](../../images/CBA_IM_23.PNG)
13621352

13631353

13641354
The add-in opens in the browser and looks exactly the same as when you ran the add-in in Debug mode. Notice that the data you entered during development is gone. When deploying the add-in, the database is deployed but not the data.
@@ -1373,7 +1363,7 @@ So far you've only run the add-in in Debug mode, which uses SharePoint to provid
13731363

13741364

13751365

1376-
![Layout in desktop browser](images/CBA_IM_24.PNG)
1366+
![Layout in desktop browser](../../images/CBA_IM_24.PNG)
13771367

13781368

13791369
You can also verify your add-in on a mobile device. Sign in to your SharePoint site from the web browser on your device, and then start the add-in.
@@ -1385,7 +1375,7 @@ So far you've only run the add-in in Debug mode, which uses SharePoint to provid
13851375

13861376

13871377

1388-
![Layout on mobile device](images/CBA_IM_25.PNG)
1378+
![Layout on mobile device](../../images/CBA_IM_25.PNG)
13891379

13901380

13911381

0 commit comments

Comments
 (0)