createTab (διαχειριστής προφίλ εφαρμογής)

Δημιουργεί μια καρτέλα εφαρμογής σε μια εστιασμένη περίοδο λειτουργίας και επιστρέφει το μοναδικό αναγνωριστικό της καρτέλας.

Σύνταξη

Microsoft.Apm.createTab(AppTabInput);

Παράμετροι

Όνομα	Τύπος	Απαιτείται	Description
AppTabInput	Συμβλοσειρά	Όχι	Ιδιότητες εισαγωγής JSON της καρτέλας που θα δημιουργηθεί.

Η δομή της παραμέτρου JSON AppTabInput έχει ως εξής:

{
    //Unique Name of the Application Tab Template
    // type = string
    templateName: <unique name of the application tab template>;
    //additional context for tab creation and tab slugs
    // type  Map<string, string>
    appContext?:  Map<string, string>;
    //should this tab be focused after creation
    // type=boolean
    isFocused?: <true or false>;
}

Τιμή επιστροφής

Αναγνωριστικό καρτέλας ως συμβολοσειρά.

Παραδείγματα

Αυτά τα παραδείγματα χρησιμοποιούν τη createTab μέθοδο για την εκκίνηση μιας νέας καρτέλας.

Δημιουργία βασικής καρτέλας

Δημιουργεί μια νέα καρτέλα στην εστιασμένη περίοδο λειτουργίας, μεταβιβάζοντας το όνομα οντότητας, το recordId και το όνομα προτύπου καρτέλας εφαρμογής ως παραμέτρους.

var tabInput = {templateName: "msdyn_entityrecord",  appContext: new Map().set("entityName", "account").set("entityId", " 22cc22cc-dd33-ee44-ff55-66aa66aa66aa"),  isFocused: true};
Microsoft.Apm.createTab(tabInput);

Δημιουργία στηλοθέτη μεταβίβασης τιμών σε φόρμα οντότητας

Δημιουργεί μια νέα καρτέλα στην εστιασμένη περίοδο λειτουργίας, μεταβιβάζοντας το όνομα οντότητας και το όνομα προτύπου καρτέλας εφαρμογής ως παραμέτρους. Συμπληρώνει επίσης τη φόρμα οντότητας προορισμού με πρόσθετες τιμές.

var formParams = {};
formParams["subject"] = "Collaboration task";
formParams["actualdurationminutes"] = 60;
formParams["prioritycode"] = 2;
formParams["scheduledend"] = "12/12/2030 10:00"
formParams["regardingobjectid"] = "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb";
formParams["regardingobjectidname"] = "How do I measure my tamp pressure?";
formParams["regardingobjectidtype"] = "incident";

var tabInput = {
templateName: "msdyn_entityrecord",
appContext: new Map().set("entityName", "task").set("formId", "d5b4a1b2-de4f-4f86-8768-b0730001e7d1").set("data", JSON.stringify(formParams)),
isFocused: true
};
Microsoft.Apm.createTab(tabInput);

Δημιουργία καρτέλας με πόρο web

Δημιουργεί μια νέα καρτέλα στην εστιασμένη περίοδο λειτουργίας, μεταβιβάζοντας έναν πόρο web ως παράμετρο για το πρότυπο καρτέλας εφαρμογής.

var tabInput = {templateName: "msdyn_omnichannel_kbsearch", isFocused: true};
Microsoft.Apm.createTab(tabInput);

Δημιουργία καρτέλας με έναν πόρο web που μεταβιβάζει παράμετρο πόρου web

Δημιουργεί μια νέα καρτέλα στην εστιασμένη περίοδο λειτουργίας, μεταβιβάζοντας ένα πρότυπο καρτέλας και μια παράμετρο πόρου web ως παραμέτρους προτύπου καρτέλας εφαρμογής.

var tabInput = {
    templateName:"msdyn_omnichannel_kbsearch",
    appContext: new Map().set("data", "Contoso"),
    isFocused: true}; 
Microsoft.Apm.createTab(tabInput);

Δημιουργία καρτέλας με μεταβίβαση ονόματος πόρου web και παραμέτρου πόρου web

Δημιουργεί μια νέα καρτέλα στην εστιασμένη περίοδο λειτουργίας, μεταβιβάζοντας ένα πρότυπο καρτέλας, ένα όνομα πόρου web και μια παράμετρο πόρου web ως παραμέτρους προτύπου καρτέλας εφαρμογής.

var tabInput = {
    templateName:" new_tabtemplate_customwebresource",
     appContext: new Map().set("data", " Contoso ").set("webresourceName","msdyn_kbsearchpagehost.html"),
    isFocused: true}; 
Microsoft.Apm.createTab(tabInput);

Δημιουργία καρτέλας με τη σελίδα ελέγχου πλαισίου στοιχείων Power Apps

Δημιουργεί μια νέα καρτέλα στην εστιασμένη περίοδο λειτουργίας, μεταβιβάζοντας ένα στοιχείο ελέγχου πλαισίου ως παράμετρο για το πρότυπο καρτέλας εφαρμογής. Το στοιχείο ελέγχου μεταβιβάζεται από την κλήση API.

var controlDataParams = {};
controlDataParams["<parameter>"] = "<Value>";

x = new Map();
x.set("<custom_session_context_params_key>", "<Value>");
x.set("parametersStr", '[["controlName", "<Control_Name>"], ["data",'+JSON.stringify(controlDataParams)+']]');

Microsoft.Apm.createSession(
    {
        templateName: "<template_name>",
        sessionContext: x
    });

Μπορείτε επίσης να περάσετε τις ακόλουθες παραμέτρους:

var controlDataParams = {};
controlDataParams["<parameter>"] = "<Value>";

x = new Map();
x.set("<custom_session_context_params_key>", JSON.stringify(controlDataParams));
x.set("<additional_custom_session_params>", "<Value>");

Microsoft.Apm.createSession(
    {
        templateName: "<template_name>",
        sessionContext: x
    });