「次のハブをルックアップ」機能
[次のハブをルックアップ (Lookup Next Hub)] 関数を使用すると、ネットワークインターフェイスレコードを入力として取得し、関連する物理接続レコードの詳細を返すことができます。ワークフロースタジオアプリケーションを使用すると、通信事業ネットワークインベントリアプリケーションで機器の物理的な接続と相互接続されたポートの詳細を自動的に取得できます。
「次のハブをルックアップ」関数を使用すると、次が返されます。
- ポートに関連する物理接続。
- ポートに物理接続が関連していない場合は、空の応答です。
- フロントポートとバックポートのsys_id、およびフロントポートとバックポートの間に構成アイテム (CI) 関係がある場合はポート名。
- NextHub インターフェイスと、物理接続のもう一方の端に接続されているインターフェイス。
- NextHub 相互接続されたインターフェイスと、物理接続のもう一方の端に接続されている相互接続されたインターフェイス。
この機能は、通信事業ネットワークインベントリワークフローのワークフロースタジオアクションとして使用できます。
ロールと可用性
admin ロールを持つユーザーは、アクションをフローに追加し、フローの構成の詳細を定義できます。この機能は、インベントリ関連のデータ操作を実行できるように、通信事業ネットワークインベントリ アプリケーションでワークフロースタジオアクションとして使用できます。
入力フィールド
次の表に、[次のハブを検索] アクションの入力フィールド とその説明を示します。
| フィールド名 | 説明 | データタイプ |
|---|---|---|
| ネットワークインターフェイス | ネットワークインターフェイスレコード。 | Reference.Network インターフェイス |
| 複数のレコードが見つかった場合のアクション | 複数のレコードが見つかったときにアクションを選択するオプション。リストから 最初のレコードのみを返す を選択して、最初の物理接続レコードの詳細を返すことができます。 | 選択肢 |
変数データ型の詳細については、「 フローデザイナーの入力データ変数と出力データ変数」を参照してください。
出力
次の表に、関数出力に関する情報を示します。
| 名前 | 説明 | データタイプ |
|---|---|---|
| 物理接続 | ネットワークインターフェイスに関連する物理接続レコードのsys_idsのリストを返します。 | Array.String |
| 相互接続ポート | ネットワークインターフェイスに相互接続されているポートのsys_idsのリストを返します。 | Array.String |
| NextHub インターフェイス | 物理接続のもう一方の端に接続されているインターフェイスのsys_idsのリストを返します。 | Array.String |
| NextHub 相互接続インターフェイス | 物理接続のもう一方の端に接続されている相互接続されたインターフェイスのsys_idsのリストを返します。 | Array.String |
例
- ユースケース 1
- 次の例に示すように、入力が Equipment-1 のインターフェイス 1 として渡された場合、ネットワークインベントリには物理接続または内部接続がないため、関数は空のレコードを返します。
- ユースケース 2
- 次の例に示すように、入力が Equipment-1 の Interface-1 として渡された場合、この関数は Interface-2 のネットワークインターフェイスレコードを返します。
- ユースケース 3
- 次の例に示すように、入力が Equipment-1 の Interface-1 として渡された場合、この関数は Interface-2 のネットワークインターフェイスレコードと PC-1 の物理接続レコードを返します。
- ユースケース 4
- 次の例に示すように、入力が Equipment-1 の Interface-1 として渡された場合、NextHub インターフェイスは 3、NextHub 相互接続インターフェイスは 4 です。