---
sourceDocument: Inventário da rede de telecomunicações da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/telecom-network-inventory

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Inventário da rede de telecomunicações da Yokohama

ft:clusterId :

    - telninv

bundleId :

    - telninv

workflow :

    - Customer and Industry


---

# Função Pesquisar próximo hub

# Função Pesquisar próximo hub {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A função Pesquisar próximo hub permite que você use o registro de interface de rede como entrada e retorne os detalhes do registro de conexão física relacionado. Você pode obter automaticamente os detalhes da conexão física e das portas interconectadas do equipamento na aplicação Telecommunications Network Inventory ao usar a aplicação Workflow Studio.
Você pode usar a função Pesquisar próximo hub para retornar o seguinte:

* Conexão física relacionada à porta.
* Resposta vazia se nenhuma conexão física estiver relacionada à porta.
* sys_id das portas frontais e traseiras e o nome da porta, se houver um relacionamento de item de configuração (IC) entre as portas frontais e traseiras.
* A interface NextHub e as interfaces que estão conectadas à outra extremidade da conexão física.
* A interface interconectada do NextHub e as interfaces interconectadas que estão conectadas à outra extremidade da conexão física.
{#lookup-next-hub-action__ul_tkd_c2h_bvb}

Você pode usar esta função como uma ação Workflow Studio no fluxo de trabalho Telecommunications Network Inventory.

## Funções e disponibilidade {#lookup-next-hub-action__section_dv3_wrd_1vb}

Usuários com a função de administrador podem adicionar uma ação a um fluxo e definir os detalhes de configuração do fluxo. Esta função está disponível como uma ação Workflow Studio na aplicação Telecommunications Network Inventory para que você possa executar operações de dados relacionadas ao inventário.

## Campos de entrada {#lookup-next-hub-action__section_ltb_bcr_x5b}

A tabela a seguir lista os campos de entrada na ação Pesquisar próximo hub e suas descrições.
{#lookup-next-hub-action__table_w3g_2fm_1vb__entry__3}

| Nome do campo | Descrição | Tipo de Dados |
|-|-|-|
| Interface de rede | Registro de interface de rede. | Referência.Interface de rede |
| Se vários registros forem ação | Opção para selecionar a ação quando vários registros são encontrados. Você pode selecionar Retornar somente o primeiro registro da lista para retornar os detalhes do primeiro registro de conexão física. | Escolha |
[Tabela 1. Campos de entrada da próxima ação de hub]

{#lookup-next-hub-action__table_w3g_2fm_1vb}

Para saber mais sobre os tipos de dados variáveis, consulte [Variáveis de dados de entrada e saída do Flow Designer](https://www.servicenow.com/docs/access?context=action-inputs-outputs&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US).

## Saída {#lookup-next-hub-action__section_rnx_nxn_dvb}

A tabela a seguir lista as informações sobre a saída da função.
{#lookup-next-hub-action__table_snx_nxn_dvb__entry__3}

| Nome | Descrição | Tipo de Dados |
|-|-|-|
| Conexões físicas | Retorna a lista de sys_ids dos registros de conexão física relacionados à interface de rede. | Array.String |
| Porta interconectada | Retorna a lista de sys_ids das portas que estão interconectadas à interface de rede. | Array.String |
| Interface do próximo hub | Retorna a lista de sys_ids das interfaces que estão conectadas à outra extremidade da conexão física. | Array.String |
| Interface interconectada do próximo hub | Retorna a lista de sys_ids das interfaces interconectadas que estão conectadas à outra extremidade da conexão física. | Array.String |
[Tabela 2. Saída da função]

{#lookup-next-hub-action__table_snx_nxn_dvb}

## Exemplo {#lookup-next-hub-action__section_otn_zrd_1vb}

Caso de uso 1
:   Se a entrada for aprovada como Interface-1 de Equipamento-1, conforme mostrado no exemplo a seguir, a função retornará registros vazios, pois o inventário de rede não tem conexões físicas ou internas no inventário de rede.  
    ![Exibição de use caso 1 em que Interface-1 está conectado ao equipamento-1.]()  

Caso de uso 2
:   Se a entrada for aprovada como Interface-1 de Equipamento-1, conforme mostrado no exemplo a seguir, a função retornará o registro de interface de rede da Interface-2.  
    ![Exibição do caso de uso 2 em que a Interface-2 e a Interface-1 estão conectadas ao Equipamento-1.]()  

Caso de uso 3
:   Se a entrada for aprovada como Interface-1 de Equipamento-1, conforme mostrado no exemplo a seguir, a função retornará o registro de interface de rede da Interface-2 e o registro de conexão física do PC-1.  

Caso de uso 4
:   Se a entrada for aprovada como Interface-1 de Equipamento-1, conforme mostrado no exemplo a seguir, a Interface do NextHub será 3 e a Interface Interconectada do NextHub será 4.  

{#lookup-next-hub-action__dl_fvj_bsd_1vb}
**Conceitos relacionados**   

* [Função Alocar número livre](https://servicenow-prod.fluidtopics.net/ipiydhYvYDC8ySVfxSBblQ "A função Alocar número livre permite atribuir números livres do registro de número Telecommunications Network Inventory. Você usa esta função para alocar uma quantidade de números de um intervalo especificado para adicionar ao item de configuração (IC) em um elemento numérico.")
* [Função Criar IC a partir do modelo](https://servicenow-prod.fluidtopics.net/vVk18oLxHlsJYPnJi2Sq4A "A função Criar IC a partir do modelo do TNI permite que você crie a instância de inventário no local designado ou no suporte de equipamento na aplicação Telecommunications Network Inventory ao instanciar um inventário com o modelo de inventário. Você pode criar automaticamente o inventário ao instanciar o design de inventário de rede e o processo de atribuição.")
* [Função de atualização em cascata](https://servicenow-prod.fluidtopics.net/fg4752gMRu2eIwvQrx_V0g "A função Atualização em cascata permite atualizar um atributo de item de configuração (IC) na aplicação Telecommunications Network Inventory e cascatear a mudança em todos os ICs relacionados. Você pode usar esta função para colocar em cascata automaticamente os valores de campo em ICs relacionados ao usar Workflow Studio.")
* [Criar e atribuir função de intervalo/número único](https://servicenow-prod.fluidtopics.net/StMylMmjHfP44Cdh6gNBlg "A função Criar e atribuir intervalo/número único permite criar os registros de número de inventário para um intervalo de números ao processar o fluxo de trabalho de inventário de rede.")
* [Criar função de interface lógica](https://servicenow-prod.fluidtopics.net/WYKOh~_EH0EssT4oXJ5y_Q "A função Criar interface lógica permite criar interfaces lógicas na aplicação Telecommunications Network Inventory.")
* [Criar função de conexão lógica](https://servicenow-prod.fluidtopics.net/3NdjfcAqQNfOydBynhUGHg "A função Criar conexão lógica permite criar um registro de conexão lógica na aplicação Telecommunications Network Inventory com base na entrada (interfaces) que você recebe ao instanciar um inventário.")
* [Criar função de conexão física](https://servicenow-prod.fluidtopics.net/kQsRTIy4xzjICSqyL2qB8A "A função Criar conexão física permite criar um registro de conexão física na aplicação Telecommunications Network Inventory com base na entrada que você recebe ao instanciar um inventário.")
* [Criar função de sub-rede IP](https://servicenow-prod.fluidtopics.net/ijizMxnkMa~jpw1l5xFB8Q)
* [CIDR para função de intervalo de IP](https://servicenow-prod.fluidtopics.net/W0f8DVxgPyHbPLaJf8MVMw "A ação de fluxo Intervalo entre domínios sem classe (CIDR) para intervalo de IP permite criar um conjunto de endereços IP usando o Intervalo entre domínios sem classe (CIDR) usando a aplicação Telecommunications Network Inventory com base na entrada que você recebe ao instanciar um inventário.")
* [Função Obter resumo da interface](https://servicenow-prod.fluidtopics.net/afg9vpyCTqBX6FFwh3VRFw "A função Obter resumo da interface permite recuperar todos os registros de interface de rede associados à entrada. Você pode usar esta função para obter automaticamente os detalhes da interface disponível, da interface conectada e da conexão física do equipamento na aplicação Telecommunications Network Inventory ao usar Workflow Studio.")
* [Função de pesquisa de caminho](https://servicenow-prod.fluidtopics.net/AlE3J67dikS1AbtDCqd3cg "A função Pesquisa de caminho permite que você execute a função de cálculo de caminho entre os sites inicial e final na aplicação Telecommunications Network Inventory. Você pode usar esta função para o cálculo do caminho ao processar o design e a atribuição do inventário de rede.")

