NextEngineにて配送番号が登録された際に、その配送番号を他システムへ連携するアプリの開発を検討しております。
メインアプリにて「出荷 > 配送番号反映」をしたことをトリガーとして、他のアプリを起動できるものでしょうか。 バッチを用いた受注情報変更の監視が必要なのであれば、受注情報のどの項目を監視すべきでしょうか。
ご教示宜しくお願いいたします。
ご質問ありがとうございます。
現在のネクストエンジンAPIではイベントハンドラのような設定は出来ません。 連携されたい状態に合わせたステータスと配送番号項目を定期監視してください。
実装方法については連携されるシステムの仕様にもよるため参考程度にはなりますが、受注伝票検索で、「受注状態区分」が ”出荷確定済” と「発送伝票番号」が ”空以外” を検索条件に指定してご確認いただくとよろしいかと存じます。 ※指定すべきID等については、各環境にて取得してください。
貴社システムとの重複連携を避ける方法としては、連携後に ”連携済み” など任意の「受注分類タグ」を受注伝票に更新（貼付）し、検索対象から除外するなどの方法もあるかと思いますので、参考にしてみてください。
以上、ご質問へのご回答とさせていただきますが、その他ご不明点がございましたらお気軽にお申し出くださいませ。
早々のご回答ありがとうございます。承知いたしました、検討いたします。
合わせて確認させていただきたいのですが、開発依頼元曰く、 NextEngineのサーバがメンテナンスなどに入る？などしたときに、 アプリのクライアントIDおよびクライアントシークレットが変更されることがあって、 その場合に認証エラーになるから、それを検知できるようにもしたいとのことでした。
アプリのクライアントID及びクライアントシークレットは、 サンプルプログラムのようにプログラム内部に埋め込もうとしていたのですが、 上記のようなことはあるのでしょうか？ 上記のようなことがあるとすると、そのたびにプログラムを更新することになりますか？
ご質問いただきありがとうございます。
＞ アプリのクライアントIDおよびクライアントシークレットが変更されることがあって
事の経緯がわかりかねますため、正確なご質問への訂正になっているかわかりませんが、当社メンテナンスにより、上記値が変更されることはございません。 ネクストエンジン「アプリを作る」の画面上から「更新」ボタンを押下することで意図的に更新することは可能です。
以上、ご質問へのご回答とさせていただきますが、その他ご不明点等ございましたらお気軽にお申し出くださいませ。
ご回答ありがとうございます。 念のため追加で確認させてください。
> ネクストエンジン「アプリを作る」の画面上から「更新」ボタンを押下することで意図的に更新することは可能です。
何かしらのタイミングで、上記操作を行う必要が発生することはあるでしょうか？
> 事の経緯がわかりかねますため
開発依頼元のお話を伺うに、 他システム上でクライアントID及びクライアントシークレットを登録し、 その、他システム側から受注情報をNE宛に連携していたアプリがあって、 その利用の中で、時折更新しないとならなかった、と伺っています。
「Key」とおっしゃっていたので、クライアントID及びクライアントシークレットではない可能性もあるのですが、 何か思い当たることがあれば合わせてご教示いただければ幸いです。
＞ 何か思い当たること
推察するに恐らくはアクセストークン（リフレッシュトークン）のことではないかと思われます。
該当項目が上記であれば、セキュリティ識別情報として一般的な仕組みになっておりますので適切にご対応いただければと存じます。 項目の正否は開発依頼元様へご確認ください。
ご回答ありがとうございます。 リンク頂いた先を拝見して、このようなことがあるのではないかと考えましたが、いかがでしょうか？
--- バッチ処理には、ユーザが画面からアクセスしたときに取得したアクセストークン（リフレッシュトークン）が必要である。 基本的には1日1度、長くて3日（リフレッシュトークンの有効期限内）に1度、バッチ実行していれば、 この初回のユーザがアクセスしたときに取得した情報を利用し続けることが出来るが、 サーバメンテナンスなどにより3日を超えてバッチ処理が実行されなかった場合、 再度ユーザ操作による画面からのアクセストークン（リフレッシュトークン）取得が必要となる。 --- ご確認宜しくお願いいたします。
仕様的には確かにそのようになりますので100%ロジック上の回避をするという意味では、画面上からアプリ再起動が必要になる可能性はございます。
ただ、ご質問は「サンプルプログラムのようにプログラム内部に埋め込もうとしていたのですが」というプログラム修正のお話しだったかと存じますので、こちらへの影響はないものと思われます。また、該当となるネクストエンジンAPIサーバーの稼働実績ですが、メンテナンスについも日単位で停止した実績はございません（災害などは除く）ので、推奨の通り、各種トークンをバッチ処理により1日1回程度更新していただければ問題は発生しないかと存じます。 --------- access_tokenの有効期限が切れていてrefresh_tokenの有効期限内の場合は、実行結果と共に新しいaccess_tokenとrefresh_tokenを返却します。 ---------
RE: NEから他システムへの配送番号連携
ご質問ありがとうございます。
現在のネクストエンジンAPIではイベントハンドラのような設定は出来ません。
連携されたい状態に合わせたステータスと配送番号項目を定期監視してください。
実装方法については連携されるシステムの仕様にもよるため参考程度にはなりますが、受注伝票検索で、「受注状態区分」が ”出荷確定済” と「発送伝票番号」が ”空以外” を検索条件に指定してご確認いただくとよろしいかと存じます。
※指定すべきID等については、各環境にて取得してください。
貴社システムとの重複連携を避ける方法としては、連携後に ”連携済み” など任意の「受注分類タグ」を受注伝票に更新（貼付）し、検索対象から除外するなどの方法もあるかと思いますので、参考にしてみてください。
以上、ご質問へのご回答とさせていただきますが、その他ご不明点がございましたらお気軽にお申し出くださいませ。
早々のご回答ありがとうございます。承知いたしました
早々のご回答ありがとうございます。承知いたしました、検討いたします。
合わせて確認させていただきたいのですが、開発依頼元曰く、
NextEngineのサーバがメンテナンスなどに入る？などしたときに、
アプリのクライアントIDおよびクライアントシークレットが変更されることがあって、
その場合に認証エラーになるから、それを検知できるようにもしたいとのことでした。
アプリのクライアントID及びクライアントシークレットは、
サンプルプログラムのようにプログラム内部に埋め込もうとしていたのですが、
上記のようなことはあるのでしょうか？
上記のようなことがあるとすると、そのたびにプログラムを更新することになりますか？
RE: 早々のご回答ありがとうございます。承知いたしました
ご質問いただきありがとうございます。
＞ アプリのクライアントIDおよびクライアントシークレットが変更されることがあって
事の経緯がわかりかねますため、正確なご質問への訂正になっているかわかりませんが、当社メンテナンスにより、上記値が変更されることはございません。
ネクストエンジン「アプリを作る」の画面上から「更新」ボタンを押下することで意図的に更新することは可能です。
以上、ご質問へのご回答とさせていただきますが、その他ご不明点等ございましたらお気軽にお申し出くださいませ。
RE: NEから他システムへの配送番号連携
ご回答ありがとうございます。
念のため追加で確認させてください。
> ネクストエンジン「アプリを作る」の画面上から「更新」ボタンを押下することで意図的に更新することは可能です。
何かしらのタイミングで、上記操作を行う必要が発生することはあるでしょうか？
> 事の経緯がわかりかねますため
開発依頼元のお話を伺うに、
他システム上でクライアントID及びクライアントシークレットを登録し、
その、他システム側から受注情報をNE宛に連携していたアプリがあって、
その利用の中で、時折更新しないとならなかった、と伺っています。
「Key」とおっしゃっていたので、クライアントID及びクライアントシークレットではない可能性もあるのですが、
何か思い当たることがあれば合わせてご教示いただければ幸いです。
RE: RE: NEから他システムへの配送番号連携
ご質問いただきありがとうございます。
＞ 何か思い当たること
推察するに恐らくはアクセストークン（リフレッシュトークン）のことではないかと思われます。
該当項目が上記であれば、セキュリティ識別情報として一般的な仕組みになっておりますので適切にご対応いただければと存じます。
項目の正否は開発依頼元様へご確認ください。
以上、ご質問へのご回答とさせていただきますが、その他ご不明点等ございましたらお気軽にお申し出くださいませ。
RE: NEから他システムへの配送番号連携
ご回答ありがとうございます。
リンク頂いた先を拝見して、このようなことがあるのではないかと考えましたが、いかがでしょうか？
---
バッチ処理には、ユーザが画面からアクセスしたときに取得したアクセストークン（リフレッシュトークン）が必要である。
基本的には1日1度、長くて3日（リフレッシュトークンの有効期限内）に1度、バッチ実行していれば、
この初回のユーザがアクセスしたときに取得した情報を利用し続けることが出来るが、
サーバメンテナンスなどにより3日を超えてバッチ処理が実行されなかった場合、
再度ユーザ操作による画面からのアクセストークン（リフレッシュトークン）取得が必要となる。
---
ご確認宜しくお願いいたします。
RE: RE: NEから他システムへの配送番号連携
ご質問いただきありがとうございます。
仕様的には確かにそのようになりますので100%ロジック上の回避をするという意味では、画面上からアプリ再起動が必要になる可能性はございます。
ただ、ご質問は「サンプルプログラムのようにプログラム内部に埋め込もうとしていたのですが」というプログラム修正のお話しだったかと存じますので、こちらへの影響はないものと思われます。また、該当となるネクストエンジンAPIサーバーの稼働実績ですが、メンテナンスについも日単位で停止した実績はございません（災害などは除く）ので、推奨の通り、各種トークンをバッチ処理により1日1回程度更新していただければ問題は発生しないかと存じます。
---------
access_tokenの有効期限が切れていてrefresh_tokenの有効期限内の場合は、実行結果と共に新しいaccess_tokenとrefresh_tokenを返却します。
---------
以上、ご質問へのご回答とさせていただきますが、その他ご不明点がございましたらお気軽にお申し出くださいませ。