| page_type | products | languages | extensions | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sample |
|
|
|
Basic CRUD operations in SharePoint Add-ins using the JavaScript object model (JSOM) APIs
SharePoint add-in model is considered as a legacy option for extending SharePoint user interface. Please see SharePoint Framework documentation and the SharePoint Framework samples for the future proven option to extend SharePoint Online. Possible backend services should be using Azure Active Directly based registration and related app models.
Summary
Use the SharePoint JavaScript object model (JSOM) to perform create, read, update, and delete operations on website properties, lists, and list items from a SharePoint Add-in.
Applies to
- SharePoint Online and on-premise SharePoint 2013 and later
Prerequisites
This sample requires the following:
-
A SharePoint 2013 development environment that is configured for app isolation. (A SharePoint Online Developer Site is automatically configured. For an on premise development environment, see Set up an on-premises development environment for SharePoint Add-ins.)
-
Visual Studio and the Office Developer Tools for Visual Studio installed on your developer computer
Description of the code
The code that uses the JSOM APIs is located in the App.js and AppUIEvents.js file of the project. (The sample was created when SharePoint Add-ins were called "apps for SharePoint".) The top of the BasicTasksJSOM.html page of the add-in appears after you install and launch the add-in and looks similar to the following.
The sample demonstrates the following:
-
How to read and write data to and from the add-in web of a SharePoint Add-in using the SharePoint JavaScript object model libray (JSOM).
-
How to load the data returned from SharePoint into the client context object and then display the data.
To use the sample
- Open Visual Studio as an administrator.
- Open the .sln file.
- In Solution Explorer, highlight the SharePoint add-in project and replace the Site URL property with the URL of your SharePoint developer site.
- Press F5. The add-in is installed and opens to its start page.
- Each section of the start page describes the code for a programming task. There is a link that enables you to view the code and a button that enables you to execute the code. In some cases data appears right on the start page. In other cases, instructions appear that tell how to see the new or changed data.
Questions and comments
We'd love to get your feedback on this sample. You can send your questions and suggestions to us in the Issues section of this repository.
## Additional resourcesComplete basic operations using JavaScript library code
Copyright
Copyright (c) Microsoft. All rights reserved.
This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.