Objeto SharedWorkspace (Office)

La propiedad SharedWorkspace de un objeto Document en Microsoft Word, un objeto Workbook en Microsoft Excel y un objeto Presentation en Microsoft PowerPoint devuelve un objeto SharedWorkspace que permite al desarrollador agregar el documento activo a un sitio de SharePoint y administrar otros objetos en el sitio del área de trabajo compartida.

Observaciones

Use el objeto SharedWorkspace para agregar el documento activo de Word, Excel o PowerPoint a un sitio de área de trabajo de documentos de SharePoint en el servidor para aprovechar las características de colaboración del área de trabajo o para desconectar o quitar el documento del sitio del área de trabajo. Use las colecciones del objeto SharedWorkspace para administrar archivos, carpetas, vínculos, miembros y tareas asociados al documento compartido.

El modelo de objetos SharedWorkspace está disponible o no un documento está almacenado en un área. La propiedad SharedWorkspace de los objetos Document, Workbook y Presentation no devuelve Nothing cuando el documento no está compartido. Utilice la propiedad Connected del objeto SharedWorkspace para determinar si el documento activo se guarda en y conectado a un área de trabajo compartida de hecho.

Los usuarios requieren permisos adecuados para utilizar los objetos, propiedades y métodos en la jerarquía de objetos SharedWorkspace.

Utilice la colección SharedWorkspaceFiles, tiene acceso a través de la propiedad Files del objeto SharedWorkspace, para administrar los documentos y archivos guardados en un área de trabajo compartida.

Utilice la colección SharedWorkspaceFolders, tiene acceso a través de la propiedad Folders del objeto SharedWorkspace, para administrar subcarpetas dentro de la carpeta de biblioteca de documentos principal de un área de trabajo compartida.

Utilice la colección SharedWorkspaceLinks, tiene acceso a través de la propiedad Links del objeto SharedWorkspace, para administrar vínculos a otros documentos o información de interés para los integrantes que colaboran en los documentos en el área de trabajo compartida.

Utilice la colección SharedWorkspaceMembers, tiene acceso a través de la propiedad Members del objeto SharedWorkspace, para administrar los usuarios que tengan derechos para participar en un área de trabajo compartida y colaborar en los documentos compartidos guardados en el área de trabajo.

Utilice la colección SharedWorkspaceTasks, tiene acceso a través de la propiedad Tasks del objeto SharedWorkspace, para administrar las tareas asignadas a los integrantes que colaboran en los documentos en el área de trabajo compartida.

Utilice el método CreateNew para crear una nueva área de documentos y para agregar el documento activo al área de trabajo. Utilice las propiedades Name y URL para devolver información sobre el área de trabajo.

El objeto SharedWorkspace utiliza una caché local de objetos y propiedades del servidor. El programador necesite actualizar esta caché antes de realizar determinadas operaciones o para guardar los cambios de propiedad almacenados en caché en el servidor. Utilice el método Refresh del objeto SharedWorkspace para actualizar la caché local del servidor y la propiedad LastRefreshed para determinar cuándo tuvo lugar por última vez la operación de actualización. Utilice el método Save de los objetos SharedWorkspaceLink y SharedWorkspaceTask después de modificar sus propiedades localmente para cargar los cambios en el servidor.

Utilice el método Disconnect para desconectar la copia local del documento activo del área de trabajo compartida dejando intacta la copia compartida en el área de trabajo. Utilice el método RemoveDocument para quitar completamente el documento compartido del área de trabajo compartida.

Los usuarios requieren permisos adecuados para utilizar los objetos, propiedades y métodos en la jerarquía de objetos SharedWorkspace. Utilice el argumento Role cuando agregue a miembros a la colección SharedWorkspaceMembers para especificar el conjunto de permisos específicos de cada miembro del área de trabajo.

Cuando se utiliza el modelo de objetos SharedWorkspace, es posible crear condiciones donde la caché del objeto SharedWorkspace no se sincroniza con la interfaz de usuario mostrada en el panel Área de trabajo compartida del documento activo. Por ejemplo, si el método CreateNew agrega mediante programación el documento activo a un área de trabajo nueva mientras el panel Área de trabajo compartida está abierto, el panel seguirá mostrando el botón crear. En circunstancias como éstas, si el usuario realiza una selección en el panel Área de trabajo compartida que ya no es válido, se produce un error y se lleva a cabo una operación de actualización para sincronizar la presentación con el estado actual del documento y los datos de área de trabajo compartida.

Los objetos Document, Workbook y Presentation también tienen una propiedad Sync que devuelve un objeto Sync . Utilice el objeto Sync y sus propiedades y métodos para administrar la sincronización de la variable local y la copia del servidor del documento compartido.

Ejemplo

En el ejemplo siguiente se muestran las propiedades del área de trabajo compartida a la que está conectado el documento activo.

    Dim swsWorkspace As Office.SharedWorkspace 
    Dim strSWSInfo As String 
    Set swsWorkspace = ActiveWorkbook.SharedWorkspace 
    strSWSInfo = swsWorkspace.Name & vbCrLf & _ 
        " - URL: " & swsWorkspace.URL & vbCrLf & _ 
        "The shared workspace contains " & vbCrLf & _ 
        " - Files: " & swsWorkspace.Files.Count & vbCrLf & _ 
        " - Folders: " & swsWorkspace.Folders.Count & vbCrLf & _ 
        " - Links: " & swsWorkspace.Links.Count & vbCrLf & _ 
        " - Members: " & swsWorkspace.Members.Count & vbCrLf & _ 
        " - Tasks: " & swsWorkspace.Tasks.Count & vbCrLf 
    MsgBox strSWSInfo, vbInformation + vbOKOnly, _ 
        "Shared Workspace Information" 
    Set swsWorkspace = Nothing

Vea también

• Miembros del objeto SharedWorkspace
• Referencia del modelo de objeto

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.