Using the "Jive Copy Document" Workflow

The "Jive Copy Document" workflow can be controlled by SharePoint site contributors. This layer is used to specify the Jive place where you can copy documents. You can perform a Copy To Jive action as long as you have write access in the Jive place you're choosing as the destination and read access in SharePoint.

Note: To use the workflow you must have the "Jive Copy To Workflow" site collection feature activated. You can activate this feature for a site collection during installation, but if you don't, then you can manually activate it later. To activate the "Jive Copy To Workflow" site collection feature, log in as a site collection administrator and go to Site Settings > Site Collection features on the root site in your site collection. Here you can activate the "Jive Copy To Workflow" feature. Note that this feature can only be used on SharePoint libraries, not on regular SharePoint lists.

The following list explains the Jive Copy Document workflow and how it depends on the access a Sharepoint user has in Jive.

Workflow Association
Workflow association requires that the list manager (the user making the workflow association) has access to Jive because this user must select a default Jive place for the destination of the copy operation. Selecting the place requires that the user navigate the Jive places and therefore the user must have access to Jive.
Manual Workflow Initiation
Manual workflow initiation involves the screen where the user may potentially override the Jive place chosen at association time. Even if the configuration does not allow an override, this operation currently requires that the user starting the workflow have access to Jive. If users may not have access to Jive and you want them to be able to run the workflow, consider having the workflow start automatically on add and/or update and turn off manual initiation.
Populate Metadata Fields
This operation occurs automatically when the workflow is run. If checked, the users who initiate the workflow (either through manual initiation or automatic initiation) must have access to Jive. If the users may not have access to Jive, leave this option unchecked.
Copy Document
Physically copying the document from SharePoint to Jive when the workflow runs requires that the user initiating the workflow (either through manual initiation or automatic initiation) has write access to the destination Jive place. This is true except for the following conditions:
  • If there is a SharePoint Location defined within Jive that would handle this SharePoint site, then the "Content Copied from SharePoint" setting for that SharePoint Location determines how/if the document is copied based on the SharePoint user's privilege within Jive. For more on this, see Adding a SharePoint Location.
  • If there is no SharePoint Location defined within Jive that would handle this SharePoint site, then the "sharepoint.default.copyToJive.username" Jive system property must be set to a valid Jive user if the user does not have write access and the copy is to succeed. For more on this, see System Properties for SharePoint.

Associating the Jive Copy Document Workflow to a SharePoint Document Library

Before the Jive Copy Document workflow can be used within a SharePoint document library, it must be associated to the document library by a manager of that library.

To associate the Jive Copy Workflow to the SharePoint document library:

  1. Select the document library where you want to associate the workflow.
  2. Navigate to the workflow settings page using the following instructions for the appropriate version of SharePoint.
    • SP 2007: Choose Settings > Document Library Settings and then click Workflow settings > Add a Workflow.
    • SP 2010: From the ribbon, select Library > Workflow Settings > Add a Workflow .
  3. When the Add a Workflow page opens, select Jive Copy Document from the list of workflow templates as shown in the following image.

    Note: If the Jive Copy Document workflow template is not shown in this list, you either need to activate the "Jive Copy To Workflow" feature as noted in the beginning of this topic, or if you have recently upgraded, see Allowing New Instances for Jive Copy Workflow.
  4. Enter the name of the workflow and either use the default information for the remaining Task List, Workflow History List, or Start Options fields or change them In the Start Options field, you can specify whether you want the workflow started manually and/or automatically when a document is created or updated.
  5. Click Next.
  6. Complete the Jive Copy Document Workflow form using the following information to help you. The previous list provides more on SharePoint user access to Jive.
    Field Description
    Jive Instance Select a Jive Instance that you can access. If you want to give users the opportunity to change the Jive Instance when they manually run the workflow, select the Allow users to override box.
    Jive Place Name Click Browse to select a place where documents can live when you run this workflow and it copies the documents to Jive. If you want to give users the opportunity to change the Jive Place Name when they manually run the workflow, select the Allow users to override box.
    Populate Metadata Fields Select this option to populate additional metadata fields in this document library when the workflow runs. When selected, Jive saves the information about when the document was last copied to a specific Jive place and who last copied the document to a specific Jive place. If some users running this workflow do not have access to Jive, you need to uncheck Create SharePoint metadata fields and make sure the workflow is not allowed to run manually. Instead, the workflow should run automatically on adding and updating documents as specified in Start Options field described previously in Step 4. Metadata should not be popluated.
    Jive Tags Select one or more fields to be translated as tags in Jive when you run this workflow on a document. Create these fields by adding columns in the document library before you create this workflow. You can use Single Line of Text, Choice, Lookup, and Calculated fields to create tags in Jive. These fields may be multi-value choice fields (check boxes) and multi-value lookup fields, which transfer multiple tags. One tag is transferred to Jive for each value chosen. For example, if the choices are blue, green, and red, and the user selects blue and green, then both a blue and a green tag are associated with the document in Jive. Regardless of whether it is a single- or multi-value field, each value is considered an entire tag, but some special characters may be changed:
    • Spaces become underscores (_)
    • Double quotes (") and single quotes (') are removed
    • Commas (,) become semicolons (;)
    • Backslash (\) becomes a front slash (/)
    • Less than and greater than signs (< >) when put together in that order become underscore (_)
    Note: If you are running this workflow automatically on document updates, you should make at least one field in your library a required field in addition to the Name field. This ensures that tag values are available when the workflow runs.
  7. Click OK.

Launching the Jive Copy Document Workflow

After you configure the Jive Copy Workflow to a document library, you can manually launch the workflow by performing the following steps.

  1. In the document library, click the down-arrow next to the desired document and select Workflows as shown in the following image.

  2. Click the workflow you want to run. This example uses "Jive Copy Document" as shown in the following image.

    Note: If your workflow used to show in this list, and you have recently upgraded, see Allowing New Instances for Jive Copy Workflow
  3. If set for user override, you can select new Jive Instance and Jive Place Name choices.

  4. Click OK.