ProjectParticipation erstellen

Artikel
07/18/2022
7 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Verwenden Sie diese API, um ein neues projectParticipation-Objekt im Profileines Benutzers zu erstellen.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	User.ReadWrite, User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	User.ReadWrite, User.ReadWrite.All
Anwendung	User.ReadWrite.All

HTTP-Anforderung

POST /me/profile/projects
POST /users/{id | userPrincipalName}/profile/projects

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich.
Content-Type	application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des projectParticipation-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die festgelegt werden können, wenn Sie ein neues projectParticipation-Objekt im Profileines Benutzers erstellen.

Eigenschaft	Typ	Beschreibung
allowedAudiences	Zeichenfolge	Die Zielgruppen, die in der Lage sind, die in der Entität enthaltenen Werte anzuzeigen. Geerbt von itemFacet. Mögliche Werte: `me`, `family`, `contacts`, `groupMembers`, `organization`, `federatedOrganizations`, `everyone`, `unknownFutureValue`.
categories	String collection	Enthält Kategorien, die ein Benutzer dem Projekt zugeordnet hat (z. B. digitale Transformation, Rig).
Kunde	companyDetail	Enthält ausführliche Informationen zu dem Client, für den das Projekt vorgesehen war.
collaborationTags	Zeichenfolgenauflistung	Enthält Erfahrungsszenario-Tags, die ein Benutzer mit dem Interesse verknüpft hat. Zulässige Werte in der Auflistung sind: `askMeAbout` , `ableToMentor` , , `wantsToLearn` `wantsToImprove` .
Kollegen	relatedPerson-Auflistung	Listet Personen auf, die auch am Projekt gearbeitet haben.
Detail	positionDetail	Enthält Details zur Rolle des Benutzers im Projekt.
displayName	Zeichenfolge	Enthält einen Anzeigenamen für das Projekt.
Ableitung	inferenceData	Enthält Denkdaten, wenn die Entität von der erstellenden oder ändernden Anwendung abgeleitet wird. Geerbt von itemFacet.
source	personDataSource	Wo die Werte stammen, wenn sie von einem anderen Dienst synchronisiert wurden. Geerbt von itemFacet.
Sponsoren	relatedPerson-Auflistung	Die Person oder personen, die das Projekt unterstützt haben.

Beziehungen

Antwort

Bei erfolgreicher Ausführung gibt die Methode 201, Created den Antwortcode und ein neues projectParticipation-Objekt im Antworttext zurück.

Beispiele

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/me/profile/projects
Content-type: application/json

{
  "categories": [
    "Branding"
  ],
  "client": {
    "displayName": "Contoso Ltd.",
    "department": "Corporate Marketing",
    "webUrl": "https://www.contoso.com"
  },
  "displayName": "Contoso Re-branding Project",
  "detail": {
    "company": {
      "displayName": "Adventureworks Inc.",
      "department": "Consulting",
      "webUrl": "https://adventureworks.com"
    },
    "description": "Rebranding of Contoso Ltd.",
    "jobTitle": "Lead PM Rebranding",
    "role": "project management",
    "summary": "A 6 month project to help Contoso rebrand after they were divested from a parent organization."
  }
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var projectParticipation = new ProjectParticipation
{
    Categories = new List<String>()
    {
        "Branding"
    },
    Client = new CompanyDetail
    {
        DisplayName = "Contoso Ltd.",
        Department = "Corporate Marketing",
        WebUrl = "https://www.contoso.com"
    },
    DisplayName = "Contoso Re-branding Project",
    Detail = new PositionDetail
    {
        Company = new CompanyDetail
        {
            DisplayName = "Adventureworks Inc.",
            Department = "Consulting",
            WebUrl = "https://adventureworks.com"
        },
        Description = "Rebranding of Contoso Ltd.",
        JobTitle = "Lead PM Rebranding",
        Role = "project management",
        Summary = "A 6 month project to help Contoso rebrand after they were divested from a parent organization."
    }
};

await graphClient.Me.Profile.Projects
    .Request()
    .AddAsync(projectParticipation);

Wichtig

Microsoft Graph SDKs verwenden standardmäßig die Version 1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Betaversion verfügbar sind. Ausführliche Informationen zum Zugreifen auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph-SDKs mit der Beta-API.

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.


const options = {
    authProvider,
};

const client = Client.init(options);

const projectParticipation = {
  categories: [
    'Branding'
  ],
  client: {
    displayName: 'Contoso Ltd.',
    department: 'Corporate Marketing',
    webUrl: 'https://www.contoso.com'
  },
  displayName: 'Contoso Re-branding Project',
  detail: {
    company: {
      displayName: 'Adventureworks Inc.',
      department: 'Consulting',
      webUrl: 'https://adventureworks.com'
    },
    description: 'Rebranding of Contoso Ltd.',
    jobTitle: 'Lead PM Rebranding',
    role: 'project management',
    summary: 'A 6 month project to help Contoso rebrand after they were divested from a parent organization.'
  }
};

await client.api('/me/profile/projects')
    .version('beta')
    .post(projectParticipation);

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/profile/projects"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphProjectParticipation *projectParticipation = [[MSGraphProjectParticipation alloc] init];
NSMutableArray *categoriesList = [[NSMutableArray alloc] init];
[categoriesList addObject: @"Branding"];
[projectParticipation setCategories:categoriesList];
MSGraphCompanyDetail *client = [[MSGraphCompanyDetail alloc] init];
[client setDisplayName:@"Contoso Ltd."];
[client setDepartment:@"Corporate Marketing"];
[client setWebUrl:@"https://www.contoso.com"];
[projectParticipation setClient:client];
[projectParticipation setDisplayName:@"Contoso Re-branding Project"];
MSGraphPositionDetail *detail = [[MSGraphPositionDetail alloc] init];
MSGraphCompanyDetail *company = [[MSGraphCompanyDetail alloc] init];
[company setDisplayName:@"Adventureworks Inc."];
[company setDepartment:@"Consulting"];
[company setWebUrl:@"https://adventureworks.com"];
[detail setCompany:company];
[detail setDescription:@"Rebranding of Contoso Ltd."];
[detail setJobTitle:@"Lead PM Rebranding"];
[detail setRole:@"project management"];
[detail setSummary:@"A 6 month project to help Contoso rebrand after they were divested from a parent organization."];
[projectParticipation setDetail:detail];

NSError *error;
NSData *projectParticipationData = [projectParticipation getSerializedDataWithError:&error];
[urlRequest setHTTPBody:projectParticipationData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

ProjectParticipation projectParticipation = new ProjectParticipation();
LinkedList<String> categoriesList = new LinkedList<String>();
categoriesList.add("Branding");
projectParticipation.categories = categoriesList;
CompanyDetail client = new CompanyDetail();
client.displayName = "Contoso Ltd.";
client.department = "Corporate Marketing";
client.webUrl = "https://www.contoso.com";
projectParticipation.client = client;
projectParticipation.displayName = "Contoso Re-branding Project";
PositionDetail detail = new PositionDetail();
CompanyDetail company = new CompanyDetail();
company.displayName = "Adventureworks Inc.";
company.department = "Consulting";
company.webUrl = "https://adventureworks.com";
detail.company = company;
detail.description = "Rebranding of Contoso Ltd.";
detail.jobTitle = "Lead PM Rebranding";
detail.role = "project management";
detail.summary = "A 6 month project to help Contoso rebrand after they were divested from a parent organization.";
projectParticipation.detail = detail;

graphClient.me().profile().projects()
    .buildRequest()
    .post(projectParticipation);

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewProjectParticipation()
requestBody.SetCategories( []String {
    "Branding",
}
client := msgraphsdk.NewCompanyDetail()
requestBody.SetClient(client)
displayName := "Contoso Ltd."
client.SetDisplayName(&displayName)
department := "Corporate Marketing"
client.SetDepartment(&department)
webUrl := "https://www.contoso.com"
client.SetWebUrl(&webUrl)
displayName := "Contoso Re-branding Project"
requestBody.SetDisplayName(&displayName)
detail := msgraphsdk.NewPositionDetail()
requestBody.SetDetail(detail)
company := msgraphsdk.NewCompanyDetail()
detail.SetCompany(company)
displayName := "Adventureworks Inc."
company.SetDisplayName(&displayName)
department := "Consulting"
company.SetDepartment(&department)
webUrl := "https://adventureworks.com"
company.SetWebUrl(&webUrl)
description := "Rebranding of Contoso Ltd."
detail.SetDescription(&description)
jobTitle := "Lead PM Rebranding"
detail.SetJobTitle(&jobTitle)
role := "project management"
detail.SetRole(&role)
summary := "A 6 month project to help Contoso rebrand after they were divested from a parent organization."
detail.SetSummary(&summary)
result, err := graphClient.Me().Profile().Projects().Post(requestBody)

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.


Import-Module Microsoft.Graph.People

$params = @{
    Categories = @(
        "Branding"
    )
    Client = @{
        DisplayName = "Contoso Ltd."
        Department = "Corporate Marketing"
        WebUrl = "https://www.contoso.com"
    }
    DisplayName = "Contoso Re-branding Project"
    Detail = @{
        Company = @{
            DisplayName = "Adventureworks Inc."
            Department = "Consulting"
            WebUrl = "https://adventureworks.com"
        }
        Description = "Rebranding of Contoso Ltd."
        JobTitle = "Lead PM Rebranding"
        Role = "project management"
        Summary = "A 6 month project to help Contoso rebrand after they were divested from a parent organization."
    }
}

# A UPN can also be used as -UserId.
New-MgUserProfileProject -UserId $userId -BodyParameter $params

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
  "allowedAudiences": "organization",
  "inference": null,
  "createdDateTime": "2020-07-06T06:34:12.2294868Z",
  "createdBy": {
    "application": null,
    "device": null,
    "user": {
      "displayName": "Innocenty Popov",
      "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
    }
  },
  "lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
  "lastModifiedBy": {
    "application": null,
    "device": null,
    "user": {
      "displayName": "Innocenty Popov",
      "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
    }
  },
  "source": null,
  "categories": [
    "Branding"
  ],
  "client": {
    "displayName": "Contoso Ltd.",
    "pronunciation": null,
    "department": "Corporate Marketing",
    "officeLocation": null,
    "address": null,
    "webUrl": "https://www.contoso.com"
  },
  "displayName": "Contoso Re-branding Project",
  "detail": {
    "company": {
      "displayName": "Adventureworks Inc.",
      "pronunciation": null,
      "department": "Consulting",
      "officeLocation": null,
      "address": null,
      "webUrl": "https://adventureworks.com"
    },
    "description": "Rebranding of Contoso Ltd.",
    "endMonthYear": "datetime-value",
    "jobTitle": "Lead PM Rebranding",
    "role": "project management",
    "startMonthYear": "datetime-value",
    "summary": "A 6 month project to help Contoso rebrand after they were divested from a parent organization."
  },
  "colleagues": null,
  "sponsors": null
}

ProjectParticipation erstellen

Berechtigungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Beziehungen

Antwort

Beispiele

Anforderung

Antwort

Feedback