Πώς να δημιουργήσετε προσαρμοσμένες ενέργειες στο Power Automate για υπολογιστή
Βελτιώστε την παραγωγικότητα, την επαναχρησιμοποίηση και την επεκτασιμότητα με προσαρμοσμένες ενέργειες στο Power Automate για υπολογιστή. Αυτό το άρθρο περιγράφει πώς οι προσαρμοσμένες ενέργειες στο Power Automate για υπολογιστή μπορούν να βοηθήσουν τους κατασκευαστές να δημιουργήσουν τις δικές τους επαναχρησιμοποιήσιμες ενέργειες που μπορούν να χρησιμοποιηθούν σε πολλαπλές ροές. Οι δημιουργοί δημιουργούν προσαρμοσμένες ενέργειες συνθέτοντας μια ακολουθία βημάτων ή συναρτήσεων σε μια νέα ενέργεια. Οι προσαρμοσμένες ενέργειες δημιουργούνται χρησιμοποιώντας το SDK ενεργειών του Power Automate για υπολογιστή, το οποίο παρέχει ένα σύνολο API που επιτρέπουν στους δημιουργούς να δημιουργούν προσαρμοσμένες ενέργειες χρησιμοποιώντας τη γλώσσα .NET C#. Οι προσαρμοσμένες ενέργειες μπορούν επίσης να κοινοποιηθούν σε άλλους χρήστες μέσω της ενότητας προσαρμοσμένων ενεργειών στο Power Automate (make.powerautomate.com). Σε αυτό το άρθρο, βρείτε λεπτομερείς οδηγίες σχετικά με τον τρόπο δημιουργίας, δόμησης, ανάπτυξης, χρήσης και ενημέρωσης προσαρμοσμένων ενεργειών.
Σημαντικό
Ενώ υποστηρίζονται οι βασικές δυνατότητες που χρησιμοποιούνται για τη δημιουργία προσαρμοσμένων ενεργειών, οι παρεχόμενες λύσεις, τα πάγια στοιχεία και τα δείγματα σεναρίων που αναφέρονται εδώ χρησιμεύουν ως παράδειγμα υλοποίησης αυτών των δυνατοτήτων και δεν περιλαμβάνουν υποστήριξη.
Επισκόπηση
Η δυνατότητα προσαρμοσμένων ενεργειών στο Power Automate για υπολογιστή σάς επιτρέπει να δημιουργήσετε τις δικές σας επαναχρησιμοποιήσιμες ενέργειες που μπορούν να χρησιμοποιηθούν σε πολλές ροές επιφάνειας εργασίας. Οι προσαρμοσμένες ενέργειες σάς εξοικονομούν χρόνο και προσπάθεια, επιτρέποντάς σας να επαναχρησιμοποιείτε πολύπλοκες ή συχνά χρησιμοποιούμενες ενέργειες χωρίς να χρειάζεται να τις δημιουργείτε εκ νέου κάθε φορά που δημιουργείτε μια νέα ροή. Οι δημιουργοί μπορούν να εφαρμόσουν τις υπάρχουσες δεξιότητες και γνώσεις τους για να δημιουργήσουν προσαρμοσμένες ενέργειες που ενσωματώνονται σε άλλα συστήματα και υπηρεσίες. Επιπλέον, οι επαγγελματίες προγραμματιστές μπορούν να συσκευάσουν τις υπάρχουσες λειτουργίες ή βιβλιοθήκες κώδικα για να κάνουν μια νέα προσαρμοσμένη ενέργεια που οδηγεί σε αυξημένη επαναχρησιμοποίηση των πάγιων στοιχείων του οργανισμού.
Δημιουργείτε προσαρμοσμένες ενέργειες συνθέτοντας μια ακολουθία μεθόδων ή συναρτήσεων σε μια νέα ενέργεια. Μόλις δημιουργήσετε μια προσαρμοσμένη ενέργεια, χρησιμοποιήστε τη σε οποιαδήποτε ροή επιφάνειας εργασίας, σύροντάς την και αποθέτοντάς τη στον καμβά σχεδιαστή Power Automate για υπολογιστή.
Οι προσαρμοσμένες ενέργειες μπορούν να κοινοποιηθούν σε άλλους χρήστες μέσω της ενότητας προσαρμοσμένων ενεργειών στο Power Automate, το οποίο παρέχει ένα κεντρικό αποθετήριο για κοινή χρήση και ανακάλυψη προσαρμοσμένων ενεργειών. Αυτό σημαίνει ότι οι χρήστες μπορούν να επωφεληθούν από την τεχνογνωσία και τις γνώσεις άλλων στον οργανισμό και μπορούν εύκολα να βρουν και να χρησιμοποιήσουν προσαρμοσμένες ενέργειες που δημιουργούνται από άλλους δημιουργούς.
Συνολικά, προσαρμοσμένες ενέργειες στο Power Automate για υπολογιστή παρέχουν έναν ισχυρό τρόπο για την επέκταση της λειτουργικότητας του προϊόντος, τον εξορθολογισμό της διαδικασίας δημιουργίας ροής και την προώθηση της συνεργασίας και της καινοτομίας εντός του οργανισμού.
Προϋποθέσεις
- Τελευταία έκδοση του Power Automate για υπολογιστή – Install Power Automate
- Εργαλείο συγγραφής C# όπως Visual Studio Community/Professional/Enterprise 2022 με το φόρτο εργασίας ανάπτυξης επιφάνειας εργασίας .NET
- SDK προσαρμοσμένων ενεργειών – NuGet Gallery | Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK
- Ψηφιακό πιστοποιητικό:
- Δημιουργία αυτο-υπογεγραμμένου πιστοποιητικού – Επισκόπηση δημιουργίας αυτο-υπογεγραμμένων πιστοποιητικών – .NET
- Ανάπτυξη επιχείρησης – Το αξιόπιστο πιστοποιητικό του οργανισμού σας από την αρχή έκδοσης πιστοποιητικών – Ψηφιακές υπογραφές και πιστοποιητικά – Υποστήριξη του Office
- SignTool:
- Windows PowerShell Script (.ps1) – Δημιουργία προσαρμοσμένων ενεργειών – Power Automate
Δημιουργία της δικής σας προσαρμοσμένης ενέργειας
Ανοίξτε το Visual Studio για να δημιουργήσετε ένα νέο έργο χρησιμοποιώντας το πρότυπο της Βιβλιοθήκης τάξεων (.NET Framework).
Ρυθμίστε το νέο σας έργο με όνομα έργου, τοποθεσία αρχείου και ορίστε το Framework ως .NET Framework 4.7.2.
Σημείωμα
Βεβαιωθείτε ότι έχετε ακολουθήσει τις συμβάσεις ονοματοδοσίας. Περισσότερες πληροφορίες: Συμβάσεις ονόματος προσαρμοσμένης μονάδας
Στο Visual Studio, επιλέξτε Εργαλεία>NuGet Package Manager>Κονσόλα Package Manager.
Ανοίξτε ένα παράθυρο PowerShell και εγκαταστήστε το NuGet package PowerAutomate.Desktop.Actions.SDK χρησιμοποιώντας αυτήν την εντολή PowerShell.
Find-Package Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK NuGet\Install-Package Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDKΑκολουθήστε τα βήματα στην ενότητα Δημιουργία προσαρμοσμένων ενεργειών για να δημιουργήσετε το αρχείο τάξεων για την προσαρμοσμένη σας ενέργεια.
Πληροφορίες που μπορείτε να χρησιμοποιήσετε ως αναφορά για την ενέργειά σας
Αρχείο λύσεων αναφοράς: .NET Module Solution
Ενέργεια: Γράψτε ένα μήνυμα σε ένα τοπικό αρχείο.
Παράμετροι εισόδου: Όνομα αρχείου, μήνυμα για εγγραφή στο αρχείο.
Παράμετροι εξόδου: Κωδικός κατάστασης – αληθής εάν είναι επιτυχής και ψευδής εάν δεν είναι επιτυχής.
Ορισμός τάξεων:
using System;
using System.IO;
using Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK;
using Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK.Attributes;
namespace ModulesLogEvent
{
[Action(Id = "LogEventToFile" , Order = 1, Category = "Logging")]
[Throws("LogEventError")]
public class LogEventToFile : ActionBase
{
[InputArgument]
public string LogFileName { get; set; }
[InputArgument]
public string LogMessage { get; set; }
[OutputArgument]
public bool StatusCode { get; set; }
public override void Execute(ActionContext context)
{
try
{
// To append all of the text to the file
File.AppendAllText(LogFileName, LogMessage);
StatusCode = true;
}
catch (Exception e)
{
if (e is ActionException) throw;
throw new ActionException("LogEventError", e.Message, e.InnerException);
}
}
}
}
Πόροι
Αυτός ο πίνακας παραθέτει τις περιγραφές και τα φιλικά ονόματα για παραμέτρους σε ένα Resources.resx αρχείο.
| Ονομασία | Τιμή | Comment |
|---|---|---|
| LogEventToFile_Description | Προσαρμοσμένη ενέργεια για την καταγραφή μηνύματος στο παρεχόμενο αρχείο | Περιγραφή ενέργειας |
| LogEventToFile_FriendlyName | LogEventToFile | Όνομα ενέργειας |
| LogEventToFile_LogFileName_Description | Παράμετρος εισόδου τύπου κειμένου | Περιγραφή εισόδου ενεργειών |
| LogEventToFile_LogFileName_FriendlyName | LogFileName | Όνομα εισόδου ενέργειας |
| LogEventToFile_LogMessage_Description | Παράμετρος εισόδου τύπου κειμένου | Περιγραφή εισόδου ενεργειών |
| LogEventToFile_LogMessage_FriendlyName | LogMessage | Όνομα εισόδου ενέργειας |
| LogEventToFile_StatusCode_Description | Παράμετρος εξόδου δυαδικού τύπου | Περιγραφή εξόδου ενέργειας |
| LogEventToFile_StatusCode_FriendlyName | LogMessage | outputName ενέργειας |
| ModulesLogEvent_Description | Ενότητα για τη διαχείριση συμβάντων καταγραφής | Περιγραφή μονάδας |
| ModulesLogEvent_FriendlyName | LogEvent | Όνομα λειτουργικής μονάδας |
Δημιουργήστε το πακέτο και αναπτύξτε την προσαρμοσμένη σας ενέργεια
Δημιουργήστε το πακέτο και αναπτύξτε το στο Power Automate.
Αποκτήστε το ψηφιακό πιστοποιητικό για να υπογραφεί το αρχείο DLL προσαρμοσμένης ενέργειας.
Σημαντικό
Τα αυτο-υπογεγραμμένα πιστοποιητικά προορίζονται μόνο για δοκιμαστικούς σκοπούς και δεν συνιστώνται για χρήση στην παραγωγή. Για την οργανωτική ανάπτυξη προσαρμοσμένων ενεργειών στο περιβάλλον σας, συνιστούμε να χρησιμοποιήσετε ένα αξιόπιστο ψηφιακό πιστοποιητικό που ακολουθεί τις οδηγίες του οργανισμού σας.
Φιλοδώρημα
Για να βελτιστοποιήσετε τη διαδικασία ανάπτυξης και χρήσης προσαρμοσμένων ενεργειών για το Power Automate για υπολογιστή σε ολόκληρο τον οργανισμό σας, μπορείτε να συνδυάσετε ένα αξιόπιστο ψηφιακό πιστοποιητικό με το πρόγραμμα εγκατάστασης Power Automate για υπολογιστή που διανέμεται μέσω του SCCM/Appstore. > Αυτό θα επιτρέψει την αυτόματη εγκατάσταση του πιστοποιητικού τόσο σε δημιουργούς όσο και σε μη επιβλεπόμενες μηχανές χρόνου εκτέλεσης που απαιτούν το Power Automate για υπολογιστή, χωρίς καμία ανάγκη για πρόσθετες ενέργειες.
Για αυτό το παράδειγμα, χρησιμοποιείται ένα αυτο-υπογεγραμμένο πιστοποιητικό.
Δημιουργήστε ένα αυτο-υπογεγραμμένο πιστοποιητικό χρησιμοποιώντας αυτό το σκριπτ.
$certPFXFileName="C:\PADCustomAction\PADCustomActionCert.pfx"; $certCERFileName="C:\PADCustomAction\PADCustomActionCert.cer"; $certStoreLocation="Cert:\LocalMachine\AuthRoot"; $certname = "PADCustomActionSelfSignCert" ##Create certificate $cert = New-SelfSignedCertificate -CertStoreLocation Cert:\CurrentUser\My -Type CodeSigningCert -Subject "CN=$certname" -KeyExportPolicy Exportable -KeySpec Signature -KeyLength 2048 -KeyAlgorithm RSA -HashAlgorithm SHA256 $mypwd = ConvertTo-SecureString -String <YOUR CERT PASSWORD GOES HERE> -Force -AsPlainText ##Export certificate $certPFXFile = Export-PfxCertificate -Cert $cert -FilePath $certPFXFileName -Password $mypwd $certCERFile = Export-Certificate -Cert $cert -FilePath $certCERFileName -Type CERT -Verbose -ForceΕισαγάγετε το πιστοποιητικό στο χώρο αποθήκευσης πιστοποιητικών χρησιμοποιώντας αυτήν την εντολή.
##Import certificate Import-Certificate -CertStoreLocation $certStoreLocation -FilePath $certCERFileΕπιβεβαιώστε ότι το εισαγόμενο πιστοποιητικό εμφανίζεται στην ενότητα Αξιόπιστες αρχές έκδοσης πιστοποιητικών ρίζας>Πιστοποιητικά στο συμπληρωματικό πρόγραμμα Κονσόλα Διαχείρισης Microsoft Πιστοποιητικών (MMC).
Ολοκληρώστε την προσαρμοσμένη λειτουργική μονάδα που δημιουργήθηκε υπογράφοντας το αρχείο DLL χρησιμοποιώντας ένα αξιόπιστο πιστοποιητικό. Χρησιμοποιήστε την προτροπή εντολών του προγραμματιστή Visual Studio για να χρησιμοποιήσετε το Signtool για αυτήν τη δραστηριότητα.
Signtool sign /f "C:/PADActions/PADCustomActionCert.pfx" /p <YOURCERTPASSWORD> /fd SHA256 "C:/PADActions/PADCustomActionEventLog/Modules.LogEvent.dll"Για να αναπτύξετε την προσαρμοσμένη ενέργεια, δημιουργήστε το πακέτο με τα περιεχόμενα σε μια αρχειοθήκη (.cab) χρησιμοποιώντας αυτό το σκριπτ PowerShell.
.\BuildCAB.ps1 "C:/PADActions/PADCustomActionEventLog" "C:/PADActions/PADCustomActionEventLog" PADCustomActionEventLog.cabΥπογράψτε την αρχειοθήκη που δημιουργήθηκε χρησιμοποιώντας το Signtool.
Signtool sign /f "C:/PADActions/PADCustomActionCert.pfx" /p <YOURCERTPASSWORD> /fd SHA256 "C:/PADActions/PADCustomActionEventLog/PADCustomActionEventLog.cab"Μεταβείτε στην ενότητα προσαρμοσμένης ενέργειας Power Automate για να ανεβάσετε την προσαρμοσμένη ενέργεια που δημιουργήσατε. Δώστε το όνομα, την περιγραφή και την αρχειοθήκη και έπειτα επιλέξτε Αποστολή.
Λαμβάνετε μια ειδοποίηση όταν η ενέργεια αποσταλεί επιτυχώς.
Ακολουθώντας αυτά τα βήματα, η λειτουργική μονάδα προσαρμοσμένης ενέργειας συσκευάζεται σε μια αρχειοθήκη και υπογράφεται με ένα αξιόπιστο πιστοποιητικό. Επιπλέον, η αρχειοθήκη προσαρμοσμένων ενεργειών μεταφορτώνεται στη βιβλιοθήκη προσαρμοσμένων ενεργειών στο Power Automate.
Περισσότερες πληροφορίες: Μεταφόρτωση προσαρμοσμένων ενεργειών
Χρησιμοποιήστε τη δραστηριότητα προσαρμοσμένων ενεργειών σας στη ροή επιφάνειας εργασίας χρησιμοποιώντας Power Automate για υπολογιστή
Δημιουργήστε μια νέα ροή επιφάνειας εργασίας και έπειτα επιλέξτε τη Βιβλιοθήκη πάγιων στοιχείων, στο πρόγραμμα σχεδίασης.
Επιθεωρήστε την προσαρμοσμένη ενέργεια που είναι διαθέσιμη στη βιβλιοθήκη πάγιων στοιχείων. Παρατηρήστε την ενέργεια που δημιουργήθηκε προηγουμένως και μεταφορτώθηκε στην ενότητα προσαρμοσμένων ενεργειών του Power Automate.
Επιλέξτε Προσθήκη για να προσθέσετε αυτήν την προσαρμοσμένη ενέργεια στην ενότητα Ενέργειες του προγράμματος σχεδίασης.
Επιβεβαιώστε ότι η προσαρμοσμένη ενέργεια προστέθηκε με επιτυχία. Αναζητήστε το στη γραμμή αναζήτησης Ενέργειες στο πρόγραμμα σχεδίασης του Power Automate για υπολογιστή.
Σύρετε την προσαρμοσμένη ενέργεια ή κάντε διπλό κλικ για να την προσθέσετε στη ροή της επιφάνειας εργασίας.
Δώστε τις παραμέτρους εισόδου και πρόσθετα βήματα για να δοκιμάσετε την προσαρμοσμένη ενέργεια.
Δείγμα ροής επιφάνειας εργασίας χρησιμοποιώντας την προσαρμοσμένη ενέργεια.
Δοκιμάστε τη ροή για να δείτε την προσαρμοσμένη ενέργεια να λειτουργεί σε πραγματικό χρόνο.
Σημείωμα
Εισαγάγετε το πιστοποιητικό που χρησιμοποιείται για την υπογραφή της αρχειοθήκης στη μηχανή που χρησιμοποιείται για τη δημιουργία ροών επιφάνειας εργασίας με προσαρμοσμένες ενέργειες και σε καθεμία από τις μηχανές χρόνου εκτέλεσης που θα εκτελούν τις ροές επιφάνειας εργασίας.
Ακολουθώντας αυτά τα βήματα, δημιουργήθηκε μια προσαρμοσμένη ενέργεια, η λειτουργική μονάδα συσκευάστηκε σε μια αρχειοθήκη, υπογράφηκε με ένα αξιόπιστο πιστοποιητικό, μεταφορτώθηκε στη βιβλιοθήκη προσαρμοσμένων ενεργειών στο Power Automate, μια ροή επιφάνειας εργασίας για τη χρήση της προσαρμοσμένης ενέργειας που δημιουργήθηκε και δοκιμάστηκε για επιτυχημένη εκτέλεση.
Ενημερώστε και αναπτύξτε ξανά την προσαρμοσμένη ενέργεια
Ενημερώστε τη λειτουργικότητα της προσαρμοσμένης ενέργειας για να αντικατοπτρίζει την ενημερωμένη δυνατότητα ακολουθώντας αυτά τα βήματα.
Ενημερώστε το αρχείο τάξεων στη λύση Visual Studio με νέα λειτουργικότητα ενεργειών. Περισσότερες πληροφορίες: Ενημερωμένη λύση μονάδας .NET
Τροποποιήθηκε η υπογραφή του αρχείου τάξεων για να λάβει μια τρίτη παράμετρο εισόδου όπως φαίνεται.
using System; using System.IO; using Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK; using Microsoft.PowerPlatform.PowerAutomate.Desktop.Actions.SDK.Attributes; namespace ModulesLogEvent { [Action(Id = "LogEventToFile" , Order = 1, Category = "Logging")] [Throws("LogEventError")] public class LogEventToFile : ActionBase { [InputArgument] public string LogFileName { get; set; } [InputArgument] public string LogMessage { get; set; } [InputArgument] public string LogLevel { get; set; } [OutputArgument] public bool StatusCode { get; set; } public override void Execute(ActionContext context) { try { // To append all of the text to the file File.AppendAllText(LogFileName, LogLevel + ": " + LogMessage); StatusCode = true; } catch (Exception e) { if (e is ActionException) throw; throw new ActionException("LogEventError", e.Message, e.InnerException); } } } }Χρησιμοποιήστε παρόμοια βήματα που περιγράφηκαν προηγουμένως όπου υπογράφετε το αρχείο DLL, δημιουργείτε την αρχειοθήκη, υπογράφετε την αρχειοθήκη και ανεβάζετε την αρχειοθήκη στην ενότητα προσαρμοσμένων ενεργειών στο Power Automate. Περισσότερες πληροφορίες: Δημιουργήστε το πακέτο και αναπτύξτε την προσαρμοσμένη σας ενέργεια
Σημείωμα
Πριν ανεβάσετε την ενημερωμένη αρχειοθήκη προσαρμοσμένων ενεργειών, φροντίστε να αναλύσετε τον αντίκτυπο αυτής της αλλαγής, καθώς οι ροές επιφάνειας εργασίας με αυτήν την ενέργεια θα ενημερωθούν με νέες δυνατότητες.
Ενημερώστε τη ροή επιφάνειας εργασίας όπως απαιτείται.
Για να επικυρώσουμε τη δυνατότητα ενημέρωσης, προσθέσαμε μια τρίτη παράμετρο εισαγωγής στην προσαρμοσμένη ενέργεια. Σημειώστε ότι η δραστηριότητα προσαρμοσμένης ενέργειας επισημαίνεται ως Σφάλμα στον σχεδιαστή και πρέπει να ενημερωθεί με νέα παράμετρο εισόδου.
Δοκιμάστε τη ροή για να δείτε την ενημερωμένη προσαρμοσμένη ενέργεια να λειτουργεί σε πραγματικό χρόνο.
Σε αυτήν την ενότητα, ενημερώσατε την υποκείμενη λειτουργικότητα της προσαρμοσμένης ενέργειας, δημιουργήσατε το πακέτο, αναπτύξατε στο Power Automate, επανασχεδιάσατε τη ροή επιφάνειας εργασίας και επικυρώσατε τη λειτουργικότητα εκτελώντας τη ροή επιφάνειας εργασίας με ενημερωμένες δυνατότητες της προσαρμοσμένης ενέργειας στο Power Automate για υπολογιστή.