Humberto's questions

Estou tentando desenvolver um suplemento de conteúdo seguindo a documentação oficial . A seção de implementação afirma que apenas algumas alterações são necessárias:

• Para o elemento OfficeApp, defina o atributo xsi:type como "ContentApp".
• No DefaultSettingselemento, adicione os elementos RequestedHeighte RequestedWidth.

Na mesma seção, estão listados dois suplementos básicos baseados em conteúdo para PowerPoint e Excel, mas, infelizmente, eles são voltados para o Visual Studio e eu não tenho uma máquina Windows. Há também uma referência a um exemplo de 9 anos chamado Excel-Content-Add-in-Humongous-Insurance , cujo manifesto parece bastante desatualizado.

Decidi experimentar usar o Yeoman e o VScode. Como o yo officeescritório não oferece um starter para o Add-in baseado em conteúdo, optei por usar:

? Choose a project type: Office Add-in Task Pane project using React framework
? Choose a script type: TypeScript
? What do you want to name your add-in? my-content-addin
? Which Office client application would you like to support? Powerpoint

Seguindo a documentação listada acima, alterei o xsi:typedo OfficeAppelemento para o ContentAppe adicionei os elementos RequestedHeighte RequestedWidthao DefaultSettingselemento.

Além disso, notei que o manifesto Excel-Content-Add-in-Humongous-Insurance não tinha o seguinte esquema no OfficeApp:

xmlns:ov="http://schemas.microsoft.com/office/taskpaneappversionoverrides"

Verifiquei o repositório office-addin-manifest e não consegui encontrar uma alternativa para suplementos de conteúdo, por exemplo, .../contentappversionoverrides. Encontrei apenas um .../mailappversionoverrides.

Também notei que o manifesto Excel-Content-Add-in-Humongous-Insurance não tinha esse VersionOverrideselemento, então o removi do meu arquivo gerado manifest.xml. Então, terminei com:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OfficeApp 
  xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0" 
  xsi:type="ContentApp">
  <Id>9e2e38ec-67af-43e6-8aeb-c8c3e22b86bd</Id>
  <Version>1.0.0.0</Version>
  <ProviderName>Contoso</ProviderName>
  <DefaultLocale>en-US</DefaultLocale>
  <DisplayName DefaultValue="my-content-addin"/>
  <Description DefaultValue="A template to get started."/>
  <IconUrl DefaultValue="https://localhost:3000/assets/icon-32.png"/>
  <HighResolutionIconUrl DefaultValue="https://localhost:3000/assets/icon-64.png"/>
  <SupportUrl DefaultValue="https://www.contoso.com/help"/>
  <AppDomains>
    <AppDomain>https://www.contoso.com</AppDomain>
  </AppDomains>
  <Hosts>
    <Host Name="Presentation"/>
  </Hosts>
  <DefaultSettings>
    <SourceLocation DefaultValue="https://localhost:3000/taskpane.html"/>
    <RequestedHeight>400</RequestedHeight>
    <RequestedWidth>400</RequestedWidth>
  </DefaultSettings>
  <Permissions>ReadWriteDocument</Permissions>
</OfficeApp>

Depois disso, tentei validar o manifesto e recebi estes erros:

Error #1: 
XML Schema Validation Error: Error found during XML Schema validation.
  - Details: The element 'DefaultSettings' in namespace 'http://schemas.microsoft.com/office/appforoffice/1.1' has invalid child element 'RequestedWidth' in namespace 'http://schemas.microsoft.com/office/appforoffice/1.1'.
  - Line: 25
  - Column: 6

Error #2: 
XML Schema Violation: Your manifest does not adhere to the current set of XML schema definitions for Office Add-in manifests.

Removi o módulo " , RequestedWidthembora pareça conhecido " , e tentei novamente. Desta vez, o manifesto era válido. Então, executei e meu suplemento foi adicionado ao slide atual automaticamente.manifestHandlerXml.tsoffice-addin-manifestnpm start

Este é meu manifest.xml final

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OfficeApp 
  xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0" 
  xsi:type="ContentApp">
  <Id>9e2e38ec-67af-43e6-8aeb-c8c3e22b86bd</Id>
  <Version>1.0.0.0</Version>
  <ProviderName>Contoso</ProviderName>
  <DefaultLocale>en-US</DefaultLocale>
  <DisplayName DefaultValue="my-content-addin"/>
  <Description DefaultValue="A template to get started."/>
  <IconUrl DefaultValue="https://localhost:3000/assets/icon-32.png"/>
  <HighResolutionIconUrl DefaultValue="https://localhost:3000/assets/icon-64.png"/>
  <SupportUrl DefaultValue="https://www.contoso.com/help"/>
  <AppDomains>
    <AppDomain>https://www.contoso.com</AppDomain>
  </AppDomains>
  <Hosts>
    <Host Name="Presentation"/>
  </Hosts>
  <DefaultSettings>
    <SourceLocation DefaultValue="https://localhost:3000/taskpane.html"/>
    <RequestedHeight>400</RequestedHeight>
  </DefaultSettings>
  <Permissions>ReadWriteDocument</Permissions>

</OfficeApp>

Como posso especificar uma largura padrão para meu suplemento de conteúdo?

Como posso inserir meu suplemento somente quando clico em um comando da Faixa de Opções, como a demonstração padrão do Painel de Tarefas, que abre o painel de tarefas?

Na demonstração do Yeoman Taskpane, VersionOverridesé necessário um esquema xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides". Qual seria a alternativa para o Controlelemento de ação: <Action xsi:type="ShowTaskpane">em um suplemento baseado em conteúdo?

Estou tentando adicionar algum suporte de preenchimento automático para um parâmetro de método genérico

 subscribeToTelemetry<T extends keyof TypeMap>(name: T): Stream<TypeMap[T]>;
 subscribeToTelemetry<T extends NonNullable<{}>>(name: EntityName<T>): Stream<T>; 

Em poucas palavras, se nenhum tipo for fornecido, subscribeToTelemetryo tipo de retorno de deve ser inferido com base no nome e em alguns tipos injetados/gerados automaticamente disponíveis. Além disso, possíveis sugestões de nomes devem ser feitas usando os tipos injetados/gerados automaticamente disponíveis. Por exemplo, usando o seguinte tipo:

type TypeMap = {
    ranger1: RangerTelemetry,
    ranger2: RangerTelemetry,
    mavic2: DroneTelemetry
};

e o seguinte código

// should suggest: ['mavic2' | 'ranger2' | 'ranger1'] since no type T is provided 
const myStream1 = r.subscribeToTelemetry('ranger1'); // myStream1: Stream<RangerTelemetry

O valor sugerido deve ser ['mavic2' | 'ranger2' | 'ranger1'] já que nenhum tipo T é fornecido, e o tipo myStream1 seráStream<RangerTelemetry>

Pelo contrário, se fornecermos um tipo subscribeToTelemetry e considerarmos o tipo injetado/gerado automaticamente disponível

const entityNames = {
    RangerTelemetry: ['ranger1', 'ranger2', 'ranger3'],
    DroneTelemetry: ['mavic1', 'mavic2', 'mavic3'],
} as const;

e alguns outros tipos de trics (veja o link do playground), usando o seguinte código

// should suggest only: ['mavic1' | 'mavic2' | 'mavic3'] since type T is provided as DroneTelemetry,
const myStream3 = r.subscribeToTelemetry<DroneTelemetry>('mavic1');

Deveríamos sugerir: ['mavic1' | 'mavic2' | 'mavic3'] já que o tipo DroneTelemetryfoi fornecido, mas ['mavic1' | 'mavic2' | 'mavic3', 'ranger1', 'ranger2', 'ranger3'] é mostrado em vez disso. O tipo de myStream3seráStream<DroneTelemetry>

Tenho várias variantes para a implementação da assinatura do subscribeToTelemetrymétodo sobrecarregado, mas não consigo fornecer as sugestões corretas ao fornecer um tipo. Sempre recebo a sugestão dos rangers, mesmo quando especifico DroneTelemetrycomo tipo.

class Registry {
    subscribeToTelemetry<T extends keyof TypeMap>(name: T): Stream<TypeMap[T]>;
    subscribeToTelemetry<T extends NonNullable<{}>>(name: EntityName<T>): Stream<T>;
    subscribeToTelemetry<T extends NonNullable<{}>>(name: EntityName<T>): Stream<T> {
        return new Stream<T>(name); 
    }
}

Se alguém tiver alguma sugestão, agradeceria qualquer ajuda

Humberto

Aqui está o código completo:

type DroneTelemetry = { kind: 'DroneTelemetry', batteryLevel: number, velocity: number, location: {latitude: number, longitude: number}}
type RangerTelemetry = { kind: 'RangerTelemetry', velocity: number, location: {latitude: number, longitude: number}}


////// the entity names and type mapping will be autogenerated
const entityNames = {
    RangerTelemetry: ['ranger1', 'ranger2', 'ranger3'],
    DroneTelemetry: ['mavic1', 'mavic2', 'mavic3'],
} as const;

type TypeMap = {
    ranger1: RangerTelemetry,
    ranger2: RangerTelemetry,
    mavic2: DroneTelemetry
};
////////

// Define the types for the keys and values of the mapping
type EntityNames = typeof entityNames;
type EntityKeys = keyof EntityNames;
type EntityValues<T extends EntityKeys> = EntityNames[T][number];

// Define a mapping from type aliases to their corresponding keys
type TypeToKey<T> = T extends { kind: infer K } ? K : never;

type ExtractEntitiesNames<T> = TypeToKey<T> extends keyof EntityNames ? EntityValues<TypeToKey<T>> : never;
type EntityName<T> = ExtractEntitiesNames<T> |  (string  & {});

/////////////////////////////////////////////////////////////////////

class Stream<T> {
    name: string
    constructor(name: string){
        this.name = name
    }
    getLastValue() {
        return {} as T // dummy impl
    }
}

class Registry {
    subscribeToTelemetry<T extends keyof TypeMap>(name: T): Stream<TypeMap[T]>;
    subscribeToTelemetry<T extends NonNullable<{}>>(name: EntityName<T>): Stream<T>;
    subscribeToTelemetry<T extends NonNullable<{}>>(name: EntityName<T>): Stream<T> {
        return new Stream<T>(name); 
    }
}

const r = new Registry();
// should suggest: ['mavic2' | 'ranger2' | 'ranger1'] since no type T is provided // OK
const myStream1 = r.subscribeToTelemetry('ranger1'); // myStream1 type will be Stream<RangerTelemetry>

// should suggest: ['mavic2' | 'ranger2' | 'ranger1'] since no type T is provided // OK
const myStream2 = r.subscribeToTelemetry('ranger2'); // myStream2 type will be Stream<RangerTelemetry>

 // should suggest only: ['mavic1' | 'mavic2' | 'mavic3'] since type T is provided as DroneTelemetry,
 // but ['mavic1' | 'mavic2' | 'mavic3', 'ranger1', 'ranger2', 'ranger3'] is shown instead.                // WRONG
const myStream3 = r.subscribeToTelemetry<DroneTelemetry>('mavic1'); // myStream3 type will be Stream<RangerTelemetry>

Aqui está um ts-playground com o código completo