formContext.ui.formSelector (klient-API-referens)

Med egenskapen formContext.ui.formSelector kan du arbeta med formulärobjekt där ett formulärobjekt representerar ett formulär som är tillgängligt för en användare eftersom det är associerat med en säkerhetsroll som användaren också är associerad med. Ofta finns det bara ett formulär. När fler än ett formulär är tillgängligt kan metoder för ett formulärobjekt användas för att ändra formuläret som användaren visar.

Anmärkning

formContext.ui.formSelectorStöds inte för snabbskapningsformulär.

Anmärkning

Formulärväljaren visas inte om användaren bara har åtkomst till ett huvudformulär

Formulärobjekt är tillgängliga via något av följande:

• formselector.items-samling : En samling med alla formulärobjekt som är tillgängliga för den aktuella användaren. Endast de formulär som delar en association med en av användarens säkerhetsroller är tillgängliga i den här samlingen. Exempel:

  formItem = formContext.ui.formSelector.items.get(arg);

  Se Samlingar för information om insamlingsmetoderna.

  Anmärkning

  Den här samlingen är inte tillgänglig för Dynamics 365-mobila klienter (telefoner och surfplattor).

• formselector.getCurrentItem-metod : Returnerar en referens till formuläret som visas för närvarande. När endast ett formulär är tillgängligt returnerar den här metoden null. Exempel:

  formItem = formContext.ui.formSelector.getCurrentItem();

Formulärobjektmetoder

När du har hämtat ett formulärobjekt på något av ovanstående sätt använder du följande metoder för att arbeta med formulärobjektet.

Namn	Decription
getId	Returnerar formulärets ID.
getLabel	Returnerar formulärets etikett.
getVisible	Returnerar ett värde som anger om formuläret för närvarande är synligt.
navigera	Öppnar det angivna formuläret.
setVisible	Anger ett värde som anger om formuläret är synligt.