Espaço de nomes: microsoft.graph.industryData
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Crie um novo objeto inboundFileFlow .
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global |
US Government L4 |
US Government L5 (DOD) |
China operada pela 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão |
Permissões com menos privilégios |
Permissões com privilégios superiores |
| Delegado (conta corporativa ou de estudante) |
IndustryData-InboundFlow.ReadWrite.All |
Indisponível. |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Application |
IndustryData-InboundFlow.ReadWrite.All |
Indisponível. |
Solicitação HTTP
POST /external/industryData/inboundFlows
| Nome |
Descrição |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type |
application/json. Obrigatório. |
Corpo da solicitação
No corpo do pedido, forneça uma representação JSON do objeto inboundFileFlow .
A tabela seguinte lista as propriedades obrigatórias e opcionais para criar um objeto inboundFileFlow .
| Propriedade |
Tipo |
Descrição |
| dataDomain |
microsoft.graph.industryData.inboundDomain |
A categoria de dados que está a ser importada neste fluxo. Os valores possíveis são: educationRostering, unknownFutureValue. Obrigatório. |
| displayName |
Cadeia de caracteres |
O nome do processo. Herdado de industryDataActivity. Obrigatório. |
| effectiveDateTime |
DateTimeOffset |
O início da janela de tempo em que o fluxo tem permissão para ser executado. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Obrigatório. |
| expirationDateTime |
DateTimeOffset |
O fim da janela de tempo em que o fluxo tem permissão para ser executado. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Opcional. |
| dataConnector |
microsoft.graph.industryData.industryDataConnector |
O conector de dados para o sistema de origem a partir do qual este fluxo obtém os respetivos dados. Herdado do Fluxo de Entrada. |
| year |
microsoft.graph.industryData.yearTimePeriodDefinition |
O ano associado aos dados que este fluxo traz. Herdado do Fluxo de Entrada. |
Resposta
Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto microsoft.graph.industryData.inboundFileFlow no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/external/industryData/inboundFlows
Content-Type: application/json
Content-length: 246
{
"@odata.type": "#microsoft.graph.industryData.inboundFileFlow",
"dataConnector@odata.bind": "https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0a0-85f6-4478-f526-08daddab2271",
"dataDomain": "educationRostering",
"displayName": "Inbound rostering flow",
"effectiveDateTime": "2023-03-12T16:40:46.924769+05:30",
"expirationDateTime": "2023-03-13T16:40:46.924769+05:30",
"year@odata.bind": "https://graph.microsoft.com/beta/external/industryData/years/ebf18762-ab92-487e-21d1-08daddab28bb"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models.IndustryData;
var requestBody = new InboundFileFlow
{
OdataType = "#microsoft.graph.industryData.inboundFileFlow",
DataDomain = InboundDomain.EducationRostering,
DisplayName = "Inbound rostering flow",
EffectiveDateTime = DateTimeOffset.Parse("2023-03-12T16:40:46.924769+05:30"),
ExpirationDateTime = DateTimeOffset.Parse("2023-03-13T16:40:46.924769+05:30"),
AdditionalData = new Dictionary<string, object>
{
{
"dataConnector@odata.bind" , "https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0a0-85f6-4478-f526-08daddab2271"
},
{
"year@odata.bind" , "https://graph.microsoft.com/beta/external/industryData/years/ebf18762-ab92-487e-21d1-08daddab28bb"
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.External.IndustryData.InboundFlows.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
"time"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodelsindustrydata "github.com/microsoftgraph/msgraph-beta-sdk-go/models/industrydata"
//other-imports
)
requestBody := graphmodelsindustrydata.NewInboundFlow()
dataDomain := graphmodels.EDUCATIONROSTERING_INBOUNDDOMAIN
requestBody.SetDataDomain(&dataDomain)
displayName := "Inbound rostering flow"
requestBody.SetDisplayName(&displayName)
effectiveDateTime , err := time.Parse(time.RFC3339, "2023-03-12T16:40:46.924769+05:30")
requestBody.SetEffectiveDateTime(&effectiveDateTime)
expirationDateTime , err := time.Parse(time.RFC3339, "2023-03-13T16:40:46.924769+05:30")
requestBody.SetExpirationDateTime(&expirationDateTime)
additionalData := map[string]interface{}{
"dataConnector@odata.bind" : "https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0a0-85f6-4478-f526-08daddab2271",
"year@odata.bind" : "https://graph.microsoft.com/beta/external/industryData/years/ebf18762-ab92-487e-21d1-08daddab28bb",
}
requestBody.SetAdditionalData(additionalData)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
inboundFlows, err := graphClient.External().IndustryData().InboundFlows().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.models.industrydata.InboundFileFlow inboundFlow = new com.microsoft.graph.beta.models.industrydata.InboundFileFlow();
inboundFlow.setOdataType("#microsoft.graph.industryData.inboundFileFlow");
inboundFlow.setDataDomain(com.microsoft.graph.beta.models.industrydata.InboundDomain.EducationRostering);
inboundFlow.setDisplayName("Inbound rostering flow");
OffsetDateTime effectiveDateTime = OffsetDateTime.parse("2023-03-12T16:40:46.924769+05:30");
inboundFlow.setEffectiveDateTime(effectiveDateTime);
OffsetDateTime expirationDateTime = OffsetDateTime.parse("2023-03-13T16:40:46.924769+05:30");
inboundFlow.setExpirationDateTime(expirationDateTime);
HashMap<String, Object> additionalData = new HashMap<String, Object>();
additionalData.put("dataConnector@odata.bind", "https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0a0-85f6-4478-f526-08daddab2271");
additionalData.put("year@odata.bind", "https://graph.microsoft.com/beta/external/industryData/years/ebf18762-ab92-487e-21d1-08daddab28bb");
inboundFlow.setAdditionalData(additionalData);
com.microsoft.graph.models.industrydata.InboundFlow result = graphClient.external().industryData().inboundFlows().post(inboundFlow);
const options = {
authProvider,
};
const client = Client.init(options);
const inboundFlow = {
'@odata.type': '#microsoft.graph.industryData.inboundFileFlow',
'dataConnector@odata.bind': 'https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0a0-85f6-4478-f526-08daddab2271',
dataDomain: 'educationRostering',
displayName: 'Inbound rostering flow',
effectiveDateTime: '2023-03-12T16:40:46.924769+05:30',
expirationDateTime: '2023-03-13T16:40:46.924769+05:30',
'year@odata.bind': 'https://graph.microsoft.com/beta/external/industryData/years/ebf18762-ab92-487e-21d1-08daddab28bb'
};
await client.api('/external/industryData/inboundFlows')
.version('beta')
.post(inboundFlow);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\IndustryData\InboundFileFlow;
use Microsoft\Graph\Beta\Generated\Models\IndustryData\InboundDomain;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new InboundFileFlow();
$requestBody->setOdataType('#microsoft.graph.industryData.inboundFileFlow');
$requestBody->setDataDomain(new InboundDomain('educationRostering'));
$requestBody->setDisplayName('Inbound rostering flow');
$requestBody->setEffectiveDateTime(new \DateTime('2023-03-12T16:40:46.924769+05:30'));
$requestBody->setExpirationDateTime(new \DateTime('2023-03-13T16:40:46.924769+05:30'));
$additionalData = [
'dataConnector@odata.bind' => 'https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0a0-85f6-4478-f526-08daddab2271',
'year@odata.bind' => 'https://graph.microsoft.com/beta/external/industryData/years/ebf18762-ab92-487e-21d1-08daddab28bb',
];
$requestBody->setAdditionalData($additionalData);
$result = $graphServiceClient->external()->industryData()->inboundFlows()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Search
$params = @{
"@odata.type" = "#microsoft.graph.industryData.inboundFileFlow"
"dataConnector@odata.bind" = "https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0a0-85f6-4478-f526-08daddab2271"
dataDomain = "educationRostering"
displayName = "Inbound rostering flow"
effectiveDateTime = [System.DateTime]::Parse("2023-03-12T16:40:46.924769+05:30")
expirationDateTime = [System.DateTime]::Parse("2023-03-13T16:40:46.924769+05:30")
"year@odata.bind" = "https://graph.microsoft.com/beta/external/industryData/years/ebf18762-ab92-487e-21d1-08daddab28bb"
}
New-MgBetaExternalIndustryDataInboundFlow -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.industry_data.inbound_file_flow import InboundFileFlow
from msgraph_beta.generated.models.inbound_domain import InboundDomain
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = InboundFileFlow(
odata_type = "#microsoft.graph.industryData.inboundFileFlow",
data_domain = InboundDomain.EducationRostering,
display_name = "Inbound rostering flow",
effective_date_time = "2023-03-12T16:40:46.924769+05:30",
expiration_date_time = "2023-03-13T16:40:46.924769+05:30",
additional_data = {
"data_connector@odata_bind" : "https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0a0-85f6-4478-f526-08daddab2271",
"year@odata_bind" : "https://graph.microsoft.com/beta/external/industryData/years/ebf18762-ab92-487e-21d1-08daddab28bb",
}
)
result = await graph_client.external.industry_data.inbound_flows.post(request_body)
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.industryData.inboundFileFlow",
"dataDomain": "educationRostering",
"displayName": "Inbound rostering fow",
"effectiveDateTime": "2023-03-12T11:10:46.924769Z",
"expirationDateTime": "2023-03-13T11:10:46.924769Z",
"id": "7bd62d17-8c37-4494-f68d-08daddab2911",
"readinessStatus": "ready"
}