Method RetrieveUserFuncAuth

Summary

Retrieve User Function Authority

Remarks

This API provides the ability to a third-party vendor to determine what CST NaviLine functions a specific user is authorized to perform with the BMI barcoding software. The “Out_Functs” parameter is a positionally based parameter that defines whether a user is authorized to a specific CST application function on the client system.It is intended to be used by the third party to condition any functionality associated with that function on the barcode scanning device, i.e.whether enable the functionality or not. Defined positional representation values for CST user authorized functions:

Input Parameters

NameTypeLengthDescription
userID System.String 10 [Required] IBM i user ID – must be defined in menu driver

Example

POST http://localhost/FusionServices/v3/Naviline/BarCode/UserFuncAuth

Return Values

NameDescription
OUT_APPS YYYYNNNNNNNNNNNNNNNN
OUT_ERRCDE 0000
OUT_ERRDSC Successful

Sample Responses

Sample Code

using System.Net;
using Newtonsoft.Json.Linq;

public void MethodName(parms)
{
   string uri = "http://localhost/FusionServices/v3/Naviline/BarCode/UserFuncAuth";
   System.Collections.Specialized.NameValueCollection postParms = 
     new System.Collections.Specialized.NameValueCollection(); 
   // Set paramater values
   postParms.Add("userID",System.Web.HttpUtility.UrlEncode("QALW"));

   WebClient req = new WebClient();
   wc.Headers.Add("Content-Type", "application/x-www-form-urlencoded");
   wc.Headers.Set("X-APPID", "YOURID");
   wc.Headers.Set("X-APPKEY", "YOURKEY");

   byte[] responseBytes = wc.UploadValues(new Uri(uri), "POST", postParms);
   string stringResult = Encoding.UTF8.GetString(responseBytes); 
   JObject response = JObject.Parse(stringResult);
   string error = response["OutputParms"]["ErrorCode"].ToString();
   if (error == "0000")
   {
         // TODO - YOUR CODE HERE
   }
}

C# Razor MVC Sample Code

using System;
using System.Linq;
using System.Web;
using System.ComponentModel.DataAnnotations;
using System.Collections.Specialized;
using FusionServiceHelper.Models;

// NOTE: Use the namespace generated when you add the class, so that it is correct.
namespace FusionRazor.Models
{
   public class RetrieveUserFuncAuth
   {
       // Add property for each input param in order to map a field to it
       [Required(ErrorMessage = "Required")]
       [RegularExpression("^(?=.{0,10}$).*", ErrorMessage = "Must be 10 characters or less. ")]
       public string userID{get; set;}

       public RetrieveUserFuncAuth()
       {
           //Set any defaults here
       }
   }
}
@* NOTE: Use Add->View to add the View. *@
@* NOTE: Check the 'Create strongly-typed view checkbox, and select the RetrieveUserFuncAuth class. *@
@* NOTE: Select Edit as the Scaffold template. *@
@* NOTE: Use the @model line that is generated at the top.  Replace the rest with the lines below.
@model FusionRazor.Models.RetrieveUserFuncAuth

@{
   ViewBag.Title = "RetrieveUserFuncAuth";
}

<h2>RetrieveUserFuncAuth</h2>
@using (Html.BeginForm()) {
   @Html.AntiForgeryToken()
   @Html.ValidationSummary(true)
   <fieldset>
   <legend>RetrieveUserFuncAuth</legend>
       <div class="editor-label">
           @Html.LabelFor(model => model.userID)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.userID)
           @Html.ValidationMessageFor(model => model.userID)
       </div>
       <p>
       <input type="submit" value="Submit"/>
       </p>
   </fieldset>

}

@section Scripts {
   @Scripts.Render("~/bundles/jqueryval")
}
using System;
using System.Collections.Specialized;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using FusionServiceHelper.Models;

// NOTE: Replace 'MyController' with the name of your controller.

// 
// GET: /MyController/RetrieveUserFuncAuth
public ActionResult RetrieveUserFuncAuth()
{
   // Create a new instance of the model to pick up any default values.
   RetrieveUserFuncAuth model =  new RetrieveUserFuncAuth();

   // pass model to set to default values
   // NOTE: Change 'MyFolderPath' to the path to the .cshtml file.
   return View("~/Views/MyFolderPath/RetrieveUserFuncAuth.cshtml", model);
}

// 
// POST: /MyController/RetrieveUserFuncAuth
[HttpPost]
public ActionResult RetrieveUserFuncAuth(FormCollection collection)
{
   string url = "v3/Naviline/BarCode/UserFuncAuth";
   // Get the value from each input field
   NameValueCollection inputParms = new NameValueCollection();
   inputParms.Add("userID", collection["userID"]);

   try
   {
       // Send the request
       FusionServiceRequest request = new FusionServiceRequest();
       FusionServiceResult result = request.Post(url, inputParms);

       return View("Result", result);
   }
   catch(Exception e)
   {
       HandleErrorInfo info = new HandleErrorInfo(e, "MyController", "RetrieveUserFuncAuth");
       return View("Error", info);
   }
}