開発者の皆さん、こんにちは！

InterSystems Python プログラミングコンテスト 2023 のテクノロジーボーナス詳細が決定しました！

• Embedded Python - 3
• Python Native API  - 3
• Python Pex Interoperability - 4
• Python libs: sqlalchemy and dbt - 2
• LLM AI or LangChain usage: Chat GPT, Bard and others - 4
• NoObjectScriptLine - 5
• Questionnaire - 2
• Docker コンテナの利用 - 2 
• ZPM Package によるデプロイ - 2
• オンラインデモ - 2
• コミュニティ（USコミュニティ）に記事を投稿する（最初の記事） - 2
• コミュニティ（USコミュニティ）に2つ目の記事を投稿する - 1
• YouTubeにビデオを公開 - 3

詳細は以下の通りです。

Embedded Python - 3 ポイント

応募されるアプリケーションに Embedded Python を使用している場合、4ポイント獲得できます。Embedded Python を利用する場合は、IRIS 2021.2以降のバージョンをご利用ください。

突然ですが、みなさま、IRIS でのコーディングに Visual Studio Code をご利用されていますか？ 以前投稿しましたように、2023.2からスタジオは非推奨 となっています。私自身も数年前からは VSCode 一本に移行しました。VSCode はご存じのように、ありとあらゆる項目でカスタマイズが可能となっており、一度慣れると、スタジオより見た目よく、自分好みに仕上げられ、何より動作が軽いのがお気に入りです。

さて今日は、その VSode の見た目のカスタマイズのお話です。

InterSystems IRIS data platform がサポートするプラットフォームやフレームワークを取り巻く変更点について、みなさまから良く質問をいただきます。この記事では、サポート対象プラットフォームで最近おこなわれた変更点や今後予定されている変更点に関する情報を共有させていただきます。ただ、将来の予測は難しい側面があり、ロードマップは約束されたものではないということを十分ご理解くださいませ。 

IRIS 本番環境用オペレーティングシステムと CPU アーキテクチャ

Red Hat Enterprise Linux

• 最近の変更点
  
  • RHEL 9.2 と RHEL 8.8 が 2023年5月にリリースされました。Red Hat はこれらのリリースを4年間サポートする予定としています。InterSystems は「マイナーOSバージョン認証」と呼ぶ新しいプロセスにより、RHEL 9.2 と RHEL 8.8 で IRIS の追加動作検証を行いました。このプロセスは、マイナーOSのアップデートによって弊社製品の動作に明確な違いは見られないことを保証するもので、 RHEL 8.8、9.2 とも問題はありませんでした。
  • RHEL 9.2 がリリースされたことで, Red Hat は RHEL 9.1 のサポートを終了しました。 これは RHEL 8.

この「DeepSee トラブルシューティングガイド」は、DeepSee プロジェクトの問題を追跡して修正する支援を提供することを目的としています。

このガイドラインに従って問題を修正できない場合でも、少なくとも DeepSee サポートに WRC の問題を提出し、すべての証拠を提供するのに十分な情報を得ることができます。この情報によって、一緒に調査を続け、より迅速に解決することが可能となります。

ご注意ください: 特定のアクションやコマンドによってどのような結果がもたらされるかがよくわからない場合は、実行しないでください。本番システムに影響を与える可能性があります。  この場合は、サポートセンターにお問い合わせください。 

左から右の操作列に進むと、このガイドを最も簡単に活用できます。

グローバルをクラスにマッピングする技術 (1/3)

グローバルをクラスにマッピングする技術 (1/3)

古くなった MUMPS アプリケーションに新たな生命を吹き込みたいとお考えですか？  以下にご紹介するステップを実行すれば、既存のグローバルをクラスにマッピングし、美しいデータを Object や SQL に公開できます。

本記事を含む合計 3 回の連載を通じてご紹介する簡単なステップを使えば、すべてのグローバル (特殊なものは除く) を Caché のクラスにマッピングできるようになります。  特殊なものについては、私が長年に渡って集めた様々な種類のマッピングを zip ファイルにまとめて提供いたします。  これは新しいデータを対象としたステップではありません。グローバルがないという方は、デフォルトのストレージをお使いください。

グローバルデータについて理解できないという方は、Support@InterSystems.com までデータをお送りください。喜んでサポートさせていただきます。

グローバルをクラスにマッピングするステップ。

1. グローバルデータが繰り返し使用されるパターンを特定する。
2. 固有キーの構成を特定する。
3. プロパティとそれぞれの型を特定する。
4. クラス内のプロパティを定義する (変数の添え字をお忘れなく)。
5. IdKey のインデックスを定義する。

Docker による Apache Web ゲートウェイ

コミュニティの皆さん、こんにちは。

この記事では、以下を使用して、Docker でプログラムによって Apache Web ゲートウェイを構成します。

• HTTPS プロトコル
• Web ゲートウェイと IRIS インスタンス間の安全な通信を確保する TLS/SSL

イメージには、Web ゲートウェイ用と IRIS インスタンス用の 2 つを使用します。

すべての必要なファイルは、こちらの GitHub リポジトリで入手可能です。

では、git clone から始めましょう。

git clone https://github.com/lscalese/docker-webgateway-sample.git
cd docker-webgateway-sample

システムの準備

権限に関する問題を回避するために、システムにユーザーとグループが必要です。

• www-data
• irisowner

コンテナと証明書ファイルの共有に必要です。 これらがシステムに存在しない場合は、以下を実行します。

InterSystems IRIS Adaptive Analytics 2023.2 がリリースされました。このバージョンでは、弊社パートナーである AtScale のバージョン 2023.2 に含まれる以下の素晴らしい機能が追加されています。

• 仮想データモデルの開発しやすくなる、キューブ間オブジェクト共有の増加
• 時間相対メジャー、インテリジェント・ディメンジョン、計算グループといった一般的だが複雑なモデル作成手順の単純化
• Microsoft PowerBI との接続の改善
• 集計とクエリを管理する使用状況メトリックダッシュボード機能

詳細な情報については、これらの新機能の デモ をごらんください。

Adaptive Analytics に関する情報については、ドキュメント ならびに オンライントレーニング をご参照ください。

InterSystems Kubernetes Operator (IKO) 3.6 がリリースされました。 IKO 3.6 は、多くのバグ修正に加えて、大幅に新機能を追加しました。注目の機能は以下のようになっています。

• コンピュートノードとデータノードに簡単に組み込める Web Gateway sidecars
• Web Gateway 認証用の Kubernetes シークレット
• Data セクションでの データベース定義
• Data セクションでの ネームスペース定義
• 必要なものがすべてコンテナイメージ内にある場合の エフェメラル Web Gateway
• Horizontal Pod Autoscaler サポートを HPA バージョン2 にアップグレード

IKO のダウンロード、インストール、開始手順については インストールガイド にしたがってください。 IKO 3.6 ドキュメント には、IKO ならびに IKO を InterSystems IRIS や InterSystems IRIS for Health とどのように組み合わせるかの手順が記載されています。 IKO は WRC からダウンロードいただけます (Kubernetes で検索してください。） コンテナは InterSystems コンテナレジストリ から入手いただけます。

開発者の皆さん、こんにちは！

次の InterSystems オンラインプログラミングコンテストは、Pythonに特化した内容を予定しています！

🏆 InterSystems Python プログラミングコンテスト 🏆

期間: 2023年9月4日～24日

賞金総額: $13,500

インターシステムズは InterSystems IRIS Data Platform、InterSystems IRIS for Health、InterSystems IRIS Studio のバージョン 2023.2 をリリースしました。

2023.2 は Continuous Delivery(CD)リリースです。2023.2には多くのアップデートや拡張機能が追加されています。

リリースハイライト

プライベートウェブサーバ

本リリースより以下の点が変更されます:

• InterSystems IRIS インストールではプライベートウェブサーバがインストールされなくなります。管理ポータルやその他の組み込みウェブアプリケーションにアクセスするためには、外部ウェブサーバの接続を構成する必要があります。インストール時にApacheウェブサーバ(Microsoft Windows以外のすべてのプラットフォーム)またはIIS(Microsoft Windows)が既にシステムにインストール済みの場合、ウェブサーバを自動構成するオプションが選択可能です。
• InterSystems IRIS コンテナにプライベートウェブサーバは同梱されません。コンテナ内インスタンスの管理ポータルにアクセスするには対応するウェブゲートウェイコンテナをデプロイする必要があります。

この記事では、.Net/Java ゲートウェイを簡単にコンテナ化する方法を説明します。

この例では、Apache Kafka との統合を開発します。

Java/.Net と相互運用するために、PEX を使用しています。

アーキテクチャ

このソリューションは完全に docker で実行し、以下のように構成されます。

Java ゲートウェイ

まず、メッセージを Kafka に送信する Java オペレーションを開発しましょう。 このコードはお好きな IDE で書くことができ、こちらのようになります。

要約すると:

• 新しい PEX ビジネスオペレーションを開発するには、抽象型の com.intersystems.enslib.pex.BusinessOperation クラスを実装する必要があります。
• public プロパティはビジネスホスト設定です。
• OnInit メソッドは Kafka への接続を初期化し、InterSystems IRIS へのポインターを取得するために使用されます。
• OnTearDown は、（プロセスのシャットダウン時に）Kafka から切断するために使用されます。
• OnMessage は dc.KafkaRequest メッセージを受け取って、Kafka に送信します。

では、これを Docker にパックしましょう！

これがこの例の dockerfile です。

このたび InterSystems IRIS 2023.1 の日本語ドキュメントが完成しました。以下のURLでご参照いただけます。

• IRIS 2023.1
• IRIS for Health 2023.1
• Health Connect 2023.1
• 日本語ドキュメント一覧ページ 

ランチャーから日本語ドキュメントを参照したい

インターシステムズは、以下2点の修正を行いました。

.

障害1: ECP アプリケーションサーバがハングする

以下の CPU かつ 以下のバージョンで発生します。
    対象バージョン: 2022.1.2, 2022.1.3
    対象CPU: ARM, IBM Power プロセッサ
この問題は修正ID DP-423661 で解決します。この修正は、今後のすべてのバージョンに含まれる予定です。 

.

障害2: 非常に稀な状況において デジャーナルがハングする

デジャーナルとはジャーナルをリストアすることで、例えば、ミラーリングのフェイルオーバーやDR非同期メンバで常時実行されています。また障害復旧に際しジャーナルをリストアする作業も対象になります。

本障害は以下のバージョンで発生します。
    対象バージョン: 2020.4, 2021.x, 2022.x, 2023.1
この問題は修正ID DP-423505 で解決します。この修正は、今後のすべてのバージョンに含まれる予定です。また 2023.1.1 には既に含まれています。

.

これら2点の修正を入手いただけるよう、公開済みの 2022.1.3 の更新版を公開いたしました。バージョン番号は以下の通りです。

    過去版:  2022.1.3.668.0
    更新版:  2022.1.3.

あるメソッドやルーチンを実行してエラーとなった場合、エラー発生個所はエラーメッセージより取得することができますが、処理の呼び出し履歴（スタックトレース）はエラーメッセージのみではわかりません。
また、.Net や Python など IRIS 外からの呼び出しの場合に、エラー情報の詳細がクライアントに返らない場合などもあるかと思います。

/// 例：エラーメッセージだけでは、エラーが発生した処理の呼び出し履歴まではわからない。d##class

そんなときは、エラー処理にて Do BACK^%ETN を実施することで、IRIS側で強制的にスタック情報を記録することができます。
スタック情報を記録することで、どのような処理がどの順番で呼び出されたかや、エラー時の内部変数情報を知ることができます。

BACK^%ETN は、エラー発生後に $ZError($ZE) 変数に値が set されている場合、アプリケーションエラーログ（^ERRORS）に情報が記録されます。
上のエラーの場合の $ZE は、以下のように確認できます。

>write

スタック情報は、以下のようになります。こちらよりスタックトレースを確認することが可能となります。

※こちらは管理ポータルで確認した結果になります。

ターミナルにライセンス期限切れの警告メッセージ（「*\* Warning: This Cache license will expire in 3 days **」）が表示されており、そのメッセージを表示したくない場合は、以下のコマンドを実行すると、メッセージの表示を無効（または有効）にできます。

Do ExpirationMessageOff^%SYS.LICENSE - Disable

Do ExpirationMessageOn^%SYS.LICENSE - Enable

2023.2 の開発者プレビュープログラムの一環として、7番目の開発者プレビューを公開いたします。今回リリースされたのは、InterSystems IRIS と InterSystems IRIS for Health です。

プライベート・ウェブサーバ (PWS) の提供終了

本リリースの一番のトピックは、プライベート・ウェブサーバ (PWS) の提供終了です。昨年から事前に発表していましたが、今回のプレビュー版で初めて InterSystems 製品のインストーラから PWS が削除されています。

こちら のドキュメントもあわせてご確認ください。本件に関する詳細な情報は こちら の記事でも公開しています。

--> 本件に関して何か問題が発生したり、弊社のプロダクトマネージメントに連絡したいことがある、あるいはご意見やご感想を伝えたい等ございましたら、ぜひ遠慮なく NoPWS@InterSystems.com までメールをお送りください。

本リリースの注目点

2023.2では、多くの機能修正と改善に加えて、時間認識モデリングや 強化された外部テーブル (まだ実験的な機能です) といった新機能が含まれます。

ドキュメントは以下のリンクからご覧いただけます。本バージョンが正式公開 (General Availability - GA) されるまで、数週間かけてドキュメントは更新される予定です。

ご好評をいただいておりますインターシステムズ主催 開発者向けウェビナーを次回は以下の通り開催いたします。

日時：2023年8月30日（水）13時半～14時

タイトル：「大規模FHIRデータの活用～Bulk FHIR Coordinatorのご紹介」（事前登録制・参加費無料）

ご登録はこちらから

【概要】
大量のFHIRベースの医療データにアクセスする必要がある場合、既存のFHIR APIでは、大規模なエクスポートには何十万ものリクエストを必要とします。
FHIRサーバーから大量のデータをエクスポートするための標準化されたFHIRベースのアプローチを定義した「HL7 FHIR Bulk Data Access」と、この実行をサポートするためのIRIS for Healthの新機能「Bulk FHIR Coordinator(BFC)」について、概要をご紹介いたします。

【こんな方にお勧め】
FHIRデータの活用をお考えの方
FHIR対応アプリケーション開発中/予定の方
大規模医療データの活用についてご興味のある方

ご多用中とは存じますが、この機会に是非ご参加ください！

Python は世界で最も使用されているプログラミング言語になり（出典: https://www.tiobe.com/tiobe-index/）、SQL はデータベース言語としての道をリードし続けています。 Python と SQL が連携して、SQL だけでは不可能であった新しい機能を提供できれば、素晴らしいと思いませんか？ 結局のところ、Python には 380,000 を超える公開ライブラリがあり（出典: https://pypi.org/）、Python 内で SQL クエリを拡張できる興味深い機能が提供されています。 この記事では、Embedded Python を使用して、InterSystems IRIS データベースに新しい SQL ストアドプロシージャを作成する方法を詳しく説明します。

サンプルとして使用する Python ライブラリ

この記事では、IRIS で SQL を扱う人にとって非常に便利な GeoPy と Chronyk という 2 つのライブラリを使用します。 

Geopy は、ジオコーディング（住所と地理座標の修飾）を住所データに適用するために使用するライブラリです。 これを使用すると、通りの名前から郵便番号と完全な住所を郵便局の形式で取得することができます。 多くのレコードには住所が含まれるため、非常に便利です。

Power BI

データソースへの接続

AtScale に接続するために、SQL Server Analysis Services データベースを使用します。 Power Query エディターで開いてみましょう。 これを行うには、 Home から Transform Data を選択します。

表示されたウィンドウで、Home を選択し、New Source を展開して Analysis Services を選択します。

開発者の皆さん、こんにちは！

InterSystems製品に関連するアイデアをご提案いただく「アイデアソン」の2回目の開催が決定しました！

🎁 第2回 InterSystems Idea-A-Thon（アイデアソン） 🎁

8月1日～21日の期間にInterSystems 製品やサービスに関連するアイデアをご提案いただくコンテストで賞品の用意があります！

どなたでもご参加いただけます！

これは InterSystems FAQ サイトの記事です。
 

以下の方法で、$ZF(-100) で実行したコマンドの出力を取得することが可能です。
 

★$ZF(-100) での実行でコマンドキーワードを使用する方法：

/STDOUT や /STDERR などの便利なキーワードを指定して、$ZF(-100) でコマンドを実行することが可能です。

USER>write$zf

USER>

コマンドキーワードについては、以下のドキュメントをご覧ください。
$ZF(-100) で指定できる便利なキーワード
※ /STDOUT と /STDERR に同じファイルを指定した場合、両方のタイプのデータがそのファイルに書き込まれます。

★標準エラー出力(2) を 標準出力(1) へリダイレクトする方法：

以下の方法で、標準エラー出力(2) を 標準出力(1) へリダイレクトし、さらにコマンドの 標準出力 を ファイル(result.log) へ出力する方法が使用できます。

USER>

上記コマンドの場合、実行したネームスペースのデフォルトデータベースのフォルダに result.log が出力されます。
内容は以下のような標準出力が記録されています。

2023.2 の開発者プレビュープログラムの一環として、6番目の開発者プレビューを公開いたします。今回リリースされたのは、InterSystems IRIS と InterSystems IRIS for Health です。

本リリースの注目点

2023.2では、多くの機能修正と改善に加えて、時間認識モデリングや 強化された外部テーブル (まだ実験的な機能です) といった新機能が含まれる予定です。これら新機能の一部は、今回の開発者プレビュー版にはまだ含まれていません。ご注意ください。

2023.2の別の注目点は、プライベート・ウェブサーバ (PWS) がインストーラから削除されることです。このことは昨年に発表され、インターシステムズ製品のインストーラから削除予定ですが、今回のプレビュー版ではまだPWSは存在します。詳細はこちらのドキュメントをご覧ください。

--> PWSが含まれないインストーラにご興味のある方は、こちらのフォームからEAPに登録してください。その際、オプションで「No Private Web Server」をお選びください。このEAPに関する情報はこちらをご参照ください。

今後のプレビューリリースは、2週間ごとの発表を予定しており、新機能が完成次第、プレビュー版に追加されていきます。

ファイルとディレクトリの操作に使用できる API 、%Library.File クラス (%File が省略形) の便利なサンプルコードをご紹介します。

こちらのAPIを使用して、ディレクトリやファイルの中身をのぞいたり、作成・書込み・読込みを行ってみます。

★ディレクトリ内のファイル一覧をリストする

以下のサンプルは、C:\temp フォルダ内の *.txt ファイルをリストします(ファイルパス_サイズ_作成日)。

 set##class

サブディレクトリ内のファイルを含む場合はこちら (filetest.mac で保存) ↓

test(dir)
  

実行結果：

USER>

★シンプルなファイル作成＆書き込み＆読み込み

作成＆書き込み

※OPEN モード・パラメータ

または (Streamの場合)、

読み込み

または (Streamの場合)、

 
★ファイルをバイト単位で読み込む

%Strean.FileCharacter の場合、Readした時点でUnicodeに変換されているため、バイト数で切ることは難しくなります（文字数単位となる）。
バイト単位で読み込みたい場合は、FileBinaryを使い「無変換」で取り込み、それを Unicode に手動で変換する方法を使用します。

※注意
バイト単位で読む場合、$ZCVT

基本操作編ビデオシリーズ：その1

Windows、Linux、クラウドのマーケットプレイスでの InterSystems IRIS Community Edition インストール方法を解説しています。

コミュニティエディションのインストールキット入手方法については、「InterSystems IRIS／InterSystems IRIS for Health コミュニティエディションのダウンロード方法」をご参照ください。

2025/4/8 追記：バージョン2025.1以降　コンテナ以外のインストールキットを使用したインストールでは、初期セキュリティ設定のオプションデフォルトが「ロックダウン（Locked down）」に変更されました。詳しくは👉「バージョン2025.1インストール時に指定する初期セキュリティオプションのデフォルトが「ロックダウン」に変わりました」をご参照ください。

コンテナ版IRISの利用方法については、「InterSystemsコンテナレジストリの使い方とコンテナ開始までの流れ（解説ビデオ付き）」をご参照ください。

開発者の皆さん、こんにちは！

InterSystems IRIS 、InterSystems IRIS for Healthのコミュニティエディションは、WindowsやLinuxにインストールするキットの他にコンテナ版も公開されています。

コンテナ版はダウンロードページからではなく、InterSystemsコンテナレジストリ よりpullいただけます。

この記事では、InterSystemsコンテナレジストリ の使い方と、コンテナ開始までの流れをご紹介します。

インターシステムズは、InterSystems IRIS データ・プラットフォーム、InterSystems IRIS for Health 、HealthShare Health Connect のメンテナンスバージョン 2023.1.1 をリリースしました。これらのリリースは、2023.1.0 に対するバグフィックスを提供します。
詳細な変更リスト/アップグレード・チェックリストは、以下のページをご参照ください。(すべて英語版です)

・InterSystems IRIS
・InterSystems IRIS for Health
・HealthShare Health Connect
ソフトウェアの入手方法

本製品は、従来からのインストーラパッケージ形式と、コンテナイメージ形式をご用意しています。利用可能なインストーラとコンテナイメージの一覧は、サポートプラットフォームページ(英語) をご覧ください。

InterSystems IRIS と IRIS for Health のインストーラパッケージは WRC Direct の IRIS データプラットフォームダウンロードページ から入手できます。
HealthShare Health Connect のインストーラパッケージは WRC Direct の HealthShareダウンロードページ から入手できます。

開発者の皆さん、こんにちは！

ご存知のように、InterSystems IRIS インターオペラビリティソリューションには、プロダクション、ビジネスルール、ビジネスプロセス、データ変換、レコードマッパーなどの様々なエレメントが含まれています。 また、UI ツールを使用してこれらの要素を作成し、変更することもあります。  もちろん、UI ツールで行った変更をソース管理する便利で堅牢な方法も必要です。

長い間、これは手動（クラス、エレメント、グローバルなどのエクスポート）か面倒な設定作業手順によって行われてきました。そのため、ソース管理 UI の自動化で節約された時間は、設定のセットアップとメンテナンスの時間で相殺されていました。

現在では、この問題はなくなりました。 パッケージファースト開発と @Timothy Leavitt の git-source-control という IPM パッケージの使用という 2 つのアプローチによる結果です。

詳細は以下のとおりです！

開発者の皆さんこんにちは！

InterSystemsグランプリコンテスト 2023 の勝者が発表されました！

この記事では、コンテスト受賞者を発表します。

今回は、20 の応募 🔥 がありました！

クラスメソッドの多くは、%Status データ型を使用して、成功 または 失敗 の情報を返します。
成功の場合は 1 が返り、失敗の場合はエラーステータス および 1 つ以上のエラーコードとテキストメッセージを含むエンコードされた文字列が返ります。
このようなメソッドでは、戻り値を必ず取得して確認するようにしてください。

こちらの記事では、失敗の場合の具体的なエラー情報を確認する方法をご紹介します。

USER>set##class0

エンコードされたエラーの文字列より、具体的なメッセージを表示したい場合、%SYSTEM.Status クラスのメソッドを使用します。

0

Do $SYSTEM.Status.DisplayError(st)

でエンコードされたエラーの内容を知ることができるようになりました。
見ることはできましたが、毎回このコマンドを実行するのは面倒だ、という方に良い方法をご紹介します。

こちらの記事 で紹介しているように、覚えにくいコマンドに対して alias を設定し、ObjectScript コマンドのショートカットを作成することが可能です。
※コマンド行インタフェースでのみ使用できます。これらは ObjectScript の拡張機能ではないため、ルーチンやメソッドで使用することはできません。

各エラーコードのメッセージ一覧は、以下のドキュメントをご覧ください

最近人気上昇中のプログラミング言語Python、ご存じのとおりIRISでは2通りの使い方が出来ます。

組み込みPython（Embedded Python）

PythonコードはIRISプロセス内でObjectScriptコードと並列に実行

具体的には

1. IRISクラス内のメソッド
2. SQL関数とストアドプロシージャ
3. ターミナルからPythonシェルを起動
4. irispythonコマンド実行

が該当します。

ネイティブAPI（Native API）

IRISの外からグローバルへのアクセス、クラスメソッドを呼び出し

上の4種類以外は全てネイティブAPIを使用します。

Pythonコードが実行される場所でIRISへのアクセス手段が決まりますが、ライブラリ名が双方とも”iris”のため注意が必要です。

* 従来からのirisnativeはDeprecated（非推奨）となりました

サンプルコードを探す時やドキュメントを参照する時、どちらのPython APIを使用しているか頭の片隅にあると予期せぬエラーに遭遇する機会が減るかも知れません。

組み込みPythonのirisパッケージ

組み込み Python | InterSystems IRIS Data Platform 2022.1