Создание элемента утверждения

Статья
09/10/2024

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Создайте объект approvalItem .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	❌	❌	❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	ApprovalSolution.ReadWrite	Недоступно.
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Для приложений	Не поддерживается.	Не поддерживается.

HTTP-запрос

POST /solutions/approval/approvalItems

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type	application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление объекта approvalItem в формате JSON.

При создании объекта approvalItem можно указать следующие свойства.

Свойство	Тип	Описание
displayName	String	DisplayName запроса на утверждение. Обязательный.
description	String	Описание запроса на утверждение. Необязательный параметр.
allowEmailNotification	Логический	Указывает, включено ли уведомление по электронной почте. Необязательный параметр.
approvalType	approvalItemType	Тип рабочего процесса элемента утверждения. Допустимые значения: `basic`, `basicAwaitAll`, `custom`, `customAwaitAll`. Обязательно.
responsePrompts	Коллекция строк	Ответные запросы на утверждение. Укажите значение этого свойства только при создании пользовательского элемента утверждения. Для пользовательских элементов утверждения укажите две строки запроса на ответ. Ответные запросы по умолчанию: "Утвердить" и "Отклонить". Необязательный параметр.
Утверждающих	Коллекция approvalIdentitySet	Удостоверение субъектов, которым изначально был назначен элемент утверждения. Обязательно.
owner	approvalIdentitySet	Набор удостоверений субъекта, которому принадлежит элемент утверждения. Укажите значение этого свойства только при создании элемента утверждения от имени субъекта. Если поле владельца не указано, используются сведения о пользователе из контекста пользователя. Необязательный параметр.

Отклик

В случае успешного 202 Accepted выполнения этот метод возвращает код ответа с расположением операции в заголовке.

Примеры

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/solutions/approval/approvalItems
Content-Type: application/json

{
  "approvers":[
    {
      "user": {
        "id": "39d1a7fb-5f54-4c89-b513-241683718c9b",
        "displayName": "Jana Pihlak"
      }
    },
    {
      "group": {
        "id": "f2926053-5479-4bce-ad4c-8394ce51d6c5"
      }
    }
  ],
  "displayName":"Title of approval",
  "description":"Details of approval",
  "approvalType": "basic",
  "allowEmailNotification": true
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new ApprovalItem
{
	Approvers = new List<ApprovalIdentitySet>
	{
		new ApprovalIdentitySet
		{
			User = new Identity
			{
				Id = "39d1a7fb-5f54-4c89-b513-241683718c9b",
				DisplayName = "Jana Pihlak",
			},
		},
		new ApprovalIdentitySet
		{
			Group = new Identity
			{
				Id = "f2926053-5479-4bce-ad4c-8394ce51d6c5",
			},
		},
	},
	DisplayName = "Title of approval",
	Description = "Details of approval",
	ApprovalType = ApprovalItemType.Basic,
	AllowEmailNotification = true,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.Approval.ApprovalItems.PostAsync(requestBody);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



mgc-beta solutions approval approval-items create --body '{\
  "approvers":[\
    {\
      "user": {\
        "id": "39d1a7fb-5f54-4c89-b513-241683718c9b",\
        "displayName": "Jana Pihlak"\
      }\
    },\
    {\
      "group": {\
        "id": "f2926053-5479-4bce-ad4c-8394ce51d6c5"\
      }\
    }\
  ],\
  "displayName":"Title of approval",\
  "description":"Details of approval",\
  "approvalType": "basic",\
  "allowEmailNotification": true\
}\
'

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewApprovalItem()


approvalIdentitySet := graphmodels.NewApprovalIdentitySet()
user := graphmodels.NewIdentity()
id := "39d1a7fb-5f54-4c89-b513-241683718c9b"
user.SetId(&id) 
displayName := "Jana Pihlak"
user.SetDisplayName(&displayName) 
approvalIdentitySet.SetUser(user)
approvalIdentitySet1 := graphmodels.NewApprovalIdentitySet()
group := graphmodels.NewIdentity()
id := "f2926053-5479-4bce-ad4c-8394ce51d6c5"
group.SetId(&id) 
approvalIdentitySet1.SetGroup(group)

approvers := []graphmodels.ApprovalIdentitySetable {
	approvalIdentitySet,
	approvalIdentitySet1,
}
requestBody.SetApprovers(approvers)
displayName := "Title of approval"
requestBody.SetDisplayName(&displayName) 
description := "Details of approval"
requestBody.SetDescription(&description) 
approvalType := graphmodels.BASIC_APPROVALITEMTYPE 
requestBody.SetApprovalType(&approvalType) 
allowEmailNotification := true
requestBody.SetAllowEmailNotification(&allowEmailNotification) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
approvalItems, err := graphClient.Solutions().Approval().ApprovalItems().Post(context.Background(), requestBody, nil)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

ApprovalItem approvalItem = new ApprovalItem();
LinkedList<ApprovalIdentitySet> approvers = new LinkedList<ApprovalIdentitySet>();
ApprovalIdentitySet approvalIdentitySet = new ApprovalIdentitySet();
Identity user = new Identity();
user.setId("39d1a7fb-5f54-4c89-b513-241683718c9b");
user.setDisplayName("Jana Pihlak");
approvalIdentitySet.setUser(user);
approvers.add(approvalIdentitySet);
ApprovalIdentitySet approvalIdentitySet1 = new ApprovalIdentitySet();
Identity group = new Identity();
group.setId("f2926053-5479-4bce-ad4c-8394ce51d6c5");
approvalIdentitySet1.setGroup(group);
approvers.add(approvalIdentitySet1);
approvalItem.setApprovers(approvers);
approvalItem.setDisplayName("Title of approval");
approvalItem.setDescription("Details of approval");
approvalItem.setApprovalType(ApprovalItemType.Basic);
approvalItem.setAllowEmailNotification(true);
ApprovalItem result = graphClient.solutions().approval().approvalItems().post(approvalItem);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const approvalItem = {
  approvers: [
    {
      user: {
        id: '39d1a7fb-5f54-4c89-b513-241683718c9b',
        displayName: 'Jana Pihlak'
      }
    },
    {
      group: {
        id: 'f2926053-5479-4bce-ad4c-8394ce51d6c5'
      }
    }
  ],
  displayName: 'Title of approval',
  description: 'Details of approval',
  approvalType: 'basic',
  allowEmailNotification: true
};

await client.api('/solutions/approval/approvalItems')
	.version('beta')
	.post(approvalItem);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\ApprovalItem;
use Microsoft\Graph\Beta\Generated\Models\ApprovalIdentitySet;
use Microsoft\Graph\Beta\Generated\Models\Identity;
use Microsoft\Graph\Beta\Generated\Models\ApprovalItemType;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new ApprovalItem();
$approversApprovalIdentitySet1 = new ApprovalIdentitySet();
$approversApprovalIdentitySet1User = new Identity();
$approversApprovalIdentitySet1User->setId('39d1a7fb-5f54-4c89-b513-241683718c9b');
$approversApprovalIdentitySet1User->setDisplayName('Jana Pihlak');
$approversApprovalIdentitySet1->setUser($approversApprovalIdentitySet1User);
$approversArray []= $approversApprovalIdentitySet1;
$approversApprovalIdentitySet2 = new ApprovalIdentitySet();
$approversApprovalIdentitySet2Group = new Identity();
$approversApprovalIdentitySet2Group->setId('f2926053-5479-4bce-ad4c-8394ce51d6c5');
$approversApprovalIdentitySet2->setGroup($approversApprovalIdentitySet2Group);
$approversArray []= $approversApprovalIdentitySet2;
$requestBody->setApprovers($approversArray);

$requestBody->setDisplayName('Title of approval');
$requestBody->setDescription('Details of approval');
$requestBody->setApprovalType(new ApprovalItemType('basic'));
$requestBody->setAllowEmailNotification(true);

$result = $graphServiceClient->solutions()->approval()->approvalItems()->post($requestBody)->wait();

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.approval_item import ApprovalItem
from msgraph_beta.generated.models.approval_identity_set import ApprovalIdentitySet
from msgraph_beta.generated.models.identity import Identity
from msgraph_beta.generated.models.approval_item_type import ApprovalItemType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ApprovalItem(
	approvers = [
		ApprovalIdentitySet(
			user = Identity(
				id = "39d1a7fb-5f54-4c89-b513-241683718c9b",
				display_name = "Jana Pihlak",
			),
		),
		ApprovalIdentitySet(
			group = Identity(
				id = "f2926053-5479-4bce-ad4c-8394ce51d6c5",
			),
		),
	],
	display_name = "Title of approval",
	description = "Details of approval",
	approval_type = ApprovalItemType.Basic,
	allow_email_notification = True,
)

result = await graph_client.solutions.approval.approval_items.post(request_body)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/solutions/approval/operations/1a837203-b794-4cea-8def-47a7d1f89335

Поделиться через

Создание элемента утверждения

Разрешения

HTTP-запрос

Заголовки запросов

Текст запроса

Отклик

Примеры

Запрос

Отклик

Обратная связь

Дополнительные ресурсы