Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,22 @@ jobs:
steps:
- uses: actions/checkout@v2

- name: Check deprecation date
shell: pwsh
run: |
$deprecationDate = [datetime]"2026-08-31"
$currentDate = Get-Date

if ($currentDate -gt $deprecationDate) {
Write-Error "ERROR: SDK deprecation date has passed (2026-08-31)"
Write-Error "Publishing to NuGet is disabled after the deprecation date."
exit 1
}

$daysRemaining = ($deprecationDate - $currentDate).Days
Write-Host "Days until deprecation: $daysRemaining"
Write-Host "Publishing allowed"

- name: Setup Nuget
uses: nuget/setup-nuget@v1
with:
Expand Down
202 changes: 202 additions & 0 deletions DEPRECATION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,202 @@
# Analytics SDK .NET - Deprecation Notice

**Status**: ⚠️ **DEPRECATED** - Effective August 31, 2026

---

## Important Notice

The **FactSet Analytics SDK for .NET** (`FactSet.AnalyticsAPI.Engines`) is **officially deprecated** as of **August 31, 2026**.

### Timeline

| Date | Status | Action |
|------|--------|--------|
| **Until Aug 31, 2026** | Active | Limited security fixes only |
| **Aug 31, 2026** | Final Release | Last day of support - FINAL DATE |
| **Sep 1, 2026+** | Removed | ALL versions removed from NuGet - Enterprise SDK REQUIRED |

### What This Means

✅ **Existing Projects**: Continue to work (installed before Sep 1)
❌ **New Projects**: Cannot install Analytics SDK from Sep 1, 2026 onwards
❌ **New Installs**: IMPOSSIBLE after Aug 31, 2026 - Enterprise SDK ONLY
⚠️ **Security Issues**: NO patches after Aug 31, 2026
🔄 **Migration REQUIRED**: Must complete migration by Aug 31, 2026

---

## Migration Required

### Why Migrate?

- **Long-term Support**: Enterprise SDK is the actively maintained solution
- **New Features**: Enterprise SDK receives regular updates and features
- **Security**: Security patches provided for years to come
- **Support**: Dedicated support team for enterprise deployments

### How to Migrate

#### Step 1: Review Current Usage

```csharp
// Identify all code using the Analytics SDK
using FactSet.AnalyticsAPI.Engines;
using FactSet.AnalyticsAPI.Engines.Api;
using FactSet.AnalyticsAPI.Engines.Model;
```

#### Step 2: Update Project File

```xml
<!-- OLD: Analytics SDK (Deprecated) -->
<PackageReference Include="FactSet.AnalyticsAPI.Engines" Version="6.1.1" />

<!-- NEW: Enterprise SDK -->
<PackageReference Include="FactSet.SDK.FactSetAnalyticsAPI" Version="1.0.0" />
```

#### Step 3: Update Imports

```csharp
// OLD: Analytics SDK
using FactSet.AnalyticsAPI.Engines;
using FactSet.AnalyticsAPI.Engines.Api;
using FactSet.AnalyticsAPI.Engines.Model;

// NEW: Enterprise SDK
using FactSet.SDK.FactSetAnalyticsAPI;
using FactSet.SDK.FactSetAnalyticsAPI.Api;
using FactSet.SDK.FactSetAnalyticsAPI.Model;
```

#### Step 4: Update API Calls

Refer to the [Migration Guide](https://github.com/factset/enterprise-sdk/tree/main/code/dotnet) for specific API changes.

### Installation Methods

**NuGet Package Manager:**
```bash
Install-Package FactSet.SDK.FactSetAnalyticsAPI -Version 1.0.0
```

**.NET CLI:**
```bash
dotnet add package FactSet.SDK.FactSetAnalyticsAPI --version 1.0.0
```

---

## Key Dates

### FINAL DATE: August 31, 2026
**LAST DAY** for Analytics SDK support and availability

### From September 1, 2026
- ✂️ **ALL versions REMOVED from NuGet**
- 🚫 **NO new installations possible**
- 🚫 **NO package discovery on NuGet**
- ⚠️ **Only Enterprise SDK available**
- 📦 **Existing installations continue to work (cached versions)**

### Migration Window
- **Start**: Now
- **Deadline**: August 31, 2026
- **After Deadline**: Enterprise SDK REQUIRED for any new projects or installations

---

## FAQ

### Q: Will my existing project break after Aug 31?
**A**: No, existing installations will continue to work. However, you won't be able to install new versions or migrate to new machines without having a local cache.

### Q: What if I don't migrate by Aug 31?
**A**: CRITICAL - After Aug 31, you CANNOT:
- ❌ Install Analytics SDK from NuGet (removed)
- ❌ Add package to new projects
- ❌ Restore on new build agents without cached version
- ❌ Get any security patches or support

**Only Option**: Migrate to Enterprise SDK immediately after Aug 31

### Q: Is the Enterprise SDK a replacement?
**A**: Yes, the Enterprise SDK is the recommended replacement. It provides:
- Same functionality
- Better performance
- Active maintenance
- Long-term support

### Q: How long do I have to migrate?
**A**: You have until **August 31, 2026** ONLY:
- ✅ Until Aug 31: Analytics SDK available from NuGet
- ❌ From Sep 1: ALL versions REMOVED from NuGet
- ⚠️ No grace period - complete removal on Sep 1

### Q: Do I need to change my code?
**A**: Minor changes may be required. See [Migration Guide](https://github.com/factset/enterprise-sdk/tree/main/code/dotnet).

### Q: Can I still download the old package?
**A**: Yes, if you have it cached. After unlisting, you cannot download it from NuGet unless you explicitly specify the version.

### Q: What about support?
**A**: Limited support available until Aug 31, 2026. After that date, support team will focus on Enterprise SDK.

---

## Support & Resources

### Migration Assistance
- **Enterprise SDK GitHub**: https://github.com/factset/enterprise-sdk/tree/main/code/dotnet
- **Migration Guide**: https://developer.factset.com
- **Email Support**: analytics.api.support@factset.com

### Repositories
- **Analytics SDK (This Repo)**: https://github.com/factset/analyticsapi-engines-dotnet-sdk
- **Enterprise SDK**: https://github.com/factset/enterprise-sdk
- **API Documentation**: https://developer.factset.com/api-catalog

---

## Upgrade Path

### For Current Users

```
Analytics SDK (v6.1.1)
[Migrate]
Enterprise SDK (v1.0.0+)
[Active Support & Updates]
```

---

## Affected APIs

This deprecation affects the following FactSet Analytics APIs:

- **PA Engine API** - Portfolio Analysis
- **SPAR Engine API** - Style Performance Attribution
- **Vault API** - Portfolio Management

All functionality is available in the Enterprise SDK with improved performance and support.

---

## Questions?

If you have questions about the deprecation or migration:

1. Check the [Migration Guide](https://github.com/factset/enterprise-sdk)
2. Review [Deprecation Documentation](./DEPRECATION.md)
3. Contact: **analytics.api.support@factset.com**

---

**Last Updated**: August 5, 2026
**Deprecation Effective Date**: August 31, 2026
**Status**: In Effect
Loading
Loading