NetSuite の始め方 | SOAP: getServerTime操作

**Richard James Uri** · Dec 5, 2024 4:03PM

以下の記事で説明されているSOAP Web Services統合に関する手順を成功裏に完了した後：

記事「NetSuite の始め方 | SOAPおよびREST Web Servicesのセットアップの前提条件」に従ってSOAP統合を有効にする。
記事「NetSuite の始め方 | インテグレーションレコードの作成方法」と「NetSuite の始め方 | アクセストークンの作成方法：管理者向け」に従ってSOAPインテグレーションを作成する。
記事「NetSuite の始め方 | SOAP Web ServicesでTBAを使用してヘッダーを作成する方法」を参照してSOAP Web Servicesにヘッダータグを含める。

これで、NetSuite内のレコードと対話する準備ができました。SOAP Webサービスで使用可能な主な操作の1つは、getServerTime操作です。この操作は、NetSuiteサーバー時間をGMTで返します。この機能は、特にクライアントのローカル時間がNetSuiteサーバーと同期されていない場合、クライアント側の時間に依存すると不正確になる可能性があるため、アプリケーションの同期を確保するために重要です。

主なメリット:

サーバー同期: 同期手順の正確なタイムスタンプを確保します。
ユニバーサル・アプリケーション: GMTは普遍的な標準であり、必要に応じて異なるタイム・ゾーンに簡単に調整できます。

タイムゾーンの処理

必要に応じて、開発者はクライアント側のコードを使用してGMTサーバーの時間をローカル・タイムゾーンに変換できます。getServerTimeによって返される時間は、次のような特定の形式に従います。

日付: YYYY-MM-DD (例: 2005-09-21)。
時間: HH:MM:SS.sss (例: 15:24:00.000)。
タイムゾーン相殺: ±HH:MM (例: -07:00)。

たとえば、レスポンス2005-09-21T15:24:00.000-07:00は、タイム・ゾーン・オフセットUTC-7の2005年9月21日の午後3時24分にタイムスタンプを表します。

注: アクティブ・セッションを持つNetSuiteユーザーは、getServerTime操作を呼び出すことができます。この機能には追加の権限が必要なく、すべての認証済ユーザーがアクセス可能です。

SOAPリクエスト

サーバー時間を取得するには、SOAPリクエストは次のようになります。

<soapenv:Body>
    <getServerTime xsi:type="platformMsgs:GetServerTimeRequest"/>
</soapenv:Body>

SOAP本体の主要コンポーネントの内訳を次に示します。

<soapenv:Body>

これは、リクエストされている特定の操作を囲む標準のSOAP要素です。
すべてのSOAPリクエストには、リクエストの詳細が存在する<Body>要素が必要です。

<getServerTime>

これは、NetSuite SOAP API内でコールしている操作の名前です。
NetSuiteサーバーに、現在のサーバー時間を取得するgetServerTime操作を実行するように指示します。

xsi:type="platformMsgs:GetServerTimeRequest"

xsi:type:実行する操作のデータ型またはスキーマ・タイプを指定します。
platformMsgs:GetServerTimeRequest: このリクエストがplatformMsgsネームスペースの一部であることを示します。このネームスペースでは、NetSuiteのプラットフォーム操作に関連するSOAPメッセージが編成されます。

SOAPレスポンス

正常なレスポンスには、指定された形式のサーバー時間が含まれます。次に例を示します。

<soapenv:Body>
    <getServerTimeResponse xmlns="">
        <platformCore:getServerTimeResult xmlns:platformCore="urn:core_2021_1.platform.webservices.netsuite.com">
            <platformCore:status isSuccess="true"/>

MFA for Oracle Community

NetSuite の始め方 | SOAP: getServerTime操作

ようこそ！

リーダーボード

コミュニティの達人

第3四半期 (7月～9月 2025年)

今週のリーダー

今月のリーダー

歴代リーダー