A bit more information: $System.Process.Terminate was added in 2015.1.0.
- Log in to post comments
A bit more information: $System.Process.Terminate was added in 2015.1.0.
Try:
Do $System.Process.Terminate(,exitCode)See documentation for reference. On older versions I believe the equivalent is:
Do $zu(4,$job,exitCode)But this shouldn't be used if the nicer method is available.
Yeah, that would be nice to have. I looked a bit and didn't see one right away. (I'd actually been wondering the same thing last night, as it happens.)
Actually - if you're going to do this after issuing the Get, you should use request.Get(,,0), then do this, then call Reset() on the request manually. Otherwise the parameters will get cleared out and the query string will always be blank.
I'd suggest something like this, after calling Get:
Set tParams = request.ReturnParams()
Set tQuery = $Case(tParams,"":"",:"?"_tParams)
Set tURL = $Select(request.Https:"https://",1:"http://")_request.Server_":"_request.Port_"/"
_request.Location_tQuery1/2. I use the "My Content" page to quickly get back to my own posts. I don't use "My Collaborations" or understand how the content that appears there is determined.
3. I'd expect to see my own posts (and perhaps answers) on "My Content" and for "My Collaborations" to show links to questions that I have answered and to posts/answers that I have commented on. Answers could fit in either category (or both); I'm not sure if those are best understood as content or as a particular type of comment.
4. Show the content described in (3) on these pages. Also, for answers, rather than showing "answer406256" as the title (for example), show "Answer: <title of question>" and link to the answer within the question page rather than the answer on its own. I think the same would also apply to comments shown on "My Collaborations" (if that approach is taken). If "My Collaborations" shows comments it might make sense to group them by post, in case there's a very active back-and-forth.
Here are two perspectives, from different development workflows:
My team (working on a large Caché-based application) does development on a newer Ensemble version than the version on which our software is released. We perform functional and performance testing against the older version. Most of the time, moving code from newer versions to older works just fine; when it does fail, it tends to be very obvious. The last class dictionary version change was in 2011.1, so that isn’t a concern for upgrades involving recent versions. These used to be much more frequent. Working this way provides a good sort of pressure for us to upgrade when we find new features that the old version doesn’t have or performance improvements on the newer version. It also eases concerns about future upgrades to the version on which the application has been developed.
For Caché-based internal applications at InterSystems, we have separate designated dev/test/live environments. Application code changes typically spend a relatively short time in dev, and a much shorter time in test, before going live. Upgrades are typically done in a short time frame and move through the environments in that order. It would be incredibly risky to upgrade the live environment first! Rather, our process and validation for upgrades go through the same process as functional changes to these applications. The dev environment is upgraded first; this might take time if there are application issues found in testing after the upgrade. The test environment is upgraded next, typically a very short time before the live environment is upgraded. It's OK if code changes are made in dev before the test environment is upgraded, because changes will still be compiled and tested in the older Caché/Ensemble version prior to going live. Of course, if testing fails, the upgrade may become a prerequisite for the given change to the application. Additionally, we periodically clone the test environment for upgrades to and validation against field test versions. Using virtual machines makes this very easy.
This should accomplish what you want:
var tablePane = zen('yourTablePaneId');
// Don't actually execute the query the next time the table is rendered.
tablePane.setProperty('initialExecute',false);
// Clear the snapshot (cached results of the query, used for quick pagination) before re-rendering.
// This is irrelevant if the tablePane isn't using snapshots.
tablePane.setProperty('clearSnapshot',true);
// Regenerate HTML for the tablePane - it'll be empty.
tablePane.refreshContents();
Or, a bit more simply:
var tablePane = zen('yourTablePaneId');
// Don't actually execute the query the next time the table is rendered.
tablePane.setProperty('initialExecute',false);
// Re-execute the query (this also clears the snapshot if snapshots are in use)
tablePane.executeQuery();
If refreshContents() / executeQuery() is called again, query results will be shown, because initialExecute is set to true each time the tablePane is drawn.
One solution would be to look at the audit database. It's not pretty, but there might not be any other way.
ClassMethod GetLoginService() As %String
{
New $Namespace
Zn "%SYS"
Set tService = ""
// Ensure that login events are being audited.
Set tLoginEvent = ##class(Security.Events).Get("%System","%Login","Login",.tProps)
If '$Get(tProps("Enabled")) {
// Querying the audit DB probably won't do any good.
Quit tService
}
// Warning: on systems with a lot of activity, this query might take a long time.
// It might be worth filtering by recent UTCTimeStamp, assuming processes won't be that long-running.
Set tRes = ##class(%SQL.Statement).%ExecDirect(,
"select top 1 EventData from %SYS.Audit "_
"where EventSource = '%System' and EventType = '%Login' and Event = 'Login' and PID = ? "_
"order by UTCTimeStamp DESC, SystemID DESC, AuditIndex DESC",$Job)
Set tHasResult = tRes.%Next()
If (tHasResult) {
Set tData = tRes.%Get("EventData")
//NOTE: This makes assumptions about the format of EventData.
//Particularly, that it looks something like:
/*
Service name: %Service_Bindings
Login roles: %All
$I: |TCP|1972|15396
$P: |TCP|1972|15396
*/
//
Set tFirstLine = $Piece(tData,$c(13,10))
//Presumably "Service name:" might be localized, but %Service_<something> would not be.
Set:tFirstLine["%Service" tService = "%Service"_$Piece(tFirstLine,"%Service",2)
}
Quit tService
}
Note: if your application is using Caché security correctly, you'd probably need to define a privileged routine application to allow access to Security.Events and the audit database.
You could probably edit the post, then click the "Source" button, and remove them from the HTML.
Agreed.
Here's a link for the Developer Community Feedback "group":
https://community.intersystems.com/group/developer-community-feedback
For what it's worth, a more direct answer to the question "Who does Windows think I am?" can be found programmatically with:
$System.Process.UserName()
(2015.1+; see class reference)
%ZEN.ObjectProjection demonstrates a few answers to your second question. There are probably more differences/advantages, but here are a few:
Thanks! The connection to the NLS locale makes sense.
Eduard,
It would help if there was further explanation of your use case. What is the "additional check" in question? Is it a flag on the user at the application level? Is it a call to some other system?
For simplicity, let's suppose your application has a role called TerminalUser that has the %Service_Console:U permission, and that it's the only role an application user might have that grants that permission.
If the "additional check" is based on a flag in your application, your application could simply add/remove the TerminalUser role when that flag changes. See class documentation for Security.* in the %SYS namespace. This might rely on a "privileged routine application" to escalate roles if the user changing this flag wouldn't normally have the necessary privileges to change security settings.
In either case, ZAUTHENTICATE might still work, although it wouldn't be as elegant. It could perform whatever additional checks are needed (against your application or some external system), and possibly add or remove the TerminalUser role based on the results. ZAUTHENTICATE would always return an error, so it falls back to password login. At that point the user could authenticate successfully but might not be allowed to use terminal if the TerminalUser role was removed. (I haven't tried this, but it seems like it could work.)
If you're using OS or Kerberos authentication, ZAUTHORIZE could also be relevant.
Specifics on %CSP.Page / cspbind error handling:
There are alternatives to modifying system-level error message translations. Even if the localization is changed, the end user would probably still see "SQLCODE -139," which isn't helpful. What you probably want to show the user is "Someone else has modified this record. Please reload the page and try again." or something similar.
Using %CSP.Page and a form with cspbind, there's no way to customize the error handling in the generated <form name>_save function. It seems to always show any error message in an alert. An alternative would be to use a similar approach to form.csp and formsubmit.csp in the SAMPLES namespace, submitting the form and calling the <form name>Submit method of the page rather than using a hyperevent (in form_save()). Note that you don't need a separate page to handle the form submit; one page can do it all.
Of course, if the form is saved with a POST rather than a hyperevent, and optimistic concurrency control is in use, it might be worth a separate call to the server immediately before submitting the form for an optimistic concurrency check. If someone else edited the record, the page could tell the user rather than submitting the form. This wouldn't prevent the error in question, but would at least make it much less likely.
(Side note: %CSP.Page/cspbind is very old technology. There are better tools available now, but if you're stuck with it in a large existing project, that's understandable.)
General thoughts on showing users friendly error messages:
The more general problem is: "Often, the error codes and messages the system produces are not helpful to an end user. How do you show the user the information they need when an error occurs?"
This gets more complicated because error messages can come from very different sources - for example, SQL, an object %Save, a variable being undefined, or the application detecting a user error.
The standard for the large Caché-based application I work on is:
The original suggestion might still work, but there are caveats with serial objects and probably some other edge cases.
What's your use case, if you don't mind elaborating? Why is SQL syntax necessary? What Caché version are you running (run in terminal: write $zversion)?
This has been bothering me a little bit; %Dictionary.* should really be a last-resort option, in my opinion, and it isn't easy to use it to get the full picture from an SQL perspective.
Here are some alternative/possibly-better solutions, using %SQL.StatementMetadata and INFORMATION_SCHEMA. It looks like INFORMATION_SCHEMA is more exactly what you were looking for, if you're running on a recent enough Caché version (2015.1+). I haven't been able to find documentation on it other than the class reference, though.
/// NOTE: It could be good to validate pTableName to avoid SQL injection. (Outside the scope of this demo.)
/// This works pre-2015.1 (since %SQL.Statement was introduced - maybe 2012.2+?)
ClassMethod GetTableColumns(pTableName As %String) As %List
{
#dim tResult As %SQL.StatementResult
#dim tMetadata As %SQL.StatementMetadata
Set tStmt = ##class(%SQL.Statement).%New()
$$$ThrowOnError(tStmt.%Prepare("select top 0 * from "_pTableName))
Set tResult = tStmt.%Execute(), tMetadata = tResult.%GetMetadata()
Set tCols = ""
For i=1:1:tMetadata.columnCount {
Set tCols = tCols_$ListBuild(tMetadata.columns.GetAt(i).colName)
}
Quit tCols
}
/// This will only work on 2015.1+; INFORMATION_SCHEMA is a new feature. For more information, see the class reference for it in the documentation.
ClassMethod GetTableColumnsNew(pTableName As %String) As %List
{
#dim tResult As %SQL.StatementResult
Set tStmt = ##class(%SQL.Statement).%New()
Set tSchema = $Piece(pTableName,".")
Set tTableName = $Piece(pTableName,".",2)
$$$ThrowOnError(tStmt.%Prepare("select COLUMN_NAME from INFORMATION_SCHEMA.COLUMNS where TABLE_SCHEMA = ? and TABLE_NAME = ?"))
Set tResult = tStmt.%Execute(tSchema,tTableName)
Set tCols = ""
While tResult.%Next(.tSC) {
Set tCols = tCols_$ListBuild(tResult.%Get("COLUMN_NAME"))
}
$$$ThrowOnError(tSC)
Quit tCols
}
Using this:
SAMPLES>set cols = ##class(Demo.TableColumns).GetTableColumns("Sample.Person")
SAMPLES>w $lts(cols)
ID,Age,DOB,FavoriteColors,Name,SSN,Spouse,Home_City,Home_State,Home_Street,Home_Zip,Office_City,Office_State,Office_Street,Office_Zip
SAMPLES>set cols = ##class(Demo.TableColumns).GetTableColumnsNew("Sample.Person")
SAMPLES>w $lts(cols) ID,Age,DOB,FavoriteColors,Name,SSN,Spouse,Home_City,Home_State,Home_Street,Home_Zip,Office_City,Office_State,Office_Street,Office_Zip
Perhaps try:
SELECT NVL(SqlFieldName,Name) FROM %Dictionary.CompiledProperty
WHERE parent = 'HS.IHE.ATNA.Repository.Aggregation' and Transient = 0
%Dictionary.PropertyDefinition only includes properties defined in a given class; %Dictionary.CompiledProperty includes properties that are inherited.
Thanks!
Great, thanks Kyle!
I agree. In some cases, having an initial default value determined when the object is saved - possibly based on values of other properties, which InitialExpression wouldn't allow - could be useful, if that's how SqlComputed + SqlComputeCode is expected to work. This probably isn't one of those cases.
In various posts, you've talked about having an implementation tool that is run from the browser, and you've also talked about running it from terminal. Here's a design that would be well-suited to both:
* Settings that apply to the whole thing are properties of an object (class extends %RegisteredObject)
* There's a class method (static method in other languages) to get the settings' values interactively
* There's an instance method to run the setup on an instance of the class
Include %syPrompt
Class Demo.SetupTool Extends %RegisteredObject
{
Property Type As %String(VALUELIST = ",Gateway,IHE");
Property Setting1Value As %String [ InitialExpression = "ABC" ];
Property Setting2Value As %Boolean [ InitialExpression = 1 ];
ClassMethod RunInteractive()
{
Set tSettingsObject = ..%New()
Write "Deployment Utility"
Set options(1) = "Gateway"
Set options(2) = "IHE"
Do ##class(%Prompt).GetArray("Deployment Type?",.tType,.options,,,,$$$InitialDisplayMask+$$$MatchArrayMask)
Set tSettingsObject.Type = tType
Set tString = tSettingsObject.Setting1Value
Do ##class(%Prompt).GetString("Enter a string: ",.tString)
Set tSettingsObject.Setting1Value = tString
Set tYesOrNo = tSettingsObject.Setting2Value
Do ##class(%Prompt).GetYesNo("Is this a helpful demo? ",.tYesOrNo)
Set tSettingsObject.Setting2Value = tYesOrNo
Do tSettingsObject.DoSetup()
}
Method DoSetup()
{
Write !,"Starting ",..Type," deployment...",!
// Here, do things based on properties of this object.
If '..Setting2Value {
//Do something specific if Setting2Value is false.
Write "Why not?",!
}
}
}
Then, for example:
USER>d ##class(Demo.SetupTool).RunInteractive()
Deployment Utility
1) Gateway
2) IHE
Deployment Type? 1 Gateway
Enter a string: ABC =>
Is this a helpful demo? Yes => No
Starting Gateway deployment...
Why not?
Or, if you want to do the same kind of setup from a simple ZenMethod in a Zen page or something, you could set up a settings object and then call DoSetup() on it.
USER>set tSettings = ##class(Demo.SetupTool).%New()
USER>set tSettings.Type = "IHE"
USER>d tSettings.DoSetup()
Starting IHE deployment...
Here's some relevant documentation: http://docs.intersystems.com/cache20152/csp/docbook/DocBook.UI.Page.cls?KEY=GORIENT_ch_cos#GORIENT_cos_scope
One way to make this work as-is would be to put tstVar in the "public" list:
start
set tstVar = "Green"
do TestIt()
TestIt() [tstVar] {
write tstVar
}
Another would be to give the variable a name starting with a %:
start
set %tstVar = "Green"
do TestIt()
TestIt() {
write %tstVar
}
Look at $zconvert (abbreviated $zcvt):
http://docs.intersystems.com/cache20152/csp/docbook/DocBook.UI.Page.cls?KEY=RCOS_fzconvert
For example:
USER>w $zcvt("thisIsATest","U")
THISISATEST
USER>w $zcvt("thisIsATest","L")
thisisatest
You could probably download the single-user evaluation version of Caché to get a look at the SAMPLES namespace, go through tutorials, etc - see https://download.intersystems.com/
For understanding routines in general, I'd recommend this part of the documentation.
"Character-based user interface"
It is in the 2015.2 documentation (you linked to 2010.1):
$$$MatchArrayMask - Only entries from the array of options are allowed, not case sensitive
Update: It looks like it first showed up in 2013.1.
"GOTO label" jumps to a specified label in the same context frame.
"DO label" adds a new context frame. Code at the specified label will execute until a QUIT/RETURN or the end of the routine, then execution will resume at the next line after the DO command.
So in this case it's running through the whole routine (including everything under the dataentry label, with dtype already set to something valid), including printing the message at the end. Then it proceeds to the next thing after the DO command, which is printing that line again.
For what it's worth, if you're building command-line tools, %Library.Prompt may save you a lot of time. See the class reference for more informatioan.
For example:
#include %syPrompt
New options,dtype
Write "Deployment Utility"
Set options(1) = "Gateway"
Set options(2) = "IHE"
Do ##class(%Prompt).GetArray("Deployment Type?",.dtype,.options,,,,$$$InitialDisplayMask+$$$MatchArrayMask)
Write !, "Starting ", dtype," deployment..."
Quit