---
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 Alocar número livre

# Função Alocar número livre {#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 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.
Você usa a função Alocar número livre para fazer as seguintes ações:

* Atribua o número livre de um intervalo de números que está no registro de inventário.
* Obtenha o número livre do intervalo de números e crie o registro de número de inventário como um número secundário.
* Adicione os números livres ao IC em um elemento numérico.
{#allocate-free-number-action__ul_cdb_m1p_t5b}

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

## Funções e disponibilidade {#allocate-free-number-action__section_kfd_fdk_x5b}

Uma função de administrador pode 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 {#allocate-free-number-action__section_vvs_jpr_x5b}

A tabela a seguir lista os campos de entrada na ação Alocar número livre e suas descrições.
{#allocate-free-number-action__table_w3g_2fm_1vb__entry__3}

| Nome do campo | Descrição | Tipo |
|-|-|-|
| Intervalo numérico | Registro de número de inventário para o qual você precisa do número livre. | Referência.Registro de número de inventário |
| Contagem | Contagem total de números livres. | Números inteiros |
| Tipo de número | Tipo de conexão de rede para a qual você precisa dos números livres. Selecione uma das seguintes propriedades: VLAN :   Registro de número de VLAN único. LAG :   Registro de número de LAG único. | Escolha |
| Pertence ao item de configuração | Item de configuração (IC) relacionado ao registro do número de inventário. | Referência.Item de configuração |
| Consecutivo | Opção para retornar os números livres consecutivos. | Verdadeiro/falso |
[Tabela 1. Campos de entrada da função Alocar número livre]

{#allocate-free-number-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 {#allocate-free-number-action__section_adz_wwm_dvb}

A tabela a seguir lista as informações sobre a saída da função.
{#allocate-free-number-action__table_fxx_wxm_dvb__entry__3}

| Nome | Descrição | Tipo |
|-|-|-|
| FinalRecordList | Retorna a lista de registros de número de inventário para o intervalo de números. | Array.Integer |
[Tabela 2. Saída da função]

{#allocate-free-number-action__table_fxx_wxm_dvb}

## Exemplo {#allocate-free-number-action__section_i5v_kpr_x5b}

Considere que uma VLAN tem de 1 a 4096 como intervalo de números e 1 a 1000, 1001 a 2500 e 2510 a 4096 são os subintervalos. Se você fornecer a contagem como 4, a função retornará a lista de registros de número de inventário para 2501, 2502, 2503 e 2504. Esses números estão livres no intervalo de números da VLAN.
**Conceitos relacionados**   

* [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 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.")

