Travaux de minuteur SharePoint Online avec des fonctions Azure à l'aide de PnP-P1

Présentation

Cette série vous montrera comment créer un travail du minuteur SharePoint avec du code CSOM PnP, à l'aide des fonctions Azure. Les captures d'écran étape par étape sont fournies dans chaque section. Cela vous donnera un bon départ si vous débutez dans Azure Functions et souhaitez créer des travaux du minuteur avec le modèle objet côté client.

Introduction

Une fonction Azure est une nouvelle option de création du travail du minuteur SharePoint Online. Comparé à Azure Web Jobs, il fonctionnera parfaitement pour les morceaux de code légers et de courte durée, ce qui est très souvent le cas avec les travaux du minuteur. Il prend également en charge le plan de consommation (Pay-As-You-Go), ce qui le rend beaucoup moins coûteux de maintenir un travail de minuteur. Voici la liste des avantages de l'utilisation de la fonction Azure par rapport aux travaux Web Azure.

• Plan de consommation
• Mise à l'échelle automatique (le processeur et la mémoire sont mis à l'échelle en fonction des besoins de l'exécution) [19659006] Plus de déclencheurs
• Développement dans les navigateurs

La comparaison entre la fonction Azure et les travaux Web Azure est supérieure à celle de la liste courte ci-dessus. Voici le lien pour vous aider à choisir entre Azure Functions et Azure Web Jobs. https://stackoverflow.com/questions/36610952/azure-webjobs-vs-azure-functions-how-to-choose

Cet article explique comment créer un travail de minuteur à l'aide de fonctions Azure et de SharePoint PnP. Extension CSOM. Si vous ne possédez pas des tonnes de code hérité construites sur PnP, ignorez cet article et commencez à rechercher des options plus pertinentes, car la fonction Azure n'est pas limitée à C # ou à PnP. Voici la liste complète des langues prises en charge par Azure Functions https://docs.microsoft.com/en-us/azure/azure-functions/supported-languages ​​

Ce poste est divisé en deux . ] parties, la première partie concerne la création d'un enregistrement d'application Azure AD. Si vous le connaissez bien, vous pouvez l'ignorer et commencer par la deuxième partie, qui concerne la création de la fonction Azure et la connexion à SharePoint Online avec les informations d'identification de l'application

. Étapes de haut niveau:

1. Créer un enregistrement d'application Azure AD (Partie 1)
2. Création d'une application de groupe de fonctions Azure et d'une fonction (Partie 2)
3. Connexion à SharePoint en ligne avec des informations d'identification d'application (Partie 2)

Création d'un enregistrement d'application Azure AD

La première étape consiste à enregistrer une nouvelle application Azure AD. Cela donnera à la fonction Azure uniquement des autorisations et un contexte pour le client hébergé SharePoint Online. Azure Function doit s'authentifier auprès de SharePoint Online. Si vous ne connaissez pas bien les applications Azure AD, vérifiez le lien suivant pour des instructions détaillées, étape par étape.

https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly -azuread

Les étapes décrites ci-dessous ne sont que la capture d'écran avec une brève explication:

1.Connectez-vous au portail Azure – Azure Active Directory – Inscriptions, cliquez sur le bouton "Enregistrement de la nouvelle application" qui est mis en surbrillance dans la capture d'écran suivante. .

https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps

2.Provide a Nom ( DemoAzureFrench ) pour l'application, option de sélection Web app / API et renseignez l'URL de connexion avec une URL (par exemple, https://www.pnp.com [Cliquezsurlebouton Créer pour créer l'application Azure AD.

Copie t La valeur de l'application et enregistrez-la dans un bloc-notes

3.Cliquez sur le lien Paramètres puis sur Autorisations requises puis sélectionnez le bouton Ajouter .

]

4.Dans la nouvelle lame Ajouter un accès API sélectionnez Office 365 SharePoint Online

5. Sélectionnez l’autorisation requise pour votre app. Dans cet article, l'application DemoAzureFunctionTimerJob n'aura besoin que de l'autorisation «Lire et écrire des éléments et des listes dans toutes les collections de sites». Cliquez sur les boutons pour sélectionner des autorisations et Terminés

6.Sélectionnez le bouton Accorder des autorisations . (Beaucoup de gens ont raté cette étape)

7. Exécutez le script dans le projet DemoAzureFunctionTimerJob dans le dossier Outils avec cette commande:

. Create -SelfSignedCertificate.ps1 -CommonName “Demo” -StartDate 2019-01-21 -EndDate 2050-01-21 -Password (ConvertTo-SecureString -String “MyPassword” -AsPlainText -Force)

[Libre] ] 8. Exécutez le script dans la solution Outils avec cette commande:

. Get-SelfSignedCertificateInformation.ps1 -CertPath

9.Sélectionnez le . ] Manifest en haut de la lame, puis sélectionnez la propriété Edit .

10.Recouvrez la clé keyCredentials et remplacez-la par l'extrait généré par le . Get-SelfSignedCertificateInformation.ps1

Avant:

Après:

Lors du remplacement du keyCredntials valeur associée à l'extrait keyCredenitals elle soulignera la propriété value en rouge, pour remédier à cela, assurez-vous que la valeur est complète. 1 ligne.

11.Cliquez sur le bouton Enregistrer pour sauvegarder le manifeste.

12.Accédez à l'URL ci-dessous avec les informations de votre enregistrement d'application, renseignez avec l'identifiant d'application de l'enregistrement d'application:

. https://login.microsoftonline.com/ .onmicrosoft.com / adminconsent? Client_id = & state = 12345

La page sera redirigée vers le site . .pnp.com qui n’existe pas. Ceci est attendu, veuillez simplement ignorer.