<html dir="LTR">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252" />
<meta name="vs_targetSchema" content="http://schemas.microsoft.com/intellisense/ie5" />
<title>P4Record Class</title>
<xml>
</xml>
<link rel="stylesheet" type="text/css" href="MSDN.css" />
</head>
<body id="bodyID" class="dtBODY">
<div id="nsbanner">
<div id="bannerrow1">
<table class="bannerparthead" cellspacing="0" id="Table1">
<tr id="hdr">
<td class="runninghead">Perforce API for the .Net CLR</td>
<td class="product"><img alt="P4.Net" src="p4net.GIF" /></td>
</tr>
</table>
</div>
<div id="TitleRow">
<h1 class="dtH1">Known Limitations</h1>
</div>
</div>
<div id="nstext">
<H4 class="dtH4">Internationalized Servers</H4>
<P>Perforce servers running in "unicode" or "internationalized" are untested. At a minimum, metadata stored with non-
ASCII characters will get mangled, and P4.Net may not work at all.<P/>
In the current implementation, all string conversions between managed and native code assume the native code
is ANSI encoded. I will need to build a string conversion method in p4dn that will know when we are connected
to an internationalized server, and translate from the appropriate encoding. It will take a little testing to
determine whether to use Perforce's translation API or .Net's (or some combination of the two). P4Python and P4COM
shows how to use the undocumented "translate" method in the C++ API.
</P>
<h4 class="dtH4">Forms</h4>
<P>Direct manipulation of the form text is not supported. That is, there is no
way get the raw text of a from command or to save a form with the raw form. Instead,
you must use the P4Form object.
</P>
<h4 class="dtH4">p4 print</h4>
<P>There is currently no way to obtain an in-memory stream of file contents using the 'print'
command. In other APIs, if multiple files are output using 'print', the contents of the file
are concatanated into one in-memory variable. I have an idea that would correct this behavior,
but it is more complex to consume. So I've punted on the idea for now, and it is unsupported.
</P>
<h4 class="dtH4">p4 filelog</h4>
<P>The parsed output for the of the filelog command is awkward. In the native C++ api, the
integration metadata is a sparse 2 dimensional array. The parsing logic in P4.Net does not
account for this, so you end up with an ArrayFieldDictionary with keys like 'fromFile1,'.
So, I could fix this, and come up with some sort of TwoDimArrayFieldDictionary. However,
the trying to make sense of the filelog output using the 2-d arrays will almost certainly
give you a headache. Instead, I want to research Tony Smith's implementation in P4Ruby. He
has created an object model that represents the filelog metadata in an easy-to-use interface.
</P>
<h4 class="dtH4">Submitting Default Changelist</h4>
<P>In P4.Net, theres no straight-forward way to submit the default pending changelist.
This is by design. If the client workspace has opened files in the default changelist
before any P4.Net automation runs, those files will "come along for the ride" when
you submit the default changelist. If the user has a JobView set, all jobs in that
JobView will automatically be fixed when you submit that default changelist. Both
of those behaviors are almost never desired, and Ive found many scripts that have
those bugs.
</P>
<P>
Note, starting in 2006.2, Perforce has native support for automatically submitting the
default changelist. This is accomplished with: p4 submit -d "change description".
</P>
<h4 class="dtH4">Changing Port after Connected</h4>
<P>You can not change the P4Port setting after a P4Connection has been connected.
This is true even after a Disconnect(). Instead, create a new P4Connection object.
</P>
<h4 class="dtH4">Supported Server Versions</h4>
<P>Servers lower than 2004.2 begin to fail the unit tests. However, it is not a complete failure.
One issue is the use of p4 login. The other failure is in the ConvertDate methods, because they
use p4 info in parsed mode to determine the server's time zone. If you avoid those methods, P4.Net
should work fine against older servers.
</P>
<hr /> <div id="footer">
<p>
<a href="Copyright.html">Copyright 2006 Shawn Hladky</a>
</p>
<p>
</p>
</div>
</div>
</body>
</html> | # | Change | User | Description | Committed | |
|---|---|---|---|---|---|
| #5 | 5830 | Shawn Hladky | P4.Net: reorg to support release branches | ||
| #4 | 5824 | Shawn Hladky | P4.Net: Last bits of documentation for 0.9 | ||
| #3 | 5815 | Shawn Hladky |
P4.Net: more documentation will build strong-named assemblies now. |
||
| #2 | 5812 | Shawn Hladky | P4.Net: More documentation. | ||
| #1 | 5798 | Shawn Hladky |
P4.Net... still not ready for beta Added license to all files Added several doc files Misc bugs |