Learn how FrameMaker provides connectors that enable integration with Documentum, Microsoft SharePoint, and DitaExchange.
FrameMaker provides connectors that enable integration with the following content management systems (CMS):
OpenText Documentum 7.2
Microsoft SharePoint Server 2016, 2013, and 2010
Microsoft SharePoint Online
DitaExchange
Once configured, FrameMaker allows you to perform search, read, write, delete, update, check in, and check out operations on the configured CMS repository.
Learn how you can configure the connectors to set up integration with Documentum, Microsoft SharePoint, and DitaExchange.
You can specify the versioning scheme to be applied when you use FrameMaker to upload a document that exists in a Documentum, Microsoft SharePoint, or DitaExchange repository. The document is overwritten and the specified file versioning settings are applied to the document.
In FrameMaker, click
.In CMS, ensure that Overwrite Existing Object And Save As is selected.
Select the versioning option per your requirement. You can choose to have the same (Documentum only), next major, or next minor version for the uploaded document.
Click OK.
In FrameMaker, Click
.In Show Hidden Objects to view the hidden files (contained in a repository) in the Repository Manager window.
, selectSelect Show Private Cabinets to view the private cabinets (contained in a repository) in the Repository Manager window.
Click OK.
Download the Documentum Foundational Services SDK from the EMC website.
Download the Documentum Foundation Services (DFS) SDK from EMC Community Network.
Extract the .zip file.
In FrameMaker, Click
.In Browse.
, clickIn the Browse For Folder window, navigate to the SDK (e.g. emc-dfs-sdk-6.5) folder.
Click OK in the Browse For Folder window.
Click OK in the CMS Preferences window.
A message box prompts you to restart FrameMaker.
Restart FrameMaker.
To be able to work with file types supported by FrameMaker, you must add FrameMaker types and formats on the Content server using a .dar file.
To add the FrameMaker types on the Content server, you need Administrator or Create Type privilege.
Download the .dar file from the following location and use it to add the FrameMaker types on the Server:
Run the .dar file installation utility shipped with FrameMaker. The default location of this utility is <Fm-install-location>\FmDctmSetup.exe.
In the Connection Information dialog, provide the following information:
Server: Path of the Documentum server.
Port: Port at which the Documentum server is listening. Default value is 1489.
UserName and Password: The user name and password of the user with administrative privileges to install the .dar file.
Repository: Name of the repository where you want to install the .dar file.
DFS SDK Path: Specify the path of the Documentum Foundation Services (DFS) SDK.
A FrameMaker sample application pack is available at www.adobe.com/go/learn_fm_sample_dita_app_pack_en. The application pack includes an indicative set of applications to help content administrators configure FrameMaker to author files on Documentum server. Download and install the sample application pack to avoid the warnings and XML parser logs when you work with XML files from Documentum server.
Understand how you can connect to the content management system in FrameMaker using the Connection Manager dialog
In FrameMaker, select
.Choose the connection type — Adobe Experience Manager, DitaExchange, Documentum, Microsoft SharePoint or SharePoint Online.
Specify the connection details, such as server name, user name, and password to connect to your CMS. Also, specify a unique name for the connection.
(Documentum only) Specify the name of the Documentum repository to which FrameMaker will connect using this connection.
Click Connect.
The Repository Manager lists the contents of the selected server.
Learn how to use FrameMaker Repository Manager.
Select
to view the Repository Manager window. Use the Repository Manager to:Switch between repositories
Browse files within a repository
Manage resources
A. Search the repository B. Perform advanced search C. Add a connection D. Close a connection E. Open review pod F. Delete G. Cancel checkout H. Checkout item I. Checkin item J.Select repository
Learn how to upload files and folders to a Documentum, Microsoft SharePoint, Microsoft SharePoint Online, or DitaExchange server using FrameMaker.
You can upload XML, DITA, FM, MIF, and book files.
The DitaExchange connector, supports two custom document libraries: Map and Topic.
Select the server from the Repository Manager window.
You can choose to upload an open (step 2) or closed (step 3) file.
Upload an open file.
Switch between the open documents to select the document to upload.
Select
.TheSelect CMS Item window is displayed.
Specify the upload location.
Click OK.
The selected document and its direct dependencies are uploaded. A message is displayed when the file is successfully uploaded.
Click OK.
Upload a closed file.
Perform one of the following:
Right-click a list or folder for Microsoft SharePoint or DitaExchange.
Right-click a cabinet or folder for Documentum.
Select Upload Document.
The Select the file to upload window displays.
Specify the file to upload.
Click Select.
The selected file and its direct dependencies are uploaded. A message is displayed when the file is successfully uploaded.
Click OK.
Select the server from the Repository Manager window.
Perform one of the following:
Right-click a cabinet or folder for Documentum.
Right-click a list or folder for Microsoft SharePoint or DitaExchange.
Select Upload Folder.
The Browse For Folder window displays.
Navigate and select the folder to upload.
Click OK.
The selected folder and all its dependencies are uploaded. A message is displayed when the directory is successfully uploaded.
Click OK.
Learn how to manage various resources like managing Documentum cabinets, folders, and files in FrameMaker.
Using FrameMaker, you can manage the resources, such as cabinets (Documentum), folders, and files, of your configured Documentum, Microsoft SharePoint, or DitaExchange server.
You can perform the following operations on your CMS resources.
Right-click the root node of the Documentum server and select New Cabinet.
Right-click a cabinet (Documentum only), folder, or file and select Delete.
When deleting a file in Documentum, a dialog prompts you to delete just the file, all versions of the file, or the file and all its dependencies.
When deleting a file in Microsoft SharePoint, a dialog prompts you to keep just the current version of the file and delete all other versions, or to delete all the versions of the file.
Right-click a cabinet, list, or folder and select Upload Document. FrameMaker uploads the file and all its dependencies, if any.
Right-click a cabinet, list, or folder and select Upload Folder.
Right-click a cabinet, list, or folder select New Folder.
Right-click a cabinet, site, list, or folder and select Show Checkout Files.
Right-click a cabinet, site, list, or folder and select Properties. The Attributes pod is displayed.
The dialog allows you to modify the value of an attribute. To modify a value, click the value of the desired attribute and modify it.
Click OK to save the modified value.
Right-click a cabinet, site, list, folder, or the root node and select Refresh.
In the Repository Manager dialog, select the repository.
Right-click the file and do one of the following:
Select Checkout and Edit to check out and open the file.
Select Checkout to check out the file.
Specify whether to check out all dependent files.
Click OK.
In the Repository Manager dialog, select the repository.
Right-click the file and select Checkin.
Specify the version details.
Click OK.
Using FrameMaker you can manage XML, DITA, FM, MIF, and book files. In addition to checking out and checking in files, you can perform the following tasks:
Right-click and select Open (read only) to view the file in read-only mode. If the file is not checked out, double-clicking or pressing Enter on the file, opens the file in read-only mode, and also downloads all the dependents of the file.
Right-click, select Delete.
Select Delete all versions to delete all versions of the file.
Right-click and select Show Versions.
Right-click and select Show Dependents.
Right-click and select Properties.
Right-click and select Refresh.
Learn how to perform basic and advanced search in the configured Documentum, Microsoft SharePoint, and DitaExchange repositories.
FrameMaker allows you to perform basic and advanced search in the configured Documentum, Microsoft SharePoint, and DitaExchange repositories.
Basic search searches on the name of the file. To perform a basic search:
In the Repository Manager, select the repository.
Enter the search term in the search field and click the search icon.
The results are displayed in the search results window.
To perform an advanced search on a Microsoft SharePoint or DitaExchange repository:
In the Repository Manager, select the repository.
Click the advanced search icon. The advanced search window is displayed as follows:
Enter the search term in the search pane.
The condition builder allows you to perform complex searches by combining two or more search criteria.
Build a criteria by selecting the property (for example, Created By), the relevant condition (for example, =), and specify a value (for example, Jones).
Click Add.
Build another criteria by selecting the operator (AND or OR), the property (for example, File Type), the desired condition (for example, =), and specify a value (for example PDF).
Click Search.
Search results are displayed based on the specified search criteria. In this example, the PDF files created by Jones are displayed.
The DitaExchange connector allows you to filter the files in the Browse File(s) and File Open dialog. You can filter the files in these dialogs by any of the available file attributes. For example, you can filter the files by file type or by the author. In a large list of files, this can narrow down the list and make it much easier to find the file or files you are looking for.
In the Repository Manager, right-click on a list or folder and choose Browse File(s).
The Browse File(s) dialogs displays the list of files in the selected list or folder.
For each file, the list also displays all the associated attributes mentioned in the View.
To filter the list of files by a specific attribute, hover the mouse pointer over the attribute title.
A pop-up arrow is displayed to the right of the title name.
Click the pop-up arrow.
The Filter - <Attribute name> dialog is displayed.
To define a filter for the files in the Browse File(s) dialog, do one of the following:
Use the checkboxes to the left of the entires in the list. For example, in the above dialog, you can choose to filter the list to display only files modified by the administrator by unchecking the other two options.
Filter the list by the text entered in the text box. For example, type ad to filter the list by entries that contain the text ad.
Click OK.
The list of files is filtered by the conditions that you have set in the Filter dialog.
Note that in the Browse File(s) dialog, an asterisk appears to the right of the attribute title on which the filter is applied.
You can clear the filters that you have applied in the Browse File(s) dialog at two levels:
Filters applied to a specific attribute
Filters applied to all attributes
In the Repository Manager, right-click on a list or folder and choose Browse Fils(s).
In the Browse File(s) dialog, notice the asterisk that appears to the right of some of the attribute titles. This is provided by the connector as an indicator for the attributes on which filter are applied.
To clear the filter on a specific attribute, hover the mouse pointer over the attribute title and click the pop-up arrow.
In the Filter - <Attribute name> dialog, click Clear Filter.
The filter is cleared from the file list in the Browse File(s) dialog.
Also notice the asterisk is not displayed to the right of the attribute title.
To clear the filter applied to all attributes, in the Browse File(s) dialog, click Clear All Filters.
To perform an advanced search on a Documentum repository:
In the Repository Manager, select the repository.
Click the advanced search icon. The advanced search icon is displayed.
Enter the search term in the search pane.
Select the location, file type, date, and file size values as required.
The condition builder allows you to perform complex searches by combining two or more search criteria.
Build a criteria by selecting the property (for example, Title) and the condition (for example, begins with), and specify a keyword (for example, Troubleshooting).
Click Add.
Build another criteria by selecting the operator (AND or OR), property (for example Modified By), condition (for example, begins with), and specify a keyword (for example, Daniel).
Click Search.
Search results are displayed based on the specified criteria. In this example, elements that have their titles beginning with Troubleshooting and are modified by users that have their names beginning with Daniel are displayed.
Learn how to add custom CMS attributes to your unique requirements in Microsoft SharePoint or Documentum.
You may need to create custom attributes according to your unique requirements in Microsoft SharePoint or Documentum. Once you have created these custom attributes, you can provide support for them in FrameMaker. You can add the custom attributes in FrameMaker that exist on your Documentum or Microsoft SharePoint CMS. You can add the following attribute types in FrameMaker CMS preferences for Microsoft SharePoint:
Text
Note
Number
Currency
Integer
Boolean
DateTime
Lookup
Choice
URL
User
You can add the following data types for Documentum:
Boolean
Integer
String
Double
Time
ID
On file upload, the attributes specified in the CMS preferences are populated in connection manager and search.
A. Properties added in Sharepoint using the Preferences dialog of FrameMaker B. Adding custom properties in FrameMaker (SingleLine, MultiLine, and curr)
To add a custom property for Documentum:
Select
.In the Preferences dialog, expand CMS and select Documentum.
In List of Attributes, enter the name of the new property and click Add. Repeat to add more properties.
Click OK.
To view the added property, right-click a folder or document within the relevant cabinet. Also, when you use Advanced Search, the Add Criteria area has the new property listed in the Property drop-down.
To add a custom property for SharePoint:
Select
.In the Preferences dialog, expand CMS and select Microsoft SharePoint and enter the following:
Name: Enter a name for the new property.
Data Type: Enter data type of the new property: Boolean, Date, Double, Integer, or String.
Attribute Type: Enter one of the following: Text, Note, Number, Currency, Integer, Boolean, DateTime, Lookup, Choice, URL, or User.
Click OK.