Build beautiful and interactive API documentation for ORDS

Image
In this blog post, I will show you how to quickly build beautiful and interactive API documentation for your Oracle APEX REST data sources using  swagger hub . Using APEX v23.1. I downloaded the  titanic data set  and loaded them into tables in my APEX instance, created some authorized restful services and published them using swagger hub. You can create a free account on swagger hub.   Check out my titanic swagger hub here ; Press Authorize. Username REST, password Glasgow123! I won't go through creating RESTful services and just show you the four I created that sit on top of the titanic data set; The GET is a very simple SQL query;      select * from TITANIC_DATA_SET_NEW A handy tip is to add comments, as there will appear on swagger hub, making your API self documenting; Once you have created your modules, press the Generate Swagger Doc button; This will generate an open API for you.  Copy the API and paste it into swagger hub This will generat...
Post a Comment

Oracle APEX style Region Display Selector (RDS) using CSS

This blog post describes how I used CSS to style Oracle APEX  Region Display Selectors (RDS) to get them looking a bit nicer.  It adds a border to the tabs and gives the tabs a background colour by using a small piece of CSS to inline CSS on page designer.  I am using version 19.2 but this solution should work on all versions.

To change the RDS tabs from this;

to this;

Add the following CSS to inline CSS (preferably a CSS file);

.apex-rds a {
    padding: 0 8px;
    font-size: 1.5rem;
}

ul.apex-rds li {

    box-shadow: 1px 2px 2px #AAAAAA;
    border: 1px solid #999999;
    border-radius: 8px 8px 8px 8px;
    background-color: #e6f9ff;
}

Tip.  Placing the CSS in a file allows you to use Google Chrome Developer tools to open the CSS file and change the CSS inline until you are happy with the look of the tabs.  Once you are happy with the look update the CSS file with your chosen styles.

Open developer tools and click on the arrow on the top left of developer tools;


Then click on one of the RDS tabs, this will open the CSS styles in developer tools where you can edit the style inline to get it looking how you want;


When you edit the style the tabs will update with the new CSS style setting.











Comments

Post a Comment

Popular posts from this blog

Oracle APEX Interactive Grid colour cells based on a condition using JavaScript and CSS

Image
In this post I will describe how to colour an Interactive Grid based on a column condition using CSS and JavaScript.  Using APEX Version 19.2. I want to colour every column red in my IG when the value is 'No'.   I have several IGs on my page I want to colour, so I set all my IGs that I want to colour with a CSS class of ATTENDEE_SCORE_IG in the Appearance section of the IG; Every column I want to colour in the IG I set the CSS Class to COLOUR_YES_NO (in this example I set this in 5 columns); I then created a Dynamic Action (DA) that contains the JavaScript that has the condition check that will colour the cells.  Because I have several IGs that are details of the master/detail relationship and these are refreshed by the user clicking on the master detail IG I have made my DA a Page Change [Interactive Grid].  If you don't need this you can set the DA on page load. The JS which will colour every column is this; ////////////////////////////////////////////////////...
Read more

How to send an email from your ORACLE APEX app

Image
Sending emails from your APEX application using APEX Email Templates is super simple. The project specification was to add buttons to a form to allow users to press a button to email students whether they have been successful or unsuccessful in their scholarship application. This is how we did it.  The application form is a standard APEX form where we will add a button to the form that when pressed will send an email; In this example I will walk you through the creation of the rejection email.  First, we created a new email template for rejection emails with the name REJECTION ; with the following identification; To send images in the email ensure they are hosted on a publicly available site.  In this case, I hosted the University of Glasgow logo on my Google Drive and put it in the header of the email using the HTML IMG tag; The body is standard HTML using  substitution strings   (Special substitution strings available within a template are denoted by the nu...
Read more

Oracle APEX style an Interactive Grid cell conditionally based on the value of another cell using JavaScript and CSS

Image
This blog post describes how you can style an Interactive Grid cell conditionally based on the value of another cell using JQuery and CSS.  Using APEX Version 19.2. The requirement is to highlight the cell that has the highest value in the row; This can be achieved by setting the IG column CSS class and using JQuery to loop round the table rows to conditionally set CSS style based on cell values First give all your columns a CSS Class (note you can give columns multiple classes separated with space) in this case all 4 columns are set with CSS class SCORE_C_1, SCORE_C_2, SCORE_C3 and SCORE_C_4 in the column Appearance; We now add the JavaScript in Execute when page loads (preferably put this is a JS file). We are using the JQuery $.each() method to fetch every table row;  $.each($('tbody tr'), function(i, item) {} and the JQuery text() method to get the column value from the row using the column CSS class names;         var scoreC1 = $(item).find('.SCOR...
Read more