assembly information
voordat de web part code op de server kan worden uitgevoerd, moet het web part als safe control geregistreerd zijn op de server. hiervoor moeten we het voorzien van een strong name. met de strong name tool (sn.exe) maken we een keyfile aan, die we aan het project toevoegen. de enige aanpassing die we hoeven te doen aan de assembly information is het verwijzen naar de keyfile.
bijvoorbeeld: [assembly: assemblykeyfile("..\\..\\sdgn.snk")]
web part opleveren op de server
web parts worden deployed in web part packs: cab files die je met behulp van een setup project kunt maken. deze web part packs kunnen op de sharepoint server worden geregistreerd met de tool stsadm.exe.
om het web part op te leveren voegen we eerst een setup project toe aan de web part solution. aan deze cab file voegen we toe: de primary output van het web part project, het manifest en de web part definitie file. (wanneer je in de classresources tag van het manifest bestandsnamen hebt ingevuld, moet je deze ook aan de cab file toevoegen.)
fig. 10: setup project
met de tool stsadm.exe registreren we de cab file op de server. wanneer je gebruik maakt deze tool wordt het web part automatisch aan de safecontrols verzameling toegevoegd in web.config. om alle code in het webpart uit te kunnen voeren, wijzigen we het trust-level in web.config het trus-tlevel dat nodig is voor het uitlezen van de ingelogde user is wss_medium (<trust level="wss_medium" originurl="" />).
wanneer je in je web part alleen html genereert, kun je het trust-level op wss_minimal laten staan.
let op: in de productieomgeving zal het niet wenselijk zijn om het trust-level te verruimen. dan zal gebruik gemaakt worden van “custom trust levels”, en wordt precies vastgelegd welke acties web parts op de server uit mogen voeren.
we kunnen het web part nu registreren met stsadm. de tool stsadm staat in de folder <root>:\program files\common files\microsoft shared\web server extensions\60\bin. het registreren van het web part kan met stsadm –o addwppack –f cabname (zie figuur 11).
wanneer een web part geregistreerd is, kan het na wijzigingen met de force parameter opnieuw geregistreerd worden. met de operation deletewppack kunnen web parts van de server verwijderd worden.
fig. 11: web part deployment m.b.v. stsadm
fig. 12: web part van de server verwijderen
conclusie
in dit artikel hebben we een web part ontwikkeld met behulp van een web part template.
we hebben de eigenschappen van dit web part aangepast in code en met behulp van het web part definition bestand. we hebben code toegevoegd aan de renderwebpart method, en het web part op de server geregistreerd met de tool stsadm. in de volgende artikelen over web part development zullen we ons web part project uitbreiden met nieuwe web parts met meer functionaliteit. zoals web parts met controls en connected web parts (web parts die samenwerken met andere web parts op de pagina).
