これは InterSystems FAQ サイトの記事です。
注意：本番環境では実行しないでください。テスト環境でご利用ください。
開発時にプロダクションに残っているキューを一括でクリアしたり、プロダクションに関連した一次的な情報をすべて消去したい場合、以下メソッドを利用して実行中のプロダクション情報をリセットできます。
set$namespace"プロダクションのあるネームスペース名指定"ドキュメント：ネームスペースでのプロダクションのリセット
プロダクション全体ではなく、一部コンポーネントの実行中データをリセットする場合は、アダプタの ClearAllAppData() を使用します。
引数にはプロダクションに登録している構成名を指定してください。
例）SQLインバウンドアダプタが保持している永続値をリセットする
"構成名称"ドキュメント：受信アダプタで以前に処理された行のリセット
例）FTPインバウンドアダプタが処理したファイルの情報をリセットする
"構成名称"FHIRドキュメント（診療情報提供書や退院時サマリ―など）をFHIRリポジトリにPOSTする場合、
エンドポイント/Bundle
上記URLでPOSTできます。（以下の例では、IRIS for Healthに用意したFHIRリポジトリを使用しています。）
.png)
GET要求で確認してみます。
登録できたことを確認できました。
FHIRリポジトリに登録したFHIRドキュメントですが、文書番号を指定してGETできると便利なのですが、現時点（バージョン2023.1）のIRIS for HealthのFHIRリポジトリでは、FHIR標準仕様にあるBundle の SearchParameter ：composition について未対応のため、Composition.identifier を指定した Bundleリソースに対する GET要求が行えません。
そこで回避策として、Bundle登録時 Composition.identifier.value に設定している文書番号を Bundle.identifier.value にも設定しPOSTします。こうすることで、Bundle の Search Parameter：identifier に文書番号を指定でき、対象となるBundleリソースをGETできます。
開発者の皆さん、こんにちは！
InterSystems グランプリコンテスト2023 では、InterSystems IRIS data platform を使用する機能であればどんな内容でもご応募いただけます。
以下の機能を含めた場合、ボーナスポイントを獲得できます。
詳細は以下の通りです。
IRIS for HealthのFHIRリポジトリには、「条件付き削除結果の最大数」がデフォルトで3件に設定されています。
そのため、条件指定のDELETE要求で4件以上が対象となる場合、以下のエラーが発生します。
例えば、あるcodeで条件指定したリソースが5件あるとします。
.png)
これをDELETE要求に変えて実行すると、以下のようにHTTPステータス412が戻り、「Conditional delete search found more than maximum allowed number of 3 results」のエラーが発生します。
HTTP応答を確認すると、ConditionalDeleteOverflowのエラーが発生しています。
これは、条件付き削除の最大値が3件で設定されているため、発生しています。
ということで、FHIR Configuration画面を開き、設定を確認します。
管理ポータル > [Health] > ネームスペース選択 > [FHIR Configuration] > [Server Configuration]
対象のエンドポイントを選択すると以下の設定画面が表示されます。
Max Conditional Delete Resultsの項目に 3 と設定されています。
FHIRリソースをリポジトリから削除するには、対象リソースに対してDELETE要求を使用すればよいのですが、例えば「テスト的に登録していたリソースばかりなので、リポジトリのデータを一括で全消去したい！」という場合の方法をご紹介します。
実行前に、エンドポイントのURLを確認します。
管理ポータル > [Health] > ネームスペース選択 > [FHIR Configuration] > [Server Configuration] で確認できます。
.png)
データの全消去を行うには、IRIS for HealthのFHIRサーバ機能で提供されているAPIを使用します。実行のため IRISのターミナルを開く、またはIRISにログインします。
ご参考：HS.FHIRServer.Storage.Json.RepoManagerクラスにあるDeleteService()メソッドを使用して削除します。
WindowsにIRISをインストールされている場合は、タスクバー上のIRISランチャー をクリックし、ターミナルを選択します。
Windows以外でお試しいただいてる場合は、iris session コマンドでIRISにログインしてください。
FHIR関連トレーニングの中で複数の方よりいただいたご質問をご紹介していきます。
IRIS for HealthのFHIRリポジトリでは、リソースPOST時のデフォルトの動作としてリポジトリ内でユニークな論理ID（id）を自動的に付与します。
例えば、以下のようなPatientリソースをPOSTした場合
{
"resourceType""Patient"以下 "id":"1" とあるように、リソースidにリポジトリ内でユニークとなる値を自動で設定します。（Patientリソースの一部抜粋）
Patientリソースを例に、もともとユニークな値である患者IDをFHIRリポジトリのリソースidとして使用したい！という場合の登録方法をご紹介します。
新規登録時はPOST要求を使用しますが、PUT要求を利用することでリソースidを指定した登録が行えます。
指定するURLは、例えば患者IDが P101001 の場合
http://localhost:52773/csp/healthshare/r4fhirnamespace/fhir/r4/Patient/P101001
のように指定します。
これは InterSystems FAQ サイトの記事です。
ターミナルでルーチンやクラスのコンパイルを行う際、コンパイル結果が画面に表示されるのでエラーが発生した場合でも確認しやすいですが、一括コンパイルの場合は、大量のコンパイル結果の中にエラー情報が含まれてしまうためエラー情報だけを取得したい場合には少し工夫が必要です。
以下、ルーチン／クラスの一括コンパイル時の結果からエラー情報を取得する方法をご紹介します。
ネームスペースにあるルーチンをターミナルで一括コンパイルするには、%Library.Routine クラスの CompileAll() メソッドを使用します。
以下実行例は、USERネームスペースにあるルーチンを一括コンパイルした結果です。TestRoutine1でコンパイルエラーが発生しています。
USER>do##class大量にルーチンがある場合、出力結果が流れて画面から消えてしまうため、カレントデバイスに出力されている内容をファイル保存し、保存したファイルの中からエラー情報を取得するようにします。
1) コンパイル結果をファイルに保存する
CompileAll() メソッドの第2引数にファイル名をフルパスで指定します。
開発者の皆さん、こんにちは！
この記事では、ワークフローコンポーネントを使ってみよう！～使用手順解説～ でご紹介したユーザ操作画面（ユーザポータル）を任意のWebアプリに変更する際に便利な REST API の使用方法をご紹介します。
ワークフロー用 REST APIですが、開発者コミュニティのサンプル公開ページ：Open Exchange に公開されているAPIでどなたでも自由にご利用いただけます。
Open Exchangeの検索ボックスに「Workflow rest」と入力すると出てきます。EnsembleWorkflow が対象のサンプルです。
.png)
ちなみに、2023年6月2日時点で724のアプリケーションが公開されているようです👀
開発者の皆さん、こんにちは！
この記事では、システム連携の自動的な流れの中にユーザからの指示を介入できる「ワークフローコンポーネント」のサンプル でご紹介した内容を、お手元のIRIS、IRIS for Healthを利用して体験いただくための手順を解説します。
なお、ワークフローコンポーネントでどんなことができるのか？の概要説明については、ウェビナーをご参照ください。
まだインストール環境がない場合は、コミュニティエディション（コンテナ版かキット版）をご利用ください。
開発者の皆さん、こんにちは。
先日のウェビナーでご紹介した「ワークフローコンポーネント」をお試しいただけるサンプルを公開しました。👉 https://github.com/Intersystems-jp/WorkFlow-DC
《サンプルのテーマ》
店舗で販売している商品に付けるPOPメッセージ候補を予めテーブルに登録できる仕組みが既にある、と仮定しています。
IRISの Interoperability を利用してPOPメッセージ候補が登録されるテーブルに対して一定間隔でSELECT文を実行し、未処理のメッセージを取得します。
新たなレコードが存在する場合、ワークフローコンポーネントを利用して担当者に審査を依頼します。
担当者は、ワークフローユーザポータルを使用して、POPメッセージ候補の承認／却下を指示できるようにしています。
開発者の皆さん、こんにちは！
毎年恒例の InterSystems IRIS開発者向け「グランプリ・コンテスト」の開催が決定しました！
今年のお題は「InterSystems IRIS data platformを利用してオープンソースを作成する」です。
🏆 InterSystemsグランプリ・コンテスト2023 🏆
期間: 2023年6月12日～7月2日
.jpg)
これは InterSystems FAQ サイトの記事です。
%SYSTEMパッケージには沢山の便利なシステムクラスがあり、Embedded Pythonでも一般クラスと同様に%SYSTEMパッケージ以下クラスを操作できます（iris.cls("クラス名").メソッド名()で呼び出せます）。
ObjectScriptでは、$SYSTEM特殊変数を利用して、%SYSTEMパッケージ以下クラスのメソッドを呼び出すことができますが、Embedded Pythonでは、iris.system を利用して実行することができます。
以下実行例をご紹介します。
一般クラスと同じ呼び出し方の例
iris.cls("%SYSTEM.SYS"iris.systemを利用する例
iris.system.SYS.NameSpace()一般クラスと同じ呼び出し方の例
iris.cls("%SYSTEM.Util"iris.systemを利用する例
SQL関連をまとめたSQLクラスの例は以下の通りです。
一般クラスと同じ呼び出し方の例
iris.cls(iris.systemを利用する例
※ 現時点（2023/5/1）では、%SYSTEM.SQLクラス
これは InterSystems FAQ サイトの記事です。
IRISではジャーナルファイルが自動的に圧縮される仕組みが導入されています。
ジャーナルファイルの圧縮機能について詳しくは、別の記事「ジャーナル圧縮機能について」をご参照ください。
例えば、CachéからIRISへ移行された後に、念のためIRISで更新されたデータを手動でCachéにも反映させたいことばある場合に、IRISのジャーナルファイルをCachéにリストアすることができます。
手順は以下の通りです。
(手順1) IRISのジャーナルファイル（YYYYMMDD.nnnz） ファイルを解凍する
(手順2,3) 解凍した ジャーナルファイルを Cachéに転送してリストアする
リストアの方法として、以下の2パタンをご紹介
(A) 指定グローバルとデータベースについて、指定ジャーナルから、全エントリをリストア
(B) 指定グローバルとデータベースについて、指定ジャーナルから、特定のアドレスまでリストアする
IRIS 2022.1 以降、現在実行中のジャーナル以外は、拡張子 z で圧縮されています。
以下のコマンドで解凍し、指定のフォルダにコピーします。
開発者の皆さん、こんにちは！
IRISのInteroperability（相互運用性）機能（Ensembleのプロダクション）を使用してどのようなことができるか、コード例をご覧いただきながら／サンプルを動かしながらご確認いただける記事をまとめてみました。
ぜひご参照ください。
記事一覧：
開発者の皆さん、こんにちは！
IRIS Cloud SQL and IntegratedML コンテストの勝者が発表されました！
この記事では、コンテスト受賞者を発表します。
今回は、8 の応募 🔥 がありました！
%20(2).jpg)
開発者の皆さん、こんにちは！
過去に開催した開発者向けウェビナー アーカイブビデオ.png)
のまとめページを作成しました。
今後もウェビナーを開催していきますのでこのページを★ブックマーク★していただけると嬉しいです
プレイリストはこちら👉https://www.youtube.com/playlist?list=PLzSN_5VbNaxB39_H2QMMEG_EsNEFc0ASz
✅ウェビナー
これは InterSystems FAQ サイトの記事です。
以下の状態の時、ReadOnlyでマウントされます。
開発者の皆さん、こんにちは！
InterSystems IRIS Cloud SQL and IntegratedMLコンテストの投票が開始されました。
🔥 ベストアプリケーションはこれだ！！ 🔥と思う作品にぜひ投票をお願いします。
%20(3).jpg)
投票方法は以下ご参照ください。
これは InterSystems FAQ サイトの記事です。
バージョン2017.2以降から、CREATE TABLE文で作成したテーブル定義のデータを格納するグローバル変数の命名ルールが変わり ^EPgS.D8T6.1 のようなハッシュ化したグローバル変数名が設定されます。（この変更はパフォーマンス向上のために追加されました。）
※ バージョン2017.1以前については、永続クラス定義のルールと同一です。詳細は関連記事「永続クラス定義のデータが格納されるグローバル変数名について」をご参照ください。
以下のテーブル定義を作成すると、同名の永続クラス定義が作成されます。
CREATETABLEVARCHAR永続クラス：Test.Productの定義は以下の通りです。（パラメータ：USEEXTENTSETに1が設定されます）
開発者の皆さん、こんにちは！
この記事では、Developer Hub にあるチュートリアルの4番目のご紹介となる REST + Augular App チュートリアル についてご紹介します。
チュートリアルでは、IRISを利用してRESTサービスで使用するテーブル、データ、RESTサーバの機能をサンプルコードをコピーしながら作成していきます。
チュートリアルの中で作成するWebアプリはとてもシンプルな内容で、データベースにブックマークとして登録したいURLを保存し、参照するだけのページとしています。
データの登録も、IRISの管理ポータルのSQLメニューでINSERT文を実行する形式で進めていきます。
最終的には、以下の図にあるように「Add a new bookmark」以下のテキストボックスで新しいブックマークを登録できるように、Web画面とRESTサーバ用コードを追加していきます。
.png)
アカウント作成やログインも不要で ボタンをクリックするだけで始められます👍
ぜひ、お試しください！
開発者の皆さん、こんにちは。
Python Native APIを利用すると、IRISにあるグローバル変数の参照／更新をPythonから行えたり、メソッドやルーチンをPythonから実行することができます。
この記事では「AWS Lambda の IRIS Python Native API IRIS」の記事を参考に、NativeAPIを利用してPythonからIRISに接続するAWS Lambda関数を作成する流れで必要となる、レイヤー作成と関数用コードの作成例をご紹介します。
※ 事前にAWSのEC2インスタンス（Ubuntu 20.04を選択）にIRISをインストールした環境を用意した状態からの例でご紹介します。
- 「AWS Lambda の IRIS Python Native API IRIS」の記事では、レイヤーとコードをまとめたZipを用意してLambda関数を作成していますがこの記事ではレイヤーとコード用Zipをそれぞれ用意して作成する流れでご紹介します。
- NativeAPIについて詳しくは、「【はじめての InterSystems IRIS】セルフラーニングビデオ：アクセス編：Python の NativeAPI に挑戦」をご参照ください。
開発者の皆さん、こんにちは。
技術文書ライティングコンテストの受賞者が発表されたばかりですが、次のコンテスト：InterSystems IRIS Cloud SQL and IntegratedML コンテスト 2023 のテクノロジーボーナス詳細が決定しましたのでお知らせします📣
獲得ポイントについて詳細は、以下ご参照ください。
開発者の皆さん、こんにちは！
第4回 InterSystems 技術文書ライティングコンテスト：InterSystems IRIS チュートリアル が終了しました。
期間内に投稿された🌟 24の素晴らしい記事はこちらから 🌟ご覧いただけます。
この記事では、コンテスト受賞者を発表します📣
開発者の皆さん、こんにちは。
前の記事では「機械学習を試せるチュートリアル：IntegratedML」で試せる内容をご紹介しましたが、この記事では Interoperability（相互運用性）チュートリアル の内容を少しご紹介します。
Interoperability（相互運用性）チュートリアルでは、Redditに新しく投稿された記事＝（https://www.reddit.com/new/）を一定間隔で取得し、全投稿の中から「猫（cat）」🐈について記載されている情報のみを抽出し、対象記事をファイル出力する流れをご体験いただけます。
開発者の皆さん、こんにちは！
技術文書ライティングコンテスト：InterSystems IRISチュートリアル へ応募いただいた記事のボーナスポイントが決定しました！
※ 14番の記事は日本のメンバーからのご応募です！💪
開発者の皆さん、こんにちは！
次のプログラミングコンテストの詳細が決定し「IRIS Cloud SQLのデータを利用してAI/MLソリューションを作成する」がテーマとなりました。
🏆 InterSystems IRIS Cloud SQL and IntegratedML コンテスト 🏆
期間： 2023年4月3日～23日
賞金総額: $13,500
開発者の皆さん、こんにちは。
AWSのEC2インスタンス（Ubuntu 20.04を選択）にIRISをインストールした環境を事前に用意した状態からの流れですが、AWS Lambda 関数からPyODBC経由でIRISに接続するまでの流れを試してみました。
- Native APIを利用する流れについては、「AWS Lambda の IRIS Python Native API IRIS」をご参照ください。
- 参考にしたAWSドキュメント：https://docs.aws.amazon.com/ja_jp/lambda/latest/dg/lambda-python.html
以下の流れでご紹介します。
例で使用しているコード一式はこちらにあります👉https://github.com/Intersystems-jp/iris-pyodbc-lambda
これは InterSystems FAQ サイトの記事です。
永続クラス定義では、データを格納するグローバル変数名を初回クラスコンパイル時に決定しています。
グローバル変数名は、コンパイル後に表示されるストレージ定義（Storage）で確認できます。
例）
開発者の皆さん、こんにちは！
前の記事では、開発者向け情報を集めた「Developer Hub」をご紹介しましたが、この記事では Developer Hub のチュートリアルの中から「機械学習」をテーマとしたチュートリアル：IntegratedML についてご紹介します
InterSystems IRISには、機械学習を行うために必要なプロセスのいくつかを自動化するAutoMLの機能が組み込まれていて、機能名として「IntegratedML」と呼んでいます。機能概要については、末尾のビデオをご参照さい。
チュートリアルを始めるための準備は不要で、.png)
ボタンをクリックするだけでチュートリアルを開始できます。
開発者の皆さん、こんにちは！
1つ前の記事では、VSCodeのObjectScriptエクステンションに追加されたRESTサービスのデバッグツールについてご紹介しましたが、この記事では、RESTクライアントなどからHTTP要求を実行し、処理中のIRIS内プロセスにアタッチしながらデバッグを行う方法についてご紹介します。
