存储SharePoint托管应用的属性

Question

我试图在SharePoint托管应用中存储键/值对，以确定最好的 - 或者实际上是任何工作方式。对需要：

• 启动时加载，如果设置存在，否则使用默认值。
• 按需创建 - 即。用户可以在UI中添加新设置，然后在代码中的其他位置使用该设置进行更改。例如，使用自定义文本字符串作为列表名称，而不是应用程序的默认设置。

我尝试过使用PropertyBag，但在尝试写入时遇到“拒绝访问”错误。

我还试图使用列表，但在使该技术正常工作方面遇到了问题。

有没有人建议采用好的方法以及如何完成。如果这些是最好的方式，我很乐意重新审视我已经尝试过的技术。

请注意，此问题应仅限于与SharePoint托管的应用程序一起使用的内容。这意味着C＃和服务器端代码都没有了。

Answer 1

以下是我最终使用的解决方案 - 将设置存储在应用主机网站的列表中。

它由以下几个功能组成。

<强> CreateSettingsList：

Create创建一个包含Title和Value字段的普通列表，我用它来存储设置名称和与之关联的值。这在文档就绪函数中被调用，以确保已经创建了一个列表，如果已经有一个列表，它会继续并尝试从中读取。如果之前没有列表，我调用一个函数来初始化列表中的默认变量值。

//___________________________________Create settings list________________________________________       
function createSettingsList()
{   
    // Create a SharePoint list with the name that the user specifies.
    var hostUrl = decodeURIComponent(getQueryStringParameter("SPHostUrl"));
    var hostContext = new SP.AppContextSite(currentContext, hostUrl);
    var hostweb = hostContext.get_web();

    var listCreationInfo = new SP.ListCreationInformation();

    //title the list
    listCreationInfo.set_title("PTOAppSettings");

    //set the base type of the list
    listCreationInfo.set_templateType(100); //generic list
    listCreationInfo.set_description("A list for custom app settings. If you have uninstalled the Paid Time Off App with no intention of reinstalling, this list can be safely deleted.");

    var lists = hostweb.get_lists();
    //use the creation info to create the list
    var newList = lists.add(listCreationInfo);

    var fieldCollection = newList.get_fields();

    //add extra fields (columns) to the list & any other info needed.
    fieldCollection.addFieldAsXml('<Field Type="Text" DisplayName="Value" Name="Value" />', true, SP.AddFieldOptions.AddToDefaultContentType);
    newList.update();

    currentContext.load(fieldCollection);
    currentContext.load(newList);
    currentContext.executeQueryAsync(onSettingsListCreationSuccess, onSettingsListCreationFail);     
}

function onSettingsListCreationSuccess(){   
    //All is well.
    initializeSettings();

}

function onSettingsListCreationFail(sender, args) {
    //alert("We didn't create the list. Here's why: " + args.get_message());

    //If a list already exists, we expect the creation to fail, and instead try to read from the existing one.
    getSetting("VAR_CCEmail");
}

<强>初始化：

Initialize为我将来可能存储的变量创建新的列表项。我将它们的值设置为＆＃34;＆＃34;如果他们没有被使用，则为null。

//___________________________________Initialize setting(s)________________________________________
function initializeSettings()
{
    //Get info to access host web
    var hostUrl = decodeURIComponent(getQueryStringParameter("SPHostUrl"));
    var hostContext = new SP.AppContextSite(currentContext, hostUrl);
    var hostweb = hostContext.get_web();

    //Get list in host web
    var lstObject = hostweb.get_lists().getByTitle("PTOAppSettings");

    //Prepare an object to add a new list item.
    var listItemCreationInfo = new SP.ListItemCreationInformation();
    var newItem = lstObject.addItem(listItemCreationInfo);

    //Create item. You should repeat this for all the settings you want to track.
    newItem.set_item('Title', "VAR_CCEmail");
    newItem.set_item('Value', "");

    //Write this new item to the list
    newItem.update();

    currentContext.executeQueryAsync(onListItemSuccess, onListItemFailure);

    function onListItemSuccess() {

        //Load customizations, if any exist
        getSetting("VAR_CCEmail");
    }

    function onListItemFailure(sender, args) {
        bootbox.dialog({
            title: "Something went wrong!",
            message: "We were unable to initialize the app settings! Here's what we know about the problem: " + args.get_message() + '\n' + args.get_stackTrace(),
            buttons: {
                success:{
                    label: "Ok"
                }
            }       
        });
    }
}

设置：

Set是一个相当简单的函数，它接受一个设置名称和一个值，并允许你更新存储在给定变量中的值。

//___________________________________Set setting________________________________________
function setSetting(setting, value){

    //Get info to access host web
    var hostUrl = decodeURIComponent(getQueryStringParameter("SPHostUrl"));
    var hostContext = new SP.AppContextSite(currentContext, hostUrl);
    var hostweb = hostContext.get_web();

    //Get list in host web
    var list = hostweb.get_lists().getByTitle("PTOAppSettings");

    //A caml query get the appropriate setting
    var queryXml = "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>" + setting + "</Value></Eq></Where></Query></View>"
    var query = new SP.CamlQuery();
    query.set_viewXml(queryXml);

    var items = list.getItems(query);

    currentContext.load(items);
    currentContext.executeQueryAsync(onListItemSuccess, onListItemFailure);  
    function onListItemSuccess() {      
        //looking up a specific setting should only return one item in the array.
        var item = items.getItemAtIndex(0);
        //update the value for the item.
        item.set_item("Value", value);

        item.update();
    }

    function onListItemFailure(sender, args) {
        bootbox.dialog({
            title: "Something went wrong!",
            message: "We were unable to set app settings! Here's what we know about the problem: " + args.get_message() + '\n' + args.get_stackTrace(),
            buttons: {
                success:{
                    label: "Ok"
                }
            }       
        });
    }
}

获取：

获取读取列表，找到您指定的设置，然后确定与该设置相关联的值＆＃34;＆＃34;或null或如果它是实际值。如果它是实际值，我将该值写入程序用于处理该设置的全局变量。

//___________________________________Get setting________________________________________
function getSetting(setting) {
var hostUrl = decodeURIComponent(getQueryStringParameter("SPHostUrl"));
var hostContext = new SP.AppContextSite(currentContext, hostUrl);
var hostweb = hostContext.get_web();
var list = hostweb.get_lists().getByTitle("PTOAppSettings");

//A caml query to get manager name for the record where user is equal to current user.
var queryXml = "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>" + setting + "</Value></Eq></Where></Query></View>"
var query = new SP.CamlQuery();
query.set_viewXml(queryXml);

var items = list.getItems(query);

currentContext.load(items);
currentContext.executeQueryAsync(
function() //on success.
{
    //get first (and only) item.
    var item = items.getItemAtIndex(0);     
    var value = item.get_item("Value");

    //If the property is empty it hasn't been set.
    if (value === "" || value === null){
        //Return null to the appropriate global variable. Not all of the settings in this switch are implemented in the program yet, but may be later.
        switch(setting) {
            case "VAR_PaidTimeOff":
                paidTimeOffListName = "";
                break;
            case "VAR_Contacts":
                contactsListName = "";
                break;
            case "VAR_CCEmail":
                carbonCopyEmail = "";
                break;
        }
    }
    else
    {
        //Return the value. Not all of the settings in this switch are implemented in the program yet, but may be later.
        switch(setting) {
            case "VAR_PaidTimeOff":
                paidTimeOffListName = value;
                break;
            case "VAR_Contacts":
                contactsListName = value;
                break;
            case "VAR_CCEmail":
                carbonCopyEmail = value;
                break;
        }
    }

}, 
function(sender,args){
    bootbox.dialog({
        title: "Something went wrong!",
        message: "We were unable to get app settings! Here's what we know about the problem: " + args.get_message() + '\n' + args.get_stackTrace(),
        buttons: {
            success:{
                label: "Ok"
            }
        }       
    });
}); 
}

这可以扩展到包括执行其他特殊任务的其他功能，例如你可以创建一个＆＃34; createSetting＆＃34;允许您动态添加新设置的功能（我在初始问题中提到的要求之一）。在我的例子中，初始化一组设置满足了我的需求，但其他人可能想要一种方法来写更多。