officedev / office-store-docs Goto Github PK
View Code? Open in Web Editor NEWMicrosoft AppSource and Office Store Documentation
License: Creative Commons Attribution 4.0 International
Microsoft AppSource and Office Store Documentation
License: Creative Commons Attribution 4.0 International
Individual account for developers in Partner Centre does not allow to submit add-ins for Word - there is no interface for that (more precisely, it always redirects to creating company account) unlike in company account. I've created an add-in for Word but cannot submit to Office Store as an individual. It's not clear from this documentation.
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
Shouldn't this page also reference this warning "Add-ins that use the on send feature aren't allowed in AppSource"? (from https://docs.microsoft.com/en-ca/outlook/add-ins/outlook-on-send-addins?tabs=windows)
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
With Windows 7 leaving extended support on January 14th, 2020 (basically in a month), will the requirements for testing Office Online add-ins in Windows 7 be dropped as well?
When I load up the Partner Center after creating an Azure Blob in the Azure Portal, I only have five options, with the missing option being 'Azure Blob'.
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
It appears that addons cannot be activated when you open either a msg or eml attachment. It looks like this is not documented anywhere.
The article mentions that one should create a new solution in Partner center. I think the documentation should state what role the user needs to have in Partner Center in order to have the appropriate permission to perform this operation.
I also tried to find documentation on this by looking here:
https://docs.microsoft.com/en-us/partner-center/permissions-overview
But, it's very hard to see what role is required to add a new solution.
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
As I understand from the documentation if I want to sell through Microsoft and not to implement my own payment model the add-in will be accessible only to users with work/school emails and people with outlook emails won't be able to use it, is this correct?
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
I can't download (or find independently) the MicrosoftMarketplacesLeadIntegrationSolution_1_0_0_0_target_CRM_6 file required to setup Dynamics for capturing new leads. Is there an updated version of this document?
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
Hi Team,
we are currently working on deploying our sample add-in to office store. we have added our package manifest file in packages tab. Although it shows in uploading status from last 24 hours and we didn't received any error while uploading.
Please suggest. we have also tried removing the package and adding again.
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
I received feedback for an AppSource submission, and there are a couple of ambiguous comments in the document that I need more information about. Inside the PDF, it says:
Please address the validation errors before we publish your solution to the storefronts on AppSource and within Office products.
Next steps:
- Contact us. We can help you resolve your validation issues more quickly.
- Address the issues listed and resubmit your solution.
- Confirm you’re following best practices. Apply our best practice guidelines to your UX design.
The problem is, there is no contact information or link for WHO to contact. It just says "Contact us".
Who should I be contacting regarding in-progress submissions, and where do I find this contact information?
At the bottom of this page, guidance is given, pointing people to Stack Overflow for non-programming purposes:
If you have general questions about policies, processes, or validation requirements, you can engage with the Microsoft AppSource validation team via Stack Overflow. Tag your question with "Office-Store".
Unfortunately, policy/procedure types of questions will likely be downvoted and/or closed by the community, as they would be considered off-topic. Perhaps these questions could be directed to a more appropriate forum...
I've now seen several questions posted, expecting someone from Microsoft to address specific validation failures. These are all off-topic for Stack Overflow.
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
Just trying to help with the docs...
The section title is "Build an Azure AD connected add-in" and goes on to describe the 3-states of your add-in. Got that. Then the section ends with "to authenticate with Azure AD, see "Authorize to Microsoft Graph" which goes to a page titled "Authorize to Microsoft Graph without SSO"??? Not clear why the add-in cares about Microsoft Graph. I believe it's to allow the user to login to AAD to get user information from a tenant but that's not really clear.
Maybe a sentence or two as to why you're doing this and why the link to "Authorize to Microsoft Graph".
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
validation-policies.md needs to incorporate the additional iOS guidelines given in https://github.com/OfficeDev/office-js-docs/blob/master/docs/develop/develop-office-add-ins-for-the-ipad.md
could be to do with some behind-the-scenes updates happening to that page but this is the link location:
https://partner.microsoft.com/dashboard/office/overview
and this is the link it sends you to:
https://partner.microsoft.com/en-us/dashboard/directory
What's more, i seem to be unable to 'get started' with the 'Office Store' developer program because it asks me for company details when my company has already signed up and is affiliated with Partner Center... PLEASE HELP
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
There is a link which redirects to a non existing page.
Repro steps:
Actual results:
Link redirects to a non existing page
Expected results:
Link redirects a existing page
Hi. T
his page describes how to update my submission to the AppSource.
It would be nice if there were some words, how should I handle the submission if I want to update my add-in.
Here is an example scenario:
We submitted an add-in successfully. Then we implement something cool, but it needs to change something in the manifest. When we submit the new manifest it contains the url to the add-in code. So it is necessary to update the addin code before the submission, which means the live audience got the new add-in before the approval.
What is the good/recommended way to upgrade the add-in?
Another thing not clean for me:
The submission form has a version field, which gets the value from the manifest. If we updating the add-in we may change the version which may be shown in the add-in UI. We may update something small, maybe something big.
What is the recommended process to update the version in the manifest?
Thanks.
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
Hello,
I have a paid add-in Funfun with a free trial period. It allowed me to gain some money each month (I got payment notification from Microsoft Partner Center).
However, I don't know where to see who have past the trial period and paid this money. This information is obviously essential for my business.
I do have lead information sent to an Azure table. It shows who added my add-in, whereas it does not show who have past the trial period and paid:
Do you know where I can find this important information?
Cheers
Tie
[Dear MS,
I am a private individual and do not have a company email.
This means I cannot register in https://partner.microsoft.com/en-us/dashboard/directory for Office Store. This in turn means I cannot publish my Add-Ins.
I find this wholly unfair.
Can you help me publish my add-on please?
Yours Sincerely
Stewart Muscutt
]
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
I am trying to understand the different options for publishing an Excel add-in, and these docs left me more confused than when I started. I'll try to explain why.
Your app can be distributed directly through the Microsoft 365 app stores inside of Outlook, Excel...
I have never seen those and I had no idea where to find them in Excel. I eventually found "Get Add-ins" under the Insert ribbon (very unexpected location); I think that's the Microsoft 365 app store but nowhere in the UI does it say "Microsoft 365 app store".
In addition to the Microsoft 365 app store, Microsoft AppSource is another distribution point for your app. It is the official app store for Microsoft 365 apps and solutions.
So the "Microsoft 365 app store" is not the official app store for Microsoft 365 apps, AppSource is? That's super confusing. This document could really also use a link to AppSource.
When you submit your app for validation and it is approved, your app is automatically added to both the Office and Microsoft AppSource stores.
This seems like the terminology changed partway through the document. What was previously described as the "Microsoft 365 app stores" is now the "Office stores"?
Finally, if I read the "Deploy and publish Office Add-ins" page it doesn't mention the "Microsoft 365 app stores". So I am left with the suspicion that the "Microsoft 365 app stores" are somewhat deprecated.
I think any developer who reads this doc is going to be left with multiple unanswered questions:
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
Link redirects to 404 error message.
Repro steps:
Actual results:
Link redirects to 404
Expected results:
Link should redirect to a valid page
GH article:
https://github.com/OfficeDev/office-store-docs/blob/live/docs/validation-policies.md
The AppSource submission FAQ question on what happens when updating an add-in doesn’t entirely clarify what happens when the previous version is unpublished, and the user does not choose to update. Will the user continue using the previous version, or is the user blocked from using the add-in until they choose to update?
I’m referring to the following question (source version, online):
What happens when I update my app to a new version in Microsoft AppSource?
The following is the update process for Office Add-ins:
- You submit your revised add-in and add-in manifest to Microsoft AppSource via Partner Center. The revised […]
- You can choose to continue to offer the previous version of your app in Microsoft AppSource, or you can unpublish the previous version.
- When an existing customer launches the updated app for the first time, a notification appears either in the task pane or the body of the document that prompts the user to update their app. When the user chooses Update, the latest version of the app launches.
Could you, for the third point, clarify what happens when the user does not choose to update? In particular if, for the second point, the previous version was unpublished? Will the user continue using the previous version, or must they accept the update to continue using the add-in?
Also: what happens if the updated add-in is no longer supported by the Office application version the user is using (due to an updated Requirements element in the manifest)?
Hyw guys can I offer a suggestion. can we bookmark theses pages
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
Here are more details regarding this issue: https://stackoverflow.com/questions/49369921/test-token-for-outlook-add-in-always-returns-null-tags
There is a broken link within an article.
Repro steps:
Actual results:
Link redirects to a non existing page
Expected results:
Link redirects correctly
GH article:
https://github.com/OfficeDev/office-store-docs/blob/master/docs/validation-policies.md
There is a link redirecting to non existing article
Repro steps:
Actual results:
Link redirects to a non existing article
Expected results:
Link redirects to a valid article
GH Article
https://github.com/OfficeDev/office-store-docs/blob/live/docs/upload-package.md
Link redirects to a non existing page.
Repro steps:
Actual results:
Link redirects to a non existing page
Expected results:
Link should redirect to a existing page
GH article:
https://github.com/OfficeDev/office-store-docs/blob/live/docs/validation-policies.md
Situation:
Microsoft Excel JS Add-in - Trying to publishing on App Source - Fonctionning add-in (local/ azure)
Issue:
The following error is raised when trying to publish the app on Microsoft Partner Center and trying to upload the package (e.g. in my case manifest.xml): "Package acceptance validation error: manifest.xml is an unknown package type. Please name your file with the appropriate file extension."
Question:
What is the correct way to publish on App source for Excel JS Add-in? Is it documented somewhere?
Thank you
Our add-in has been published to MS add-in store. And we plan to release a mobile version.
We deploy our add-in via MSFT partner center.
From these screenshots, it seems we need to provide a apple developer id because our manifest has mobileFormFactor element. And I wondering if our add-in does not need to be in the Apple Store, do I need to select this checkbox for Apple Store Availability?
And all I need to do is just provide apple dev id on account settings? Is there any limitation of this apple dev id or other requirements for publish mobile version?
Thanks in advance!
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
In the seller dashboard, it says "Account pending approval", but on my developer account (https://partner.microsoft.com/en-US/dashboard/account/management) the account status is "Authorized". It has been this way for days now, and I'm at a loss to figure out what I should do. Who can I turn to for support on this matter?
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
There is a broken link within an article.
Repro steps:
Actual results:
Link redirects to a non existing page
Expected results:
Link redirects correctly
GH article:
https://github.com/OfficeDev/office-store-docs/blob/master/docs/add-license-checks-to-office-and-sharepoint-add-ins.md
The documentation suggests to send the customer directly to the rating page, after a while the user using the add-in.
How can I determine the link for my add-in's feedback/rating page?
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
I am the developer of a Microsoft Teams app and I have configured Azure table details for lead management.
I know customers have installed the app since I setup lead management but there is no data in the azure table or in the analytics section of the app.
There is a typo on the LH menu for this page - it reads "Mange" instead of "Manage"
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
We are using the Seller Dashboard to manage the client id and client secret, and recent we found the SharePoint Online App is not working in U.S. Government environment like GCC High Office 365 tenant. Is there any separated Seller Dashboard for U.S. Government? Thank you!
The other user is facing the same issue here https://sharepoint.stackexchange.com/questions/283831/sharepoint-add-in-client-id-and-secret-for-us-gov-tenancy
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
I chose to setup the Azure Table option for our Excel add-in, but at the moment it looks like it only stores placeholder information. Is there are timeline for when this will be implemented? Also, how will the in-client piece work? My guess is that it will still use the "src" and "mrktid" parameters in the url?
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
I am trying to get test token validation working for an Outlook office add-in.
Decoded String:
VNNAnf36IrkyUVZlihQJNdUUZlYFEfJOeldWBtd3IM=
Encoded String:
%3Cr%3E%3Ct%20aid%3D%22WA900006056%22%20pid%3D%22bd1fedd2-ff5f-4b8e-ac48-c2b47ee0ce91%22%20oid%3D%223DBFC30C-DBE9-419E-A5FB-1DB48BEDEC1B%22%20did%3D%22xxxxxxx.onmicrosoft.com%22%20et%3D%22Trial%22%20ad%3D%222018-01-12T21%3A58%3A13Z%22%20sd%3D%222018-01-12T00%3A00%3A00Z%22%20te%3D%222018-06-30T02%3A49%3A34Z%22%20test%3D%221%22%20%2F%3E%3Cd%3EVNNAnf36IrkyUVZlihQJNdUUZlYFEfJOeldWBtd3IM%3D%3C%2Fd%3E%3C%2Fr%3E
No matter what and how I pass this to https://verificationservice.officeapps.live.com/ova/verificationagent.svc/rest/verify?token={token} it just does not return anything with any value populated.
Is the documentation stale on the string format or am I missing anything? The documentation says 64 bit encoding is not required for Office Add-ins.
There is a link which redirects to a non existing page
Repro steps:
Actual results:
Link redirects to a non existing page
Expected results:
Link redirects a existing page
It is really unclear in this page that VSTO add-ins are not supported (unless they are) but I can't figure out how to publish one for monetization. Is there a way to monetize VSTO Add-Ins ? If so do you have a sample walk-through ?
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
[Enter feedback here]
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
There is a broken link in an article
repro steps:
Actual results:
Link redirects to a non existing page
Expected results:
Link should redirect correctly
When we visit the app page and go over comments, logged in as the same user used to submit the app to the store, we only have a "report abuse" link near reviews. the "comment" link is not available.
Please clarify where this link is or why this option is not available.
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
If I want to start the approval process before knowing an exact release date, I might want to:
Is it possible to edit the release date after an app is approved? If possible, does that require going through the approval process again?
(P.S. Thanks for the great docs!)
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
When You choose "Edit Lead Management information" in app details, after information and credential input there is a "Your data has been saved successfully" communicate and after returning to the edit page there is no information at all only unchecked "Leave management" I was using a Chrome browser 59.0.3071.115
I would like to monetise Excel add-in, by creating my own payment and licensing model. I would like allow users to download add-in for free from office store, use it for some time free of charge and later when the initial free offer is expired I will give user and option to buy a licence from my own portal. The payment collection system will be implemented using trusted payment collection provider system like Strip or other. Can I implement my own licensing / payment system? My adding will contact my licensing API check that the user is fully licensed before allowing user to user the services. Is this model comply with MS monetising guidance?
I just had an application rejected because I changed my manifest but did not increment my manifest version. While it may be obvious to some that you should increment your version, while there may be technical reasons this should be done, nothing in the guidelines even suggests this.
Recommendation: If this is an actual requirement, add it to the guidelines.
Specifically referencing this page: https://dev.office.com/officestore/docs/validation-policies
Hello,
I am currently running a node/express server to do license verification for my application. I am having issues I was able to work around but it does not follow the guidelines provided so I wanted to check if I am missing something.
Currently I am getting the et parameter and base64 decoding it
var token = new Buffer(req.query.et, 'base64').toString('ascii');
Then according to the guidelines I need to url encode this to send it to the verification service. If I use encodeURIComponent as suggested, I get the following url (this is based off of the sample token provided in the docs).
token = encodeURIComponent(token);
This does not work (IsTest is false). However if I use some regex magic I do get a working response.
token = encodeURIComponent(token).replace(/%00|%0D/g, '').replace(/%20/g,'+');
Just wanted to clarify if I am doing something wrong or the documentation is out of date.
Hey everyone,
It is mentioned in the doc that if you've already published your solution to Microsoft AppSource, you can't remove it from Partner Center but there's no guidance on where and how to remove it, unfortunately.
Is a Support Request required in order to get a solution deleted?
Many thanks!
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
[Enter feedback here]
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
Under "Effective Long Descriptions" you say "Most users read between 300 and 500 words.". In the table under "Apply guidelines for title and description length", for Long description the recommended length is "300-500 characters". These recommendations are contradictory. I presume the table should say "300-500 words" rather than "300-500 characters"
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
And I found that When I turn on this toggle and using Office.context.ui.displayDialogAsync to open dialog box for login in authentication, it will always jump up to other browser to open login in page instead of display inside outlook app, and outlook add-in toggle will turn off just like connection lose.
This issue was just happened and only on Andriod machine, it used to dispaly in outlook but recently its bahavior was changed. And some add-ins like Zoom will still display inside outlook.
By the way, if I repeat to turn on toggle for 2-3 times, it will open dialog inside outlook app again, just as the screenshot, it's so wired...
I wondering if this is due to my add-in is just for development and not submit to MS store yet, is there any scecurity update on MSFT?
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.