Cp5 Project version control

Hi all
Can anyone recommend best practice for version control in Cp5? In other documentation I'm in the habit of saving the version number in the file name, but with Captivate, if there are links to projects, changing file names with every edit will cause problems.
Any advice would be appreciated.
Regards
Amanda

I don't know of a way to do this so that you can see the version information without opening the Captivate file. My way to include version information within the .cptx file is to put the version number into a caption on the title slide of the presentation. If the version number is only relevant to the developer(s), make the caption invisible, but if you want users to be able to see it in the published presentation, leave it visible and format it appropriately (e.g., a transparent caption with say 8 point font, at the very bottom of the slide).

Similar Messages

How do I fix project after "Remove From Version Control" corrupted it?

I am using RoboHelp 9.0.1 and installed both Tortoise SVN 1.6.9 and latest PushOK SVNSCC then added my large RoboHelp project to SVN. I was able to check in and out files from SVN but had several issues with it:
1) Super super slow. Working with folders or any renames would take 10 seconds per file and up to 1 hour if needed to refresh the root folder.
2) I could not perform some actions at all, such as delete, rename, or move folders. I kept getting COM errors.
I therefore decided that working with SVN and RoboHelp is not practical, at least not on my VPN so I decided to disconnect the project from source control and just work locally. The only option that I saw that sounded like it would do that was the "Remove from Version Control". This started a process that lasted for several hours. At the end of it, I now have several significant issues:
1) The order of the files and folders in my Project Manager is completely wrong now. I have almost 1000 topics and reordering all of them is not possible.
2) The Table of Contents, Glossary, and Index files appear empty. They had content before.
2) A couple of the Single Source Layouts I had created are completely missing.
3) Many, but not all, of the folders have tons of files with the extension ending in "_temp_removed_by_svn"
4) Many, but not all, of the files are actually gone from SVN so I can't recover a clean image. There was no warning that this command would actually delete the files from SVN (I thought it would just remove the version control connection).
5) Who know what other issue exist that I haven't seen.
Any idea how I can fix this?
Thanks in advance,
Dan

Are the "_temp_removed_by_svn" files in your local folder or SVN? Let us know how you get on with the new project. It sounds like something is wrong with SVN. Can you use the SVN Log command to see whether there is a different version you can restore. This might also give you an indication of what might have caused the problem. You could try deleting your CPD file. It gets rebuilt it is isn't there anyway. This file can become bloated and it is good practice to delete it when it gets close to 2mb in size. Your project is fairly large and has a lot of folders and may affect performance. Have you considered splitting them and merging the output? I know you probably don't want to consider this right now, but I think it may be a better long term solution.
The RoboColum(n)
@robocolumn
Colum McAndrew

Version Control in RoboHelp 9: Changing projects

I am using Robohelp version 9. We had originally set up the internal Version Control to point to a particular project in our Team Forge. Now we have a new project that we need to point to and we cannot figure out how to change the location of where we are checking files into. We can see the path in the Version Control properties dialog box, but no way to edit the path. Any suggestions on how to switch from one project in Team Forge to another?
Thanks!

I am a dope! I meant Version 8!!!

Opening Project First Time from Version Control. RoboSource Node

Four writers have upgraded successfully. My fifth is having issues...
She has Serena Dimensions SCC installed as well (another source control product - used by Applications, not the authors or Infra.
Problem: When she is establishing the root path (and the Browse RoboSource Node window opens, but it does not populate, even after 20 minutes. Reboot did not work, neither did manually removing Serena Dimensions SCC. I have verified that she has a connection to the database (via RSC Explorer) and can see the project (as well as the RH7 version of the project). We have
These are the instructions... (screenshots not included). She's hanging up on
1.1    Using a New Project for the First Time
IMPORTANT NOTE:
The author must have local administrator rights on the machine. If the user has a privileged account, they must set up full local control of their work folder (specified in 1.1.2.8).
1.1.1    Install RoboHelp and RoboSource Control
1.    Download appropriate software packages, including all patches, from Adobe.
2.    Launch RoboHelp Installer. Select the following options for installation:
o   RoboHelp for HTML
o   RoboSource Control (Client)
o   CS4 Script Extender
INSTALLATION NOTES
Installation of each component is separate and may take up to 30 minutes. You do not have to install RoboHelp for Word.
Only select the Client Install for RoboSource Control.
3.    Install all patches in the order specified by the vendor. Check with the technical communicator on which version is currently in use for patching.
1.1.2    Open the Project
1.    Launch RoboSource Control.
2.    Establish a database connection per section 3.3.1.
3.    Close RoboSource Control.
4.    Launch RoboHelp 8 for HTML.
5.    Click Open under Recent Projects under the main frame (do not use title bars).
6.    Click the Open Project from version control button (shown below).
7.    Make sure that RoboSource Control 3.1 is highlighted as the Version Control Provider and the checkbox for “Make this my default selection” is checked. Click OK.
8.    Configure the Source Control system as follows:
Connection: PROD
Root Path: Click the … button and navigate to the (project name) root in the database and click OK. This may take several minutes.
Connection Mode: Online
Get to Local Path: Click the … button and navigate to your Data folder. Select Make New Folder under Data and give the folder a unique name to help you identify the files as for the Support KB in RoboHelp.
9.    Click OK when you have configured source control. A copy of the database is now being downloaded to the path you specified. This may take up to 20 minutes.
You can verify that installation is proceeding either by watching your local path fill with files or keeping an eye on the CPU usage of the RSO3MiddleTierService and RoboHelpHTML files under Task Manager.
10. Once transfer is complete, highlight Tier1KB.xpj and click Open. It may take several minutes to open the project the first time. It is typical for the snippet file to check out the first time you open the project and the first time each day that you save all project files.
11. Once the project is open, set Version Control properties:
a.         Select Tools > Options.
b.         On the Version Control tab, select all options. This will prompt the user on each version control action they take.
12. Test a check out/check in to validate correct installation and source control operation.

It's the settings in miscproperties in the XPJ and it works in TFS just fine. I'ts as follows:
<miscproperties>
<matchedpair>
<name>vc::provider</name>
<value>Team Foundation Server MSSCCI Provider</value>
</matchedpair>
<matchedpair>
<name>vc::agent</name>
<value>MSSCC</value>
</matchedpair>
<matchedpair>
<name>vc::database</name>
<value>http://ap-gda113-tfs-a:8080/tfs/centric|NB-WWEELDEN|ITS\Wweelden</value> <- Add the TFS URL, your workspace name and your domain name.
</matchedpair>
<matchedpair>
<name>vc::cookie</name>
<value>$/BV - MVV/Main/Tools/Documentatie/mvv-beheerders</value> <- The location of the project in TFS.
</matchedpair>
</miscproperties>

Writer can't see projects in Robo Version Control - no error messages

Background:
Robo Version Control 3.1
RoboHelp 8 (same issue happened with 7)
Issue:
We are having trouble with our source control, and I wasn't able to find an answer on this forum or on Google.
From time to time, when a writer opens RoboSource Control Explorer, they can't see any projects. They're not getting error messages, they seem to connect to the DB, but the left pane is simply empty (they don't see the root folder or anything else). We recently upgraded to RoboHelp 8, but this has happened on RoboHelp 7 too. Source control does work - for example, if they open their local version of a version controlled project, they can get the latest version of files, check in, check out and so on. They simply can't use RSC Explorer, so they can't Get projects they don't have on their HDDs already.
In the meantime, Source Control works just fine for the rest of the team, so I'm guessing it's a problem with some local settings. (The writer who is having trouble now can't get it working on her machine with her personal user or the admin user. At the same time, I can use the admin user just fine from my machine.)
This problem always solved itself after a while, but it's getting a bit annoying and I'm hoping someone knows why this is happening.

In general, manually moving files around inside the store like this should be discouraged.
reconstruct is telling you something is wrong:
ERROR: Inconsistent information: 0 idx records 41 messages 0 expunged
Reconstructing...
cannot retrieve message uid 590
cannot retrieve message uid 807
cannot retrieve message uid 911
cannot retrieve message uid 915
cannot retrieve message uid 1198
cannot retrieve message uid 1286The first line is to be expected based on what you have done. The store.idx indicates there are no messages in the folder. But it found 41 .msg files. So it is going to rebuild store.idx to fix that.
But then there is some problem with accessing the .msg files. Possibilities would include:
- wrong ownership/permissions?
- the .msg file being in the wrong NN subdir ??
If those guesses do not lead to anything, try truss on the reconstruct command to see what happens when reconstruct tries to open those files.

Version Control - Web(JSF) project

Hello fellows,
Which version control for Web project you are using? I have been using CVS for common java (and nojava) projects but is there any another version control tool for Web projects. Any suggestion how web projects should be stored in repository?, how web project should be maintained ?.
Any help and suggestion will be helpful.
Thanks in advance.

SVN is better then CVS

Extremely slow performance on projects under version control using RoboHelp 11, PushOk, Tortoise SVN repository

We are also experiencing extremely slow performance for RoboHelp projects under version control. We are using RoboHelp 11, PushOk and a Tortoise SVN repository on a Linux server. We are using a Linux server on our IT guys advice because we found SVN version control under Windows was unstable.
When placing a Robohelp project under version control, and yes the project is on my local machine, it can take up to two hours to complete. We are using the RoboHelp sample projects to test.
We have tried to put the project under version control from Robohelp, and also tried first putting the project under version control from Tortoise SVN, and then trying to open the project from version control in Robohelp. In both cases, the project takes a ridiculous amount of time to open. The Robohelp status bar displays Querying Version Control Status for about an hour before it starts to download from the repository, which then takes more than an hour to complete. In many cases Robohelp becomes unresponsive and we have to start the whole process again.
If adding the project to source control completes successfully, and the the project is opened from version control, performing any function also takes a very long time, such as creating a topic. When I generated a printed documentation layout it took an astonishing 218 minutes and 17 seconds to complete. Interestingly, when I generated the printed documentation layout again, it took 1 min and 34 seconds. However when I closed the project, opened from version control, and tried to generate a printed documentation layout, it again took several hours to complete. The IT guys are at a loss, and say it is not a network issue and I am starting to agree that this is a RoboHelp issue.
I see there are a few other discussions here related to this kind of poor performance, none of which seem to been answered satisfactorily. For example:
Why does it take so long when adding a new topic in RH10 with PushOK SVN
Does anybody have any ideas on what we can do or what we can investigate? I know that there are options for version control, but am reluctant to pursue them until I am satisfied that our current issues cannot be resolved.
Thanks Mark

Do other applications work fine with the source control repository? The reason I'm asking is because you must first rule out that there are external factors causing this behaviour. It seems that your it guys have already looked at it, but it's better to be safe than sorry.
I have used both VSS and TFS and I haven't encountered such a performance issue. I would suggest filing it as a bug if you rule out that the problem is not related to external influences: https://www.adobe.com/cfusion/mmform/index.cfm?name=wishform&loc=en
Kind regards,
Willam

Version control (lvcompare and lvmerge) for projects, classes and libs?

Hi everyone
Version control for classes, projects and libs (not just a plain .vi) - can it be done with lvcompare and lvmerge?
I've tried a simple "LVCompare.exe project1.lvproj project2.lvproj" and it only returns an error (lvcompare.exe vi1.vi vi2.vi works). So this is maybe a dead end.
How do you guys version control more complex projects? E.g. projects which use classes, libs, labview projects (.lvproj)?
Best regards
Jonascj

Thank you for your reply. You are right, .lvclass, .lvproj and .lvlib are all just xml files - I've just figured that out my self when I accidentally called GIT's default diff on a lvclass
I've also just spoken to National Instruments. The person I spoke to (from the one of the danish offices) told me that no tools exist at this time (2013-04-08) which will compare those LabView file types, but that there was an internal (National Instruments themselves) feature request for such tools.
He also told me another interesting thing which I did not know. The lvcompare.exe (located in National Instruments/Shared/LabVIEW Compare/ on Windows) is actually the not developed by National Instruments, but is either a "fork" of LVDiff (http://meta-diff.sourceforge.net/) or LVDiff renamed. So one could simply obtain the source code from http://meta-diff.sourceforge.net/ (at the bottom of the page "Win32 binary w/source") and add a few property nodes to do comparision of lvclass attributes etc.

Opening a project from version control

RH11 | WebHelp
This may be related to my previous post (File Status "New version available") but I am now unable to open a project from version control using the padlock button in RoboHelp's Open Project dialog box. It lets me select a project to open, but then just sits there, not doing anything.
Any ideas?
Thanks
Jonathan

This sounds like a bug to me. Does the RH11 work on a Windows 7 machine? If you have a VMWare lying around, you may want to give that a shot. Short of contacting Adobe with a bug report, I'm out of idea's.
Kind regards,
Willam

Project Not Checking out From Version Control

All of our help projects are managed using version control
(Team Foundation Server).
I recently had an XPJ file that became corrupted. As per
Adobe's instructions, I deleted the XPJ and CPD files and
regenerated the project from the HHP file. That worked fine, but
now launching the project from the XPJ file opens the project
outside of version control. (I'm no longer being prompted to check
the files out.) I think this is because the newly created XPJ file
now disassociated with the source control. If this is true, how do
I get the XPJ file back into source control?
Hopefully this makes sense.
Christina Stommel

Hi Christina,
My understanding of the entire "version control" process is
limited but since no one else has thrown in, I will try to pass
along what little I know. What I have learned is that version
control works great until it doesn't.
What I've had to do in the past, when I've had these sort of
synchronization problems, is to remove the entire project from
version control (I would be sure to back up your local project as
well as your version-controlled project). Then, you should be able
to add the repaired project back to your source control software
(we use MS VSS but I think it shouldn't matter).
I have tried, in the past, to add individual files to the
database from the RH interface (you could try "check in all files")
and I have gone into the database and manually added the necessary
files, but I have had mixed results. In the end, it seems that
removing the project from version control, then adding it back, is
the only thing that is guaranteed to work.
Good luck!

How do you create translated versions of a project under version control?

Hi,
We have a project under version control that has been translated. How do we best create projects for the translated material so that the webhelp output matches the English version only translated? Is it possible to create a project with a name that reflects the translated language, copy the English project file to the new folder, change the name to coincide with the translated version, import all of the associated English files, and then exchange all of the English files with the translated ones?
Thanks,
Allen

Hello Allen and welcome to the community.
See if this article helps. You didn't mention which RH version you're using, but except for the features specifically called out as being in RH8, the process should work for RH7 projects.
I use Subversion for version control, and I haven't had any additional challenges from having localized projects in version control—you check the files in and out as you do the English ones. Check out the article and let us know if you have any additional questions.
Note that the article gives recommendations, but you certainly can do your localized versions as completely separate projects. If you do it that way, for each separate project, copy the English project to a new location, rename it if you want, and change the project language.
Hope this helps,
Ben
GryphonMountain.net

How to upgrade RoboHelp HTML 9 version-controlled projects to RoboHelp HTML 10

Existing Environment:
PC 1: RoboSource Control Server
Windows 7, 64-bit, SP1
Adobe TCS 3.5
RoboHelp HTML 9
RoboSource Control 3.1 (Server install)
Microsoft SQL Server 2005
PC 2: Client
Windows 7 Enterprise, 64-bit, SP1
Adobe TCS 3.5
RoboHelp HTML 9
RoboSource Control 3.1 (Client install)
PC 3: Client
Windows 7 Enterprise, 64-bit, SP1
Adobe TCS 3.5
RoboHelp HTML 9
RoboSource Control 3.1 (Client install)
PC 4: Client
Windows 7 Enterprise, 64-bit, SP1
Adobe TCS 3.5
RoboHelp HTML 9
RoboSource Control 3.1 (Client install)
PC 5: Client
Windows 7 Enterprise, 64-bit, SP1
Adobe TCS 3.5
RoboHelp HTML 9
RoboSource Control 3.1 (Client install)
We are upgrading from TCS 3.5 to TCS 4. In our existing TCS 3.5 environment, we have approximately 20 RoboHelp HTML 9 projects that are under version control. Our version control system is provided through RoboSource Control 3.1/Microsoft SQL Server 2005.
I have determined that RoboSource Control 3.1 is provided with TCS 4. Therefore, it doesn't appear that we need to worry about upgrading the version control databases or the RoboSource Control software (we had to upgrade both the version control software and the version control databases when we upgraded from RoboHelp x5 to TCS 3.5).
So, my primary question is this: After we run the TCS 4 install, what is the recommended process for opening our existing RoboHelp HTML 9 projects from the new RoboHelp HMTL 10? As I see it, there are three potential answers:
Delete all existing RoboHelp HTML 9 "working" folders for the projects, and use RoboHelp HTML 10 to recreate the "working" folders from the version control databases.
Simply open the existing RoboHelp HTML 9 "working" folders for the projects using RoboHelp HTML 10.
It doesn't matter; either of the two options above will work.

Hi,
I'm not really familiar with RCS, but for other source control systems I recommend the following:
1. Make sure that all your changes are checked in and that at least on pc has the latest version of all the files before updating TCS.
2. Run the update.
3. Now open the project on the pc that has the latest version of all files.
4. After update, check in the entire project.
5. Get the latest version on all pc's using the server. (Don't open the project in the client.)
- Mostly, I just remove the entire project from the pc's and use a GET to get updated project from the server.
I hope the RCS supports a get all from the server, if not, please ignore the above list.
Greet,
Willam

Error Message - Project is missing or has been removed from version control

All of a sudden, the SharePoint RoboHelp version control "link" stopped connecting to the team's local versions. Now, once we logout of RH, we have to redownload the SP version to our computers in order to continue working. We are on RoboHelp 10 and did not have this issue previously. We do not know what may have triggered it (perhaps an enterprise deployment of new security software?). Any thoughts or ideas on how to re-establish and MAINTAIN the version control connection?

Thread moved to Source Control.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Oracle Service Bus Configurations version control and deployment automation

Hi,
Currently we have OSB10gR3 installed and we use the web based sbconsole to create projects and proxy services. It's all working well and good!!
We are at the state where we need to think about source control, migration of artifacts from dev to test and to prod.
I'm looking for pointers to version control the artifacts of OSB projects, what could be version controlled (no binaries) and how do we extract those artifacts?
How do we customize those artifacts while migrating to different environments in an automated fashion?
Please point me to best practices and gotchas that we should be aware of while dealing with deploying OSB proejcts from test to Prod.
Thanks in Advance!!

After reading the threads mentioned by Deba, I'm able to get this all worked out with SBConsole itself. Experts, please review my approach below and let me know if I have overlooked anything.
Simple advantage I see in using sbconsole is that it requires less maintenance, i.e. avoids rolling out another IDE (Eclipse -Workshop plug-in) to IT developers and at the same time provides the functionality that we are looking for. Currently, JDeveloper is our primary IDE, so we thought it's best to wait till OSB development gets integrated into JDev.
This is the deployment workflow which worked for us,
Developer:
1)Develops Proxy services using SBconsole in Dev environment.
2)Creates sbconfig.jar by using the export functionality available in System Administration link in sbconsole
3)Checks-in ALL the files present in the above jar into version control under the proxy service project name
4) Creates customization file using the customization file link in System Administration and modifies the value for each environment i.e. creates two files test_customfille, prod_customfile
5)Checks-in the customization files into version control under the same proxy service project
Promotion to Test and Prod
1) From the source control, service proxy is built (actually the jar file of all files including the custom file is created)
2) SCP proxy_sbconfig.jar file to Test or Prod box
3) Follow the steps mentioned in Auto deploy of ALSB/OSB artifacts - Proxy, WSDL and webservices...
4) Depending on the server, test or prod, pick the right customization file and deploy using ANT.
Thanks!!

Application size in terms of pages and performance and Version Control

Currently I'm looking into the best way to version control our APEX applications. From other threads, it seems it's an area that leaves much to be desired. We are on the verge distributing a large APEX project commercially but I cannot find a suitable versioning method to support bug fixes and new development happening at the same time to the same set of applications. I just hope everyone out there realises versioning is a vital area of the development process and VOTES for it in the V3 poll.
Anyway, enough of the my whinging. I did have a brain wave (quite rare !). What would the drawback be to have only 1 or 2 pages per application. This would allow a developer to always import the application at the start of work (ie from versioning software such as VSS or PVCS) and then export it at the end back into say PVCS. The application has everything self contained and correct versions etc.
This would allow more developers to work on different areas at the same time as opposed to having many pages in the one application where developers could step on each others toes etc. I've considered importing/exporting pages but the fact you cannot lock shared objects means there is a possibility that if many developers are working on the same application someone will change something that affects pages other than their own. It would also be a nightmare to tie up different versions of of pages, shared objects, applications etc. Would there a performance problem with this method ? Incidentally, why can't TABS be shared/subscribed across applications. It means they have to be created separately in each application whereas things like Nav Bars and Templates can be shared across applications.
Currently, my thoughts are that: bug fixing for a production release has to be in a separate stream (apex installation) from say new development work for the same set of applications BUT what this means is that the bug fixes have also to be manually applied in the new development stream - which is a considerable overhead (ie twice the work).
Thanks for hearing me out - assuming you survived to the end !
Any encouraging comments would be appreciated !

Wim,
I don't entirely understand the behavior. There should be little/no difference between the two cases. I'm assuming you have no indexes, which isn't recommended for such large containers anyway. Can you make your document set available to me so I can see if I can reproduce the behavior and look at it more closely? A single container, or dbxml_dump of a container is sufficient (both compress well).
Contact me directly at george dot feinberg at you know where.
George

Cp5 Project version control

Similar Messages

Maybe you are looking for