Wednesday, September 30, 2009

Sharepoint_Web_Services

Autor:André Lage
Publicação:__________
Download:Documento
(EN)TranslateLink

Windows Forms e Sharepoint Webservices

 

Olá pessoal,

Umas das dificuldade quando desenvolvemos aplicações de apoio ao SharePoint é realizar a necessidade de um servidor onde o SharePoint se encontra instalado, agora imaginem podes desenvolver ferramentas de apoio e acesso a dados em SharePoint, sem desenvolver no Servidor nem utilizar as DLLs de Sharepoint comoMicrosoft.SharePoint.dll”, a resposta é simples, utilizar Web Services. J.

Cenário:

Muitas vezes existe a necessidade de realizar aplicações no cliente de apoio ou Listagem de Dados em SharePoint com outros Bancos de dados para integração feita a medida.

Óptimo, como os Web Services de SharePoint podem ajudar?.... J

 

OverView

 

Microsoft SharePoint disponibiliza um conjunto de Web Services que servem de apoio a aplicação externas.

Web Services são métodos para listagem e apoio utilizando a o método SOAP e XML, bem utilizadas é uma ferramentas muito importante no teu desenvolvimento.

Os Web Services encontram-se no servidor onde o SharePoint está instalado:

%COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\ISAPI

Link com Lista dos WebServices que o SharePoint fornece http://msdn.microsoft.com/pt-br/library/bb862916.aspx.

Neste exemplo vou realizar uma aplicação em Windows Forms para Listar todos os utilizadores de um Site de SharePoint.

Para chamar o web services irei utilizar o método UserGroupque vou usar para Listar os utilizadores do Site.

Exemplo:

http://[url]/_vti_bin/UserGroup.asmx?WSDL

WebService2.JPG

Umas das funcionalidades do .Net é a capacidade de converter os nossos Web Services em Classes .Net...., isso mesmo que leu... J

Microsoft SharePoint para cada área Web Services com bastantes métodos que vão servir para apoio ao nosso desenvolvimento.

 

Conversão de WebService para Classe  .CS

 

PATH "C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\Bin"

wsdl.exe /l:CS /n:Empresa /out:C:\ListaSharepoint\UserGroup.cs http://[url]/_vti_bin/UserGroup.asmx?WSDL

Comandos:

/l: Linguagem que vai ser convertido “VB” ou “CS”

/n: Namespace da Class construída

/out: ficheiro convertido do webService

WebService1.JPG

Depois de utilizar a linha de comando para converter o Web Service em Class, podemos adicionar na nossa solução Windows Forms e utilizar os seus métodos para desenvolvimentos.

 

Windows Forms Listagem de utilizadores

 

Após adicionar a nova Classe podemos começar a utilizar o métodos para listar os nosso utilizadores, para utilizar conteúdo dos nossos Web Services será necessário utilizar classes de XML para retornar utilizadores.

 

WebService3.JPG

WebService4.JPG

 

Exemplo para Listagem utilizadores:

            UserGroup utilizadores = new UserGroup();

           

            //Site de Sharepoint a pesquisar utilizadores

            utilizadores.Url = String.Concat(TxtUrl.Text,"/_vti_bin/usergroup.asmx");

           

            //Credenciais do utilizador

            utilizadores.Credentials = CredentialCache.DefaultCredentials

            XmlNode userNodes = utilizadores.GetAllUserCollectionFromWeb();

 

            DataSet dsXML = new DataSet();

            using (XmlNodeReader reader = new XmlNodeReader(userNodes))

            {

                dsXML.ReadXml(reader);

            }

            String[] Username = new String[dsXML.Tables["User"].Rows.Count];

           

            //Listagem dos utilizadores

     for (int i = 0; i < dsXML.Tables["User"].Rows.Count; i++)

            {

                LstUtilizadores.Items.Add(dsXML.Tables["User"].Rows[i]["loginname"].ToString());

            }

            }

 

WebService.JPG

Feito, Listamos todos os utilizadores do site de SharePoint utilizando os Web Services de SharePoint, podem começar a fazer aplicação em Windows Forms, sem utilizar a DLL “Microsoft.SharePoint.dll”.

Em anexo fica o projecto.

Espero que tenham gostado, um grande abraço. J


Como criar um site SharePoint via STSADM

Autor:André Lage
Publicação:__________
Download:Documento
(EN)TranslateLink

Como criar um site SharePoint via STSADM

Como administrador e Arquiteto de Portais colaborativos SharePoint, umas das principais tarefas e criar a esqueleto do nosso sistema onde o site de SharePoint vai funcionar, antes de começar a realizar qualquer customização e desenvolvimento é necessário construir as fundações da nossa casa, nunca começar pelo telhado.

Microsoft forneceu Linhas de comandos via ms-dos, que tem as mesmas funções e melhoradas que as Paginas de Administração do SharePoint.

Podemos encontrar o executável na maquina de servidor onde se encontra o nosso SharePoint instalado.

C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\bin\stsadm.exe

 

How to:

Exemplo simples da nossa estrutura inicial.

Neste projecto exemplo, o cliente pretende criar um Portal para gestão das diversas áreas da empresa, cada uma tem regras de negocio e costumizaçoes diferentes.

Exemplo de uma área:



 

Assim que definimos as áreas e os desenhos como a estrutura podemos começar a pensar em criar o site.

Para detalhar cada passo da nossa arquitectura no SharePoint, podemos socorrer dos documentos que o TechNet da Microsoft nos disponibilizam para registo e suporte da nossa arquitectura.

http://technet.microsoft.com/en-us/library/cc262451.aspx

 

1º Passo será criar a nossa Aplicação Web, onde iremos trabalhar o nosso site de SharePoint

 

Exemplo pagina de Administração de SharePoint:

2.JPG

 

2º Caminho será definir os caminhos para as nossas colecções do Site

 

//Para isso podemos utilizar os comandos stsadm para criar os caminhos

stsadm -o addpath -url http://[site]/RH -type Explicitinclusion

stsadm -o addpath -url http://[site]/Administracao -type Explicitinclusion

stsadm -o addpath -url http://[site]/DF -type Explicitinclusion

Managed Paths

http://technet.microsoft.com/pt-br/library/cc263161.aspx

Exemplo pagina de Administração de SharePoint:

1.JPG

 

Criar sites com Banco de dados diferentes para áreas

 

Depois de criar os caminhos, podemos criar os nossos Site para as diferentes Areas, se utilizamos a Pagina de Administração de Sharepoint é um processo que demora algum tempo e temos que ir a varias páginas, mas existe via stsadm um processo que podemos fazer tudo em uma linha.

// comando para criar site para as diferentes Áreas com Banco de dados diferente

stsadm -o createsiteinnewdb -url http://[site] /HR -owneremail [email] -ownerlogin [Dominio\utilizador] –sitetemplate BLANKINTERNETCONTAINER#0 -title “Recursos Humanos” -databaseserver [NomeServidor]  -databasename WSS_content_recursosHumanos

stsadm -o createsiteinnewdb -url http://[site] /Administracao -owneremail [email] -ownerlogin [Dominio\utilizador] –sitetemplate BLANKINTERNETCONTAINER#0 -title Administracao -databaseserver [NomeServidor]  -databasename WSS_content_Administracao

stsadm -o createsiteinnewdb -url http://[site] /DF -owneremail [email] -ownerlogin [Dominio\utilizador] –sitetemplate BLANKINTERNETCONTAINER#0 -title Administracao -databaseserver [NomeServidor]  -databasename WSS_content_DepartamentoFinanceiro

Stsadm createsiteinnewdb

http://technet.microsoft.com/en-us/library/cc262407.aspx

 

Descrição dos Parâmetros na Linha Stsadm para “createsiteinnewdb”:

-url “Site que vamos criar”

-ownerlogin “Administrador do Site”

-owneremail “Email do administrador do site”

–sitetemplate “Modelo de Site” **

-title “Titulo do novo site”

- databaseserver “Nome do servidor do Banco de dados”

-databasename “Nome do Banco de Dados para a área do site criado”

 

O que vamos ganhar em separar o nossos Sites ”Site Collections” em vários Banco de dado.

  1. Mais fácil para realizar a gestão do Banco de Dados, podemos criar tarefas diárias para realizar o Backup das Colecções do Site “Site collections” com o conteúdo mais importante de uma maneira rápida e eficiente.
  2. O limite recomendado pela Microsoft para um boa performance da Base de dados de Conteúdo é 100 GB, como o nosso site de SharePoint esta separado em vários banco de dados é mais difícil crescer os ficheiros .mdf. http://technet.microsoft.com/en-us/library/cc262787.aspx.

 

O SharePoint tem modelos de sites com funcionalidades para ajudar os utilizadores a construir o nosso site de SharePoint de uma forma muito interactiva através das linhas de comando.

**Modelos de Sites que podemos utilizar :

GLOBAL#0 = Modelo global

STS#0 = Site de equipa

STS#1 = Site em branco

STS#2 = Área de trabalho de documentos

MPS#0 = Área de trabalho base da reunião

MPS#1 = Área de trabalho da reunião em branco

MPS#2 = Área de trabalho da reunião reservada ao registo de decisões

MPS#3 = Área de trabalho da reunião reservada a eventos sociais

MPS#4 = Área de trabalho da reunião com várias páginas

CENTRALADMIN#0 = Site de Administração Central

WIKI#0 = Site Wiki

BLOG#0 = Blogue

BDR#0 = Centro de Documentos

KB#0 = Base de Dados de Conhecimento

OFFILE#0 = Centro de Registos

OFFILE#1 = Centro de Registos

OSRV#0 = Site de Administração de Serviços Partilhados

PWA#0 = Site do Project Web Access

PWS#0 = Área de Trabalho do Microsoft Office Project

SPS#0 = Site do SharePoint Portal Server

SPSPERS#0 = Espaço Pessoal do SharePoint Portal Server

SPSMSITE#0 = Site de Personalização

SPSTOC#0 = Modelo de  rea de conteúdo

SPSTOPIC#0 = Modelo de  rea de tópicos

SPSNEWS#0 = Site de Noticias

CMSPUBLISHING#0 = Site de Publicação

BLANKINTERNET#0 = Site de Publicação

BLANKINTERNET#1 = Subsite de Comunicados de Imprensa

BLANKINTERNET#2 = Site de Publicação com Fluxo de Trabalho

SPSNHOME#0 = Site de Notícias

SPSSITES#0 = Directório de Sites

SPSCOMMU#0 = Modelo de  rea de comunidade

SPSREPORTCENTER#0 = Centro de Relatórios

SPSPORTAL#0 = Portal de Colaboração

SRCHCEN#0 = Centro de Procuras com Separadores

PROFILES#0 = Perfis

BLANKINTERNETCONTAINER#0 = Portal de Publicação

SPSMSITEHOST#0 = Anfitrião de O Meu Site

SRCHCENTERLITE#0 = Centro de Procuras

SRCHCENTERLITE#1 = Centro de Procuras

 

4º Criar Sub-sites dentro da Area

 

Depois de criar os Site principais, podemos criar diversos Sub-sites e podemos criar

//Linha de commandos para criar Sub-site associados

stsadm" -o createweb -url http://[Site]/RH/MK1  -lcid 1046 -sitetemplate BLANKINTERNET#2 -title "Marketing 1"

stsadm" -o createweb -url http://[Site]/RH/MK2  -lcid 1046 -sitetemplate BLANKINTERNET#2 -title "Marketing 2"

stsadm -o createweb -url http://[Site]/Administrativo  -lcid 1046 -sitetemplate BLANKINTERNET#2 -title "Gerente Comercial"

stsadm" -o createweb -url http://[Site]/DF  -lcid 1046 -sitetemplate BLANKINTERNET#2 -title "Tesouraria"

http://technet.microsoft.com/en-us/library/cc287718.aspx

Exemplo Criar Sub-site por site de gestão de conteúdo de SharePoint:

5.JPG

6.JPG

5º Adicionar Grupos e pessoas ao Site

 

Depois de criar os sites e Sub-Site podemos começar a adicionar as pessoas e grupos através de Stsadm

//Comando para adicionar Grupos ao Site

stsadm -o creategroup -url http://[Site]/HR -name [RH Grupo] –description “Grupo de Contribuição -ownerlogin [Grupo ou utilizador]

http://technet.microsoft.com/en-us/library/cc263302.aspx

//Comandos para adicionar utilizadores ao Site

stsadm -o adduser  -url http://[Site]/HR  -userlogin [Nome] –useremail [email] role [contribuir/utilizador]

http://technet.microsoft.com/en-us/library/cc262627.aspx

Exemplo de Grupo e pessoas no site de SharePoint:

7.JPG

Migrar Sub-site

 

Em algumas situações podemos encontrar a necessidade de exportar o conteúdo dos nosso sub-sites para outra área, para isso existe instruções em STSADM para apoio a essa tarefa.



//Linha de STSADM para exportar o Sub-site e todo o conteúdo para ficheiro.

stsadm –o export –url http://[Site]/RH/MK2  –filename c:\MK1.dat –versions 4

http://technet.microsoft.com/pt-br/library/cc262759.aspx

Parametros

-versions “Tem como função guardar os diversos estado dos Documentos é muito importante em documento que se encontram a trabalhar”

Este ficheiro tem a função de guardar o conteúdo do nosso sub-site que iremos importar para o novo sub-site

Exemplo do Output de exportação do Sub-site:

Export.JPG

//Para adisub-site guardado devemos criar um novo sub-site onde vai ficar alojado e importar o seu conteúdo através das seguintes linhas de comandos

stsadm -o createweb -url http://[Site]/DF/MK2  -lcid 2070 -sitetemplate BLANKINTERNET#2 -title "Marketing 2"

stsadm –o import –url http://[Site]/DF/MK2  –filename c:\[name].dat

http://technet.microsoft.com/pt-br/library/cc261866.aspx

//Para apagar o subsiste antigo podemos utilizar a seguinte linha de comando

stsadm -o deleteweb -url http://[site]/HR/MK2

http://technet.microsoft.com/pt-br/library/cc287710.aspx

Backup das Áreas

Se pretenderes fazer o Backup dos sites com Areas podes utilizar a linha de comando

Stsadm –o backup –url http://[Site]/DF -filename c:\Backup.dat

http://technet.microsoft.com/pt-br/library/cc263441.aspx

Sempre que é realizado um Backup o Banco de Dados entra em modo de READ ONLY como modo de garantia que os dados não são alterados quando estamos a fazer Backup,

Se acontecer um erro no Backup o Banco de dados fica em READ ONLY sem conseguires altera o conteúdo no SharePoint.

Para alterar o estado do Banco de Dados pode utilizar a linha de comando

stsadm -o getsitelock -url http://[Site]/DF

8.JPG

Para alterar o estado do Banco de dados, utilizes a linha

stsadm -o setsitelock -url http://[Site]/DF -lock none

9.JPG

http://technet.microsoft.com/pt-br/library/cc262811.aspx

Depois de o banco de dados estar a funcionar podemos restaurar o nosso site para o novo Site

Stsadm –o restore –url http://[NovoSite]/DF -filename c:\Backup.dat

http://technet.microsoft.com/pt-br/library/cc262087.aspx

Existem muitas outras linhas de STSADM que podem ajudar, mas a principal função das linhas STSADM é criar  muitos sites através de ficheiros .bat de uma maneira simples e sem utilizar a paginas de Administração de Sharepoint.

Espero que explorem as linhas de comandos STSADM e ajudem na estrutura do Site de Sharepoint

STSADM o nosso melhor amigo. J


Integraçao Office e Sharepoint

Autor:André Lage
Publicação:__________
Download:Documento
(EN)TranslateLink

Integração Microsoft Office 2007 com SharePoint

Olá pessoa, hoje vou falar uma das verdadeira força do SharePoint  que é a integração do Microsoft Office com SharePoint, os meus exemplos tem com função a possibilidade de utilizar Pastas de Documentos e colunas com o Word, o segundo exemplo tem como função utilizar a Pesquisa de SharePoint com os nosso documentos Word.

Integração Pasta documento de Sharepoint e Microsoft Word

 

Esta é daquelas funcionalidades que

Form1.JPG

Adicionar colunas com o tipo de campo que precisamos, neste caso utilizado adicionamos estes 2 tipos de campo:

  • Pais “Texto”
  • Orçamento “Menu de Opções”

Form2.JPGForm3.JPG

 

Quando adicionamos um documento a nossa pasta de SharePoint, as colunas que criamos estão disponíveis para apoio, mas também podemos usar os campos existentes na Pasta de sharepoint para o nosso modelos de Documento.

Para adicionar os campos da Lista de SharePoint no Documento Word, temos que seleccionar na opção “Insert>Quick Parts>Document Property” onde será listados os  campos existentes na nossa lista de SharePoint, para ajuda do nosso documento de SharePoint.

Neste caso utilizei os campos da Lista de Sharepoint:

  • Author
  • Pais
  • Orçamento

 

Form4.JPG

 

Quando todo o nosso documento estiver elaborado, então podemos guardar

Form5.JPG

Sempre que for realizada um alteração nos campos da nossa lista Documentos de SharePoint, o nosso documento também irá ser alterado, sem haver necessidade de alterar o documento.

De uma maneira muito simples podemos utilizar as ferramentas de SharePoint a ajudar os utilizadores nos documentos e a sua actualização.

Espero que tenham gostado J

 

Pesquisa de SharePoint em documento Word 2007

 

A funcionalidade de Pesquisa é realmente muito poderosa e bastante útil, mas eu sempre considerei que apenas utilizar nas paginas de SharePoint, seria um desperdício de um recurso tão importante e com o aprofundar e maior conhecimento da ferramenta, encontrei algo que achei muito útil com a utilização da pesquisa de SharePoint com o Microsoft Word o que demonstra um verdadeira integração entre estas duas grande ferramentas .

Configurara Pesquisa de SharePoint no Microsoft Word

 

Em primeiro peço desculpa porque não uso o Microsoft Word em Português.

O primeiro passo, será abrir o nosso novo documento de Work e seleccionar as seguintes opções.

Review>Research> Research options>Add Services.

Search1.JPG

Para aceder o serviço de Pesquisa do SharePoint para funcionar com o pesquisa do Word, será necessário adicionar o Web Service por defeito de Pesquisa para o SharePoint.

Exemplo:

Http://[site]/_vti_bin/search.asmx

 

Search2.JPG

Após o Web Service  estar adicionado, para realizar a pesquisa é necessário seleccionar o site “Inicio” a realizar a Pesquisa, os valores que retornam serão so mesmo que os do Sharepoint,

Search3.JPG

 

Feito, os nosso Documentos estão pesquisáveis sem nunca precisar de aceder ao nosso site de SharePoint.

Espero que tenham gostado, um grande abraço. J