---
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 Obter resumo da interface

# Função Obter resumo da interface {#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 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.
A função Obter resumo da interface permite recuperar os registros de interface de rede associados à entrada, como Local, Rack ou Equipamento. Você deve inserir o valor do local, equipamento ou rack para retornar a saída.

Se várias entradas não corresponderem, a ação relatará um erro. Por exemplo, digamos que você possa ver os detalhes do equipamento e do local, mas como o equipamento não pertence ao local, o sistema relata um erro com as informações de conflito.

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

## Funções e disponibilidade {#get-interface-summary-action__section_kfd_fdk_x5b}

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 {#get-interface-summary-action__section_y33_w2k_x5b}

A tabela a seguir lista os campos de entrada na função Obter resumo da interface e suas descrições.
{#get-interface-summary-action__table_w3g_2fm_1vb__entry__3}

| Nome do campo | Descrição | Tipo de Dados |
|-|-|-|
| Site | Site de rede associado à interface de rede. | Site.Referência.Rede |
| Rack | Rack associado à interface de rede. | Referência.Equipamento de telecomunicações |
| Equipamento | Equipamento associado à interface de rede. | Referência.Equipamento de telecomunicações |
| Disponibilidade | Status do ativo de rede. Você pode selecionar uma das seguintes opções: * Disponível * Usados * Reservado * Compartilhado {#get-interface-summary-action__ul_vl2_25y_25b} | Escolha |
| Modelo | Modelo de conexão física associado à interface de rede. | Referência.Modelo de conexão física |
| Tipo | Código de tipo opcional definido pelo usuário que você usa para categorizar os tipos das várias entidades ou ativos de rede. | Referência.Valor de TRF |
| Função | Código de função opcional definido pelo usuário que você usa para categorizar as funções ou finalidades das várias entidades ou ativos de rede. | Referência.Valor de TRF |
| Função | Código de função opcional definido pelo usuário que você usa para categorizar as funções das várias entidades ou ativos de rede. | Referência.Valor de TRF |
| Se vários registros forem ação | Opção para retornar o tipo de saída quando vários registros são encontrados. Você pode selecionar Retornar somente o primeiro registro da lista para retornar o primeiro registro de rede de interface. | Escolha |
[Tabela 1. Campos de entrada da função Obter resumo da interface]

{#get-interface-summary-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 {#get-interface-summary-action__section_rnx_nxn_dvb}

A tabela a seguir lista as informações sobre a saída da função.
{#get-interface-summary-action__table_snx_nxn_dvb__entry__3}

| Nome | Descrição | Tipo de Dados |
|-|-|-|
| Interfaces disponíveis | Retorna a lista sys_id das interfaces de rede disponíveis. | Array.String |
| Interfaces conectadas | Retorna a lista sys_id das interfaces de rede que estão conectadas a outros ativos de rede. | Array.String |
| Conexões físicas | Retorna a lista sys_id das conexões físicas. | Array.String |
[Tabela 2. Saída da função]

{#get-interface-summary-action__table_snx_nxn_dvb}

## Exemplo {#get-interface-summary-action__section_hdk_y2k_x5b}

Se a entrada for aprovada como Equipamento-1, conforme mostrado no exemplo a seguir em que a Porta-1, a Porta-2 e a Porta-3 estão conectadas ao Equipamento-1, a Porta-4 e a Porta-5 estão conectadas ao Equipamento-2 , conexão física-1 entre a Porta-2 e a Porta-4 e conexão física-2 entre a Porta-3 e a Porta-5. Em seguida, a saída é a seguinte:

* Interface disponível - Port-1
* Interfaces conectadas - Port-2 e Port-3
* Conexões físicas - PC-1 e PC-2

{#get-interface-summary-action__ul_upn_y1t_fvb}

Se você selecionar a ação Se vários registros forem encontrados como Retornar somente o primeiro registro, ele retornará a Porta-1, a Porta-2 e o PC-1, respectivamente.
**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 Pesquisar próximo hub](https://servicenow-prod.fluidtopics.net/LqazWIu_WmzCpmJ_2Uqbyg "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.")
* [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.")

