How to Submit and Manage Applications

The Java Warehouse Developer Portal lets you join the Java Warehouse Developer Program, submit Java SE and JavaFX applications to the Java Store, and administer submitted applications.

After an application is reviewed, you will be notified by email whether it has been rejected or approved. Once an application has been approved, you can publish it to the Java Store.

Contents

• Registration
• Submittal
• Obtaining a Certificate for your JAR file
• Review
• Publishing
• Authorize the Java Store to Initiate Refunds
• Application Statistics
• Report Sales Tax Collected
• Removal

Registration

Registering to become a Java Warehouse Developer requires you to choose and verify an email address, and then choose the name under which all the applications you submit will be listed. Since consumers want to know the provider of the application, you can only choose between your real name or your company name. Once a name is chosen it cannot be changed. Using aliases or nicknames is not allowed. You are also required to pay a $50.00 annual membership fee using PayPal.

Prerequisites:

• Sun Developer Network membership: If you are not already a member of the Sun Developer Network, you will need to create an account before applying for the Java Warehouse Developer Program. You can create an SDN account here. The information in your Sun Developer Network account will be used as part of your registration information.
• A PayPal account. You will need to have an active PayPal account to pay the $50 annual membership fee. You will also need a PayPal account to receive revenue and sales taxes from the sale of your applications if you decide to publish for-fee applications.
• If you are going to submit for-fee applications you will also need to enter the sales tax rates that apply for each location for which you have to charge sales taxes. Please have your tax rates available.

How to Register

1. Review that your system complies with the recommended configurations.
2. Go to the Java Warehouse landing page. If you are visiting the site from outside the United States, the option to enter to the Java Warehouse Developer Portal will be available to developers from a selection of countries. Developers from outside the United States will not be charged a membership fee and will only be allowed to submit free applications at this time. More countries will be allowed access to the Java Warehouse Developer Portal in the near future.
3. Click Login to the Developer Portal and log in using your SDN account.The first time you log in to the Java Warehouse Developer Portal, you will see the Terms of Use for the program. Read it carefully. You must accept the terms in order to join the program. To agree to the terms, select the I agree to the terms above. checkbox, and click Next.
4. Select the name under which your applications will be listed on the storefront. You can only choose between your full name, or the name of your company (or the name under which you do business if you have filed a Doing Business As form). Please note that you will not be allowed to change this name later. We might require a copy of your articles of incorporation, DUN number, or other form of verification before we allow you to use a company name.
5. On the same form, enter the email address at which you would like us to contact you. This defaults to the email used for your SDN membership, but can be changed to any other email that you own.
6. Click Submit Registration to send a verification email to the email address that you entered.
7. Check your email and when the verification email arrives, click the Confirm registration link. The Java Warehouse Administrators will review your application and might request additional documents before final approval. Once you are approved you will receive a confirmation email. Your application is now complete.
8. Click the PayPal button to go to PayPal to pay your $50.00 annual membership fee. The fee can only be paid using PayPal and is non-refundable.
9. Optionally, click Enable Charging for Apps to start the Enable Charging for Applications wizard or you can click Exit and Begin Publishing Free Apps, if you wish to offer your applications free of charge. You can enable charging for applications later if you prefer. In order to complete the Enable Charging for Applications wizard, you must enter the sales tax rates on the Sales Tax page. Enter the sales tax rates of each location for which you have to charge sales taxes in the tax table provided. Please note: charging for applications is currently restricted to U.S. developers.
10. When you've completed the Enable Charging for Applications wizard, click Exit and Begin Publishing Apps on the Registration page.Your registration is now complete. You are now ready to start submitting your applications to the Java Warehouse.

Submittal

Once you are a registered Java Warehouse developer, you can submit your first application. There are several requirements to submit an application. You will need:

• Your application JAR file(s).
• Descriptive text to document your application.
• Graphic image files used for icons and to give the consumer an idea of your application's look.

Gather your information and files, and go to the Java Warehouse Developer Portal website. See the Application Requirements for a complete list of the items and data that you will need.

How to Submit Content

1. If you are not on the Developer Dashboard page, click Developer on the top of the page to go to your Developer Dashboard.
2. Click Submit Application. Enter the required information on the main form and upload the JAR file(s). You must upload the main JAR file first.
3. Fill out the Export Control questionnaire.
   Note that certain applications will require that you file an Export Control questionnaire with the government and provide us with a CCATS number.
4. Upload the required images (and, optionally, the non-required images).
5. Continue filling in the required and optional fields, but before clicking the Submit for Review button, verify that your application will launch.
   • Click the Show Store Preview button at the bottom of the page. A view of the application's Detail page appears.
   • Use the pull down menu to select the operating system you will use to review the application.
   • Enter the login user name that you use on the system to review the application.
   • Click the Launch button on the Detail page to launch your application with the JNLP created by the Java Warehouse.
6. After confirming that your application will launch, click the Submit for Review button to submit your application.

Once you have submitted the application for review, all fields will become read-only. You can only edit fields again if you remove your application from the review queue by going to the version tab and choosing Make Changes.

Note: Be aware that making changes removes your application from the review queue. You must submit the application for review again after making your changes. You will lose your original place in the review queue if you recall your applications to make changes.

Changing the Price of Your Application

1. To change the price of your application, go to the Developer Dashboard and click the price of the application you want to change. The Change Price page appears.
2. Select the Free radio button or select the Price radio button and enter the new price in US dollars in the field provided. Click Next. The Confirm Price Change page appears.
3. Click Edit to go back and change the price or click Confirm to accept the new price.

Obtaining a Certificate for your JAR file

Signing your JAR file begins with choosing a trusted certificate authority. This example uses https://secure.ksoftware.net . The steps to obtain a certificate may differ from company to company. Here's an example you might follow to sign your JAR file.

To obtain a certificate:

1. Go to the Code Signing Certificate Order Page at https://secure.ksoftware.net/code_signing_order.html and complete the form and submit it.
2. Purchase your certificate. Rates will vary from company to company. KSoftware charges $99.00 for one year.
3. Provide the requested documentation to verify your identity to the certificate authority.
   
   These steps may include:
   • Providing a photocopy of your driver's license and your order number.
   • Making sure the whois information for your domain matches your address.
   • Providing proof of your phone number such as a bill.
   • Receiving a phone call from KSoftware and a code to use to receive your certificate. This is done to verify your phone number.
   • Receiving an email notifying you that your certificate is ready. The email contains a link to use to enter the code you received. The certificate will be installed in your browser.
4. In your browser:
   • Follow these instructions to export the code signing certificate to a PFX file in FireFox:
     
     http://blog.ksoftware.net/2009/10/exporting-your-code-signing-certificate-to-a-pfx-file-from-firefox/
     
     
   • Follow these instructions to export the code signing certificate to a PFX file in IE:
     
     http://blog.ksoftware.net/2009/10/exporting-your-code-signing-certificate-to-a-pfx-file/
     
     
   • In Firefox go to Preferences -> Advanced -> Encryption -> View Certificates to locate your new certificate and export it to the file ´mycert.p12´ using a password you create.
5. From the command line execute:
   
   keytool -list -keystore mycert.p12 -storetype pkcs12 -v
   
   
6. When prompted, enter the password you chose in step 4. It displays information about your certificate, including the alias name. Note: keytool is included in the JDK.
7. Sign your JAR. Here's an example of an Ant task you can use to sign your JAR:

       
   <target name="signjar">
   <input
   message="Please enter keystore password:"
   addproperty="keypass" />
   
   <signjar jar="Test.jar" storetype="pkcs12"
   keystore="mycert.p12" alias="alias name"
   storepass="${keypass}"/>
   </target>
   
   	

   You will be prompted for a password. The alias name should match the name listed in the keystore output displayed in the previous step. Your JAR is now signed.

Review

The Java Warehouse team reviewers will review your application and supporting content. They will either approve or reject your submission. The reviewers might send you comments or request that you change some of the images or descriptions in your application, or they may suggest improvements needed for your application.

It can take several days for an application to be approved depending on the requested permissions, complexity of the application, the accuracy of the application's descriptions, and the quantity of applications in queue ahead of yours. Once the application is approved, you will receive email notification that your application is ready for publishing.

Publishing

• To start publishing your application immediately after approval, select the Automatically publish upon approval checkbox on the Submit New Application page.

• To have more control over when you publish your application, wait until you receive email notification that your application has been approved and then do the following:
  1. Go to the Java Warehouse Developer Dashboard and select the approved application.
  2. Select the correct version of your application.
  3. Click Publish.

Authorize the Java Store to Initiate Refunds

Use the following procedure to authorize the Java Store to initiate refunds to your customers:

1. Log into your PayPal merchant account. Click Profile.
2. In the Account Information section, click API Access.
3. Under Option 1 of the API Access section, click Grant API permission.
4. In the Give Third-Party API Permission section, click Configure a custom API authorization.
5. Enter the Java Store user ID, JavaStore_Payments_api1.sun.com.
6. Select Refund. (Do not select RefundTransaction.)
7. Click Submit.

Application Statistics

To view the statistics of your application, choose Developer > Statistics from the Java Warehouse Developer Portal main menu. The Product Versions Statistics tables displays the following data:

• Feature Views
• Total Views
• Feature Previews
• Total Previews
• Feature Purchases
• Total Purchases
• Feature Installs
• Total Installs
• Runs
• Removes
• Install Errors
• Run Errors

Click the More Data link to see a detailed report. From this screen you can export the data to a CSV file or view it in a chart.

Report Sales Tax Collected

The Java Warehouse team has developed a tool called JWReportHelper to help you calculate the total sales tax due from your monthly sales.

To calculate the your total sales tax due for each tax authority:

1. Go to PayPal and log in to your account.
2. Select History > Reports > Download History.
   Do not use the report generated using the History > Download History path. This option will not result in a report with the Notes column necessary to calculate your taxes.
3. Enter the start and end dates for the report spanning a maximum of 31 days. Make sure that the CSV option is selected. Click Download. The default name of the file is DHR.csv.
4. Go to the Note column in the report and parse the information which is separated by semicolons. Add Java Warehouse transaction ID (txid), total amt, tax amt, tax authority, fees, and product name as new columns at the end of the spreadsheet.
5. In Excel, go to the main menu and choose Data > Text to Columns to parse the data from the Note field.
6. Locate the Transaction ID column and insert two new columns after it.
7. Copy the data in the JW Tax and JW Tax Authority columns into the two columns you created and label them JW Tax and JW Tax Authority.
8. Insert two new columns after the Reference Txn ID column and label them Refund Tax and Refund Tax Authority.

9. Use VLookup on the Reference TxnID column to find the refund tax. Here's a sample Microsoft Excel formula: VLOOKUP(AH15,$O$8:$Q$79,2,FALSE)*-1.

   Where:
   AH15 is the first the cell that contains an entry for "Reference TX."
   $O$8:$Q$79 represents the range of cells that contains the PayPal Transaction ID and the two columns that you added in step 7.

   The number "2" represents the second column of the range.
   The "False" entry retrieves exact matches only.
   The -1 changes the sign of the resulting value because it is a refund.

   Adjust the rows and columns, as well as the size of the range, to match your data.

10. Copy the formula to find all refund transactions. These transactions have a value in the Reference Tax ID column.

11. Some transactions may be designated N/A, because the original transaction occurred outside of the start and end dates you designated for the report. To find the values for these transactions you will need to use the PayPal find transaction functionality.

    1. To find the related transaction, go to PayPal and select History > Advance Search.

    2. Enter the transaction ID of the N/A transaction. When the two transactions are displayed, go to the one marked refunded and look in the Note column.

    3. Copy the Tax Amount and the Tax Authority data to the Refund Tax and the Refund Tax Authority columns. Enter the tax amount as a negative number.

12. Use a spreadsheet formula such as VLookup to get the tax authority for the Refund Tax Authority column for Transactions with a valid ID number and a non-zero value by using a spreadsheet formula such as VLookup. For example: VLOOKUP(AH15,$O$8:$Q$79,3,FALSE)

    Where:
    AH15 is the first the cell that contains an entry for "Reference TX"
    $O$8:$Q$79 represents the range of cells that contains the PayPal Transaction ID and the two columns that you added in step 7.
    The number "3" represents the third column of the range
    and the "False" means that you want exact matches only.

    It may be necessary to adjust the rows and columns as well as the size of the range to match your data.

13. Save your work as "Excel Spreadsheet". If you save it as a CSV file your formulas will be lost when you exit Excel.

    You now have the information needed to calculate how much sales tax you own to each taxing authority. Aggregate the taxes for each tax authority, taking into consideration the effect of refunds, if any, on the taxes you owe.

---

Removal

To remove an application from the Java Warehouse and stop offering it in the Java Store:

1. Go to the Java Warehouse Developer Portal and select the application to remove.
2. Choose the Version you want to remove.
3. Click Delete.

Back to top