createTab (αναφορά API JavaScript) για το Dynamics 365 Channel Integration Framework 2.0

Σημείωμα

Χρησιμοποιήστε αυτό το API μόνο όταν η εστιασμένη περίοδος λειτουργίας ανήκει στον πάροχο ή εάν είναι η αρχική ή η προεπιλεγμένη περίοδος λειτουργίας.

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

Syntax

Microsoft.CIFramework.createTab(input, correlationId).then(successCallback, errorCallback);

Παράμετροι

Όνομα Τύπος Απαιτείται Περιγραφή
εισαγωγή Συμβλοσειρά Όχι Είσοδος JSON
επιτυχίαΕπανάκληση Function όχι Μια συνάρτηση για κλήση κατά τη δημιουργία μιας εγγραφής. Το μοναδικό αναγνωριστικό (αναγνωριστικό καρτέλας) της καρτέλας που δημιουργήθηκε επιστρέφεται στην απόκριση.
errorCallback Function όχι Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία. Θα περάσει ένα αντικείμενο με τις ακόλουθες ιδιότητες:
errorCode: Αριθμός. Ο κωδικός σφάλματος.
μήνυμα: Συμβολοσειρά. Ένα μήνυμα λάθους που περιγράφει το ζήτημα.

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

{
    //Unique name of the tab 
    // type = string
    templateName: <unique name of the tab template>;

    //additional context for tab creation and tab slugs
    // type = JSON Object
    templateParameters?:<>
    
    //should this tab be focused after the creation
    // type=boolean
    isFocused?: <true or false>;
}

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

Υπόσχεση με την τιμή του αναγνωριστικού καρτέλας ως συμβολοσειρά

Παράδειγμα

var tabInput = {
    //Unique Name of the Application Tab Template
    // type = string
    templateName: "msdyn_test_entity",
    templateParameters: {
    entityName: "incident",
    data: "{}",
    },
    isFocused: true
};
Microsoft.CIFramework.createTab(tabInput).then((tabId)=>{
    console.log("created tab with id" + tabId);
}, (error)=>{
    console.log(error);
});