#autoscript

[maximopro]

3桁区切り数字を4桁に変換する [Maximo]

Maximoの数値フィールドは基本的に欧米と同じ3桁区切りで表示されるのがデフォルトです。こちらはロケールを変更しても変わりません。

慣れの問題ではありますし、基本的に企業のシステムであれば問題になることは少ないと思います。ただし金額など、慣れ親しんだ4桁区切りの方が直感的に分かりやすいということはあると思います。今回は4桁区切り表示の方法について解説します。

まず4桁区切り数字を表示するための属性を追加します。当然ながら漢字が入る場合は数値型ではなく文字列型になります。従って、数値属性から非永続の文字列型属性へ変換した値を格納し、それを表示することにします。では対象の属性 (今回はPURCHASEPRICE) に対する非永続属性をASSETに追加します。

追加後はデータベースの構成変更を行ってください。分からない方は過去の記事を参考にしてください。次に自動化スクリプトを作成します。今回は特に特定の属性に限ったスクリプトではないのでスクリプトから作成します。自動化スクリプトのオプション・メニューからウィザードを起動します。

以下のように値を埋めます。バインディング値は後から変更するので適当な値を入力します。

スクリプトはこちらになります。ダウンロードはGitHub Gistから可能です。スクリプトは数値を4桁毎に分割し、それぞれの桁に対して単位を挿入し、対象の非永続属性へ保存します。

convert_to_kanji.py

GitHub Gist: instantly share code, notes, and snippets.

次に属性起動ポイントを作成します。上と同様に自動化スクリプトから作成します。イベントは値の初期化です。非永続属性は値を入力しても保存されないため、属性が読み取られるときに値を入力します。

次へを進むとバインディング値の設定になります。「グローバル・バインディング値」はこのスクリプトのデフォルト値です。「起動ポイントのバインディング値」はこの起動ポイント固有の値を設定できます。起動ポイント毎にリテラル・データを変更したい場合はこちらに値を埋めます。dest_attrには保存先の属性を入力します。

src_attrには数値変換元の属性を入力します。

起動ポイントを作成すれば完了です。表示が可能になっているか確認します。アプリケーション・デザイナーでASSETに対して上記で追加したデータのテキスト・フィールドを追加します。以下のように表示されれば良いでしょう。

価格を表示するためであれば最後に「円」をつけるのも良いでしょうし、逆変換を実装して表示だけではなく入力も可能にすると面白いと思います。

[rawisrollie]

Prompting only the hardest hitting headlines, #BODYSLAM, #WRESTLING, #SLUGLINE, #AUTOSCRIPT https://instagr.am/p/Cc5ZGpQLVLY/

[maximopro]

画面XMLや自動化スクリプトの履歴を保存する

単純ですが開発時に非常に役に立つtipsを紹介します。画面XMLや自動化スクリプトの管理は外部のSCMやファイルサーバーなどで行われることが多いと思います。そのためバックアップの取得などは手動になるため管理が煩雑になる場合が多いかと思います。Maximoには「監査」という機能があり、保存時に自動的に別テーブルへ履歴を残すことが可能です。

画面XMLの自動履歴保存を有効にする手順 データベース構成より詳細検索をクリックしてオブジェクトに”MAXPRESENTATION”を入力して内部？の値をクリアします。

MAXPRESENTATIONを開いて監査の項目をチェックします。

属性タブを開いてPRESENTATIONに対して監査の有効化をチェックします。

後は管理モードに入りデータベースの構成を完了させれば有効になります。これ以降は”A_MAXPRESENTATION“に履歴が自動的に残るようになります。

自動化スクリプトの自動履歴保存を有効にする手順 データベース構成より詳細検索をクリックしてオブジェクトに”AUTOSCRIPT”を入力して内部？の値をクリアします。

AUTOSCRIPTを開いて監査の項目をチェックします。

属性タブを開いてSOURCE, COMMENTに対して監査の有効化をチェックします。ここでコメントの履歴を有効にすることでコミットログのように変更に対するコメントを入力できるようになります。

後は管理モードに入りデータベースの構成を完了させれば有効になります。これ以降は”A_AUTOSCRIPT“に履歴が自動的に残るようになります。

参考: https://www.keegosysit.com/audit-tracking-in-maximo-by-keegosys/

[maximopro]

OAuth2のリソースを自動化スクリプトのエンドポイントを使ってアクセスする

IBM Maximo CommunityにてOAuthハンドラーについての質問が挙がっていました。標準のOAuthエンドポイントはOAuth 1プロトコルのみサポートしており、かつOSLCアプリケーションからのみアクセスできるようです。Maximo 7.6.1.2ではE-mail リスナーでOAuth2のサポートが追加されています。こちらはGMailなどの認証に使われるもので統合IF (MIF) で使われることは想定していないようです。MIFでOAuth2リソースにアクセスするには自前で実装する必要があります。

OAuth2 認証フロー

OAuth2にはフロート呼ばれるいくつかの認証プロトコルが規定されています。こちらのサイトにはOAuth2 フローが解説されています。どのフローをサポートすべきかはどのフローがアクセスしたいリソースで提供されているかに依ります。例えば、GmailなどのGoogle APIではAuthorization code flowが提供されています。また、Microsoft Identity platformではサーバー間やデバイス・サーバー間で主に使用されるClient credential flowがサポートされています。本記事では多くのサービスで提供されている Authorization code flow の リフレッシュ・トークン・フローを実装してみたいと思います。

自動化スクリプトを使ったエンドポイント

OAuth2プロトコルではHTTPアクセスの際にリフレッシュ・トークン・フローによってトークンを取得する必要があります。これを自動化スクリプトを使ったエンドポイントを利用して標準のHTTPHandlerの実行前にスクリプトを挟み込む形で実装します。自動化スクリプトを使ったエンドポイントの実装はこちらのブログが参考になります。エンドポイントの定義にはハンドラー定義にScriptRouteHandlerを追加し、それを指定したエンドポイントのプロパティに自動化スクリプト名を入力します。スクリプトではrequestDataとresponseDataという特別な変数が定義されており、それぞれエンドポイントがMaximoから受け取るデータと返すデータに該当します。エンタープライズ・サービスなどからデータをこのエンドポイントにデータを送信すると、requestDataにはXMLのバイト列が入力されます。自動化スクリプトではエンドポイントを呼び出すことができますので、この要求・応答を使って標準のHTTPhandlerに流し込むことが可能です。

実装方法

OAuth2を実装するには以下の3つが必要になります。

OAuth2のClient IDとRefresh Tokenを格納するテーブル

Refresh token flowを実行する自動化スクリプト

自動化スクリプトのHTTPエンドポイント

エンドポイントには静的な情報のみ入力できるので、リクエストごとに認証情報をキャッシュしておくようなテーブルが必要になります。OAuth2のアクセス・トークンとそのリフレッシュ・トークンは変更される可能性があるため、エンドポイントのプロパティーに格納しておくことはできません。

まずはテーブルを定義しましょう。

属性定義は以下になります。アクセストークンは期限 (EXPIREAT) が切れるまで再利用されます。

次に自動化スクリプトの実装になります。

スクリプトはこちらです。

https://gist.github.com/nishi2go/e7f97032eaac2d741c4526aa4c99829a

最後に、自動化スクリプトの定義になります。上記で作成したスクリプト名をSCRIPTプロパティーにセットしてください。ハンドラーの作成はこちらを参考にしてください。

テスト

自動化スクリプトで呼び出す先のエンドポイントを作成します。以下の例ではMaximoのPingサービスにアクセスします。

OAuth2のフローをテストするにはOAuth Toolsを使用します。以下のようにAuthorization codeを取得します。

こちらのコードを上記で作成したテーブルに入力します。テーブル入力はSQLで直接書き込むか、カスタムアプリを作成します。以下はカスタムアプリの例です。

実際に実行した結果はこちらになります。OAuth Toolsにより取得されたアクセストークンはログに出力されています。フローでエラーが出ている場合は何らかのエラーメッセージが表示されているはずです。

今回は自動化スクリプトを使ってOAuth2リソースにアクセスできるエンドポイントの作成方法について解説しました。この他にも特殊なアクセス方法を要求するHTTPリソースなどにも応用できると思います。

[maximopro]

複数言語を入力するエディターを作成する

複数言語をインストールしたMaximoでは、指定された言語でログインすると複数言語に対応した部品マスターなどのアプリケーションでは、その言語で表示されるようになります。しかし、例えば英語で新規にレコードを入力した場合、日本語などの他の言語では英語で入力した箇所は空文字で表示されてしまいます。日本語を入力したい場合は、その言語設定でログインし直す必要があります。今回はログインし直さなくても複数言語を一括で更新できる機能を開発してみたいと思います。

目標は特定のカラムの複数言語を編集できるようにすることです。複数言語対応の属性は、「データベースの構成」の「属性」タブで確認することができます。その中で「複数言語を使用?」などにチェックがついているものが対象となります。まずは複数言語に対応した属性を抽出するドメインを作成します。ドメインアプリケーションから以下のようにテーブル・ドメインを作成します。

ドメイン: MLATTRIBUTE オブジェクト: MAXATTRIBUTE 検証Where文節: objectname=:objectname and attributename=:attributename and mlinuse=1 リストWhere文節: objectname=:objectname and mlinuse=1

複数言語を編集するエディターはダイアログボックスで作成します。ダイアログボックスで属性を選択したときに対象のオブジェクトからデータを抽出し、編集した後に親オブジェクトの値を更新します。ダイアログボックスで使用する値はDBに値を格納する必要がないため非永続MBO (NonPersistentMbo)を利用し、値を抽出・更新するロジックは自動化スクリプトを使用します。まずは非永続MBOを作成することから始めます。対象のオブジェクトと属性を格納するオブジェクトとそれぞれの言語の値を格納する子オブジェクトの2つをそれぞれ作成します。

子MBOの作成 オブジェクト: MLEDITORVALUES 永続: チェックをオフ

子MBOの属性1 属性名: LANGCODE

子MBOの属性2 属性名: VALUE タイプ: CLOB (どの長さにも対応できるようにするため)

次に親MBOを作成します。

オブジェクト: MLEDIOTR 永続: チェックをオフ

親MBOの属性1

属性名: ATTRIBUTENAME ドメイン: MLATTRIBUTE 同じオブジェクト: MAXATTRIBUTE 同じ属性: ATTRIBUTENAME

親MBOの属性2

オブジェクト: OBJECTNAME 同じオブジェクト: MAXOBJECT 同じ属性: OBJECTNAME

親MBOと子MBOの関係を定義します。以下のような関係を親MBOに作成して下さい。

関係名: MLEDITORVALUES 子オブジェクト: MLEDITORVALUES

次にダイアログボックスの定義を行います。今回はどのアプリケーションから呼び出せるようにLibrary XMLにその定義を追加します。

手順

アプリケーション・デザイナーを開く

システムXMLのエクスポート

LIBRARYのXMLのダウンロードボタンをクリックする

ダウンロードしたXMLの最後に以下のXMLを挿入する

アプリケーション定義のインポート・ボタンよりXMLを更新する

https://gist.github.com/nishi2go/b97e8d5ad4a5d51dced78f880fbca554

自動化スクリプトを作成します。はじめはダイアログボックス初期化時のロジックを実装します。以下のスクリプトを作成して下さい。

スクリプト: MLEDITOR.NEW 言語: python

https://gist.github.com/nishi2go/77a9229a2bda3799af34acc152816c01

次のスクリプトは属性名が入力されたときに複数言語の値を取得するロジックとダイアログのOKボタンがクリックされた時に値を書き出すロジックが実装されています。

スクリプト: MLEDITOR 言語python

https://gist.github.com/nishi2go/3f40f070bc3145560ef39d3ff9867eab

こちらには起動ポイントを2つ追加してください。

一つはオブジェクト起動ポイントです。ダイアログを閉じたときに実行されます。

起動ポイント: MLEDITORSAVE オブジェクト: MLEDITOR イベント: 保存 追加: チェック 保存前: 選択 スクリプト: 既存 スクリプト名: MLEDITOR

もう一つは属性起動ポイントです。属性名を入力したときに起動されます。

起動ポイント: MLEDITORATTR オブジェクト: MLEDITOR 属性: ATTRIBUTENAME イベント: アクションの実行 スクリプト: 既存 スクリプト名: MLEDITOR

以上で基本設定は終わりです。こちらの機能を部品マスターで実装したいと思います。

まずアプリケーション・デザイナーを開きITEMを選択します。アクションの選択から署名オプションの追加/編集にMLEDITORを追加します。

署名オプションからダイアログボックスを開く方法を定義します。ダイアログボックスを開くにはアクションの選択メニューに登録するか、プッシュボタンを定義します。今回はアクションの選択に登録します。

タイプ: OPTION キー値: MLEDITOR

署名オプションの追加後に機能を有効にするには、セキュリティ・グループで権限を追加してください。

署名オプションを反映させるには、一度ログアウトする必要があります。設定を反映するとアプリケーションでメニューを選べるようになります。エディターの画面は以下のように表示されます。

OKをクリックすることで値が変更されることを確認してください。注意点としてはBiDiと呼ばれるヘブライ語などは正しく動作しない可能性がありますのでご注意ください。

[maximopro]

自動化スクリプト .NEW .SAVE .DUPLICATEの使い方

LinkedInで話題になっていた自動化スクリプトのtipsを紹介します。 Stephen Humeさんがこちらでプレゼンテーションを公開しています。使用方法は至って簡単です。

オブジェクト名.NEW オブジェクト名.SAVE オブジェクト名.DUPLICATE

例えば ASSET.SAVE のようにスクリプト名をつければ、起動ポイントを作成しなくても資産の保存時にスクリプトが実行されます。

大規模なプロジェクトでは複数の処理を一つのスクリプトにまとめるような使い方は推奨されませんので、起動ポイントを使用するべきです。ただ、小規模な開発や簡易なスクリプトのみを使用したい場合は非常に有用だと思います。

[maximopro]

自動化スクリプトのユニットテストを作成する

前回は限りなく本番環境に近いMaximoのユニット・テスト環境を構築する方法を解説しました。今回はその環境を使用してJUnitを使った自動化スクリプトのユニット・テストを書いてみたいと思います。

標準Maximoの自動化スクリプトにはテスト機能が備わっています。自動化スクリプトの下部にある”Test Script”ボタンから実行できます。ブラウザ上で完結するの非常に魅力的ですが、より複雑な機能開発になった場合、より高機能なエディタが使えないことと自動化が難しいことなどが障壁になることがあります。

そこで、スクリプトをGitなどの外部のソースコード管理システムで管理し適宜それを取り込む方法をプロジェクトによってしばしば採用されることがあります。その場合、問題は本番環境に近いMaximo上でのユニット・テストが難しいことがあげられます。そのため、前回ご紹介した環境を使用してより本番に近づけたユニット・テスト環境を使用してJUnitを使った自動化を検討してみたいと思います。

まず、サンプルのコードは以下の通りです。

https://gist.github.com/nishi2go/0f70c5f9ec151023d9bf9de2ce3e35f0

scriptSource変数はスクリプトを記述したテキストを格納します。こちらは本来はユニット・テストと分離してファイルを用意するのが良いでしょう。

前回のユニットテストと同様にMBOを準備します。スクリプトの性質によって既存のレコードを使うか、新規レコードにするかなど事前準備を行います。

次にScriptの本体であるScriptInfoを作成しスクリプトをコンパイルした後にキャッシュに登録します。

contextに先ほどのMBOを登録することによって、スクリプトからMBOの呼び出しを行えるようにします。

次に変数のテストを行ってみます。EQ1に対して変数を使って値を変更します。

https://gist.github.com/nishi2go/e9c9c90d44e2b728c77370c3e31a56f6

ScriptParamInfoをScriptInfoに登録することで変数の定義を行うことができます。スクリプトの結果はcontextに格納されていますので、そちらを参照することでスクリプトが実行されたことを確認できます。

[maximopro]

オブジェクト構造を自動化スクリプトを使ってJSON APIで公開する

MaximoではMIF (Maximo Integration Framework)にてWeb ServiceやJMS, JSON API (OSLC)などにpolymorphicに外部統合を行うことができます。このマルチ・インターフェース対応は将来的にもある程度はそのまま引き継がれるかと思いますが、昨今の開発状況では徐々にJSON APIへ流れがシフトしてきていると感じます。例えば、Maximo V7.6.1ではWebSphere Libertyがサポートされましたが、そちらはオブジェクト構造、エンタープライズ・サービスはWeb Servicesのみ提供されています。旧来のHTTP Postなどはwar/earとも提供されていません。

ここでは旧来のインターフェースでHTTP Postを自動化スクリプトとJSON APIで実装してみます。

自動化スクリプトでJSON APIを作成するには起動ポイントなしで以下の通りにスクリプトを作成してください。

こちらを保存するだけでインターフェースは公開されます。以下のようにRequestすると結果が取得されます。

旧来のインターフェースをそのまま使用したい場合はURLの変更だけで対応できるようになります。