Cool Solutions

TTP iPrint Printer Lists and Extending Novell Open Enterprise Server Part IV: Creating The Administrative Interface With iManager Plug-In Studio

jlodom

By:

May 17, 2017 12:24 pm

Reads:311

Comments:0

Score:Unrated

Print/PDF

Preface

This article is a walk-through. We assume that you have already read the previous parts in this series:

Part I is here.
Part II is here
Part III is here.

This entire walk-through takes place in a copy of iManager that has been installed on OES server and which includes the standard plug-ins including those for iPrint.

I use text rather than screenshots for navigation because I find that textual descriptions tend to be more accurate over time as products are visually refreshed.

Reminder: There are only three administrative tasks we want to accomplish with printer lists: Create, Delete, and Modify. Delete can be done with the standard “Delete Object” task under the “Directory Administration” role that is available in the iManager “Roles and Tasks” view.

That leaves us with “Create” and “Modify”. We will create both of these under a new role in iManager Plugin Studio, starting naturally with “Create”

In order to use Plug-in Studio, Role Based Services (RBS) will need to be installed and configured on your network. If RBS is not already installed, you can start setting it up in iManager under Configure->Role Based Services->RBS Configuration. Once you have configured RBS for the first time, Plug-In Studio also becomes available as an option under Configure->Role Based Services.

Installing and configuring RBS is outside the scope of this article. The official iManager and eDirectory documentation covers it quite nicely. If you are using OES with more than a single administrator your organization should already be using it (RIGHT???) and so we will just build on the RBS configuration you already have.

Making A Simple Create Task

The process starts by clicking Configure->Role Based Services->Plug-in Studio .
We get a menu called “Custom Plug-ins” with several options. We click “New” and find ourselves in the “Create iManager Task” wizard.

“Step 1: Choose object type and platform” [Create]
Available classes: We choose the one we created in Part Two of this series – ttpiPrintPrinterList
Target Device: Default is fine.
Plug-in type: Task for Create
Leave the Auxiliary Class checkbox empty and click “Next”

The next screen is the actual plug-in configuration screen. At the top we can choose our Plug-in Fields. CN and Container are already there. From the right we will double-click “Title” and “Description” to add them to our fields. The first three attributes can be contained in a single line so their default controls are fine. Description, however, should be longer than a single line and so we need to change the control it uses. We do that by clicking on the middle button next to the Description field (“Change Control”). We will select TextArea.

These are the only fields we are going to add to the Create task. After some experimentation I discovered that it is easier to populate the multi-valued attributes such as ttpiPrintMemberPrinter and Member when modifying an existing object. Therefore we will not handle those here during “Create” even though they are the most important attributes in the entire object.

At the bottom of the page we choose our Plug-in Properties. Our Plug-in id should be “TTP iPrint List Create”. For RBS Collection you should choose an existing RBS Collection from the tree – by setting up RBS at least one will already exist. Role can remain empty for now.

Once we are finished we can click “Install” and the task will be created. We will make it accessible a bit later.

Stepping Back a Moment

Now we are going to make “Modify” which will be a little more complicated and will be a Property Book rather than a Task. Property Books have multiple “pages” and are more suitable for complex operations. As part of this complexity, we will wrestle with where our plug-in will be located within the iManager “Roles and Tasks” list and who gets to see them.

Our “Create” and “Modify” options will reside under a heading of “TTP Printer List” much like the “Users” and “Partitions and Replicas” headings that already exist. All of these headings in the interface represent Modules, and so we will need to create a Module to hold our tasks.

We will also need a Role to determine which administrators can see the tasks.

Making the Role

Let us create the Role first. Starting from any iManager view, we go back to Configure->Role Based Services->RBS Configuration and then select an existing RBS Collection. A new tabbed interface representing the RBS Collection is now before us, and we will be using these tabs throughout the rest of our plug-in creation process.

The initial tab is “Role” and so we will start there. Select New->iManager Role. On the ensuing screen use “TTP Printer List” as the name, leave the description blank, and click “Next”. On the next screen transfer the “TTP iPrint List Create” task that we created earlier from “All Tasks” to “Assigned Tasks” and click “Next”. The next screen asks us to assign categories. Transfer “Printing” from “Available Categories” to “Assigned Categories”. This step is a little arbitrary and you can change the assignment or add categories without much effect on the rest of these instructions. Click “Next”.

The final step for role creation is assigning members and scopes. This will be different for every organization, and is much more of a general RBS function. Only the members you assign to this role will see the administration tasks for printer lists within iManager, and they will only be able to administer lists in the scopes that they are assigned to. This is another topic better handled by the RBS sections of the iManager and eDirectory documentation. When the members and scopes are assigned, click “Next”. Then click “Finish” and “Okay” on the next screens to create the role. The screen then returns to the tabs representing the RBS Collection.

Making the Module

Now we will create the Module. Select the “Module” tab and “New”. For “RBS Module Name” enter “TTP iPrint Lists” and for context pick the RBS collection that we are creating the lists from (things are getting a bit circular … and will get moreso in a moment). After clicking “Okay” twice the new Module will be created and we will be back at the Role Based Services menu for our chosen RBS Collection.

Making the “Modify” Property Book

It is time to start work on the Property Book. Change the tab from “Module” to “Property Book” and select “New” again. This brings us to the “Create Property Book” wizard, and “Step 1: Name the property book”. For Property Book Name enter “Manage TTP iPrint Printer Lists” and for Module select from the drop-down menu the “TTP iPrint Lists” Module we just created. Leave “Description” blank and uncheck “Allow multiple object editing”. Click “Next”.

On the next screen (“Step 2: Select the object types”) move the ttpiPrintPrinterList object from “Available Object Types” to “Assigned Object Types” and click “Next”. (If the object does not exist, you need to follow Part 2 of this series of articles.)

The third step (“Step 3: Select the pages”) is actually one that we will gloss over for the moment: Move “Other” from “Available Pages” to “Assigned Pages” and click “Next”. There are many other pages to add, but they do not exist yet.

The Role required by the fourth step (“Step 4: Select the roles”), however, does exist. Transfer the “TTP Printer List” Role from “Available Roles” to “Assigned Roles” and click “Next”. Then click “Finish” and “Okay” to create the property book.

For the moment we are finished with the Collection. It is time to create the other property book pages for our modify function. Four pages will ultimately be created.

Making the Property Book Pages for “Modify”

We return to Plug-In Studio by going to Configure->Role Based Services->Plug-in Studio in the main iManager interface.

The following process will be repeated for each page. We will refer to it as “Property Page Initial Creation”. The basic steps are:

One again we click “New” from the “Custom Plug-ins” menu.
“Step 1: Choose object type and platform” [Modify]
Available classes: We choose the one we created in Part Two of this series – ttpiPrintPrinterList
Target Device: Default is fine.
Plug-in type: Property Book Page (NOT “Task for Modify”)
Leave the Auxiliary Class checkbox empty and click “Next”

Now let’s look at the process for each page.

ONE

The most important page is the one where we actually add printers to the list. After going through the “Property Page Initial Creation” above put in the following settings:

Plug-in Properties
Plug-in id: TTP iPrint List Modify
Property Book: Choose the “Manage TTP iPrint Printer Lists” property book created earlier.
Chapter: New “Printers”
Public: Checked

Plug-in Fields
CLick ttpiPrintMemberPrinter from the Attributes list and then select “MV String Editor” from Controls.

When the control appears under “Plug-in Fields” select the magnifying glass to the right and fill in the following settings (leaving others at their defaults)
Custom label: Printers
Object Type Filter: iprintprinter
Then click “Okay”

When all the settings are placed, click “Install” above “Plug-in Fields” and then “Okay” to confirm that the page has been created.

TWO

You will then be back to the first step of this process and should go through the “Property Page Initial Creation” steps to get back to the creation page again.

The second page has the following settings:

Plug-in Properties
Plug-in id: TTP iPrint List Modify Description
Property Book: Choose the “Manage TTP iPrint Printer Lists” property book created earlier.
Chapter: New “Description”
Public: Checked

Plug-in Fields
CLick Title from the Attributes list and then select “Textfield” from Controls.
CLick Description from the Attributes list and then select “Textfield” from Controls.

Next to the “Description” control select the magnifying glass to the right and fill in the following settings (leaving others at their defaults)
Input Field Size: 100
Then click “Okay”

When all the settings are placed, click “Install” above “Plug-in Fields” and then “Okay” to confirm that the page has been created.

THREE

You will then be back to the first step of this process and should go through the “Property Page Initial Creation” steps to get back to the creation page again.

The third page has the following settings:

Plug-in Properties
Plug-in id: TTP iPrint List Modify Members
Property Book: Choose the “Manage TTP iPrint Printer Lists” property book created earlier.
Chapter: New “Membership”
Public: Checked

Plug-in Fields
CLick Member from the Attributes list and then select “MV String Editor” from Controls.

When the control appears under “Plug-in Fields” select the magnifying glass to the right and fill in the following settings (leaving others at their defaults)
Custom label: Users Groups and Containers
Then click “Okay”

When all the settings are placed, click “Install” above “Plug-in Fields” and then “Okay” to confirm that the page has been created.

You will then be back to the first step of this process and should go through the “Property Page Initial Creation” steps to get back to the creation page again.

FOUR

The fourth and final page has the following settings (which differ slightly):

Plug-in Properties
Plug-in id: TTP iPrint List Stub For General
Property Book: Choose the “Manage TTP iPrint Printer Lists” property book created earlier.
Chapter: Existing “General”
Public: Unchecked

Plug-in Fields
CLick CN from the Attributes list and then select “Textfield” from Controls.

When the control appears under “Plug-in Fields” select the magnifying glass to the right and fill in the following settings (leaving others at their defaults)
Read-only: Checked
Then click “Okay”

When all the settings are placed, click “Install” above “Plug-in Fields” and then “Okay” to confirm that the page has been created.

We have now created all of the property book pages we need. They are not yet active and will not show up in the iManager Roles and Tasks interface until we assign them to the Manage TTP Printer Lists property book.

Finalizing the Property Book and Everything Else

Go back to Configure->Role Based Services->RBS Configuration and then select the RBS Collection we have been using. From the tabs select Property Book. Check the box next to “Manage TTP iPrint Printer Lists” and then from the “Actions” drop-down select “Page List”. The four pages we created will show up under “Available Pages”. Transfer them all to “Assigned Pages”. Move the “TTP iPrint List Stub For General” to the top of the Assigned Pages list and click “Okay” twice.

Under the “Roles and Tasks” view in iManager, there is now a category for “TTP Printer List”. Under this category are links for “Manage TTP iPrint Printer Lists” and “TTP iPrint List Create”

Refer back to Part Three in this series for how to use these.

We are now done with iManager. In Part Five we will begin displaying printer lists to our end users.

0 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 5 (0 votes, average: 0.00 out of 5)
You need to be a registered member to rate this post.
Loading...

Tags: , , , ,
Categories: File & Networking Services, iPrint, Open Enterprise Server, Technical

0

Disclaimer: This content is not supported by Novell. It was contributed by a community member and is published "as is." It seems to have worked for at least one person, and might work for you. But please be sure to test it thoroughly before using it in a production environment.

Comment

RSS