Caché 2017.2

新しいインストールでは機能トラッカが既定で有効化されている

機能トラッカは、ソフトウェア・モジュールの使用量に関する統計を収集する Caché のソフトウェア・ユーティリティです。この統計は、特定の Caché インスタンスにソフトウェア・モジュールが存在し、使用されているかどうかを追跡します。機能トラッカは、毎週この情報を https 経由で InterSystems に送信します。これらの統計データは、開発およびサポート計画の参考にされます。収集される情報にはアプリケーション・データは一切含まれていません。以前のリリースでは、機能トラッカは既定で無効になっていました。このリリースでは、新しいインストールで機能トラッカが既定で有効になっています。既存のインストールをアップグレードしている場合、アップグレード後も機能トラッカの既存の状態は保持されます。

機能トラッカを無効にするには、機能トラッカを実行しているタスクを一時停止します。詳細は、"Caché システム管理ガイド" の “機能トラッカを非アクティブ化する方法” を参照してください。

並列デジャーナリングによってデジャーナリング順序が変更される

このリリースには並列デジャーナリングが含まれていて、最大 4 つのジョブをデジャーナリングできます。データベースは単一のジョブによって常にデジャーナリングされているため、並列デジャーナリングは単一のデータベースをデジャーナリングする順序に影響しません。ただし、並列デジャーナリングによって、あるデータベースと別のデータベースのデジャーナリング順序が変更される可能性があります。これは、個別のデジャーナリング・ジョブによって更新されるデータベースがデジャーナリング順序において若干異なる場所にある可能性があるためです。例えば、データベース B が 11:45:28 からの更新に対してのみ準備できているときに、データベース A に 11:45:30 にプライマリで実行される更新が含まれている場合です。詳細は、"Caché 高可用性ガイド" の “ミラーリング” の章にある “並列デジャーナリングの構成” を参照してください。

ジャーナル・バッファのプール・サイズの変更

このリリースでは、ジャーナル・バッファのプール・サイズが構成できるようになり、既定のサイズが 64MB に増えました。以前のリリースでは、既定のサイズは、非 Unicode システムでは 8MB、Unicode システムでは 16MB でした。このバッファのプール・サイズの増加によって効率を向上させられますが、システムのクラッシュが発生した場合に失われる場合があるデータ量も増えます。

クラスの削除

以前のバージョンに存在していた以下のクラスは、今回のリリースで削除されています。

• %Library.RunJava

削除されたメソッド

以前のバージョンに存在していた以下のメソッドは、今回のリリースで削除されています。

• %DeepSee.UI.Dialog.ShowQuery

  • EncryptQuery

• %DeepSee.Utils

  • %ClearUpdateBuffer

• %Library.IResultSet

  • %ToDynamicArray

  • %ToDynamicObject

  • %ToJSONValue

• %Net.Remote.Utility

  • ClearPassphrase

  • GetPassphrase

  • RecordPassphrase

• %SQL.IResultSet

  • %ToDynamicArray

  • %ToDynamicObject

  • %ToJSONValue

• %SQL.StatementMetadata

  • %ToJSONValue

• Config.Shadows

  • SourceDatabasesClose

  • SourceDatabasesExecute

  • SourceDatabasesFetch

削除されたプロパティ

以前のバージョンに存在していた以下のプロパティは、今回のリリースで削除されています。

• %DeepSee.Component.Widget.controlPanel

  • isPdfEnabled

• %DeepSee.Component.Widget.widget

  • isPdfEnabled

削除されたパラメータ

以前のバージョンに存在していたパラメータでこのリリースで削除されたものはありません。

削除されたインデックス

以前のバージョンに存在していたインデックスでこのリリースで削除されたものはありません。

変更されたメソッド

今回のバージョンの Caché では、以下のメソッドのシグニチャが変更されました。

• %Atelier.v1.Utils.MetaData

  • 古いメソッド ： Build (pDataBaseName:%String) As (none)

  • 新しいメソッド ： Build (pDataBaseName:%String) As %Status

• %CSP.UI.Portal.Dialog.EncAddAdmin

  • 古いメソッド ： SaveData (What, File, Username1, Password1, Username2, Password2, Description) As %String

  • 新しいメソッド ： SaveData (What, File, Username1, Password1, Username2, Password2, Description, KeyLen) As %String

• %CSP.UI.Portal.ViewLog

  • 古いメソッド ： DrawLogContent (filename) As %Status

  • 新しいメソッド ： DrawLogContent (tmp) As %Status

• %DeepSee.AbstractKPI

  • 古いメソッド ： %GetKPIValue (pKPIName:%String, *pValue:%String, pKPIProperty:%String="", pSeries:%String="", &pFilters:%String, pCellContext:%String="", &pCacheKey:%String, *pPctComplete:%Integer, pParentQueryKey:%String="") As %Status

  • 新しいメソッド ： %GetKPIValue (pKPIName:%String, *pValue:%String, pKPIProperty:%String="", pSeries:%String="", &pFilters:%String, pCellContext:%String="", &pCacheKey:%String, *pPctComplete:%Integer, pParentQueryKey:%String="", *pKPIStatus:%Status) As %Status

• %DeepSee.Component.pivotTable

  • 古いメソッド ： getFilterInfo (fnames, fvalues) As (none)

  • 新しいメソッド ： getFilterInfo (fnames, fvalues, flabels) As (none)

• %DeepSee.PMML.Model.AbstractModel

  • 古いメソッド ： %ExecuteModelInternal (pInput:%DeepSee.PMML.ModelInput, *pOutput:%DeepSee.PMML.ModelOutput) As %Status

  • 新しいメソッド ： %ExecuteModelInternal (&pInput:%DeepSee.PMML.ModelInput, *pOutput:%DeepSee.PMML.ModelOutput) As %Status

• %DeepSee.PMML.Model.GeneralRegression

  • 古いメソッド ： CalculateXBeta (pObservation:%DeepSee.PMML.ModelInput, *pXBeta, *pBestTarget:%String="", *pBestScore:%Double="", pAddZero:%String="") As %Status

  • 新しいメソッド ： CalculateXBeta (&pObservation:%DeepSee.PMML.ModelInput, *pXBeta, *pBestTarget:%String="", *pBestScore:%Double="", pAddZero:%String="") As %Status

• %DeepSee.ResultSet

  • 古いメソッド ： %PrepareObject (pQuery:%DeepSee.Query.query) As %Status

  • 新しいメソッド ： %PrepareObject (pQuery:%DeepSee.Query.query, &pVariables) As %Status

• %DeepSee.Utils

  • 古いメソッド ： %GetDimensionMembers (pCubeName:%String, pSpec:%String, pContext:%List, *pMembers, pMaxMembers:%Integer=100, *pMemberClass:%String, &pRelatedFilters, pCalcMode:%Integer=0, pSearchKey:%String="") As %Status

  • 新しいメソッド ： %GetDimensionMembers (pCubeName:%String, pSpec:%String, pContext:%String="", *pMembers, pMaxMembers:%Integer=100, *pMemberClass:%String, &pRelatedFilters, pCalcMode:%Integer=0, pSearchKey:%String="") As %Status

• %Exception.SystemException

  • 古いメソッド ： %OnNew (pName:%String="", pCode:%String="", pLocation:%String="", pData:%String="", pInnerException:%Exception.AbstractException=$$$NULLOREF, pStack:%String="") As %Status

  • 新しいメソッド ： %OnNew (pName:%String="", pCode:%String="", pLocation:%String="", pData:%String="", pInnerException:%Exception.AbstractException=$$$NULLOREF, pStack:%String) As %Status

• %Library.GlobalEdit

  • 古いメソッド ： GetGlobalSizeBySubscript (Directory:%String, StartNode:%String, EndNode:%String="", &Size:%String=0) As (none)

  • 新しいメソッド ： GetGlobalSizeBySubscript (Directory:%String, StartingNode:%String, EndingNode:%String="", &Size:%String=0) As (none)

• %Library.Routine

  • 古いメソッド ： CompileAll (Flags:%String=0, IO:%String=$p, &Count:%Integer, &Errors:%Integer, MultiCompile:%Integer=1, Journal:%Integer=1, KeepSource:%Boolean=1) As %Status

  • 新しいメソッド ： CompileAll (Flags:%String=0, IO:%String=$p, &Count:%Integer, &Errors:%Integer, MultiCompile:%Integer, Journal:%Integer, KeepSource:%Boolean=1) As %Status

  • 古いメソッド ： CompileSelected (Mask:%String="*.*", Flags:%String=0, IO:%String=$p, &Count:%Integer, &Errors:%Integer, MultiCompile:%Integer=1, Journal:%Integer=1, KeepSource:%Boolean=1) As %Status

  • 新しいメソッド ： CompileSelected (Mask:%String="*.*", Flags:%String=0, IO:%String=$p, &Count:%Integer, &Errors:%Integer, MultiCompile:%Integer, Journal:%Integer, KeepSource:%Boolean=1) As %Status

• %Library.SQLCatalog

  • 古いメソッド ： SQLClassname (qh:%Library.SQLProcContext, table:%String) As %Library.String

  • 新しいメソッド ： SQLClassname (qh:%Library.SQLProcContext, table:%String(MAXLEN=257)) As %Library.String

• %SYSTEM.SQL

  • 古いメソッド: SetSQLStats (flag:%Library.Integer=1) As %Library.Integer

  • 新しいメソッド ： SetSQLStats (flag:%Library.Integer=0) As %Library.Integer

• %ZEN.ComponentEx.svgImageProvider

  • 古いメソッド ： dumpSVGNode (e, svgDoc, src, intro, coda, NSPrefix, maxWidth) As (none)

  • 新しいメソッド ： dumpSVGNode (e, svgDoc, src, intro, coda, NSPrefix, maxWidth, maxHeight) As (none)

  • 古いメソッド ： extractXSLFOSource (svg, intro, coda, maxWidth) As (none)

  • 新しいメソッド ： extractXSLFOSource (svg, intro, coda, maxWidth, maxHeight) As (none)

• %ZEN.Template.AddInWizard.SOAPWizard

  • 古いメソッド ： GetSRC (filetype:%String, url:%String, sslConfig:%String="", username:%String="", password:%String="") As %String

  • 新しいメソッド ： GetSRC (filetype:%String, url:%String, sslConfig:%String="", sslCheckServerId:%Boolean, username:%String="", password:%String="") As %String

  • 古いメソッド ： SaveLast (filetype, url, sslConfig="") As (none)

  • 新しいメソッド ： SaveLast (filetype, url, sslConfig="", sslCheckServerId) As (none)

• SYS.Stats.WriteDaemon

  • 古いメソッド ： Sample (DaemonID:%Integer) As SYS.Stats.Resource

  • 新しいメソッド ： Sample (DaemonID:%Integer=1) As SYS.Stats.WriteDaemon

delete() のハード・エラーが %Status 値と共に報告される

以前のリリースでは、クラス・コンパイラの delete() メソッドでハード・エラーが発生すると、呼び出し元にエラーをスローしていました。このリリースでは、これらのエラーは delete() メソッドによって処理され、エラーを %Status 値と共に呼び出し元に報告します。

DeepSee のリスト選択での表示モードの既定値の変更

以前のリリースでは、DeepSee フィールドで %EXTERNAL(field) または %INTERNAL(field) を明示的に宣言していない場合、DeepSee はリスト出力に内部値を表示していました。このリリースでは、DeepSee は外部値を使用します。内部値を使用させるには、%INTERNAL() でフィールドをラップする必要があります。

メッセージ・リスナとして JMS ゲートウェイを使用していない

このリリースでは、Java ゲートウェイから JMSGateway クラスが削除されました。このクラスは、Ensemble で JMS リスナを使用する方法の例として意図されていました。このクラスを使用して JMS リスナを実装していた場合、これを EnsLib.JavaGateway.JMSTest クラスで示されているメカニズムに置き換える必要があります。

オブジェクト・ゲートウェイ Load^%apiGTW が err 変数をパブリックにしない

以前のリリースでは、Load^%apiGTW を呼び出すと変数 err を意図的にパブリックにし、管理ポータルおよびその他の InterSystems API で使用できるようにしていました。このリリースでは、自動的にパブリックにせず、状態値を返します。使用中のコードが以前の動作を必要とする場合、以下のプログラムを呼び出して err をパブリック変数として明示的に宣言する必要があります。

Set err=$$Load^%apiGTW 

ODBCx API で使用される SysList クラス、SysListUtil クラス、および CacheListRO クラスの置き換え

ODBCx API で SysList クラス、SysListUtil クラス、および CacheListRO クラスを直接使用する場合、同様の機能を提供するその他のクラスにこれらを置き換えます。これらのクラスは廃止されましたが削除されていません。これらのクラスを使用しているが、その他の ADO API で使用していない場合、都合の良いときまでこの置き換えを延期できます。ODBCx API で使用している場合、このリリースで使用する前に置き換える必要があります。

%RunJava ユーティリティ・クラスが削除された

このリリースでは、%RunJava ユーティリティ・クラスが削除されました。このクラスでメソッドを呼び出す場合、%Net.Remote.Service のユーティリティ・メソッドの呼び出しに置き換える必要があります。

間接演算用の添え字数の制限

このリリースでは、アプリケーションは間接演算用の添え字数が 254 個に制限されています。254 個を超える添え字を使用して間接演算を実行する既存のコードが存在する可能性はほぼありません。そのようなコードでは簡単にアクセスできないノードが作成されてしまいます。

QuickStatement を作成する API の変更

QuickStatement クラスの構文が変更され、このクラスが cache-jdbc から cache-db jar に移動しました。新しい構文は以下のとおりです。

QuickStatement qs = QuickStatement.createQuickStatement((CacheConnection) connection); 

以前の構文 “QuickStatement qs = (QuickStatement) rs.getObject("**QuickStatement**");” を使用する場合、コードを新しい構文に更新する必要があります。

%Date LogicalToOdbc と LogicalToDisplay の変更

以前のリリースでは、タイムスタンプ値は、%Date LogicalToOdbc または LogicalToDisplay を使用して渡された場合には変更されませんでした。1840 年 12 月 31 日以前の日付をサポートするためのフィックスの一環として、この動作が変更されました。このリリースでは、タイムスタンプ値は、%Date LogicalToOdbc または LogicalToDisplay を使用して渡された場合、値の時刻の部分が削除され、日付の部分のみが返されます。使用中のアプリケーションのロジックが以前の動作を必要としている場合、コードを変更する必要があります。例えば、Oracle に接続されたテーブルから DISPLAY モードまたは ODBC モードでデータをクエリし、CAST(field AS DATE) や TO_DATE(...) のような関数を使用すると、Oracle は日付/時刻値を返します。このリリースでは、Caché はこれを DATE に変換します。

外部キーへの REFERENCES 特権の適用

以前のリリースでは、参照先テーブルの REFERENCES 特権を保持していなくても DDL 文を使用して外部キー制約を作成できました。このリリースでは、テーブル T を参照する外部キー制約を定義するには、ユーザは、テーブル T の REFERENCE 特権または外部キーが参照する列 (テーブル T) の REFERENCE 特権を保持している必要があります。アプリケーションが REFERENCES 特権を保持せずに外部キーを作成すると、エラーが発生します。

oref 番号の順序の変更

このリリースでは、OREF 処理の効率を向上させました。結果として、OREF 番号の割り当ては、これまでは作成順に割り当てられていましたが、独立した方法で割り当てられるようになりました。その結果、使用中のコードが OREF 番号を割り当てる方法に左右される場合、ロジックを変更する必要があります。以前の順序付けは実装の詳細で、ドキュメントに記載されている機能ではありませんでした。例えば、OREF 文字列値が Caché 多次元配列のインデックス化に使用される場合、OREF 文字列値の添え字の順序は、その OREF 値が作成された順序と関係なくなりました。アプリケーションが OREF 値の順序を使用して実行順序またはデータの処理順序を制御する場合、そのアプリケーションは、$INCREMENT や $SEQUENCE など、その他の方法を使用して目的の順序を生成するように変更する必要があります。

コンソール・ログの変更

場合によっては、以前のリリースでは 2 つのメッセージに分割されていた長いコンソール・ログ・メッセージが 1 つのメッセージとして記述されるようになりました。コンソール・ログに特定のメッセージ用に解析するコードがある場合、これを更新する必要があります。

短い配列名を生成するオプションの SOAP ウィザードへの組み込み

以前のリリースでは、配列アイテムの既定のタイプ名には、アイテム名とタイプ名の両方またはキー名とタイプ名の両方が含まれていました。これは両方の名前が同じでも同様でした。このリリースでは、既定では、アイテム名とタイプ名が同じ場合、一方のみが既定の配列タイプ名に含まれます。同様に、キー名とタイプ名が同じ場合、一方のみが既定の配列タイプ名に含まれます。例えば、以前のリリースでは、XML スキーマ (または Web サービスの場合には WSDL) には以下のようなプログラムが含まれていました。

<element minOccurs="0" name="PropName" type="s01:ArrayOfSimpleObjectSimpleObject" xmlns:s01="mytypes"/>

このリリースでは、このスキーマまたは WSDL には代わりに以下のようなプログラムが含まれています。

<element minOccurs="0" name="PropName" type="s01:ArrayOfSimpleObject" xmlns:s01="mytypes"/>

場合によっては、以前の既定の動作に戻すことができます。

• %XML.SchemaOpens in a new tab の AllowRedundantArrayName プロパティでは XML スキーマの以前の形式が許可されています。真の場合、以前の長いタイプ名が生成されます。

• Web サービス・クラスの ALLOWREDUNDANTARRAYNAME パラメータでは Web サービス用の WSDL の XML スキーマで以前の形式の配列名が許可されています。このパラメータが真の場合、以前の長いタイプ名が生成されます。

• %XML.AdaptorOpens in a new tab の XMLSchema() メソッドを使用してスキーマを生成している場合、以前の既定の長い配列名をリストアする方法はありません。このスキーマは、%XML.SchemaOpens in a new tab クラスを使用して作成する必要があります。

HTTP 要求を使用した Web メソッドの呼び出しの変更

以前のリリースでは、HTTP SOAP 要求を作成せずに Caché SOAP Web サービスを直接呼び出すことができました。このショートカットでは SOAP クライアントの使用が回避され、HTTP SOAP 要求を使用して実現できるセキュリティがバイパスされます。このショートカットは、SOAP Web サービス・クラス用に Caché が生成するカタログおよびテスト・ページによって使用されます。このショートカットを使用せず、常に SOAP Web クライアントを使用して HTTP SOAP 要求を生成し、Caché SOAP Web サービスを呼び出すことをお勧めします。URL に %SOAP.WebServiceInvoke クラスを使用して SOAP Web サービスを呼び出すコードがある場合、これを SOAP クライアントによって生成される HTTP SOAP 要求に置き換えることをお勧めします。

お勧めしませんが、このショートカット・メカニズムの使用を継続できます。その場合、このアクセスを明示的に有効にする必要があります。%SOAP.WebServiceInvoke クラスおよび soap_method クエリ・パラメータを使用するには、以下を実行する必要があります。

• 以下のように、コマンドで %SOAP.WebServiceInfo と WebServiceInvoke を有効にします。

  set ^SYS("Security","CSP","AllowClass",webapplicationname,"%SOAP.WebServiceInfo")=1
  set ^SYS("Security","CSP","AllowClass",webapplicationname,"%SOAP.WebServiceInvoke")=1
  

  

  webapplicationname は、末尾にスラッシュを付けた Web アプリケーションの名前です。例えば、"/csp/mynamespace/" のようになります。

• CSP ページにアクセスするユーザに %Development リソースの USE 特権があることを確認してください。

XSLT2 変換が致命的なエラーのエラー・ステータスを返す

以前のリリースでは、XSLT2 変換で致命的なエラーが発生すると、$$$OK を返していました。このリリースでは、エラー・ステータスを正しく返すようになりました。既定のエラー処理が必要な場合、この変更を処理するようにコードを変更する必要があります。既定のエラー処理をカスタムのエラー処理に上書きした場合、以前のリリースで行っていたような動作を継続します。