Publishing & Refreshing
There are two tools that govern the interaction between TeamSpec and your Team Foundation
Server: Publish and Refresh. The publish tool saves changes you have made and work
items you have created to the server. The refresh tool updates the information in
your document with the values that are saved on the server.
Publishing
The easiest way to publish content to your server is with the global "Publish" button
in the TeamSpec tab of the ribbon bar.
This will save every work item you have created or modified in TeamSpec to your
Team Foundation Server.
You can also publish specific work items. Simply right-click on a work item in the
Index and select "Publish."
Publishing Issues
There are several problems that can arise and impede your publishing content to
your server. If you have referenced the same work item multiple times with different
values, if you have failed to fill out a required field in a new work item, or if
you have filled out a work item field with an invalid value you will not be able
to publish it without resolving the issue. If you try to publish with one of these
issues in your document, TeamSpec will open the "Publishing Issues" dialogue.
If you have two references to the same work item with different values, you will
need to select one of them to publish to the server.
Choose which value you want from the option tabs and then click "Use the currently
shown Value." Then click "Publish Ready Items" to save your selection to the server.
If you have input an invalid value for a work item field, you will be prompted to
select a valid option.
Once you have done so, click "Publish Ready Items" to save your work item to the
server.
If you have failed to fill out a required field for a new work item you have created
in your document, you will be prompted to do so before you can publish the item.
Input or select a value for any field labeled "Invalid Empty." When you have populated
all the required fields, click "Publish Ready Items" to save your new work item
to the server.
Refreshing
The easiest way to refresh the content of your document with values from your server
is with the global "Refresh" button in the TeamSpec tab of the ribbon bar.
This will compare every value of a work item that is referenced in your document
with the value that is saved on your server.
You can also refresh specific work items. Simply right-click on a work item in the
Index and select "Refresh."
When there are differences between the values in your document and the values on
the server, TeamSpec will give you the option to "Overwrite local values" or to
"Merge" the values.
If you select "Overwrite local values," TeamSpec will replace every value in your
document with the values on the server. If you select "Merge," TeamSpec will open
a dialogue in which you can choose which value you want for each disagreement.
Select which value you want from the "Comparison" section of the window. If you
want to use the values from the server for every disagreement, you can streamline
the process by clicking "Resolve Remaining Items with Server." You can do the same
if you want to use all the values from your document with "Resolve Remaining Items
with Document." When you are finished, click the "Refresh Ready Items" to apply
your choices.
Additional Topics
Send questions or comments about this topic to TeamSolutions