hol6 manual vb

39
Desarrollar un tipo de contenido externo de BCS con Visual Studio 2010 Laboratorio práctico Manual del laboratorio SPCHOL304 - Desarrollar un tipo de contenido externo de BCS con Visual Studio 2010 - VB

Upload: ezequielsaldana

Post on 03-Oct-2015

30 views

Category:

Documents


1 download

DESCRIPTION

Hol6 Manual Vb

TRANSCRIPT

  • Desarrollar un tipo de

    contenido externo de BCS

    con Visual Studio 2010

    Laboratorio prctico

    Manual del laboratorio

    SPCHOL304 - Desarrollar un tipo de contenido externo de BCS con Visual Studio 2010 - VB

  • Este documento se proporciona tal cual. Es posible que la informacin y los puntos de vista reflejados

    en este documento, incluidas la direccin URL y otras referencias a sitios web de Internet, cambien sin

    previo aviso. El usuario asume el riesgo de su uso.

    Este documento no proporciona ningn derecho legal sobre la propiedad intelectual e industrial de ningn

    producto de Microsoft. Este documento puede copiarse y usarse para fines internos y de referencia.

    2010 Microsoft. Todos los derechos reservados.

  • Pgina 1

    Contenido

    DESARROLLAR UN TIPO DE CONTENIDO EXTERNO DE BCS CON VISUAL STUDIO 2010 ........................... 2 Objetivo del laboratorio .......................................................................................................................................... 2 Recursos adicionales ............................................................................................................................................. 2 Introduccin ............................................................................................................................................................ 2

    Iniciar sesin en la mquina virtual .................................................................................................................... 2 Ubicaciones........................................................................................................................................................ 2 Requisitos previos para el laboratorio ............................................................................................................... 3 Copiar las muestras de cdigo desde un documento de Word ......................................................................... 3 Fragmentos de cdigo ....................................................................................................................................... 4

    Ejercicio 1: crear un tipo de contenido externo de BCS ........................................................................................ 5 Tarea 1: crear un proyecto de modelo de conectividad a datos empresariales ................................................ 5 Tarea 2: actualizar el esquema de la clase de entidad ..................................................................................... 7

    Tarea 3: actualizar el cdigo del servicio ............................................................................................................. 19 Tarea 4: crear e implementar ........................................................................................................................... 21

    Ejercicio 2: usar el tipo de contenido externo desde Outlook con un formulario de Outlook personalizado ....... 24 Tarea 1: configurar el tipo de contenido externo para su uso sin conexin .................................................... 24 Tarea 2: dejar la lista sin conexin .................................................................................................................. 34 Tarea 4: quitar la lista externa ......................................................................................................................... 36

    Resumen del laboratorio ...................................................................................................................................... 37

  • Pgina 2

    Desarrollar un tipo de contenido externo de BCS con Visual Studio 2010

    Tiempo estimado para completar este laboratorio: 30 minutos

    Objetivo del laboratorio

    En este laboratorio, se muestra cmo crear un tipo de contenido externo del servicio de conectividad empresarial y, posteriormente, que est disponible sin conexin en Outlook. El objetivo de este laboratorio es aprender a generar tipos de contenido externo de BCS y que estn disponibles sin conexin en Outlook mediante Visual Studio 2010 y SharePoint Designer.

    Crear un tipo de contenido externo de BCS.

    Crear un nuevo proyecto de modelo de catlogo de datos empresariales.

    Configurar el tipo de contenido externo para su uso sin conexin.

    Abrir la lista con Outlook.

    Recursos adicionales

    Este laboratorio incluye los siguientes recursos adicionales:

    Este manual del

    laboratorio.

    SPCHOL304_Manual_VB.docx Este documento.

    Cdigo fuente. Completed\VB\Ex1 Cdigo fuente del laboratorio completado.

    Recursos Resources\VB\Ex1 Recursos varios usados a lo largo de este

    laboratorio.

    Introduccin

    Iniciar sesin en la mquina virtual

    Inicie sesin en la mquina virtual como el usuario siguiente: Nombre de usuario: Administrator Contrasea: pass@word1

    Ubicaciones

    Este laboratorio prctico contiene diversos recursos adicionales en ubicaciones establecidas. De forma predeterminada, se asume que el directorio HOL es C:\Content Packs\Packs\SharePoint 2010 Developer Labs 1.0\Supporting Files\SPCHOL304\Resources. La carpeta de trabajo predeterminada para este laboratorio es C:\SPHOLS\SPCHOL304.

  • Pgina 3

    Requisitos previos para el laboratorio

    Vaya al directorio HOL base Supporting Files\SPCHOL304\Resources y ejecute el script de PowerShell optimize.ps1: 1. Haga clic con el botn secundario en optimize.ps1 y seleccione Ejecutar con PowerShell:

    Figura 1 - Ejecutar el script de PowerShell

    2. De esta forma se abrir la ventana de PowerShell para ejecutar el script. Espere mientras PowerShell completa la ejecucin del script y cierra la ventana de PowerShell (esto puede tardar varios minutos):

    Figura 2 - Ventana de PowerShell donde se ejecuta el script

    Copiar las muestras de cdigo desde un documento de Word

    Solo ser seguro copiar y pegar cdigo desde este documento de Word en Visual Studio para las secciones de cdigo con formato, por ejemplo:

    Console.WriteLine ("Esto es cdigo seguro!");

    Es posible que el cdigo que no se encuentre en estas secciones contenga Unicode o caracteres invisibles que no sean cdigo XML o C#/VB vlido, por ejemplo:

    Console.WriteLine (Esto NO es cdigo seguro!!)

  • Pgina 4

    Fragmentos de cdigo

    Tambin se pueden usar fragmentos de cdigo para insertar el cdigo apropiado en el laboratorio. Para usar el fragmento de cdigo necesario para este laboratorio:

    Haga clic con el botn secundario en el archivo de cdigo donde desea insertar el fragmento de cdigo.

    Seleccione Insertar fragmento de cdigo...:

    Figura 3 - Men contextual para el cdigo de Visual Studio.

    Seleccione fragmentos de cdigo en la galera Mis fragmentos de cdigo.

  • Pgina 5

    Ejercicio 1: crear un tipo de contenido externo de BCS

    Este ejercicio le guiar en la creacin de un tipo de contenido externo mediante la plantilla de proyecto

    del modelo BDC de Visual Studio 2010 y en la extensin del tipo de contenido externo.

    Tarea 1: crear un proyecto de modelo de conectividad a datos empresariales

    1. Abra Visual Studio 2010; para ello, vaya al Men Inicio | Todos los programas | Microsoft Visual Studio 2010 | Microsoft Visual Studio 2010 y, en el men, seleccione Archivo | Nuevo | Proyecto.

    2. Seleccione la plantilla de proyecto Modelo de conectividad a datos profesionales de Visual Basic | SharePoint | 2010.

    3. Escriba BDCEx1 en el cuadro de texto Nombre.

    Figura 4 - Cuadro de dilogo Nuevo proyecto

    4. Escriba C:\SPHOLS\SPCHOL304\VB\Ex1 en el cuadro de texto Ubicacin.

    5. Haga clic en Aceptar.

  • Pgina 6

    6. Cambie la direccin URL a http://intranet.contoso.com.

    7. Seleccione el botn de opcin Implementar como solucin de granja de servidores.

    Figura 5 - Asistente para personalizar SharePoint

    8. Haga clic en Finalizar.

  • Pgina 7

    Tarea 2: actualizar el esquema de la clase de entidad

    1. En el men principal, seleccione Ver | Explorador de soluciones. En el Explorador de soluciones, cambie el nombre de Entity1.vb por Customer.vb y Entity1Service.vb por CustomerService.vb. Haga clic en S cuando se le pida mediante el siguiente aviso:

    Figura 6 - Aviso de cambio de nombre del archivo de Visual Studio

    2. Si todava no se abri, haga doble clic en Customer.vb en el Explorador de soluciones. Reemplace el cdigo del cuerpo de la clase Customer por el siguiente cdigo. Se agregarn dos propiedades adicionales y se cambiar el tipo de una tercera propiedad como una asignacin para los descriptores de tipo agregados y modificados en la definicin de BDC. Tenga en cuenta que al cambiar Identifier1 por CustomerId, puede usar el glifo que aparece en el editor para cambiar el nombre de todas las referencias a Identifier1 del campo. En este caso esto no le servir de ayuda, pero es una buena prctica.

  • Pgina 8

    Partial Public Class Customer

    Private _CustomerId As Int32

    Public Property CustomerId() As Int32

    Get

    Return _CustomerId

    End Get

    Set(ByVal value As Int32)

    _CustomerId = value

    End Set

    End Property

    Private _Message As String

    Public Property Message() As String

    Get

    Return _Message

    End Get

    Set(ByVal value As String)

    _Message = value

    End Set

    End Property

    Private _FirstName As String

    Public Property FirstName() As String

    Get

    Return _FirstName

    End Get

    Set(ByVal value As String)

    _FirstName = value

    End Set

    End Property

    Private _LastName As String

    Public Property LastName() As String

    Get

    Return _LastName

    End Get

    Set(ByVal value As String)

    _LastName = value

    End Set

    End Property

    End Class

    Fragmento de cdigo: Mis fragmentos de cdigo | spchol304_ex1_customer

  • Pgina 9

    Figura 7 - Clase Customer despus de los cambios en el cuerpo

  • Pgina 10

    Tarea 3: extensin de los metadatos de BCS para el tipo de contenido externo 1. En el Explorador de soluciones, abra BdcModel1.bdcm si todava no se abri el Diseador de BDC.

    Figura 8 - Explorador de soluciones mostrando BDCModel1.bdcm en el Diseador de BDC

    2. En el diseador, seleccione la entidad Entity1; para ello, haga clic en el ttulo.

    Figura 9 - Entidad Entity1

    3. Cambie el nombre de Entity1 por Customer; para ello, haga clic en el nombre Entity1 en el diseador y presione F2 (como alternativa, puede cambiar el nombre en la cuadrcula Propiedades).

  • Pgina 11

    4. Resalte Identifier1 en el diseador de entidades y presione F4 para abrir la cuadrcula de propiedades. Use la cuadrcula Propiedades para cambiar el nombre Identifier1 por CustomerId y cambiar su nombre de tipo por System.Int32.

    Figura 10 - Panel Propiedades despus de cambiar el nombre de tipo

    5. En el Explorador de BDC en Visual Studio, expanda Modelo | BdcModel1 | BdcModel1 | Customer | ReadList | returnParameter. Haga clic en Entity1List para abrir su cuadrcula de propiedades.

    Figura 11 - Explorador de BDC donde se resalta Entity1List

  • Pgina 12

    6. Mediante la cuadrcula Propiedades, cambie el nombre de Entity1List por CustomerList.

    7. En el Explorador de BDC, expanda CustomerList.

    Figura 12 - Explorador de BDC donde se resalta Entity1

    8. Mediante la cuadrcula Propiedades, cambie el nombre de Entity1 a Customer.

    En el Explorador de BDC, expanda Customer y, mediante la cuadrcula Propiedades, cambie el nombre de Identifier1 a CustomerId y establezca el nombre de tipo en System.Int32.

    Figura 13 - Cuadrcula Propiedades despus de los cambios en Identifier1

  • Pgina 13

    9. En el Explorador de BDC, haga clic con el botn secundario en Customer y seleccione Agregar descriptor de tipo.

    Figura 14 - Men contextual de la entidad Customer

    10. Seleccione TypeDescriptor y, mediante la cuadrcula Propiedades, cambie Nombre a FirstName.

    11. En el Explorador de BDC, haga clic con el botn secundario en Customer y seleccione Agregar descriptor de tipo.

    12. Seleccione TypeDescriptor y, mediante la cuadrcula Propiedades, cambie Nombre a LastName.

    Figura 15 - Entidad Customer en el Explorador de BDC despus de agregar los descriptores de tipo FirstName y LastName

    13. En el Explorador de BDC, haga clic con el botn secundario en Customer y seleccione Copiar.

    Figura 16 - Men contextual de la entidad Customer

  • Pgina 14

    14. En el Explorador de BDC, expanda el mtodo ReadItem, haga clic con el botn secundario en returnParameter y seleccione Pegar.

    Figura 17 Men contextual de returnParameter

    15. Haga clic en S.

    Figura 18 - Aviso para reemplazar el descriptor de tipo

  • Pgina 15

    16. Expanda returnParameter | Customer y confirme que los descriptores de tipo FirstName y LastName se copiaron correctamente.

    Figura 19 - Explorador de BDC despus de los cambios realizados en los pasos del 1 al 16 de la Tarea 1

  • Pgina 16

    17. En el Explorador de BDC, expanda ReadItem | id y seleccione Identifier1.

    18. Con la cuadrcula Propiedades, cambie el nombre de Identifier1 aCustomerId, establezca el nombre de tipo en System.Int32.

    Figura 20 - Cuadrcula Propiedades despus de los cambios en Identifier1

    19. Mediante el panel Detalles de mtodos de BDC, agregue un mtodo Update.

    Figura 21 - Detalles de mtodos de BDC agregando el mtodo Update

  • Pgina 17

    20. Agregue un parmetro y denomnelo id

    .

    Figura 22 - Se agrega el parmetro id al mtodo Update

  • Pgina 18

    21. Abra el nuevo mtodo Update en la ventana Explorador de BDC.

    22. Copie el descriptor de tipo de la descripcin de tipo CustomerId del parmetro @id del mtodo ReadItem al parmetro @id del mtodo Update.

    23. Cambie la propiedad Campo Pre-Updater del parmetro id para que sea True.

    Figura 23 - Se actualiza el campo Pre-Updater a True

  • Pgina 19

    Tarea 3: actualizar el cdigo del servicio

    1. En el Explorador de soluciones, abra CustomerService.cs.

    2. Reemplace el cuerpo de la clase CustomerService por el siguiente cdigo. Se devolver un cliente en funcin de un identificador determinado, y una matriz de clientes si se solicita.

    Public Class CustomerService

    Public Shared d As Dictionary(Of Integer, Customer) = Nothing

    Public Shared Function ReadItem(ByVal id As Integer) As Customer

    Dim e As New Customer()

    Dim c = d([id])

    e.CustomerId = c.CustomerId

    e.Message = c.Message

    e.FirstName = c.FirstName

    e.LastName = c.LastName

    Return e

    End Function

    Public Shared Function ReadList() As IEnumerable(Of Customer)

    If d Is Nothing Then

    d = New Dictionary(Of Integer, Customer)

    For i As Integer = 0 To 9

    Dim e As New Customer()

    e.CustomerId = i

    e.Message = e.CustomerId & " Datos de elemento"

    e.FirstName = e.CustomerId & " Nombre"

    e.LastName = e.CustomerId & "Apellido"

    d.Add(i, e)

    Next

    End If

    Return d.Values

    End Function

    Public Shared Sub Update(ByVal customer As Customer, ByVal id As Integer)

    d([id]).FirstName = customer.FirstName

    d([id]).LastName = customer.LastName

    d([id]).Message = customer.Message

    End Sub

    End Class

    Fragmento de cdigo: Mis fragmentos de cdigo | spchol304_ex1_customerservice

  • Pgina 20

    Figura 24 - Clase CustomerService despus de los cambios

    3. En el Explorador de soluciones, expanda la carpeta Features y haga doble clic en el nodo

    Feature1.feature. Se abrir el diseador de caractersticas.

    4. Haga clic en la pestaa Manifiesto en la parte inferior del diseador de caractersticas.

    5. Haga clic en el glifo + situado junto a Editar opciones para abrir el editor de plantillas.

    6. Agregue una nueva propiedad para la direccin URL del sitio.

  • Pgina 21

    El diseador de caractersticas ahora debera verse como la Figura 25.

    Figura 25 Diseador de caractersticas con la propiedad SiteUrl agregada

    Tarea 4: crear e implementar

    1. En el men, seleccione Generar | Implementar BDCEx1.

    2. Abra http://intranet.contoso.com en una sesin del explorador.

    3. Haga clic en Listas en la zona de navegacin izquierda

    .

    Figura 26 - Vnculo Listas

    4. Haga clic en Crear.

    Figura 27 - Vnculo Crear

  • Pgina 22

    En el cuadro de dilogo Crear, seleccione Lista externa y, a continuacin, seleccione Crear.

    Figura 31 Cuadro de dilogo para crear una lista externa

    5. Escriba My Contacts en el cuadro de texto Nombre.

    6. Haga clic en el segundo botn a la derecha del cuadro de texto Tipo de contenido externo (el botn en cuya informacin sobre herramientas se lee Seleccionar tipo de contenido externo).

    Figura 32 Pgina para crear una lista externa nueva

  • Pgina 23

    7. Seleccione BDCModel1 y haga clic en Aceptar.

    Figura 33 - Selector de tipo de datos profesionales -- Cuadro de dilogo Pgina web

    Figura 28 - Pgina de la nueva lista externa

    8. Haga clic en Crear.

  • Pgina 24

    9. Ya ha creado un tipo de contenido externo y una lista para hospedar el tipo de contenido.

    Figura 29 - Tipo de contenido externo (modelo BDC) que aparece en la lista

    Ejercicio 2: usar el tipo de contenido externo desde Outlook con un formulario de Outlook personalizado

    Esta tarea le servir de gua para hacer que el tipo de contenido externo que se ha creado en el Ejercicio 1 est disponible en Outlook mediante el uso de SharePoint Designer 2010.

    Tarea 1: configurar el tipo de contenido externo para su uso sin conexin

    1. Abra SharePoint Designer 2010; para ello, vaya a Inicio | Todos los programas | SharePoint | Microsoft SharePoint Designer 2010

  • Pgina 25

    2. Haga clic en Sitios y, a continuacin, en Abrir sitio.

    Figura 30 - Botn de men Sitios en SharePoint Designer 2010

  • Pgina 26

    Escriba http://intranet.contoso.com en el cuadro del texto del nombre del sitio y haga clic en Abrir. De esta forma se abrir SharePoint Designer.

    Figura 31 - Cuadro de dilogo Abrir sitio

    3. Si se le pide autenticacin, escriba los siguientes detalles:

    Nombre de usuario: administrator

    Contrasea: pass@word1

  • Pgina 27

    4. Haga clic enTipos de contenido externo en la zona de navegacin izquierda.

    Figura 32 - Elemento de men Tipos de contenido externo

  • Pgina 28

    5. Haga doble clic en la entidad Customer.

    Figura 33 - Pestaa Tipos de contenido externo con las entidades disponibles

  • Pgina 29

    6. En la lista desplegable Tipo de elemento de Office, seleccione Contacto.

    Figura 34 - Panel con informacin sobre el tipo de contenido externo

    7. Tenga en cuenta la advertencia en el panel Operaciones de tipo de contenido externo.

    Figura 35 - Panel con informacin sobre el tipo de contenido externo

    8. Para editar las asignaciones de propiedades, haga doble clic en ReadItem.

  • Pgina 30

    9. Haga clic en S en la solicitud de Confirmacin de deteccin de origen de datos.

    Figura 36 - Solicitud de Confirmacin de deteccin de origen de datos

    10. Escriba My Contact en el cuadro de texto Nombre para mostrar de la operacin. De momento, ignore el error de configuracin.

    Figura 37 - Cuadro de dilogo Propiedades operativas

  • Pgina 31

    11. Haga clic en Siguiente.

    Figura 38 - Cuadro de dilogo Parmetros de entrada

  • Pgina 32

    12. Haga clic en Siguiente para abrir la pantalla Configuracin de parmetros de devolucin.

    Figura 39 - El panel de configuracin de elementos

    13. Tenga en cuenta los Mensajes de error que aparecen en la parte inferior de Configuracin de

    parmetros de devolucin.

    Figura 40 - Mensaje de error

    14. Para asignar LastName (cadena), seleccione LastName en el panel Jerarqua del tipo de datos del parmetro.

    Figura 41 - Jerarqua del tipo de datos del parmetro

  • Pgina 33

    15. Seleccione Apellidos (LastName) en la lista desplegable Propiedad de Office. Nota el mensaje de error se borra tan pronto como se selecciona Apellido.

    Figura 42 - Propiedades para el parmetro LastName

    16. Seleccione FirstName y establezca la Propiedad de Office en Nombre (FirstName).

    17. Seleccione Message y establezca la Propiedad de Office en Cuerpo (Body).

    18. Haga clic en Finalizar.

    19. Haga clic en el icono Guardar en la parte izquierda de la pantalla.

    Figura 43 - Botn Guardar

    20. Ver una barra que muestra el progreso de la operacin de guardar.

    Figura 44 - Cuadro de dilogo con el progreso de la operacin de guardar

  • Pgina 34

    Tarea 2: dejar la lista sin conexin

    1. Abra http://intranet.contoso.com en una sesin del explorador.

    2. Haga clic en My Contacts en la zona de navegacin izquierda

    .

    Figura 45 - Seccin de listas en el men de navegacin a la izquierda

    3. Haga clic en Lista.

    Figura 46 - Opciones de la pestaa Herramientas de listas

    4. Haga clic en Conectar con Outlook

    Figura 47 - Botn para dejar a la lista sin conexin

    5. Se crear un instalador de un solo clic para que la lista est disponible sin conexin en Outlook. Si aparece un cuadro de dilogo que le solicita un Instalador de Personalizacin, como se muestra a continuacin, haga clic en Instalar. (Esto puede llevar varios minutos).

    Figura 48 - Cuadro de dilogo con el progreso del procesamiento

  • Pgina 35

    Figura 49 - Solicitud de Instalador de Personalizacin de Microsoft Office

    Esto puede llevar varios minutos.

    Figura 50 - Cuadro de dilogo con el progreso del Instalador de Personalizacin de Microsoft Office

    Una vez haya finalizado el instalador, haga clic en Cerrar.

    Figura 51 - Solicitud del Instalador de Personalizacin de Microsoft Office completada

  • Pgina 36

    6. Microsoft Outlook abrir una lista externa y mostrar las entidades como contactos.

    Figura 52 - Contactos que aparecen en Outlook

    Tarea 4: quitar la lista externa

    Es solamente necesario para trabajar en otros laboratorios. Si hay una lista externa se romper el comando SPMetal que se usa con las caractersticas de LINQ-to-SharePoint en esta vista previa tcnica. 1. Abra http://intranet.contoso.com en una sesin del explorador.

    2. Haga clic en My Contacts en la zona de navegacin izquierda.

    3. Haga clic en Lista en el panel Herramientas de listas.

    4. Haga clic en Configuracin de la lista.

    5. Haga clic en Eliminar esta lista .

  • Pgina 37

    Resumen del laboratorio

    En este laboratorio, ha realizado los ejercicios siguientes: 1. Crear un tipo de contenido externo de BCS.

    2. Crear un nuevo proyecto de modelo de catlogo de datos empresariales.

    3. Extender el tipo de contenido externo.

    4. Configurar el tipo de contenido externo para su uso sin conexin.

    5. Dejar la lista sin conexin.

    6. Abrir la lista con Outlook.