Accessing a List from a Different Site

Screenshot

How to Deploy

1. In the Management Apps tab of AppManager, click on SiteCreator. Select Digital Workplace Department Site. Create your subsite with the values in the Subsite section of this document. Click ‘Deploy All’.
2. Create the Sample_AK list within your newly created ‘Sample’ subsite. The Sample_AK list will need an additional text field called ‘Value’
3. Download digitalworkplace.custom.js from the “/Style Library/DigitalWorkplace/JS” folder within SharePoint
4. Paste the Customdataload Callback within digitalworkplace.custom.js
5. Upload the updated digitalworkplace.custom.js to the “/Style Library/DigitalWorkplace/JS” folder within SharePoint
6. Only if you have not completed the Hello World example on this site: In the Management Apps tab of AppManager, click on the View Manager. Click “Add New”. In the left pane navigate to “/DigitalWorkplace/Content/Templates/” for the folder path. Click “Choose File”, navigate to your custom template (ListItems.html). Click “Save”.
7. Only if you have not completed the Hello World example on this site: In the Management Apps tab of AppManager, click on the Widget Manager app. Then in the list of Widgets find the GenericList widget. Click Edit. Add our newly added templates to the WidgetViews field. Refer to the values in the Widget Manager – Widget Definition section
8. In the Manage Widgets window, find the GenericList widget and click its ‘View Instances’ button. Then click on ‘Add New’. Create your widget instance with the values in the Widget Manager – Widget Instance section. Click Save & Exit
9. Copy the Widget Snippet of your Widget Instance.
10. Paste the snippet into a Content Editor Web Part on a page within your root Akumina Foundation Site. Publish the page.
11. Flush your cache by clicking on the Akumina icon in the left rail, clicking the refresh icon, then clicking “Refresh All Cache”
12. Refresh the page. You will see your widget displaying items from Sample_AK

Subsite

The Title of the site to be created

Sample

The URL of the site to be created

Sample

Inherit permissions from the parent site

Checked

List

Customdataload Callback

function CustomDataloadFromSite(listRequest, def) {
	me = this;
    Akumina.AddIn.Logger.WriteInfoLog('CustomDataloadFromSite');
    if (listRequest.dataLoadProperties == null || listRequest.dataLoadProperties == '') {
        listRequest.dataLoadProperties = "{'site':''}";
    }
    var siteProperties = JSON.parse(listRequest.dataLoadProperties.replace(/'/g, "\""));
    var targetSite = siteProperties.site;

    GetListItemsFromSite(listRequest, targetSite, def);
}

function GetListItemsFromSite(listRequest, site, def) {
    var siteName = site;

    var utils = Akumina.AddIn.Utilities;
    var web;
    var context = new SP.ClientContext(_spPageContextInfo.siteServerRelativeUrl + "/" + siteName);//.get_current();

    web = context.get_web();

    var list = web.get_lists().getByTitle(listRequest.listName);
    var camlQuery = new SP.CamlQuery();
    var query = listRequest.viewXml;
    if (utils.IsNullOrEmpty(query)) {
        query = SP.CamlQuery.createAllItemsQuery();
    }
    camlQuery.set_viewXml(query);
    listRequest.listItems = list.getItems(camlQuery);
    if (!utils.IsNullOrEmpty(listRequest.selectFields)) {
        context.load(listRequest.listItems, 'Include(' + listRequest.selectFields + ')');
    } else {
        listRequest.listFields = list.get_fields();
        context.load(listRequest.listFields);
        context.load(listRequest.listItems);
    }
    context.executeQueryAsync(
		Function.createDelegate(me, function () { SubsiteDataSuccesshandler(listRequest, def); }),
		Function.createDelegate(me, function (sender, args) {
		    Akumina.AddIn.Logger.WriteErrorLog('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
		    SubsiteDataErrorhandler(listRequest, def);
		})
	);
}

function SubsiteDataSuccesshandler(listRequest, def) {
	var listEnumerator = listRequest.listItems.getEnumerator();
	var result = {};
	result.Items = [];
	result.ListName = listRequest.listName;
	
	while (listEnumerator.moveNext()) {
        var listItem = listEnumerator.get_current();
		var item = {};
        if (typeof listRequest.listFields != 'undefined') {
            var fields = listRequest.listFields.getEnumerator();
            while (fields.moveNext()) {
                var fieldName = fields.get_current().get_staticName();
                if (!Akumina.AddIn.Configuration.containsInExcludeField(fieldName)) {// containsInExcludeFieldForGenericItem(fieldName)) {
                    item[fieldName] = listItem.get_item(fieldName);
                }
            }
        }
        else {
            var fields = listRequest.selectFields.split(',');
            for (var i = 0; i < fields.length; i++) {
                var fieldName = fields[i];
                if (!Akumina.AddIn.Configuration.containsInExcludeField(fieldName)) {
                    item[fieldName] = listItem.get_item(fieldName);
                }
            }
        }
        item =
		{
		    "Key": item["Title"],
			"Value": item["Value"]
		}

		result.Items.push(item);
    }
	
	def.resolve({ response: result });
   
}
	
function SubsiteDataErrorhandler(listRequest, def) {
	def.reject();
}

Template

We will be using the ListItems.html template from the Hello World Sample

Widget Manager - Widget Definition

We are using the same view as the Hello World Sample

Widget Manager - Widget Instance

Title

SampleSite – ListItems Custom

WidgetProperties

selectfields

Title,Value

List Name

Sample_AK

callbackmethod

CustomDataloadFromSite

callbacktype

customdataload

dataloadproperties

{‘site’:’Sample’}

WidgetOptions

ListItems

Display View

Checked

Selected View

Selected

Widget Manager - Widget Snippet

References

See the articles below for more on the Customdataload callback

• Hello World
• Overview
• Accessing a List
• Third Party Data