arquivos mensuais: Xullo 2007

Moss: Iteración mediante listas personalizadas e retornando datos filtrados para InfoPath

Escenario empresarial:

Proporcionar un método que permite que os usuarios insiran as solicitudes de compra precisos axiña.

Problema de negocio:

O cliente fai negocios con centos de empresas.

Vendors are "type" específico. Isto significa que un provedor vende equipamento informático (e.g. Dell) ou material de oficina (e.g. Staples).

Como podemos permitir que os usuarios finais que crear solicitudes de compra seleccionar un provedor válido?

Business Solution:

Differentiate vendors in the system via "type".

Enable users to select the "type" de produto e, a continuación, proporcionar un conxunto de filtración de provedores axeitados.

Solución Técnica:

Un formulario do InfoPath foi deseñado que permite que os usuarios insiran as solicitudes de compra en liña.

Dúas listas de selección de selección de provedores control InfoPath. Primeiro, the user selects a "purchase type". This limits a second selection list to contain only vendors that sell for that purchase type. This is a classic cascading drop-down.

Os vendedores están gardados nunha lista personalizada Moss con columnas personalizadas para os atributos de provedores, como nome, address and especially "type".

Implement a web service for an InfoPath client to consume that iterates through the custom vendor list, returning only vendors matching a supplied "type".

Invoke the web service via the InfoPath form.

Leccións aprendidas:

  • Primeiro, it seems necessary to go this route. I would have preferred to do the filtering entirely within InfoPath and not create any web service functionality here. Con todo, forms server does not provide the required filtering capability. We can put a rule onto a the "type" selection list in the form to sort of re-open the vendor query, but we can’t get it to work properly. Polo tanto, it was necessary to implement the web service.
  • This is a classic "cascading selection list" problem in the InfoPath forms server world and there are many good examples out there that explain how to solve this.
  • A blank value for a column in the vendor list does not return an empty string when referenced like this: initItem["Vendor Name"]. Pola, it returns a null.

Some other Notes:

  • I return an array[] of vendors because I had some difficulty returning an ArrayList. InfoPath was complaining about it and I didn’t have the time or the inclination to fight over it. Este, claro, puts an artificial limit on the total number of vendors. It also compelled me to implement a trim() method on the array because I hate the idea of returning back 100’s of null vendors. InfoPath doesn’t care, but it nagged at me. (De novo, this was easier than fighting InfoPath over ArrayLists).
  • I implemented a GetSpecificVendorByName() function as well, which may be instructive.

O código:

utilización Sistema;
utilización System.Web;
utilización System.Web.Services;
utilización System.Web.Services.Protocols;
utilización Microsoft.SharePoint;
utilización System.Configuration;

/// <resumo>
///
Vendor Service: Provides vendor related services which today are consumed by an infopath client form.
///
/// History:
/// ——–
/// 07/24/07: Initial coding, Paul J. Gavin of Conchango.
///
/// </resumo>
[WebService(Namespace = "Http://www.conchango.com/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
público clase VendorService : System.Web.Services.WebService
{

/// <resumo>
/// Represents a vendor from a custom sharepoint list maintained by MSUSA.
/// </resumo>
público clase Vendor
{
público Vendor() { }

público Vendor(SPItem initItem)
{
se (! (initItem["Vendor Name"] == nulo)) VendorName = initItem["Vendor Name"].ToString();
se (! (initItem["Address 1"] == nulo)) VendorAddress1 = initItem["Address 1"].ToString();
se (! (initItem["Address 2"] == nulo)) VendorAddress2 = initItem["Address 2"].ToString();
se (! (initItem["City"] == nulo)) VendorCity = initItem["City"].ToString();
se (! (initItem["VendorPhone"] == nulo)) VendorPhone = initItem["VendorPhone"].ToString();
se (! (initItem["PurchaseType"] == nulo)) VendorType = initItem["PurchaseType"].ToString();
se (! (initItem["State"] == nulo)) VendorState = initItem["State"].ToString();
se (! (initItem["Zip"] == nulo)) VendorZip = initItem["Zip"].ToString();
se (!(initItem["Fax"] == nulo)) VendorFax = initItem["Fax"].ToString();
se (!(initItem["SalesRepName"] == nulo)) VendorSalesRepName = initItem["SalesRepName"].ToString();

VendorItemId = initItem.ID; // Unique ID maintained via MOSS.
}

público int VendorItemId;
público corda VendorName;
público corda VendorAddress1;
público corda VendorAddress2;
público corda VendorCity;
público corda VendorState;
público corda VendorZip;
público corda VendorPhone;
público corda VendorType;
público corda VendorSalesRepName;
público corda VendorFax;
}

público VendorService () {

//Uncomment the following line if using designed components
//InitializeComponent();
}

privado Vendor[] GenerateTestVendors()
{
Vendor[] resultList;
resultList = novo Vendor[100];

Vendor v;
v = novo Vendor();
v.VendorAddress1 = "v1_address1";
v.VendorAddress2 = "v1_address2";
v.VendorCity = "v1_city";
v.VendorName = "v1_vendorname";
v.VendorPhone = "v1_vendorphone";
v.VendorState = "v1_st";
v.VendorType = "v1_type";
v.VendorZip = "v1_zip";

resultList[0] = v;

v = novo Vendor();

v.VendorAddress1 = "v2_address1";
v.VendorAddress2 = "v2_address2";
v.VendorCity = "v2_city";
v.VendorName = "v2_vendorname";
v.VendorPhone = "v2_vendorphone";
v.VendorState = "v2_st";
v.VendorType = "v2_type";
v.VendorZip = "v2_zip";

resultList[1] = v;

v = novo Vendor();
v.VendorAddress1 = "v3_address1";
v.VendorAddress2 = "v3_address2";
v.VendorCity = "v3_city";
v.VendorName = "v3_vendorname";
v.VendorPhone = "v3_vendorphone";
v.VendorState = "v3_st";
v.VendorType = "v3_type";
v.VendorZip = "v3_zip";

resultList[2] = v;

volver resultList;

}

[WebMethod]
público Vendor GetSpecificVendorById(int vendorId)
{
corda SpVendorSiteName; // Name of the actual MOSS site that hosts the vendor custom list.
corda SpVendorListName; // Name of the actual MOSS list containing vendors.

SpVendorSiteName = ConfigurationSettings.AppSettings["VendorListHostingSite"].ToString();
SpVendorListName = ConfigurationSettings.AppSettings["VendorList"].ToString();

utilización (SPSite site = novo SPSite(SpVendorSiteName))
{

utilización (SPWeb web = site.OpenWeb())
{

SPList currentList = web.Lists[SpVendorListName];

SPItem specificItem = currentList.Items[vendorId];

volver novo Vendor(specificItem);

} // using spweb web = site.openweb()
} // using spsite site = new spsite("Http://localhost/mizuho")

}

[WebMethod]
// Assumes that the vendor name is unique, from a business perspective
público Vendor GetSpecificVendorByVendorName(corda vendorName)
{
corda SpVendorSiteName; // Name of the actual MOSS site that hosts the vendor custom list.
corda SpVendorListName; // Name of the actual MOSS list containing vendors.

SpVendorSiteName = ConfigurationSettings.AppSettings["VendorListHostingSite"].ToString();
SpVendorListName = ConfigurationSettings.AppSettings["VendorList"].ToString();

utilización (SPSite site = novo SPSite(SpVendorSiteName))
{
utilización (SPWeb web = site.OpenWeb())
{

SPList currentList = web.Lists[SpVendorListName];

foreach (SPItem vendorItem en currentList.Items)
{
se (vendorItem["Vendor Name"] == nulo) continuar;

se (vendorItem["Vendor Name"].ToString().Igual(vendorName))
volver novo Vendor(vendorItem);
}

Vendor v = novo Vendor();
v.VendorPhone = "not found: " + vendorName;

volver v;

volver nulo;

} // using spweb web = site.openweb()
} // using spsite site = new spsite("Http://localhost/mizuho")

} // método

[WebMethod]
público Vendor[] GetVendorsOfType (corda filterType)
{

corda SpVendorSiteName; // Name of the actual MOSS site that hosts t
he vendor custom list.
corda SpVendorListName; // Name of the actual MOSS list containing vendors.

SpVendorSiteName = ConfigurationSettings.AppSettings["VendorListHostingSite"].ToString();
SpVendorListName = ConfigurationSettings.AppSettings["VendorList"].ToString();

Vendor[] resultList;
int vendorIndex = 0;
resultList = novo Vendor[1000];

// Initialize the list with a default friendly message.
Vendor v = novo Vendor();
v.VendorName = "Select a vendor type to populate this list.";
resultList[0] = v;

// Convert the filter to lower case for easier string comparison later.
filterType = filterType.ToLower();

// If the filter type passed is "test", generate some simple data.
#rexión Filter type = "test"
se (filterType.Equals("test"))
volver GenerateTestVendors();
#endregion

se (certo)
{
utilización (SPSite site = novo SPSite(SpVendorSiteName))
{
utilización (SPWeb web = site.OpenWeb())
{

v = nulo;

SPList currentList = web.Lists[SpVendorListName];

// Iterate through all the items in the vendor list.
foreach (SPItem vendorItem en currentList.Items)
{

corda lowerVendorType;

lowerVendorType = vendorItem["PurchaseType"].ToString().ToLower();
lowerVendorType = lowerVendorType.Substring(3);

se (lowerVendorType.Equals(filterType))
{
resultList[vendorIndex ] = novo Vendor(vendorItem);
}
} // iterating thru all the vendors in the list


volver TrimVendorArray(vendorIndex, resultList);
// return resultList;

} // using spweb web = site.openweb()
} // using spsite site = new spsite("Http://localhost/mizuho")

} // if true

volver nulo;
}

privado Vendor[] TrimVendorArray(int newsize, Vendor[] originalVendorArray)
{
Vendor[] trimmedArray;

se (newsize == 0) newsize = 1;
trimmedArray = novo Vendor[newsize];

int currentCounter = 0;

para (currentCounter = 0; currentCounter < newsize; currentCounter )
{
trimmedArray[currentCounter] = originalVendorArray[currentCounter];
}

volver trimmedArray;

}
}

Moss: Observacións sobre a depuración InfoPath

Mensaxes de erro do servidor de formulario do InfoPath son enganosas.

Durante o desenvolvemento dun formulario do InfoPath, Quere publicar-la para o servidor Moss e acceder ao formulario. A forma comezaría a cargar e logo, xerar unha mensaxe de erro erro me no rexistro de eventos de Windows apuntando para máis detalles. En realidade, ningunha mensaxe foi gravada no rexistro de eventos de Windows. Moi, a mensaxe foi enviada o rexistro de diagnóstico ASCII Moss. Pode seguir o que se vía central de administración de servizos de.

Ten que ser rápido nos seus pés. Moss desexa escribir no ficheiro de rexistro, miúdo e con detalle. This can be trimmed but the default log writing behavior is "everything as quickly as possible".

Moss: Actualizar a lista personalizada

Hai moitos bos exemplos de actualizar as listas personalizadas a través do SDK. Aquí está aínda outra.

Problema de negocio: Formulario InfoPath foi deseñado que permite que os usuarios insiran as solicitudes de compra en liña. Números petición PO debe ser valores enteiros baseados en secuencias tradicionais e calcula automaticamente.

Business Solution: Crear unha lista MOSS personalizado que contén dúas columnas: "ControlField" and "ControlValue". O valor da columna contén o seguinte número da petición de compra. Note that the generic "control" convención de nomenclatura prevé campos de control futuros que poden ser utilizados segundo a necesidade.

Solución Técnica: Crear un servizo de web acceder polo cliente InfoPath. O servizo web devolve o seguinte número da petición de compra e actualiza o valor da lista.

Leccións aprendidas:

  • Engadindo este servizo web como fonte de datos para o formulario do InfoPath, Eu penso necesario convertelo en un UDC e almacena-lo nunha biblioteca de conexión de datos.
  • Eu tamén penso que é necesario para permitir cruz dominio script vía central de administración de servizos de // xestión de aplicacións // configuración do servidor de forma.
  • A primeira vez que o formulario intentou acceder o servizo web, leva un tempo e de cando en vez, sería o tempo de espera. Eu xogaba con as opcións de configuración do servidor de forma a ampliar a configuración de tempo de espera e que parecía axudar.

O código:

utilización Sistema;
utilización System.Web;
utilización System.Web.Services;
utilización System.Web.Services.Protocols;
utilización Microsoft.SharePoint;
utilización System.Configuration;

[WebService(Namespace = "Http://www.conchango.com/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
público clase PoService : System.Web.Services.WebService
{
público PoService () {

//Uncomment the following line if using designed components
//InitializeComponent();
}

/// <resumo>
/// Obtain the next PO number from the sharepoint po number control list.
/// Increment the PO number in that list.
/// </resumo>
/// <returns></returns>
[WebMethod]
público corda GetNextPoNumber()
{
corda SpPoControlSiteName; // Name of the actual MOSS site that hosts the PO Control list.
corda SpPoControlListName; // Name of the actual MOSS list containing the Po control.

SpPoControlSiteName = ConfigurationSettings.AppSettings["PoControlListHostingSite"].ToString();
SpPoControlListName = ConfigurationSettings.AppSettings["PoControlList"].ToString();

corda nextPoReqNumber = "Xyzzy";

utilización (SPSite site = novo SPSite(SpPoControlSiteName))
{
utilización (SPWeb web = site.OpenWeb())
{

SPList currentList = web.Lists[SpPoControlListName];

foreach (SPItem controlItem en currentList.Items)
{

se (((corda)controlItem["ControlField"]).Igual("NextPoNumber"))
{
nextPoReqNumber = (corda)controlItem["ControlValue"];

int int_nextPoReqNumber;
int_nextPoReqNumber = Converter.ToInt32(nextPoReqNumber);

int_nextPoReqNumber ;

controlItem["ControlValue"] = int_nextPoReqNumber;
controlItem.Update();
}

} // Locating, reading and updating the PO number in the list.


} // using spweb web = site.openweb()
} // using spsite site = new spsite("Http://localhost/mizuho")

volver nextPoReqNumber;

}
}